A Node Tag is used to embed nodes or data elements in QIE templates. The node tag identifies both the data source (source, message, message cache, variable, etc.) and the associated Node Path. QIE templates are used in mapping functions, database queries, file and FTP paths, etc. The qie.evaluateTemplate() function must be called when using node tags, except when using the qie.doQuery() and qie.doConditionQuery() functions. The QIE node tag syntax conforms to the following pattern:
{ Source Indicator [ Format Indicator ] : Node Path }
|
Element
|
Required
|
Description
|
Source Indicator
|
Optional
|
The source indicator is a 1 or 2 character value which identifies the data source associated with the node path. If the source indicator is omitted, the data source is assumed to be the Source object.
|
Format Indicator
|
Optional
|
The format indicator is used to specify the desired format of the data returned by the node path.
|
Node path
|
Required
|
The node path, value name, or variable name to use when querying the specified data source for the associated node tag value
|
The following Source Indicators are defined:
Source Indicator
|
Object
|
Description
|
no indicator
|
Source
|
When no indicator is specified, the node tag will return the value of the node in the source object which matches the specified node path
|
cc
|
Channel Cache
|
The node tag will return the value of a channel cache entry with a name that matches the specified node path (a source indicator of ‘ch’ can also be used)
|
mc
|
Message Cache
|
The node tag will return the value of a message cache entry with a name that matches the specified node path (a source indicator of ‘c’ can also be used)
|
m
|
Message
|
The node tag will return the value of the node in the message object which matches the specified node path
|
p
|
Parameter
|
The node tag will return the value of a parameter with a name that matches the specified node path
|
s
|
Source
|
The node tag will return the value of the node in the source object which matches the specified node path
|
v
|
Variable
|
The node tag will return the value of a system variable with a name that matches the specified node path
|
ws-user
|
Web Service
|
The node tag will return the value of the “Username” field of the web service connection with a name that matches the specified node path.
|
ws-pass
|
Web Service
|
The node tag will return the value of the “Password” field of the web service connection with a name that matches the specified node path.
|
The following Format Indicators are defined:
Format Indicator
|
Description
|
base64
|
When the base64 format indicator is used, the data returned by the node tag will be Base64-encoded before being added to the template
|
Date/time format string
|
When using the SYSTEM_DATE System Node Tag, the desired date/time format must be specified (see Date/Time Mapping Function for more information).
|