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:getNamespaceTags
 
pub.xmldata:getNamespaceTags
WmPublic. Retrieves the namespace declarations, specifically the prefix and namespace URI, associated with a particular field in an XMLData Document.
An element in an XML document may contain information that is unique to that particular instance document, including namespace declarations and instance assertions such as type, nil, or schemaLocation. A namespace declaration associates a prefix with a namespace URI. Because namespace declarations cannot be asserted for an element in an XML schema definition, an XML document type cannot contain fields for the namespace declarations. It is impossible for the XML Schema definition and the XML document types generated from that schema to know where the namespace declarations 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 namespace declarations in a *namespace field under the parent of the element that contains the namespace declaration. That is, Integration Server stores the namespace declarations in an *namespace field that appears as a child of the field that corresponds to the element containing the namespace declaration in the XML document. Use the pub.xmldata:getNamespaceTag service to retrieve the namespace declarations for a particular field from the XMLData created from the XML document. After you retrieve the namespace declaration, you can manipulate the namespace declarations in the pipeline. To set the value of a namespace declaration for a particular field in the XMLData, use the pub.xml:setNamespaceTag service.
Input Parameters
xmlDataParent
Document The XMLData document that is a parent of the field for which to retrieve the namespace tag and value.
ncName
String The NCName (non-colonized name), of the field for which you want to retrieve an namespace declaration. The NCName is also called the local name.
namespace
String Optional. The namespace URI for the field for which you want to retrieve the namespace declaration. If you do not specify a namespace, the service looks for a field that does not belong to a namespace.
particleId
String The sequential number for the particle in a model group for which you want to retrieve a namespace declaration. 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 namespace declaration is a repeating field (minOccurs > 0), the index for the occurrence for which you want to retrieve the namespace declaration. A value of 0 refers to the first instance of a repeating field.
Note:
Repeating elements are represented as arrays in XMLData.
Output Parameters
results
Document List A document (IData) containing namespace declarations for the specified field. A namespace declaration consists of a prefix and a namespace URI.
Key
Description
tagName
String Prefix specified in the namespace declaration. The tagName parameter contains an empty string if this is the default namespace declaration.
tagValue
String The namespace URI associated with the namespace declaration.
Usage Notes
Together, the ncName, namespace, particleId, and index identify a particular field in the XMLData.