The Business Connect XML mapping utility provides a way to connect source and target elements using drag and drop functionality. The mapping utility represents each connection using a line that you draw from the Source XML column to the Target XML column. Each connection is also represented in the preview pane of the mapping utility main window. For more information about the mapping utility, see Business Connect XML Mapping Utility Overview. For more information about transaction maps, see XML Transaction Maps Overview.
Bold elements in a trading partner's DTD indicate elements that are required for the transaction.
See the following instructions to map elements:
Map source and target elements (one-to-one, one-to-many, and many-to-one relationships).
Map repeating groups to non-repeating groups (many-to-one relationships).
To map source and target elements (one-to-one, one-to-many, and many-to-one relationships):
Right-click a transaction in the Trading Partner Tree and select Edit Transaction Map to display the transaction map.
Note: Expand the elements as necessary to access nested elements.
In the Source XML column, select the element you want to connect to a target element.
Click and drag the selected source element to the element in the Target XML column to which you want to connect the source element.
The system draws a line from the source element through the Mapping column to the target element and highlights the elements mapped together.
Note: You can also view the map in column format using the Mapping Preview pane.
To map repeating groups (many-to-one relationships):
Right-click a transaction in the Trading Partner Tree and select Edit Transaction Map to display the transaction map.
Note: Expand the elements as necessary to access nested elements.
In the Source XML column, select the repeating element you want to connect to a target element.
Note: Repeating groups are identified in a DTD file with a plus (+) after the element.
Click and drag the selected source element to the element in the Target XML column to which you want to connect the source element.
The Repeating Group Selection dialog box displays with the source element listed in the Group Name field.
In the Occurrence field, indicate the occurrence number that you want to map to the target element.
For example, a trading partner sends you contact telephone numbers in an element called ContactNumber nested in an element called Contact. The ContactNumber is a repeating group that can occur one or multiple times:
The first time it occurs, the telephone number it contains is the contact's business phone number.
The second time it occurs, the telephone number it contains is the contact's mobile phone number.
The third time it occurs, the telephone number it contains is the contact's home phone number.
You want to map the contact's business phone number to a target data element. In this example, enter 1 in the Occurrence field to indicate that you want to map the first occurrence of the repeating group to capture the business telephone number.
Click OK to save the information and return to the mapping utility main window.
Right-click a transaction in the Trading Partner Tree and select Edit Transaction Map to display the transaction map.
Note: Expand the elements as necessary to access nested elements.
In the Target XML column, right-click the element whose connection you want to remove and select Remove Mapping.
The system removes the connection between the source element and the target element.
See Also: