Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Integration Server Built-In Services | XMLData Folder | Summary of Elements in this Folder | pub.xmldata:getInstanceTag
 
pub.xmldata:getInstanceTag
WmPublic. Retrieves the value of a specified instance tag from a field in XMLData document.
An element in an XML document may contain information that is unique to that particular instance document, including instance (xsi) assertions such as type, nil, or schemaLocation. Because instance information cannot be asserted in an XML schema definition, an XML document type cannot contain fields for the instance information. It is impossible for the XML Schema definition and the XML document types generated from that schema to know where the instance assertions might be specified in an instance document. When an XML instance document is parsed and converted to XMLData, specifically an XMLData-formatted document, Integration Server places the instance information in *instance field under the parent of the field that contains the instance information. That is, Integration Server stores the instance information in an *instance field that is a child of the field that corresponds to the element that contains the instance information in the XML document. Use the pub.xmldata:getInstanceTag service to retrieve the instance information from the XMLData created from the XML document. After you retrieve the instance information, you can manipulate or use the instance information in the pipeline. To set the value of the instance information in the XMLData, use the pub.xml:setInstanceTag service.
Input Parameters
xmlDataParent
Document The XMLData document that is a parent of the field for which to retrieve the instance tag value.
ncName
String The NCName (non-colonized name), of the field for which you want to retrieve an instance tag value. The NCName is also called the local name.
namespace
String Optional. The namespace URI for the field for which you want to retrieve an instance tag value. If you do not specify a value, the service looks for tags that do not belong to a namespace.
particleId
String The sequential number for the particle in a model group for which you wan to retrieve an instance tag value. A value of 1 refers to the first instance of the field with ncName#namespace name in a model group.
index
String Optional. If the field for which you want to retrieve a tag value is a repeating field (minOccurs > 0), specify the index for the occurrence for which you want to retrieve a tag value. A value of 0 refers to the first instance of a repeating field.
Note:
Repeating elements are represented as arrays in XMLData.
tagName
String Name of the instance tag for which you want to retrieve a value, such as type, nil, schemaLocation.
Note:
Tag names are case-sensitive.
Output Parameters
tagValue
String Value of the tag.
Usage Notes
Together, the ncName, namespace, particleId, and index identify a particular field in the XMLData document.