Monday, February 9, 2015

OSM Data Significance



Data Significance  become important when Order amendment  is triggered , on the basis of Data Significance OSM decide whether Data need to be updated or not .

By default, all data is flagged significant.
We can make any data structure  as Significant or non-Significant , During amendment processing,
OSM identifies all tasks in the order that are affected
by the changed order data then determines whether the data being changed is flagged as significant ,
because OSM compensate only those tasks that process significant data

Level Of Significance

Data Dictionary(High) --->  Order template data -----> Task data(Low)

Changes to non-significant data are updated on the in-flight order. For example, if the
customer’s preferred contact method (email or text message) is marked as
non-significant, a revision order that changes only that data does not trigger
amendment processing. Instead, the base order is changed, and the revision order is

completed without starting amendment processing. The next task that uses the
changed data uses the updated values.

Order Item Association

Order Item Association

Association can be Achieved in 3 way

1. Fulfilment pattern :- In this case you have to put name of fulfillment pattern which you want to include in order component  after decomposition.

2. Matching Order component ID

3:- Property Correlation :-

x Query / Enrich the order item after decomposition .
when order is moving from one function(fromOrderComponent) to other function(toOrderComponent) .

Order Item Association XQuery assigns order items to order components that are not assigned by their product specification.

These order item associations are typically required when external systems need a specific context for an order item and includes the following characteristics:

let $fromItem := osm:fromOrderComponent/osm:orderItem[osm:name/text()="Speed By Demand [Add]"]
let $toItem := osm:toOrderComponent/osm:orderItem[osm:name/text()="Broadband Bundle [Add]" and osm:properties/im:SiteID/text() = $fromItem/osm:properties/im:SiteID/text()]
return
<osm:dependency fromOrderItemId='{$fromItem/@id}' toOrderItemID='{$toItem/@id}'/>
where

osm:fromOrderComponent: Returns the set of order items included in the order component after the decomposition phase.

osm:toOrderComponent: Returns the entire set of order items included in the order.

osm:orderItem: These are the order items in the fromOrderComponent or toOrderComponent categories.

osm:dependency fromOrderItemId='{$fromItem/@id}: The output of the XQuery specifying the source order item ID for the association.

toItem='{$childOrderItem/@id}'/>: The output of the XQuery specifying the target order item ID for the association.

Saturday, February 7, 2015

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.


About Central Order Management and Service Order Management

When fulfilling orders, OSM can perform two primary roles:
■ Central order management
■ Service order management

OSM in the central order management role receives customer orders from one or more
order-source systems. OSM creates an order, and manages the fulfillment of the order
across other enterprise systems including billing systems, shipping systems, and
service fulfillment systems.

The central order management role is also responsible for receiving status information
from the fulfillment systems and providing an aggregated status back to the
order-source systems. The central order management role is sometimes called central
fulfillment.

OSM in the service order management role is typically a part of a dedicated service
fulfillment system, working with inventory and activation systems to fulfill services in
About Central Order Management and Service Order Management

OSM Concepts

one or more network domains. OSM in its service order management role typically
receives a service order that manages a limited part of the overall order fulfillment. A
service order is typically sent by OSM in its central order management role. OSM
service order management can orchestrate and manage the fulfillment of the services
and resources for the order. It typically works in conjunction with an inventory system
to track and allocate resources (assign-and-design) and an activation system to
configure the network devices and applications. The service order management role is
sometimes called provisioning or local fulfillment.


All OSM functionality; (for example, orchestration) can be used in both of the roles.
However, the order processing performed by OSM in the central order management
role typically uses orchestration more, because of the need to manage relationships
between multiple systems. Orders sent to a service order management system often do
not require an orchestration plan because the tasks in the order can be run as a static
process by OSM.

As an example, an order might be processed as follows:

1. OSM in its central order management role receives a customer order for a
broadband service. Included in the order are requirements for billing, shipping,
and provisioning.

2. OSM generates an orchestration plan, which runs the various fulfillment processes
needed to fulfill the order.

3. To provision the order, OSM uses an automated task to create a separate service
order, which is sent to another instance of OSM functioning in the service order
management role.

4. OSM in its service order management role receives the service order and processes
the provisioning task. It sends the status back to the OSM instance running in the
central order management role.

Service order management typically handles specific provisioning tasks that do not
require orchestration, but you can use orchestration with service order management.
 shows two scenarios. In the first scenario, central order management
handles provisioning for a fixed-line service and a DSL service separately, and it is
therefore able to send service orders directly to OSM in the service order management
role. In the second scenario, the fixed-line service and the DSL service are sent
simultaneously to service order management. Service order management uses an
orchestration plan to send the provisioning requests to separate fulfillment


1. OSM first reads the incoming customer order and creates order items from the
order line items contained in the order.  shows that order line items for
two fixed services and handsets are derived from the order. There are different
regions defined for each service and handset (Ontario and Quebec).

2. OSM begins the orchestration process. The first step is to assign the order items to
order components that are based on fulfillment functions.  shows that
the order items are organized into three function order components: Provisioning,
Shipping, and Billing. The fixed-line services require provisioning, the handsets
require shipping, and all order items require billing, so they are all included in the
Billing order component.

3. The Billing order component must be decomposed further.  shows two
levels of decomposition:

■ Order items for the Ontario and Quebec regions are decomposed into target
system order components. This sends the billing fulfillment process to the
correct region, Ontario or Quebec.

■ For each region, the fixed-line service must be billed separately from the

handset.