Monday, January 31, 2011

Siebel Business Service Library - Part 12: PRM ANI Utility Service

It has been a while that we discussed one of the business services in our library of predefined Siebel business services.

Today we have a look at the PRM ANI Utility Service. This business service is often mentioned and used by Oracle and external professionals alike.

As an offspring of the Siebel PRM (Partner Relationship Management) family, the business service and its methods are described in the respective bookshelf guide.

The main purpose of the business service is the creation and manipulation of property sets. Other interesting methods include GenerateKey, GetSystemPreference and QueryBusComp.

The PRM ANI Utility service's methods in Siebel Tools
The CUT Credit Check workflow process - a sample delivered with the Siebel Industry Applications (SIA) repository - makes ample use of the CreateEmptyPropSet, GetProperty and SetProperty methods.

The CreateEmptyPropSet method has only one required input argument named Hierachy Name. This is the name of an integration object definition. After method execution, the SiebelMessage child of the output property set contains an empty instance of the integration object.

We can now use the various property set related methods to manipulate the property set. The business service also has methods like GetProperty which is useful to read data from any property set hierarchy.

Similar to SetProperty, this method uses the Hierarchy Path: and Property Name input arguments to locate the property in the SiebelMessage child hierarchy. The Hierarchy Path: (note the colon) input argument supports dot notation.

It is noteworthy that the PRM ANI Utility Service only supports one child property.

The QueryBusComp method stands out a bit as it can be used to query any business component and retrieve the row count from the Record Count output argument as well as field values.

The benefit of the QueryBusComp method lies within its Keep Context input argument. When set to TRUE, it keeps the context of the query within the current primary business component. When set to FALSE it queries the entire business component (specified by the Business Component input argument).

The Find Existing Cart step in the Transfer Cart Inbound Create Quote Process uses the QueryBusComp method.

Have a nice day



Anonymous said...

It is really nice to see the explanation about this BS. it would be grate, if you could share the details description of this WF (posted in this page) or sif file.

@lex said...

Hi Anonymous,

the workflow processes mentioned in the post are part of the Siebel Industry Applications (SIA) 8.1.1 repository.

You can find them in the Siebel SIA 8.1.1 sample database.

Have a nice day