Creating a status change listener derived transaction

You can create listener transactions to keep track of the changes in a document when it is in another pipeline. For example, if you are creating an order fulfillment pipeline in which the order document is dropped into an outbound shipment pipeline with its own set of statuses for shipment, you can configure a status change listener transaction in the order fulfillment pipeline to keep track of the statuses the order document goes through in the outbound shipment pipeline.

About this task

The transaction details screen for a listener allows multiple drop statuses to be added. A validation is performed to prevent the removal of a transaction drop status record if there is a pipeline listener record for that drop status. When setting the statuses listened to in the pipeline, specify which drop status to use for each listened to status. When a child order changes status, the parent order is updated with the specific drop status for the status to which the child order has just changed.

This listener listens to all the same statuses as the previous three listeners combined and drops into whichever drop status that the previous three listeners did.

Listeners that change status on an order raise an event upon status change. Listeners raise the event for each order line that has a status change. The ON_STATUS_CHANGE event is raised for each order line using the Listener transaction.

To configure a status change listener:


  1. Open the Applications Manager and select the application that you want.
  2. In the Process Modeling window, select the Order, Load, or General tab to view the corresponding process modeling tree for that base document type.
  3. In the Process Types swimlane, right-click on the applicable process type and choose Model Process. The Repository Details window and work area display for the corresponding process type.
  4. Choose the Transactions tab.
  5. Select the Transactions branch and choose the Create New icon. The Create New Transaction pop-up window displays.
  6. Select ‘Derive from this abstract transaction' and select the applicable listener transaction.
  7. Choose OK.
  8. In the repository, choose the pipeline tab and then select the pipeline you want to add the status change listener transaction to. Right-click on the pipeline and choose Details. The details of that pipeline appear in the work area.
  9. Choose the transactions tab and drag your transaction into the appropriate spot in the work area.
  10. Right-click on the status change listener transaction and choose Show Listener Details. The Listener Details pop-up window displays.
  11. From Process Type Listening To, select the applicable process type pipeline from which you want the listener to track statuses.
  12. From the Status Listening To list, select the Create New icon. A list of statuses that can be tracked displays.
  13. Select the statuses you want the listener to track and choose Add Service to Transaction.
  14. Choose OK.
    Note: Work Order Status Listeners do not work on provided service or delivery service work orders.