Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Automated Test Framework use case: test a Service Catalog request

This use case illustrates testing a service catalog request with the Automated Test Framework.

Before you begin

Role required: atf_test_admin

About this task

With the Replay Request Item test step, you can test the service catalog ordering process once a request exists and has a record in the request item table. In the Australia release, you cannot create an automated test for the process by which the user creates a new request.

Image omitted: atf-use-serv-cat.png
Test steps

Procedure

  1. Replay an existing service catalog request item.

    This test step inserts a new record in the [sc_request] table for the catalog request item RITM0010001.

Image omitted: atf-use-sc-step-01.png
Replay request item
This insertion triggers the Service Catalog Request workflow, which checks the price of the item, determines that it exceeds $1000.00, and therefore generates approval records for users belonging to the Catalog Request Approvals group. In this example, only one user– Eric Schroeder – belongs to this group.
Image omitted: atf-use-sc-scrwf-a.png
Service catalog request workflow
  1. Impersonate Eric Schroeder, the user who needs to approve this Service Catalog Request.
Image omitted: atf-use-sc-step-02.png
Impersonate test step
  1. Verify that the system created an approval record for Eric Schroeder and this request.

    Note that for the Approval for field, you assign the output value from Step 1.

Image omitted: atf-use-sc-step3.png
Record query test step
  1. Set the state of this approval record to Approved.
Image omitted: atf-use-sc-step-04.png
Update setting approval state
The Service Catalog Request workflow sees that all required approval records have the state of Approved and transitions to the Approval Action which marks the request record \[sc\_request\] as Approved.
Image omitted: atf-use-sc-scrwf-b.png
Sc workflow with approval portion highlighted
When the record in \[sc\_request\] changes to the Approved state, an associated business rule generates request items \[sc\_request\_item\] for each item in the request. In this example, the request contains only one item, so the business rule inserts one record into the \[sc\_request\_item\] table. This insertion triggers the Service Catalog Item Request workflow.
Image omitted: atf-use-sc-item-wf.png
Service catalog item request workflow
The first activity in the Service Catalog Item Request workflow generates an approval record for the head of the department in which the requesting user works. In this example, the department head is Natasha Ingram.
Image omitted: atf-use-sc-ir-01.png
Service catalog item workflow
  1. The workflow does not continue until the department head approves it, so the next test step impersonates Natasha Ingram.
Image omitted: atf-use-sc-step-05.png
Impersonate user test step
  1. Obtain the sys_id for the new approval record with the Record Query step.

    Note that Record Query creates an output variable with the sys_id of the first record returned from the query.

Image omitted: atf-use-sc-step-06.png
Record query test step
  1. Set the approval record to Approved.
Image omitted: atf-use-sc-step-07.png
Approval user test step
Note how Step 7 refers to the **First record**output variable from Step 6 to specify which record to approve. When the record is approved, the workflow transitions to the next Approval - User activity, which generates an approval record for the CIO. In this example, the CIO is Bow Ruggeri.
Image omitted: atf-use-sc-ir-02.png
Service catalog item workflow
  1. Impersonate Bow Ruggeri.

  2. Obtain the sys_id for the approval record for Bow Ruggeri.

  3. Set the approval record to Approved.

    When the record is approved, the workflow transitions to the Approval Action activity which sets the record for this item in the [sc_request_item] table to Approved. The workflow transitions to the Catalog Task activity labelled Asset Mgmt. Fulfills Order. This Catalog Task activity generates a new record in the [sc_task] table that instructs a user in the Fulfillment group to order the item.

Image omitted: atf-use-sc-ir-03.png
Service catalog item workflow
  1. Impersonate a user in the Fulfillment group, in this example ATF.User.
Image omitted: atf-use-sc-step-11.png
Impersonate user test step
  1. Obtain the sys_id for the new catalog task with the Record Query step.

    Note that Record Query creates an output variable with the sys_id of the first record returned from the query.

Image omitted: atf-use-serv-cat-step12.png
Record query test step
  1. Mark the [sc_task] record as Closed Complete.
Image omitted: atf-use-sc-step-13.png
Record update test step
Note how Step 13 uses the **First record**output variable from Step 12 to specify which record to mark as **Closed Complete**.

When the record is marked **Closed Complete**, the workflow exits the Catalog Task activity along the In Stock exit path.
Image omitted: atf-use-sc-ir-04.png
Service catalog item request workflow
The workflow transitions to the Notification activity, then to the Catalog Task activity labelled Deploy Item to User.The Deploy Item to User Catalog Task activity inserts a new record into the \[sc\_task\] table that instructs a user in the Deployment group to deliver the item.
  1. Obtain the sys_id for the new catalog task with the Record Query step.

    Note that Record Query returns an output variable with the sys_id of the first record returned from the query.

Image omitted: atf-use-sc-step-14.png
Record query test step
  1. Mark the [sc_task] record as Closed Complete.

    Note how Step 15 uses the First recordoutput variable from Step 14 to specify which record to mark as Closed Complete.

Image omitted: atf-use-sc-step-15.png
Record update test step
When the record is marked Closed Complete, the workflow exits the Catalog Task activity, logs a message, and exits.
Image omitted: atf-use-sc-ir-05.png
Service catalog item request workflow
  1. Verify that the request item in [sc_request_item] has the state Closed Complete.
Image omitted: atf-use-sc-step-15.png
Record validation dialog
  1. Verify that the request [sc_request] has the state Closed Complete.
Image omitted: atf-use-sc-step-16.png
Record validation test step

Parent Topic:Automated Test Framework use case examples

Related topics

Replay Request Item