Using Policies to Manage Requests › How to Create a Condition › Conditions Based on the Attributes of Service Option Elements

Conditions Based on the Attributes of Service Option Elements

Conditions for service option elements must reference the service option group and the row of the service option they belong to. To identify the service option element, use its column number in the service option row.

For service options and service option elements, you can specify conditions that use match functions.

You can specify conditions based on the following attributes of the service option elements affected by the policy:

estimatedCost item_type

item_text status

The following attributes may require explanation:

estimatedCost

Specifies the estimated cost of a service option element in a service option in a service in a request. The Catalog system includes the cost of all service option elements in the cost of the service option to which they belong. The Catalog system calculates this cost when the request is submitted.

To find the cost of a service option in a service in a request, select Home, Requests and view the details for the request that contains the service option of interest.

item_type

Specifies a valid value for the item type, as specified in the Type field of the service option element. For example, if the type of the service option element is CA Oblicore Guarantee contract, the value of item_type is 5. Similarly, if the type is Form Designer form, the value of item_type is 14.

item_text

Specifies the value of the Display Text field on the service option element definition page. You can specify the condition to require either exact match or an approximate match, as follows:

• To require an exact match, specify the condition as follows:

  _.sog[‘ab’].serviceoption[1].soe[2].item_text==’abc’

  In this format, the text must match exactly, including case and spaces. For example, if "Premium Laptop" is the value of the Display Text field, then the value of item_text must also be 'Premium Laptop' not 'premium laptop' or 'Premium Laptop' or another value.

• To require an approximate match, specify the condition as follows:

  anySoeWith(‘item_text’,contains,’abc’)

  In this format, the Display Text must contain either the same text as the item_text field or a substring of it. The Display Text is not required to match exactly and is case sensitive.

  For example, if "Premium Laptop" is the value of the Display Text field, then the value of item_text could be any of these:

  • 'Premium Laptop'
  • 'Laptop'
  • 'Premium'

Formats

Use the following format for conditions with a match function:

$(anySoeWith('attribute',operator,'value'))

Use the following format (without spaces) for conditions without a match function:

$(_.sog[sogname].serviceoption[rownum].soe[colnum].attribute operator 'value')

For both formats, enclose string values in single quotation marks, and enter numeric values without quotation marks.

sogname

Specifies the name of the service option group.

rownum

Specifies the row number of the service option.

colnum

Specifies the column number of the service option element.

Examples

Consider the following examples:

• Use this condition to specify the assignee for the pending action when the service option group is named Reserve Virtual Machine and the item type is 15 (for reservation) for the first service option element in the first service option:

  $(_.sog['Reserve Virtual Machine'].serviceoption[1].soe[1].item_type==15)

  Thus, this condition is met when a service option for creating or extending a reservation meets the specified criteria.

• Use this condition to specify the assignee for the pending action when the service option group is named Increase Mailbox Size and the estimated cost is greater than 200 monetary units (by default, dollars) for the first service option element in the first service option:

  $(_.sog[‘ Increase Mailbox Size’].serviceoption[1].soe[1].estimatedCost >200)

  Thus, this condition is especially useful to specify approvers or fulfillers for service options costing more than a specified amount.

• Use this condition to specify the assignee for the pending action when the service option group is named Application Hosting and the estimated cost is greater than or equal to 2500 monetary units (by default, dollars) for the sixth service option element in the fifth service option:

  $(_.sog['Application Hosting'].serviceoption[5].soe[6].estimatedCost>=2500)

Examples with the Match Function

Consider the following examples:

• Use this condition to specify the assignee for the pending action when any service option element in the request has an estimated cost greater than 30.0 monetary units (for example, pounds):

  $(anySoeWith('estimatedCost',gt,30.0))

• Use this condition to specify the assignee for the pending action when the value of the item_text attribute of any service option element in the request contains the text string 'share':

  anySoeWith('item_text',contains,'share')

• See the examples earlier in this topic for the item_text attribute.