XML Property Fields
Overview
In the Semarchy xDI XML Metadata, Property Fields are used to retrieve additional technical data about the XML file during the data flow.
When reading or writing the XML file, technical information such as file name, path, or size can be dynamically processed.
Configure Property Fields
To configure Property Fields:
-
Create or Edit an XML metadata. See Metadata and Reverse Engineering.
-
In the metadata editor, right-click an XML node, then choose New > Property Field.
-
Give a Name to the property field and select the type of property in the Property attribute.
The types of properties available depend on the type of the XML node selected. Refer to the table below for the full list of properties. |
Property | Usable at Read | Usable at Write | Description |
---|---|---|---|
fileAbsolutePath |
X |
Absolute path of the file. |
|
fileCanonicalPath |
X |
Canonical path of the file. |
|
fileName |
X |
Name of the file. |
|
fileParentName |
X |
Name of the folder containing the file. |
|
fileParentPath |
X |
Path of the folder containing the file. |
|
filePath |
X |
Path of the file. |
|
fileSequenceNumber |
X |
Place of the file in the queue of found files. Useful in case of using file masks. |
|
fileTotalSpace |
X |
Total disk space. |
|
nodeAbsolutePosition |
X |
Position of the current node which is incremented on each node. |
|
nodeLocalName |
X |
Name of the node. |
|
nodeLocalPosition |
X |
Position of the current node in its parent |
|
nodeName |
X |
Name of the XML node when writing an XML File. This can be used to define dynamically the node name at execution. |
|
nodePath |
X |
Path of the current node. |
|
nodePrefix |
X |
Prefix of the current node. |
|
nodeURI |
X |
URI of the current node. |
|
nodeUUID |
X |
Generated identifier for each node when reading XML data. |
|
binary_content |
X |
The full content of the file is retrieved directly as binary data in this field. |
|
string_content |
X |
The full content of the file retrieved as string data in this field. |
Use Property Fields in a Mapping
To use XML Properties Fields in a mapping:
-
Drag and drop the XML structure into the mapping.
-
Map the Property Fields as the source or the target, depending on the type of property.
See Work With Mappings.