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 based on service option elements can apply to either global or attached policies.

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 service option elements:

code item_type

estimatedCost status

item_text

The following attributes require explanation:

Code

Is a user-specified text value to represent the product code, subscription code, SKU # or any other applicable code.

Note: To find the value of this attribute for a service option element, proceed as follows: click Catalog, Services Offerings, Option Groups. View the service option and service option element of interest. On the Service Option Element Definition dialog, click the Options tab and find the value of the Code field.

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.

Note: To find the cost of the service option, click Home, Requests and, if applicable, use the My Requests drop-down list to display requests. Find the request that contains the service option and view the details.

item_type

Specifies a valid value for the item type, as specified in the Type label of the service option element. For example, if the type of the service option element is CA BSI contract (for CA Business Service Insight contract), the value of item_type is 5. Similarly, if the type is 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 an exact match or an approximate match, as follows:

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

  For global policies:

  $(_.sog['ab'].serviceoption[1].soe[2].item_text=='abc')

  For attached policies:

  $(_.serviceoption.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 string specified must be either the same as the Display Text or a substring of Display Text. The string 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 string specified can be any of the following options:

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

status

Specifies the request status of the service option that contains this service option element.

Formats

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

Use the following format for conditions with a match function:

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

Use the following formats (without spaces) for conditions without a match function.

• For global policies, conditions for service option elements use this format:

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

  sogname

  Specifies the name of the service option group.

  rownum

  Specifies the row number of the service option.

  Use the product UI to find the row number of the service option in the service option group.

  Row numbers apply to global policies only.

  colnum

  Specifies the column number of the service option element in its service option.

  Use the product UI to find the column number of the service option element in the service option.

• For attached policies, conditions for service option elements use this format:

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

  The same colnum attribute as for global policies also applies to attached policies.

Examples

Consider the following examples:

• You can specify the assignee for the request pending action when all of the following are true:
  • The service option group is named Reserve Virtual Machine. Applies to global policies only.
  • The service option is in row 2. Applies to global policies only.
  • The service option element is in column 3. Applies to both global and attached policies.
  • The item type of the service option element is 15 (for reservation). Applies to both global and attached policies.

  To do so, use this condition:

  For global policies:

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

  For attached policies:

  $(_.serviceoption.soe[3].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 all of the following are true:
  • The service option group is named Increase Mailbox Size. Applies to global policies only.
  • The service option is in row 3 of the service option group. Applies to global policies only.
  • The estimated cost for the service option element is greater than 200 monetary units. The default unit is dollars. Applies to both global and attached policies.
  • The service option element is in column 2 of the service option. Applies to both global and attached policies.

  To do so, use this condition:

  For global policies:

  $(_.sog['Increase Mailbox Size'].serviceoption[3].soe[2].estimatedCost >200)

  For attached policies:

  $(_.serviceoption.soe[2].estimatedCost >200)

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

• You can specify the assignee for the request pending action when all 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:

  For global policies:

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

  For attached policies:

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