Bookshelf Home | Contents | Index | PDF |
Siebel Order Management Infrastructure Guide > Asset-Based Ordering Methods Reference > Product Manipulation Toolkit Business Service Methods > Delta MethodThis is one of the Product Manipulation Toolkit Business Service Methods. It generates the actions necessary to change an existing product with components (asset) into a new product with components. The set of actions can be written to a quote or an order. Delta compares two complex assets (original and modified) and returns a quote or order. The return contains line items that specify the actions required to change the asset from the original state to the final state. NOTE: An update occurs if a field in the product or any of its attributes changes. The list of fields being compared is defined by the Delta Line Item Compare Field user properties. This list of fields is configurable to support customer extensions to the database. Arguments
ReturnsProperty Set containing the complex quote or order. RemarksBecause Delta is used frequently, the following additional information about the method is useful:
User PropertiesThe Delta method uses the following user properties:
For descriptions of these user properties, see User Properties used by PMT Methods. Before InvocationBefore Delta is invoked, the system must call two other methods:
ProcessingDuring Delta processing, the method:
Delta compares a user-configurable set of fields. This includes the parent component ID to make sure that changes to the product with components structure are reflected as an update. Increasing Quantities of an Asset ComponentIf the user edits a customizable asset and increases the quantity of an existing component, the result is two line items. The first line item represents the original asset. The second line item adds new copies of that asset. If the original line item is changed, the Delta action is Update or NULL. Action Field in the Quote and Order Attribute TablesDelta logic populates an Action field in the quote attribute and order attribute tables. This field allows order provisioning logic to determine which of the attributes of a service product has changed. For example, a delta quote can be represented as shown in Figure 41: In this example, the call forwarding number changed but the number of rings did not. Action Codes Reset Upon Delta Line Item or Attribute ChangesWhen a delta-enabled field in a line item changes (because of direct user input or a process such as repricing) or an attribute of a line item changes, the action code is automatically set. This is shown in Table 46. NOTE: The customer should make the Action field Read-Only to avoid possible violations of configuration rules that could be caused by changing the action code of a line item. Alias Action CodesThe Delta method has been extended to support Alias Action Codes. Delta replaces one of the standard action codes (Add, Update, Delete, -) with an alias action code if a certain condition is met. For example, an action code of Update can be replaced by Suspend if the status field changes from Active to Suspended. Alias action codes are evaluated for components but not attributes. Alias action codes are specified by the Alias Action Code user properties. Old Value SupportWhen performing a modify order in Siebel Customer Order Management versions prior to 7.7, you can view the changes made to a product but only the end state, and values prior to the modify are lost. Downstream provisioning systems require both the prior and current values. For example, a change in bandwidth from 56K to 1024K might require a new piece of equipment to be installed at the wire center whereas a change form 2048K to 1024K is simply a downgrade using the existing equipment. The Delta method has been extended to store the values of fields prior to their being changed. The prior value is the value of the field in the initial property set being considered by Delta. Service Item Unique Keys (Asset Integration Id)The Delta and Apply method operations depend upon the unique keys to each service item. Typically, the unique key is an invariable combination of fields in the service item record. Because no combination of user-entered fields is certain to be unique or invariable, the Siebel Business Application provides a hidden Asset Integration Id field that stores a unique identifier for each service item. The asset integration ID links the service item to the quotes and orders that modify it. On creation of a quote to add a new service item a new asset integration ID is generated from the row ID of the quote line item The quote is converted to an order at which time a new asset integration ID is generated from the row ID of the order line item. This occurs only if the action code of the quote line item is Add to enforce uniqueness if multiple orders are created from the same quote. When the completed order is converted into an asset the asset integration ID is copied from the order line item to asset. When the asset is subsequently modified (Modify or Disconnect) the asset integration ID is copied to the quote and order line items. Action TypesEach action types is implemented as a soft-coded list of values. This soft coding supports a multilingual user interface and allows for industry specific terminology. The action types supported by the Siebel Business Application are listed in Table 47.
ExamplesReview the following Delta method examples:
Generating a Delta Quote to Update an AssetThe following example shows how this method generates a delta quote to update an asset.
Generating a Delta Quote to Add a New AssetThe following example shows how this method generates a delta quote to add a new asset.
Generating a Delta Quote to Disconnect an AssetThe following example shows how this method generates a delta quote to disconnect an asset.
Generating a Delta Property Set to Add More AssetsThe following example shows how this method generates a delta property set to add more copies of an asset.
Identifying Changes in Product StructureThe following example shows how this method is used to change a product structure.
See AlsoSee the topic about workflows in Siebel Order Management Guide, and the following methods: |
Siebel Order Management Infrastructure Guide | Copyright © 2008, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |