Use > Service Catalogs > Service Catalog management > Service Catalog status mapping > Configure Service Catalog status mapping for delivery target monitoring

Configure Service Catalog status mapping for delivery target monitoring

Service Catalog status mapping enables you to set the appropriate status on Service Catalog cart item (svcCartItem) records. When an order for a catalog item is being fulfilled, the cart item status is automatically synchronized based on status mapping that you specify.

You can add these cart item status values to the slamodulecontrol table so that you can create a process target based on these status values to monitor the delivery target of a catalog item during its fulfillment process.

To achieve this, complete the following tasks.

Task 1: Create Service Catalog status mapping records for the catalog item

In this task, you need to create status mapping records for different phases of the fulfillment record that is created after a user orders the catalog item. The type of fulfillment record varies depending on the connector that is defined in the catalog item. For example, if the Open a Change connector is defined, the fulfillment record is a Change record.

To complete this task, follow these steps:

  1. Add a Service Catalog status mapping record for a phase of the fulfillment record.

    1. Click Service Catalog > Tailoring > Add Field Mapping.
    2. Provide the following information.

      Field Description
      Id This is a system-generated identification number for the record.
      Source Status

      The status of the source field that will be mapped to the status of the request.

      This field is referenced as SOURCEVALUE in the transformation code.

      Example: Registration and Categorization

      Source File Name

      The source file where the request's status will be mapped from.

      Example: cm3r

      Source Field Name

      The field name that will be mapped to the status of the request. This field name can be referenced in the transformation code.

      Example: current_phase

      Target Status

      The status text that the request maps to. This field is referenced as TARGETVALUE in the transformation code.

      Example: Categorization

      Status Score

      The order in which to process this field.

      When mapping more than one field to the status of a request, you must specify the order in which to process the fields. Mapping more than one field makes it possible to build phrases based on the status of various fields in the source record.

      Example: 1

      Filter Code

      JavaScript code to transform the target status of fields based on the source status of this or other mapped fields in this source file.

      The source status and target status of this and other fields in the same source file can be referenced with the strings "@[field name].SOURCEVALUE@" and "@[field name].TARGETVALUE@". Using these strings and JavaScript, it is possible to transform the target values.

      Example: if (@current_phase.SOURCEVALUE@=="Registration and Categorization"){@status.TARGETVALUE@="";@approval_status.TARGETVALUE@="";}

      Notification Name The name of the notification to be sent when the request reaches this status.
      Notify requester of change Indicates whether to send a notification when the request reaches this status.
      Skip processing for this status Indicates whether to skip processing if the source record has the specified status.
    3. Click Add to add the new record to the svcCatStatusMap table.

  2. Repeat the previous step to add a status mapping record for each of the remaining workflow phases that you want to use for delivery target monitoring.

Task 2: Add the new target status in the slamodulecontrol table

The purpose of this task is to make the target status values that you define in the status mapping records available in Service Level Agreements so that you can use them to create process targets for the Service Catalog area.

To complete this task, follow these steps:

  1. Enter db in the Service Manager command line, and press Enter.
  2. In the Table field, enter slamodulecontrol. Click Search.
  3. In the Table Name field, enter svcCartItem. Click Search.
  4. Go to the Process Target Information section, and make sure the Process Target State Field value is status.
  5. Add the new target status that you specified previously to the Process Target State Progression array. For example, enter Categorization in the array field.

    The following figure shows an example.

Task 3: Add a process target to the relevant Service Level Agreement (SLA)

In this task, you need to go to the relevant Service Level Agreement (SLA) that is defined in the catalog item definition, and add a process target for the catalog item. If the catalog item has no SLAs defined, use the default SLA that is defined in Service Level Management.

Tip You can define suspending statuses for the process target. For example, if the cart item reaches a "Pending customer information" status, you may want to suspend the delivery target calculation.

Important To use the Service Catalog status mapping functionality for SLA monitoring for catalog items, you need to create a process target for the Service Catalog area. The process target must use the delivery target defined in the catalog item definition.

To complete this task, follow these steps:

  1. Go to Service Catalog > Administration > Manage Items, and open the catalog item definition by performing a search. For example, open the PC Backup record.
  2. On the Agreements tab, find the service level agreements defined for the item.

    Important If the catalog item has multiple agreements defined, you need to add a process target for each of the agreements, as described in the following steps.

  3. Click Service Level Management > Agreements, and open an agreement record of the catalog item.

    For example, open the Base Monitoring SLA for IT services agreement.

  4. Click the Process Targets tab, and then click Add SLT(s).
  5. In the Service Area field, select Service Catalog. Click Next.
  6. Enter a name for the SLT (for example, Cart Item SLA monitoring) and enter an optional description. Click Next.
  7. Select a schedule and time zone. Click Next.
  8. Provide information as follows:

    1. Select a catalog item or leave the Catalog Item field blank to use this process target for multiple items.
    2. Select a service recipient or leave the Requested For field blank to use this process target for multiple recipients.
    3. In the Delivery field, select the delivery target defined in the catalog item definition. For example, select 3 Business Days for PC Backup.
    4. In the Quantity field, specify a quantity condition if necessary.
    5. Click Next.
  9. On the Process Time page, specify the following information:

    Note On this page, the target status values that you specified previously when creating the Service Catalog status mapping record are displayed in the Initial State and Final State drop-down lists.

    • Initial State: Select the initial state to be used for SLA monitoring.
    • Final State: Select the final state to be used for SLA monitoring.
    • Duration Type: Select Calculation.
    • Duration calculation method: Select Service Catalog Item Expiration.

    The following figure shows an example for PC Backup.

    Click Next.

  10. On the Alerts and Suspend Information page, provide the following information:

    • If needed, select one or more alerts; otherwise, leave the Alerts field blank.
    • If appropriate, specify one or more states when processing for the Service Level Target (SLT) should be suspended; otherwise, leave this field blank.

    The following figure shows an example for PC Backup.

  11. Click Finish to add the Process Target, and then click OK.

  12. If the catalog item has multiple agreements defined, repeat these steps to add a process target for the rest of the agreements.