Replicating Mapper Nodes (Magic xpi 3.x)

Magic xpi lets you replicate the Data Mapper's compound nodes in XML type Sources and Destinations. This allows you to map data to specific occurrences in the Destination, and to assign specific occurrences of compound Source nodes to Destination fields.

To replicate compound nodes in the Data Mapper, follow these steps:

1. Drag a Data Mapper component into the flow and configure it as an XML type.

2. When the Data Mapper screen opens, select the compound node that you want to replicate. Right-click on the node, and select Properties from the context menu. The Node Properties dialog box opens.

3. Check the Replication check box. You cannot replicate node instances without doing this. The compound node now carries a #1 suffix.

4. Click OK.

5. In the Data Mapper screen, right-click again on the compound node that you want to duplicate. Select Add Replication from the context menu. This duplicates the compound node, along with all entries underneath it.

The replicated compound node carries a #2 suffix. This new node is added underneath the node that you just duplicated. The new instances are numbered sequentially. You can repeat the replication process, without limit, by right-clicking the original compound node, or also by right-clicking any of the replicated nodes.

If you want to remove a replicated compound node, right-click either on the original or on the replicated compound node, and select Remove Replication from the context menu. This removes the last compound node that you replicated. To restore the original node name, you should first make sure that there are no duplicate nodes. Select the original compound node, and either clear the Instance Creation check box or select Remove Instance from the context menu.

When you have finished, click OK to save your mappings.