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 specific service option in a service in a request, select Home, Requests. View the details for the request that contains that service option.

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 Business Service Insight 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, suppose "Premium Laptop" is the value of the Display Text field. In that case, the value of item_text must also be 'Premium Laptop': The value cannot be 'premium laptop' or 'Premium Laptop'; the value cannot be any value except an exact match.

• 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 can be any of the following:

  • '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:

• You can specify the assignee for the request pending action when both of the following are true:
  • The service option group is named Reserve Virtual Machine.
  • The item type is 15 (for reservation) for the first service option element in the first service option.

  To do so, use this condition:

  $(_.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.

• You can specify the assignee for the request pending action when both of the following are true:
  • The service option group is named Increase Mailbox Size.
  • The estimated cost is greater than 200 monetary units for the first service option element in the first service option. The default unit is dollars.

  To do so, use this condition:

  $(_.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.

• You can specify the assignee for the request pending action when both of the following are true:
  • The service option group is named Application Hosting.
  • The estimated cost is greater than or equal to 2500 monetary units for the sixth service option element in the fifth service option.

  To do so, use this condition:

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

Examples with the Match Function

Consider the following examples:

• You can specify the assignee for the request pending action when the following is true: Any service option element in the request has an estimated cost greater than 30.0 monetary units (for example, pounds). To do so, use this condition:

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

• You can specify the assignee for the request pending action when the following is true: The value of the item_text attribute of any service option element in the request contains the 'share' text string. To do so, use this condition:

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

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