STx 3.9 Documentation

Book

Shell Items

Up

XML Element and Attribute Manipulation

Previous

EXTRACTFILE

Next

ROOT

EXTRACTTABLE

SET xmlfile EXTRACTTABLE extTable posFld|* elemTag tagFld attr1Name attr1Fld ... [ /P /R /1|All /Y]

Extract a selection of attribute values from elements with a specific tag on the current level into a table.

extTable

The id of an extended table item.

posFld

The name of the table field where element positions should be stored. If the option /P is specified, the position of the element's parent is save instead.

elemTag

The name of the element tag (e.g. "AFile" for <AFile> elements) or an asterisk for all elements.

tagFld

The name of the table field to store the extracted element tags.

attr1Name

The name of an attribute to extract.

attr1Fld

The name of the table field where the attr1Name attribute values should be stored.

/Recursive

If specified, the whole sub-tree is extracted.

/Parent

If specified, the element's parent's position is stored in the posFld column.

/1|All

If /1 is specified, elements are only extracted if at least one of the specified attributes is set. If /All is specified, elements are only extracted if all of the specified attributes are set. The default behaviour is to extract all elements irrespective of whether any attributes are set or not.

/Y

If specified, the elemTag argument is treated as a DOCTYPE class name and not only the elements, but also their derived classes are searched (e.g. if elemTag is ASeg, then all APar's are searched too).

If positions are stored (i.e. posFld is not set to *) the programmer is responsible for deleting the positions.

SET xmlfile EXTRACTTABLE extTable elemTag1 nameFld1 ... /Mode=Attributes /Y /Recursive

Saves a list of all the attributes found in the specified elements. Each elements (elemTagX) attributes are stored in the associated table field nameFldX.

/Mode=Attribute

This is mandatory.

See the command above for a description of the other parameters and options.

SET xmlfile EXTRACTTABLE extTable posFld|* tagFld attr1Name attr1Fld ... /Mode=Read [/All|Tagged]

Updates the attribute list already in the table extTable. No new elements are searched (i.e. the existing positions are used).

/Mode=Read

This is mandatory.

/All|Tagged

If /All is specified, all table entries are used (this is the default). If /Tagged is specified, then only the tagged entries are used.

See the command above for a description of the other parameters and options.

© 2009 The Austrian Academy of Sciences Acoustics Research Institute