XPath of source field()

This function returns an XPath-like expression of the referenced source structure field a. Additionally, the iteration level of the nodes is displayed (see example).

With parameter "c", the complete data line of the segment of the referenced field can also be output for document type "EDIFACT" (see example).

Parameters


Parameter

Description

a

Name of the source structure field. You have to use parameter type " Source field" .

b

If "true", the field names are normalised in the output, i.e. if the field name is "field-1", the output name would be "field" (see example). Default: " false" .

c

If "true", the complete data line of the segment of the referenced field is also output if you are using document type "EDIFACT" (see example). Default: "false".

As a prerequisite, the checkbox "Use matchcode values for functions in mapping" must be set.

Example


We use the following EDIFACT file.


UNA:+.? '
UNB+UNOC:3+Sender+Recipient+060620:0931+1++1234567'
UNH+1+ORDERS:D:96A:UN'
BGM+220+B10001'
DTM+4:20060620:102'
NAD+BY+++Name+Street+City++23436+xx'
LIN+1++101556:SA'
LIN+2++102683:SA'
QTY+1:1000'
UNS+S'
CNT+2:1'
UNT+9+1'
UNZ+1+1234567'


We create the following mapping.


images/download/attachments/189457725/804-version-2-modificationdate-1742532057474-api-v2.png


(1) This node has a path to node (2).

(3) We want to have the XPath expression for this field.

(4) We place the function on this field (5).

(6) The referenced source structure field (3).


images/download/attachments/189457725/803-version-2-modificationdate-1742531958415-api-v2.png


Our example file contains two "LIN" segments, therefore we also get two result lines. The square brackets contain the iteration level of each node.