XML property fields :: Semarchy xDI Documentation

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.

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.