Sign in
< Back to User Guide Top

Local Listener ebXML Message Service

Configure your local listener to handle inbound ebXML messages. 

Configuring ebXML Message Service

  1. Expand the Local Listener node in the tree pane and then click the ebXML Message Service node.
  2. On the ebXML tab in the content pane, specify parameter values as appropriate.

    See Local Listener ebXML Service reference for information about the parameters available.

  3. Click Apply.

Local Listener ebXML Service reference

 Resource Path

Defaults to /ebMS. Your trading partners must include this resource path in the URL when sending ebXML messages. You can change it at any time, but it must start with a forward slash (/) character.
Acknowledgments: Storage Folder
The folder where Acknowledgments (Acks) are stored. By default this directory is pre-defined to be a subdirectory under the VersaLex directory tree. Click …, navigate to a new path and folder, and click Apply.
Retain Message ID History
The number of days message ID history is retained for checking for and reporting duplicate messages (with the same Message-ID header value) from your trading partners. The default is 5 days.

Configuring ebXML CPA

A Collaboration Protocol Agreement (CPA) describes the relationship between two parties, typically you and your trading partner. Use the CPA tab to provide information about yourself for use in a CPA.

  1. Expand the Local Listener node in the tree pane and then click the ebXML Message Service node.
  2. Click the CPA tab in the content pane and specify parameter values as appropriate.

    See Local Listener ebXML CPA reference for information about the parameters available.

  3. Click Apply.

Local Listener ebXML CPA reference 

My Party Id(s)
Identifies you to your trading partners. You can list more than one party IDs (URI, email address, DUNS number, etc.) If the type attribute is not included in a party ID, the value must be a URI.  If necessary, your normal party ID can be overridden in the ebXML host and mailbox respectively for a specific trading partner.
My Role
Optional field that can help identify your authorized role (for example, buyer, seller, or dealer) usually using a URI. If necessary, your normal role can be overridden in the ebXML host and mailbox respectively for a specific trading partner.
Resource Path
Defaults to /ebMS. Your trading partners must include this resource path in the URL when sending ebXML messages. You can change it at any time, but it must start with a forward slash (/) character.
My Service(s)
Messages received from your trading partner must match these values. If you list more than one service, each one must be on its own line. If necessary, your normal services can be overridden in the ebXML mailbox for a specific trading partner.
My Action(s)
Messages received from your trading partner must match these values. If you list more than one action, each one must be on its own line. If necessary, your normal actions can be overridden in the ebXML mailbox for a specific trading partner.

Viewing ebXML acknowledgments

An ebXML acknowledgment is used by a message service handler to indicate that another message service handler has received a message.

  1. Expand the Local Listener node in the tree pane and then click the ebXML Message Service node.
  2. Click the Ack tab in the content pane.
    The Acks tab displays a list of acknowledgments in a tabular format.
  3. Optionally, filter the list of acknowledgements. Select a value from the Status menu.
    The list displays acknowledgments whose status matches the value you selected.
  4. Display detailed information about a particular acknowledgment. Right-click a row in the table to display a menu and select Display. Alternatively, double-click a row.

    The VersaLex application displays the contents of the selected acknowledgment.

    If an acknowledgment has not (yet) been received, the VersaLex application displays message tracking information, including the conversation, message, and CPA IDs, the message time-to-live, the host/mailbox, and the name and location of the file. If the message has errored out, the error code and description is also included.

  5. Optionally, copy or print the acknowledgment.
    • Copy. You can then paste the contents of the acknowledgment into a new document or an email message, for example.  
    • Print. Alternatively, you can right-click a row in the acknowledgments table and select Print from the drop down menu.

Related articles

Comments

0 comments

Please sign in to leave a comment.