Defining an XML document with a DTD

Edit online

This use case explains how to define an XML document with a DTD.

Before you begin

Ensure that you have an existing project in IBM® webMethods Integration. ​

About this task

The use case begins with either a plain DTD document, a compressed compressed file containing a DTD document, or a URL where a DTD is hosted, based on which you define an XML document. The use case ends when you create the XML document.

In this example, define an XML document based on a DTD purchaseorder1 that is project-aware of the project B2B_Test in webMethods Integration and uses a DTD POAccept.DTD.

Procedure

  1. In webMethods B2B, from the side navigation menu, click Assets > Business document.
  2. Click Add documet icon and select XML.
  3. Provide the following details:
    • Name, type purchaseorder1, a name for the XML document.
    • Description, optional. Provide a brief description for the XML document.
  4. Select the project B2B_Test and click Next.
  5. Select No to create an XML document without referring to an existing document type from the selected project.
  6. Select DTD Document to build the XML document.
  7. Select the method to upload the DTD document. Either use a plain DTD document that is available locally, or a DTD in a compressed format or a URL that hosts the DTD document.

    If you upload a compressed DTD document, ensure that you provide the DTD document path along with the file name within the compressed file. For example, if the DTD document is within several levels of sub folders, specify the exact file path and the filename of the DTD document.

    Note: The DTD document or compressed compressed file containing DTD document must be less than or equal to 5 MB.
  8. Click Next.
  9. Select a root DTD with which you want to create the XML file and click Save.

What to do next

  • After you add the XML document, manually extract the senderID and receiver Ids, so that webMethods B2B can recognize the documents.
    Note: After adding XML documents using DTD or XSD or a sample XML, you must explicitly add the processVersion attribute in the pipeline matching step under Identifiers for each document. Only then, webMethods B2B recognizes RosettaNet messages.
  • Activate the XML document and test it.

With this use case, the respective document type is also created on webMethods Integration.

To update the XML document, click Edit icon on the document details page. You can update the name, description, project, and document type.

Navigate to the respective pages to edit the Identifiers, Attributes, Namespaces, and Options.