Defining terms and conditions for service targets and CI attributes

Terms and conditions are the circumstances under which service targets are in effect. When a request is submitted that fulfills these terms and conditions, the service target is attached to the request. In the case of a compliance-only service target, the terms and conditions are qualifying the set of data from the Action Request System form. The fields used in the terms and conditions must not change throughout the lifespan of the request because these fields are used in the measurement processing. 

For example, the terms and conditions might state that urgent service desk cases from the Engineering department are applied to a specific service target.

Related topics

General-information-for-service-targets

Important

If the terms and conditions no longer apply, the Detach feature removes the service target from the request. However, if you update a new CI Unavailability record and if the Terms and Conditions of the service targets no longer apply, the Detach feature does not remove the service target from the request. For more information, see KA413254.

Qualification Builder for creating expressions

Use the Qualification Builder to create expressions with the Application field, Keywords, and Symbols lists to enter your qualification, or you can type the qualification manually. 

The following example means that this service target applies to every record in a configured AR System form that has the category of "Hardware" and a priority of "Urgent," if it is submitted, modified, or imported. 

'Category' = "Hardware" AND 'Priority' = "High"

Other examples are as follows:

'Priority' = "High" AND 'Urgency' = "3-Medium"
'Company' = "ABC Company" AND 'Organization' = "Finance" AND 'Department' = "Payroll" AND 'Site' = "San Francisco, CA"
'Category' = "Business Service" AND 'Type' = "Customer Service"


Rules for defining terms and conditions

Some rules for defining terms and conditions are as follows:

  • Limit the Terms and Conditions statement to 32k characters when you build a service target. Otherwise, the statement will be truncated and your service target will not be created.

Important

  • If you are running an environment with double-byte characters, the AR System server could determine that your Terms and Conditions should be less than 32k as the maximum size.
  • When you create a service target by using a locale other than the English language, make sure that you do not use the localized Terms and Conditions statement. Use ENUM values instead of the qualification field values from the list.
  • Enter double quotation marks for strings. Do not include double quotation marks for integer fields.
  • Do not include special characters or carriage returns.
  • Do not use fields that change during the life-cycle of the request, for example the Status field.
  • Do not use the transaction (TR) value in the field because this value will not be true the next time the request is modified.
  • Do not use Display Only fields because these fields might not be loaded when the filter processing starts.
  • Do not use the Assignee Group field (ID 112) when you set the terms and conditions because this field is used for assigning permissions and the assignee group is stored as a number.

The values that you define in the qualification should match the values in the application form, or View form in the case of compliance-only service targets. For example, in the Service Level Management Sample Application, acceptable values for Priority include Low, Medium, High, and Urgent.


To build a custom qualification

  1. Log in to Mid Tier and go to Applications > Service Level Management > Service Level Management Console.
  2. Click the Service Target tab.
  3. Click Create to open the Service Target wizard. 
  4. Enter the basic information for the service target in the appropriate fields.
  5. From the Applies To field, select Incident.
  6. From the Goal Type field, select Incident Resolution Time.

  7. To open the Qualification Builder, click Define next to the Terms and Conditions field or click Create next to the CI Terms and Conditions field.

    Important

    The CI Terms and Conditions field is displayed only when you enable BMC Helix Telco Extensions and you select the value of Applies To as Incident and the Goal Type as Incident Resolution Time.

  8. In the Custom Qualification box, select Yes.
  9. In the Advanced Qualification Builder, enter the qualification by typing entries or using the operators, keywords, and fields from the application form.
  10. Click OK to return to the Qualification Builder.
    The system enters the Qualification in the Qualification field.

  11. Save your qualification.

    Important

    If the service target is related to an agreement with an associated business service CI, an additional qualification is added to the terms and conditions.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*