Siebel Order Management Guide Addendum for Communications > Creating Communications Promotion Groups > Process of Setting Up Promotion Groups (Administrators) >

Applying Validation Rules to Promotion Group Definitions

To validate a promotion group, you might have to check all the assets associated with the promotion group for a common value or for unique values, for example:

• All associated members of a promotion group must have the same billing profile.
• Each membership in a promotion group is associated with a different asset.

To implement these rules, validation services exist for promotion groups. Each of these validation services takes a set of field values as an input and verifies whether these field values are all the same for the first rule and whether they are all different for the second rule.

This task is a step in Process of Setting Up Promotion Groups (Administrators).

To apply validation rules to a promotion group definition

1. Navigate to the Administration - Product screen, then the Promotion Groups view.
2. In the Promotion Group Definitions list, select the promotion group definition for which you are specifying the validation rules.
3. Click the Validation view tab.
4. For each validation that you want to define for this promotion group definition, perform the following steps:
   1. In the Validation list, select a validation business service.

      Some fields of the Validation list records are described in the following table.

      Field	Comments
      Sequence	Specifies the order in which the validation rule is to be processed at run time.
      Business Service	The business services that apply promotion group validations are as follows: PG Member Distinct Value Checker Business Service. This business service validates that its input arguments are unique. PG Member Common Value Checker Business Service. This business service validates that its input arguments are the same.
      Active	Select this check box to activate the validation rule.

   2. In the Parameters list below the Validation list, enter values for parameters of the selected business service by completing the Value fields of the parameter records.

      Some fields of the Parameters list records are described in the following table.

      Name	Value
      Attribute1	Can be any field that is allowed in the Query method of the Project Asset service.
      Member Field	A list of fields that are allowed in the Query method of the Project Asset service, separated by vertical bars (|).
      Message	The UMF (Universal Media Format) message type that is displayed if a violation is found.

      For information about how validation business services and parameter values interact to form validation rules, see About Validation Business Services and Parameters.

About Validation Business Services and Parameters

This topic covers the business services that apply validation rules to promotion group definitions and the parameters you can set for each business service. This topic covers the following subjects:

• PG Member Distinct Value Checker Business Service
• Example of Setting Distinct Value Checker Parameters
• PG Member Common Value Checker Business Service
• Example of Setting Common Value Checker Parameters

PG Member Distinct Value Checker Business Service

This business service validates that its input arguments are unique. Input arguments for this business service can include one or more fields in the asset business component, for example, Billing Account and Service Account. If the billing account and service account of a member are not unique, then the business service generates an exception. The parameters and parameter values for this business service are shown in Table 111.

If the same field, for example, Billing Account Id, is defined in both the Member Field parameter and the Attribute1 parameter, then the Member Field parameter overrides the Attribute1 parameter. Consequently, this field is validated in the member records and not in the membership records.

Example of Setting Distinct Value Checker Parameters

This topic gives one example of setting the parameters for the PG Member Distinct Value Checker Business Service. You might use this feature differently, depending on your business model.

A product administrator is setting up promotion group validation rules to verify unique field values. The product administrator navigates to the Administration - Product screen, Promotion Groups view, Validation subview for that promotion group definition and performs the following steps:

1. In the Validation list, the product administrator selects the PG Member Distinct Value Checker Business Service record.
2. In the Parameters list, she selects the Attribute1 record and enters Member Asset Id in the Value field.
3. In the Parameters list, she selects the Member Field record and enters Service Account Id|Billing Account Id in the Value field.

As a result, your Siebel application applies the following validation rules at run time:

• Each member of a promotion group must have a different service account and a different billing account.
• Each membership of a promotion group is associated with a different asset; that is, each membership has a different Member Asset Id.

PG Member Common Value Checker Business Service

This business service validates that its input arguments are the same. The input arguments for this business service can include one or more fields in the asset business component, for example, Billing Account and Service Account. If the billing account and service account of a member are not the same, then the business service generates an exception.

The parameters and parameter values for this business service are shown in Table 112.

If the same field, for example, Billing Account Id, is defined in both the Member Field parameter and Attribute1 parameter, then the Member Field parameter overrides the Attribute1 parameter. Consequently, this field is validated in the member records and not in the membership records.

Example of Setting Common Value Checker Parameters

This topic gives one example of setting the parameters for the PG Member Common Value Checker Business Service. You might use this feature differently, depending on your business model.

A product administrator is setting up promotion group validation rules to verify equal field values. The product administrator navigates to the Administration - Product screen, Promotion Groups view, Validation subview for that promotion group definition and performs the following steps:

1. In the Validation list, the product administrator selects the PG Member Common Value Checker Business Service record.
2. In the Parameters list, she selects the Attribute1 record and enters Member Asset Id in the Value field.
3. In the Parameters list, she selects the Member Field record and enters Service Account Id|Billing Account Id in the Value field.

As a result, your Siebel application applies the following validation rules at run time:

• All members of a promotion group must have the same service account and the same billing account.
• All memberships of a promotion group are associated with the same asset, that is, all memberships have the same Member Asset Id.