Bookshelf Home | Contents | Index | Search | PDF

Siebel Assignment Manager Administration Guide > Assignment Concepts > Assignment Manager Components >

Server Key Maps

---

A server key map defines the rule groups that load and process for each server. You can configure a server to load multiple rule groups. When you define server key maps, you are actually dividing the rules among the different servers. Server key maps are defined in the Server Key Map view in the Assignment Administration screen. For information about defining server key maps, see Defining Server Key Maps.

You submit an assignment request by specifying the AsgnKey parameter, where the AsgnKey parameter is the row id of the assignment rule group that is associated with the rules you want to evaluate. When using AsgnSrvr, the AsgnKey parameter must be the row id of one of the rule groups defined for the server in the Server Key Mappings view. The assignment server (AsgnSrvr) first looks for entries in the server key map for a specific server, and then loads rules for only those rule groups associated with that server key map. Assignment Manager uses key-based routing to route the request to a particular instance of Assignment Manager where the rules are loaded for that rule group.

You can specify multiple servers to load the same rule group. Assignment Manager routes requests to one of the servers where that rule group is based on load balancing metrics.

However, the server key mapping feature is only supported in certain environments, as follows:

Interactive and dynamic assignment

For interactive and dynamic assignment, Assignment Manager does not support invocation of rules through rule groups. You cannot assign server key mappings in these environments, therefore, all active rules are processed.

Script or Workflow Process Calling a Business Service

You can invoke Assignment Manager through a business service from within a workflow process, or from a script, using one of the following predefined business services:

Synchronous Assignment Manager Requests business service. This business service has one method available: Assign. This method sends a request to the assignment manager server component using the AsgnObjName and ObjRowId parameters. All active rules in the database are processed.

Use this business service:

To submit requests to assign a single object row.
With the Default Group (no server key maps defined).

NOTE:  You cannot use this business service to invoke rules based on rule groups.

Server Requests business service. You can use this generic business service to submit requests to the server request broker. With this business service, you can use the Assignment Manager server mapping feature. If using this business service to invoke rules based on rule groups, pass the AsgnKey parameter as the input parameter, and pass the ReqKey parameter as a request parameter (in the child property set for the component). Set the AsgnKey and ReqKey parameters to the rule group ID of the relevant rule group.

NOTE:  You can use this business service with the server key mapping feature.

For more information about business services, see Siebel Business Process Designer Administration Guide.

Batch Assignment

You can start a batch assignment task with a particular group of rules loaded. This task is performed by specifying the row id of the rule group in the Assignment Key (AsgnKey) parameter for the task. If the Asgnkey parameter is specified when submitting a batch assignment request, Assignment Manager loads only rules of that rule group. If the AsgnKey parameter is not specified when submitting a batch assignment request, Assignment Manager loads all rules in the Default Group. For more information about the Default Group and loading a particular group of rules, see Assignment Rule Groups.

NOTE:  Batch assignment does not read entries from the server key map; only AsgnSrvr reads entries from the server key map.

Assignment Manager stores rule information in a cache file, and there are different cache files for each assignment mode. Batch assignment uses the batchrulecache.dat file to store information. After the cache file is created, Assignment Manager loads the rules from this cache file instead of from the database, resulting in faster loading. However, the next time an assignment is submitted and given the rules have been released, the rules again load from the database and the cache file is recreated.

For example, if you submit a request for rule group A, Assignment Manager loads the rules from the database, creates a batchrulecache.dat file, and processes the rules for group A. If another similar request for rule group A is initiated, Assignment Manager uses this same cache file. However, if you submit a request for rule group B, Assignment Manager loads the rules from the database, overwrites the batchrulecache.dat file, and processes the rules for group B. Then, if you submit another request for rule group A, Assignment Manager reloads from the database because the batchrulecache.dat file has rules only for rule group B. For more information about the AsgnKey parameter, see AsgnKey.

NOTE:  Siebel Incentive Compensation and Siebel Marketing are specifically designed to use the server key mapping and rule group features. For more information, see Siebel Incentive Compensation Administration Guide and Siebel Marketing Guide.

Bookshelf Home | Contents | Index | Search | PDF