create xml from node()
This function creates an XML file based on the node that is specified in parameter a. If no value is set in a, the node that contains the field with this function is used.
Parameters
|
Parameter |
Description |
|
a |
(optional) Name of the node, from which the XML is created. If the parameter is left empty, the node on/under which the function is executed is used. Important note: If the root node uses a namespace, parameter c must be set to "true". |
|
b |
(optional) "true" if no XML header should be created. Default: "false". |
|
c |
(optional) If the memory-safe method used (parameter c=true), elements will be swapped to the file system during the creation of the XML. This is the preferred option for larger amounts of data. See parameter d. |
|
d |
(optional) When the memory-safe method is used (parameter c=true), this parameter defines the threshold value of elements at which the swapping to the file system starts. Default: "1000". |
|
e |
(optional) "true" to inherit namespaces from a node. Default: "false". |
|
f |
(optional) "true" to also write the whitespaces of field values (even if there are only whitespaces). Default: "false". |
|
g |
(optional) Replace field names "D-_..." and "F-_..." with "_..." (meaning: cuts off "D-" and "F-"). Default: "false". |
|
h |
(optional) "true" to suppress defined namespaces. Default: "false". |
|
i |
(optional) "true" to also write empty fields. Default: "false". |
Parameter description for XML handling in the target tree
In order to control the structure of XML elements in the target tree, properties in the target structure nodes/fields and special fields with reserved suffixes are used.
Properties in target structure nodes
"XML Namespace": This property defines a namespace for the element which is created from the node where it is specified, e.g. " soapenv" . All elements contained in this node will get the same namespace as long as there is no other namespace set. If no namespace should be set, use " DEFAULT" as value.
"XML/JSON handling": This property controls the way in which the node is added to the XML. The following settings are possible:
"Normal": The node is created as an element in the XML.
"Transparent": The node itself does not generate an XML element, but the content in the node is considered.
"Exclude": The node is ignored in the generation.
"Array": (This value is not relevant for this function.)
"Array Transparent": (This value is not relevant for this function.)
Properties in target structure fields
"XML Namespace": This field property can be used to assign an XML namespace to the element that is crated from the field, e.g. " soapenv" . You can also define a new namespace in this property. Example: " soapenv=http://schemas.xmlsoap.org/soap/envelope/" . If no namespace should be set, use " DEFAULT" as value.
Reserved field names for additional control
Within a target structure node, fields can be created, which allow further control. The following suffixes are reserved.
"_val": A field with this suffix contains the value of the XML element.
"_attr": (e.g. "id_attr") With fields with this extension, attributes can be added to the XML element. In the example here, the attribute "id" would be added to the element.
"_nsdef": (e.g. "xsd_nsdef") Defines a namespace ("xsd") in the XML element. The content of the field has to be the namespace, e.g. "http://www.w3.org/2001/XMLSchema".
"_name": The value of this field is used as the name of the XML element instead of using the node name.
Example
In the following example, the four reserved field names were used. The node "Rootnode" is renamed into "Envelope" in the field "Rootnode_name" with a fixed value. The three namespaces are defined in the three fields "wsdw_nsdef", "xsd_nsdef" and "xsi_nsdef". The "SoapRequest" element gets the attribute "ID" with value "1" from field "ID_attr". The field "item_val" contains the values of the "item" element. Field "create_xml_from_node" contains the described function. The following function parameters were used in the example.
|
Parameter a |
b |
c |
d |
e |
f |
g |
h |
i |
|
Rootnode |
|
|
|
|
|
|
|
|