Creating XML Transaction Maps

Use the Business Connect XML mapping utility to create a relationship between the document type definition (DTD) files you receive from your trading partners and Eclipse data. Define the relationship by creating a transaction map.

Creating an XML transaction map requires completing the following tasks:

• Defining transaction types and selecting DTD files.

• Mapping the received XML.

• Mapping the sent or reply XML.

• Defining mapping selection criteria.

To better understand the layout of the mapping utility, see Business Connect XML Mapping Utility Main Window Aspects.

Note: If you need to modify the XML data, modify the mapping characteristics after creating the XML transaction map.

Defining Transaction Types and Selecting DTD Files

Create transaction maps for each transaction you want to trade with each trading partner. Before you can create a transaction map, you must work with your trading partner to obtain DTD files and document specifications. DTD files define the data that is contained within each document you trade using XML. For more information, see Getting Started with Business Connect XML.

A transaction can be a received-only transaction with no reply document, or a sent-to only transaction with no received document.

To define the transaction type and select the DTD files:

1. Access the Business Connect XML mapping utility and select the trading partner for which you want to define a transaction.

2. Right-click the trading partner and select New Transaction Map to display the New Transaction Map dialog box.

3. In the Transaction Name field, enter the name of the transaction, such as Purchase Order. The name you enter here displays in the Trading Partners Tree under the trading partner.

4. In the Transaction Source field, enter the portal or marketplace the trading partner uses for the transaction. Entering a transaction source allows you to sort by the source in the remote review queues within Eclipse.

5. Based on the trading partner for which you are creating the transaction map, the New Transaction Map dialog box displays fields specific to customers or vendors. Enter the transaction type and DTD information in the fields for a customer or vendor transaction.

   Vendor Transaction Type	Description
   Document sent to the vendor and a reply document received from the vendor (outbound with an inbound response)	In the Transaction Type field in the Document Sent to Vendor area of the New Transaction Map dialog box, select the transaction type of the document you receive from your vendor. For example, if you are creating a map for a purchase order transaction, select Order Submit as the type in the Transaction Type field. Your selection populates the Source XML column in the mapping utility's main window for the sent document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Vendor's DTD field in the Document Sent to Vendor area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Target XML column in the mapping utility's main window for the sent document map. Click Browse to select the field. In the Transaction Type field in the Reply Document Received from Vendor area, select the transaction type of the reply document your vendor sends to you. For example, if you are creating a map for a purchase order transaction, select Order Submit Response as the type in the Transaction Type field. Your selection populates the Target XML column in the mapping utility's main window for the received document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Vendor's DTD field in the Reply Document Received from Vendor area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Source XML column in the mapping utility's main window for the received document map. Click Browse to select the file.
   Document sent to the vendor, but no reply document received from the vendor (outbound only)	In the Transaction Type field in the Document Sent to Vendor area of the New Transaction Map dialog box, select the transaction type of the document you receive from your vendor. For example, if you are creating a map for a purchase order transaction, select Order Submit as the type in the Transaction Type field. Your selection populates the Source XML column in the mapping utility's main window for the sent document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Vendor's DTD field in the Document Sent to Vendor area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Target XML column in the mapping utility's main window for the sent document map. Click Browse to select the file. In the Reply Document Received from Vendor area, select the No Reply Will Be Received check box to indicate that the vendor does not send a reply to your request. When your vendor's system receives your XML document, it sends an immediate HTTP Status 200 message back to your system. The Status 200 message indicates that the system received your request. The Document Received From Vendor tab is disabled for the transaction map.
   Document received from the vendor, but no document sent to the vendor (inbound only)	In the Document Sent to Vendor area of the New Transaction Map dialog box, select the No Document Will Be Sent check box to indicate that you are not sending an XML document to your vendor. The Reply Document Sent To Vendor tab is disabled for the transaction map. In the Transaction Type field in the Document Received from Vendor area, select the transaction type of the document your vendor sends to you. For example, if you are creating a map for an invoice transaction, select Invoice as the type in the Transaction Type field. Your selection populates the Target XML column in the mapping utility's main window for the received document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Vendor's DTD field in the Document Received from Vendor area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Source XML column in the mapping utility's main window for the received document map. Click Browse to select the file.

    

   Customer Transaction Type	Instructions
   Document received from the customer and a reply document sent to the customer (inbound with an outbound response)	In the Transaction Type field in the Document Received from Customer area of the New Transaction Map dialog box, select the transaction type of the document you receive from your customer. For example, if you are creating a map for a purchase order transaction, select Order Submit as the type in the Transaction Type field. Your selection populates the Target XML column in the mapping utility's main window for the received document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Customer's DTD field in the Document Received from Customer area of the New Transaction Map dialog box, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Source XML column in the mapping utility's main window for the received document map. Click Browse to select the file. In the Transaction Type field in the Reply Document Sent to Customer area, select the transaction type of the reply document you send to your customer. For example, if you are creating a map for a purchase order transaction, select Order Submit Response as the type in the Transaction Type field. Your selection populates the Source XML column in the mapping utility's main window for the sent document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in the XML transaction schemas. In the Reply Document Sent to Customer area enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Target XML column in the mapping utility's main window for the sent document map. Click Browse to select the file.
   Document received from the customer, but no reply document sent to the customer (inbound only)	In the Transaction Type field in the Document Received from Customer area of the New Transaction Map dialog box, select the transaction type of the document you receive from your customer. Your selection populates the Target XML column in the mapping utility's main window for the received document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Customer's DTD field in the Document Received from Customer area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Source XML column in the mapping utility's main window for the received document map. Click Browse to select the file. In the Reply Document Sent to Customer area, select the No Reply Will Be Sent check box to indicate the transaction type does not require a response. When your system receives the XML document from your customer, it sends an immediate HTTP Status 200 message back to the system that sent the document. The Status 200 message indicates that your system received the request The Reply Document Sent To Customer tab is disabled for the transaction map.
   No document received from the customer, but a document is sent to the customer (outbound only)	In the Document Received from Customer area of the New Transaction Map dialog box, select the No Document Will Be Received check box to indicate the transaction does not have an inbound transaction type, such as sending an invoice to your customer. The Document Received From Customer tab is disabled for the transaction map. In the Transaction Type field in the Document Sent to Customer area, select the transaction type for the document you send to your customer. For example, if you are creating a map to send an invoice to your customer, select Invoice as the type in the Transaction Type field. Your selection populates the Source XML column in the mapping utility's main window for the sent document map and determines which elements in Eclipse are available. For additional information about how your selections display in the main window, see Understanding the Business Connect XML Mapping Utility. The options available in the Transaction Type field are defined in XML database schemas. In the Customer's DTD field in the Document Sent to Customer area, enter the path to the DTD file your trading partner provided you for this transaction type. The DTD you enter here populates the Target XML column in the mapping utility's main window for the sent document map. Click Browse to select the file.

    

