Advanced Navigation (Sun Identity Manager 8.1 Resources Reference)

Sun Identity Manager 8.1 Resources Reference

Advanced Navigation

The advanced navigation feature of the Siebel CRM adapter allows you to create and update child business components. This is an advanced feature that is not typically implemented in Identity Manager.

The advanced navigation feature allows you to optionally specify the following information needed to create and update child business components:

business object name
parent business component name
parent search attribute
target business component
target search attribute
in scope attributes (which attributes of the business component should be set/updated)
optional co-action

An advanced navigation rule can be used during create and update actions. It cannot be used for other types of actions.

To implement the advanced navigation feature of the Siebel CRM adapter, you must perform the following tasks:

Add an attribute to the schema map in which the Resource User Attribute (right hand side) is named PARENT_COMP_ID.

Use the debug page to manually add the following ResourceAttribute to your resource’s XML

<ResourceAttribute name=’AdvancedNavRule’
    displayName=’Advanced Nav Rule’
    value=’MY_SIEBEL_NAV_RULE’>
</ResourceAttribute>

Replace MY_SIEBEL_NAV_RULE with a valid rule name.

Write the advanced navigation rule. The rule should expect two variables to be present:

resource.action. The value must be either create or update.

resource.objectType. For normal account maintenance, this value will be account.

The rule must return a map with one or more of the following name/value pairs:

Attribute	Definition
`busObj`	The name of the business object.
`parentBusComp`	The name of the parent business component for `busObj`. The context of the business object is updated by moving to the first qualified (see `parentSearchAttr`) record of this business component
`parentSearchAttr`	The attribute to use as the search field in the `parentBusComp`. The value to search for is expected to be present as the value for the attribute whose Resource User Attribute name is PARENT_COMP_ID.
`busComp`	The name of final business component to create or update. If creating, then a new record of this business component will be created in the business object. If updating, then the business component record to update is selected by moving to the first qualified (see `searchAttr`) record of this business component.
`searchAttr`	The attribute to use as the search field in the `busComp`. The value to search for is the user’s account ID.
`attributes`	A list of strings that specifies the set of fields in the `busComp` that will be set or updated. This list overrides the attributes defined in the resource’s schema map for the action being performed.
`coAction`	If the requested action (`resource.action`) is `create`, then specify a `coAction` value of `update` to instruct the adapter to also perform an update immediately following the create. This may be necessary if the create cannot set all the necessary fields, and therefore an update must also occur to logically complete the create. This attribute will be ignored unless `resource.action` is `create` and `coAction` is set to `update`.

An example navigation rule is provided in $WSHOME/sample/rules/SiebelNavigationRule.xml.