Enabling Order Amendment Processing

To enable OSM to amend in-flight orders, you must configure the order to allow amendment processing. By default, orders are not amendable.

To enable order amendment processing:

  1. From the Studio menu, select Show Design Perspective.

  2. Double-click any order in the Solution view or Studio Projects view.

    The order opens in the Order editor.

  3. Click the Amendable tab.

  4. Select the Amendable option.

  5. Click the Add button in the Key area.

    Design Studio adds a key with a default name key and a corresponding XPath expression with the default value true().

  6. In the Expression field, specify an order key as an XPath to a node that will uniquely match an amended order to its corresponding OSM order.

    For example, you might specify a customer reference ID as an XPath. You can select a data node from the Data Element view and drag the selected data node into the XPath Expressions field to define the XPath expression. See "Order Editor Amendable Tab" for more information about defining order keys.

  7. Select one or more events to be published at run time for this order type.

    If you select no events, the system publishes no events. See "Order Editor Amendable Tab" for more information.

  8. Specify the version as an XPath to a node that will return a numeric value representing the version of an amended order.

    Amendments with higher versions are considered to be more recent than amendments with lower versions. If there are multiple queued amended orders for the same original order, OSM processes only the most recent amendment version.

  9. Click Save.

Related Topics

Working with Event Notifications

Working with Orders