Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter ElevenSGML Functions (continued)

XDXPropertiesToEngram Function

Overview

The XDXPropertiesToEngram function takes an optional parameter list and creates an XDX engram.

Syntax/Parameters

Syntax

string = XDXPropertiesToEngram ( byte type, [string properties], [boolean unique] );

Parameters

type

A byte specifying the type of XDX engram.

properties

An optional string containing key named parameters to add to the engram,

unique

An optional boolean value indicated whether to add a randomly generated unique ID. If omitted, the default value is TRUE.

Return Value

A string containing an engram or an empty string on failure. Use the GetLastError function to retrieve a formatted error code and GetLastErrorMessage for additional detail.

Remarks

Engrams are normally stored in the ID attribute of HTML tags but may also be stored in comment fields. See Section 11.18 Low Level XDX Functions for the definition of engram type codes, properties names and value format. Note, many items must be encoded before being added to an engram.

The API function does not test whether specified properties are appropriate for the engram type.

Finally, not all XDX information is contained in ID engrams.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic