Understanding Order Recognition

Order recognition is the process of determining the type of an incoming customer

order so it can be mapped to an order type in OSM. Recognition rules allow OSM to

accept any input message structure.

During order recognition, OSM steps through a prioritized list of recognition rules to

determine which rule applies to the in-bound order. Each recognition rule is associated

with an order specification. The first rule that evaluates to true determines the order

specification to use for the incoming customer order and which validations and

transformations are required, if any. Rules are evaluated in an order based on a

property called relevancy, which is defined as part of the recognition rule specification

in Design Studio.

Recognition Rule Errors

There are two possible errors during order recognition:

■ A recognition rule fails to run; for example, because of bad syntax. Evaluation of

other rules continues.

■ The in-bound order is not recognized. If all recognition rules run and fail to find a

match, then no OSM order can be created. This failure generates fallout, which you

can view and manage as an order failure in the Order Management Web client.

To avoid this kind of failure, you can create a lowest-relevancy catch-all rule that

recognizes any in-bound order and maps it to a default order specification.

Creating a Catch-All Recognition Rule

An order that fails to be recognized by any recognition rule is rejected by OSM, and an

error is returned by the Web services operation to the order-source system. To make

sure that all orders are entered into OSM, create a catch-all recognition rule that

accepts all incoming customer orders.

To configure this recognition rule:

■ Set the relevancy to 0, and set the relevancy for all other recognition rules higher

than 0, so they are processed first.

■ Include the following recognition rule XQuery:

fn:true()

Understanding Order Transformation

■ Select the Fail Order check box, and enter a reason. For example:

No valid recognition rule found.

Using this lowest-level recognition rule, an invalid order is recognized and then fails

during validation. It then transitions to the Failed state and is kept by OSM.