Debatching Incoming XML Document Sets

Product orders sent in XML format are typically enclosed in a parent container. In order to process the product orders, they must be debatched: that is, separated so that each product order is enclosed in its parent container, as shown in XML Debatching.

img-xml-debatching
Figure 1. XML Debatching

This page shows how GearCo uses Document Types to debatch an XML parent container received from its partner AAZBoards.

Before you begin

Get Started

  1. In the CONFIGURATION section of the left-hand navigation pane on the Company Information Page, click Document Definitions.

    The Document Types Page appears.

img-document-types-none-added
Figure 2. Document Types Page
  1. On the Document Types Page, click New.

    The Document Type Page appears.

img-document-type
Figure 3. Document Type Page

Creating Document Types

Create Parent Container

  1. In the Standard box, select XML.

  2. In the Root Node box, type Parent-Container.

  3. To create the Parent Container, click Save.

    The Document Types Page appears.

img-document-types-parent-container-added.png
Figure 4. Document Types Page

Create Child Product Order

  1. On the Document Types Page, click New.

    The Document Type Page appears.

  2. In the Standard box, select XML.

  3. In the Root Node box, type ProductOrder.

  4. Click Save.

    The Document Types Page appears.

  5. On the Document Types Page, select the child (ProductOrder) document.

    The Document Type Page appears.

  6. Click the Parents Tab.

    The This document has parent document types checkbox appears.

  7. Select the checkbox.

    The Debatching Tab appears.

  8. Click Add Parent Document Type

    The Linked Parent Document Type window appears.

  9. Click the Parent Document box.

    The Pick a document window appears.

  10. Select XML-ParentContainer(AAZBoards).

    The Linked Parent Document Type window reappears.

  11. In the Shredding Path box, type ./ProductOrder.

  12. Click Add Parent Document.

    The Document Type Page appears.

  13. Click Save.

    The Document Types Page appears.

img-document-types-xml-complete.png
Figure 5. Document Types Page

Verify Debatching Settings

  1. To verify that you have configured the Product Order document type to debatch correctly, on the Document Types Page, click the XML-ParentContainer document type.

  2. On the Document Type Page, Children Tab, click Children.

    img-document-types-parent-container-detail.png
    Figure 6. Document Type Page, Children Tab

    Note that:

    • The Product Order document type that you added in the previous section appears in the Debatching section of the tab.

    • Automatic debatching is set to occur for the document type.

Thus, whenever this partner receives a document of the type you created in Create Parent Container, and the docment contains x XML documents of the type you created in Create Child Product Order, the parent container document will be debatched into x parent containers, each containing a product order. This process is shown in XML Debatching.