XML Position Forwarding (Magic xpi 4.13)
The XML Position Forwarding functionality can be used only with XML Sources and Call Flow Destinations. It allows you to pass the currently processed compound to the called flow for additional processing. This means that the called flow can access the processed compound using the original Source schema.
For example, if you have an order entry where each XML order file includes one order header and multiple order items, the order header is handled in the main flow. The multiple order items are handled in a second (called) flow. If you select XML Position Forwarding, the called flow handles single order items instead of reprocessing the entire XML.
To use the XML Position Forwarding functionality:
-
When you define the Source's XML properties in the called flow, select XML Position Forwarding from the XSD Sub Type property's drop-down list. Then, click
next to the XML Position Forwarding property.
-
The Schema List opens, which displays a list of all the Data Mapper steps that call the current Data Mapper. Select one of these steps as the calling Data Mapper.
When you have selected the required calling Data Mapper, the following fields are updated in the XML Source Properties dialog box, according to the calling Data Mapper properties:
-
XSD File: Read-only. This displays the calling flow XSD path.
-
Data Source: Read-only. This displays the calling Data Mapper's data source.
-
XML Root: Read-only. This displays the XML's full file path up to the compound element that is mapped to the called flow.
-
Recursion Depth: Read-only. This displays the recursion depth setting from the calling step.
The original Source's mapping in the called flow can handle all mapped compound members and their compound elements, as with any other mapping.
![](/PublicKnowledge/servlet/rtaImage?eid=ka23z000000H0Ox&feoid=00ND0000005rAjf&refid=0EM3z000007lCyY)
|
-
If there is only one flow available, the flow selection form will not be displayed, and a form containing all mapper steps that call the current Data Mapper will be displayed. The user can only select one Data Mapper.
-
If there are multiple flows available, the flow selection form will be displayed and upon user selection, the Data Mapper selection form will be displayed.
-
The mapping of the original Source in the called flow can handle all mapped compound members and their compound elements, as in any other mapping.
-
In the called flow, the mapping of the root element, and all compound elements above the root element, are based on the calling flow. Changing these mappings can lead to unintended results.
-
XML position forwarding defined with an inactive source flow might cause unexpected behavior during runtime.
|