Sidebar

What is a nodetag?

0 votes
462 views
asked Dec 10, 2018 by brandon-w-8204 (33,270 points)
What is a node tag and what is the syntax?

1 Answer

+1 vote

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).

answered Dec 10, 2018 by brandon-w-8204 (33,270 points)
...