6. Click OK to add the transaction under the trading partner in the Trading Partner Tree.

7. If the transaction has a received document, continue with Mapping the Received XML. If the transaction does not have a received document, continue with Mapping the Reply/Sent XML.

Mapping the Received XML

If the transaction you are mapping contains a received document, map the received DTD elements from your trading partner to the Eclipse database elements available for the transaction type. If the transaction you are mapping does not contain a received transaction type, the Document Received From Customer/Vendor tab of the mapping utility is disabled.

Note: The tab name changes based on whether you are creating a customer or vendor transaction map.

To map the request XML:

1. If the transaction you want to map is not open, right-click the transaction in the Trading Partners Tree and select Edit Transaction Map.

2. Select the Document Received From Customer/Vendor tab to display the DTD for the source XML and the elements in Eclipse to which you can map the data.

3. Map elements from the Source XML column to elements in the Target XML column. For additional information about how to map and guidelines for creating valid mapping connections, see Mapping XML and Eclipse Data Elements.

4. Modify the mapping characteristics, as necessary.

5. If the transaction has an outgoing transaction type, continue with Mapping the Reply/Sent XML. If the transaction is a received-only transaction type, continue with Defining XML Mapping Selection Criteria.

Mapping the Reply/Sent XML

If the transaction you are mapping contains a document you are sending to a customer or vendor, map Eclipse elements available for the transaction type to the elements in the response DTD from your trading partner. If the transaction you are mapping does not contain a reply/sent transaction type, the Document Sent to Customer/Vendor tab of the mapping utility is disabled.

Note: The tab name changes based on whether you are creating a customer or vendor transaction map.

To map the reply/sent XML:

1. If the transaction you want to map is not open, right-click the transaction in the Trading Partners Tree and select Edit Transaction Map.

2. Select the Document Sent To Customer/Vendor tab to display the DTD for the reply/sent XML and the data elements in Eclipse from which you map the outgoing data.

3. Map Eclipse database elements in the Source XML column to the data elements in the response DTD in the Target XML column. For additional information about how to map and guidelines for creating valid mapping connections, see Mapping XML and Eclipse Data Elements.

4. Modify the mapping characteristics, as necessary.

5. Define the XML mapping selection criteria.

6. From the File menu, select Save Transaction Map to save the map.

See Also:

Defining XML Mapping Selection Criteria

Modifying Incoming and Outgoing XML Data

Previewing XML Transaction Maps

Business Connect XML Mapping Utility Main Window Aspects

XML Transaction Maps Overview