Routing Orders

The routingorders service allows searching, editing and reprocessing routing orders.
A routing order is a persistent instruction to execute a service with a fixed number of parameters. It mainly serves the purpose of being re-executed or re-processed in case it failed.

To see the ‘Routing Orders’ menu entry on the Portal, the routingorders=view permission is required.

Note

The routingorders=* permission will grant access to all the functions mentioned below.

Search Routing Orders

To search, list and view routing orders, the routingorders=read permission is required.

There are several search options:

  • State defines the state of the routing order:
    • ACTIVE: the routing order is in the process of being executed.
    • COMPLETED: the routing order has been successful executed.
    • FAILED: the execution of the routing order has failed.
  • Data Partition is either ‘LOG’ or ‘TRANSACTION’.
  • Data Type lists available types.
  • Service refers to the service targeted by the routing order. You can select a service’s id in the list suggested by the user interface or directly key a value after clicking on the pencil button.
  • From / To dates is the range of dates which includes the routing order‘s creation date.
  • Keywords allows searching on the whole content of routing orders.

Search for Routing Orders

After entering your search criteria and hitting the ‘Search’ button, you will see the result of the query below the ‘SEARCH OPTIONS’ section.

List the results

Search results can be exported to an Excel file.

Edit a Routing Order

To reprocess, update, delete or export a routing order, the routingorders=edit permission is required.

Double-click on the line associated to a routing order or hit the orange pen icon to see the edit form.

Edit a Routing Order

Once you are done with your changes, reprocess the routing order to execute it with the new values. Note that experience show that there are many cases where there is no need to update a routing order to reprocess it, for example if it failed due to an unavailable target system.

Reprocess Routing Orders

Reprocess one

There are various possible ways to reprocess a routing order:

  • Hit the blue reprocess icon of the concerned routing order in the result list
  • Right-click the concerned routing order row and select ‘Reprocess’ in the pop-up action window
  • Open the routing order (either double-clicking the row or hit the orange pen icon) and then click on the ‘Reprocess’ button

Reprocess multiple ones

Bulk reprocessing is possible: select multiple routing orders in the search result list then right-click and choose ‘Reprocess’ in the pop-up action window.

Delete Routing Orders

In a similar fashion to the ‘Reprocess’ action, there are multiple ways offered to delete one or more routing orders.