Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter ElevenSGML Functions (continued)

XDXCreateGroupingComponent Function

Overview

The XDXCreateGroupingComponent function assembles parameters to create group component.

Syntax/Parameters

Syntax

string = XDXCreateGroupingComponent ( string data[] );

Parameters

data

A string array containing named parameters. See Remarks below.

Return Value

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

Remarks

Component parameters are provided as an array with named keys. The key names are as follows:

  Key Name   Description  
  id  

An identifier for the grouping that is only letters with the exception of L1, L2, or L3 are allowable. All engrams that use the same grouping identifier will be part of a single group.
 
  order   An optional order that describes the order of the parts of the continuation. If an order is not specified the order is assumed to be the order the engrams appear in the file.  

 

Note that the returned component does not contain an engram code. This is added when the component is added using the XDXPropertiesToEngram function.

The complimenting function is XDXGetGroupingProperties.

Related Functions

Platform Support

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

Legato IDE, Legato Basic