SAP Cloud ALM

Integrate your SAP Cloud ALM projects to Test Manager to create test projects, test cases, execute tests, and view detailed execution information. The integration helps you manage and execute automated tests in your SAP Cloud ALM instance through Test Manager.

You can integrate SAP Cloud ALM with UiPath Test Suite, and leverage the test automation and test management capabilities offered by UiPath Studio and Test Manager.

Supported testing scenarios

When you integrate SAP Cloud ALM with Test Manager you can perform the following testing activities:

• Test case creation:
  • Create automated test cases in SAP Cloud ALM, for which you can later assign Studio automations inside Test Manager.
  • Create automated test cases in Test Manager that synchronize with your target SAP Cloud ALM project.
• Test case execution:
  • Execute automated test cases within Test Manager through the SAP Cloud ALM interface.
    Note: When you trigger an execution from SAP Cloud ALM, you must assign a default Orchestrator folder to the project created through SAP Cloud ALM.
  • Execute automated test cases within Test Manager independently from the SAP Cloud ALM interface.
• Test case reporting
  • Navigate from SAP Cloud ALM directly to the test execution view in Test Manager for detailed information.

Integrating SAP Cloud ALM with Test Manager

Perform the following steps to integrate SAP Cloud ALM with Test Manager:

1. Create a new service

For more information about manually creating a service, visit Creating Services Manually, from the SAP Cloud ALM documentation.

1. In SAP Cloud ALM, go to Administration, and then Landscape Management.
2. Open the Services & Systems page.
3. Select Add, and choose New Cloud Service.
4. Configure the new UiPath service with the required parameters as follows:
   1. Name: Input UiPath.
   2. Description: Input UiPath Test Suite.
   3. System Number: Input the system number available in your SAP environment.
   4. Service Type: Select Unspecified Cloud Service (HTTP).
   5. Role: Select Test.
5. Select Save to confirm the new service.

2. Add a new endpoint

Endpoints allow you to create an authenticated connection to the previously created service. For more information, visit Adding Endpoints from the SAP Cloud ALM documentation.

Prerequisites

1. Create an external application in the UiPath organization that you want to connect SAP Cloud ALM to.
   Note: The App ID and Secret ID (under App Secrets) are used when configuring the authentication type of the endpoint.

   For more information about creating and managing external applications, visit Managing external OAuth applications.

2. Assign the following Test Manager user and application scopes to the previously created external application.
   1. TM.Projects
   2. TM.TestCases
   3. TM.CustomFieldDefinitions
   4. TM.CustomFieldValues

   For more information about Test Manager scopes, visit API Scopes.

1. Inside the Services & Systems page, select the previously created service.
2. Under Endpoints, select Add.
3. In the Add Endpoint pop-up, configure the following parameters:
   1. Endpoint Name: This parameter is automatically generated.
   2. Use Case: The supported use case for the UiPath service is Test Automation.
   3. Root URL: Input the Test Manager URL of the tenant where you want to create the test cases, followed by the api suffix.
      For example: https://govcloud.uipath.us/{organizationName}/{tenantName}/testmanager_/api.
   4. Authentication Type: Select OAuth2ClientCredentials.
      1. Client ID: Input the value of App ID from the previously created external application.
      2. Client Secret: Input the value of Secret ID from the previously created external application.
      3. Token Service URL: Input the UiPath® Identity Server endpoint of type Token: https://cloud.uipath.com/identity_/connect/token.

         For a list of Identity server endpoints, visit UiPath Identity Server Endpoints.

4. Select Save to confirm the new endpoint.

These configurations ensure that the SAP Cloud ALM and Test Manager systems can communicate and synchronize.

Working with SAP Cloud ALM and Test Manager

After you integrate SAP Cloud ALM with Test Manager, you can perform testing operations, such as creating test cases, executing them, and viewing the execution reports. The following sections demonstrate the end-to-end process of the integration.

Creating test cases

The SAP Cloud ALM and Test Manager integration applies only to automated test cases.

Overview

When you create an automated test case, SAP Cloud ALM simultaneously creates a new project in your connected Test Manager instance. The name of the project is the same as the one in SAP Cloud ALM, as well as a unique ID at the end. The project also includes the new test case that you created. When you decide to create further test cases using identical configurations to your initial test case, SAP Cloud ALM creates a new test case within your previously generated project.

Test cases created in both SAP Cloud ALM and Test Manager, are created within a specific context. The SAP Cloud ALM context is stored in the following custom fields from the Test Manager project: SAP Country/Region, SAP Scope, and SAP Solution Process. These parameters establish the proper mapping and context between test cases in SAP Cloud ALM and Test Manager.

Creating an automated test case in SAP Cloud ALM

To trigger the creation of an automated test case in Test Manager directly from SAP Cloud ALM, perform the following steps:

1. Go to SAP Cloud ALM and from the Project dropdown list, select an existent project or create a dedicated one, used to integrate with Test Manager.
2. Go to the Test Preparation app.
3. In the Test Cases section, select Create a Test Case. Configure the test case as follows:
   1. Type: Select Automated.

      The integration helps with creating, managing, and executing automated test cases for your business solutions in SAP Cloud ALM.

   2. Automation Provider: Select the UiPath Test Suite endpoint from the dropdown list.
   3. Title: Enter a title that is unique for the desired scope.
   4. Scope: Select a scope.

      This value is present in Test Manager as the SAP Scope custom field.

   5. Solution Process: Optionally, select a solution process.

      This value is present in Test Manager as the SAP Solution Process custom field.

   6. Country/Region: If you selected a solution process, then you have to select a desired country or region.

      This value is present in Test Manager as the SAP Country/Region custom field.

4. Select Save to confirm the test case creation.

For more information about creating automated test cases in SAP Cloud ALM, visit Creating Automated Test Cases.

Figure 1. The New Test Case pop-up from SAP Cloud ALM where you configure the new test case

Next steps

To execute a test case from a project synchronized from SAP Cloud ALM, you must first define an execution folder in Test Manager. This ensures a dedicated Orchestrator folder is available for the test's execution. You can define the default folder only at the project level.

For more information about the execution contexts, and execution folders, visit Automation project configuration.

Assigning test automations to test cases

Use UiPath® Studio to create a test automation or assign an automation to an existent test case in Test Manager.

Steps

1. In Studio, open an existing project or create a new one.
2. Connect this project to a Test Manager instance.
   1. From the Design ribbon, select Test Manager.
   2. Select Test Manager Settings.
   3. Enter the base URL of your synchronized Test Manager instance with SAP Cloud ALM.
   4. Select Connect.
   5. After the connection is successful, in the Default Project field, enter the name or prefix of the target Test Manager project.
3. Create and design test cases for your solution process.

   Visit the Introduction page of Test Suite Studio to explore the available test design capabilities.

4. Go to the Project panel of your project, and right-click a test case.
5. Select Link to Test Manager.
6. In the Link to Test Manager pop-up, provide the following test information:
   1. Project: Select the project containing the existent test case or where a new one will be created.

      If you selected a default project when you connected Studio to Test Manager, this project will appear in the Project field.

   2. Test: Enter the name of an existent test case from the selected project. To create a new test case, leave the default <new test case> value selected.
   3. Name: To create a new test case, leave <new test case> in the Test field, and provide a name for the new test case in Test Manager.
   4. Requirement: Optionally, enter the name of an existent requirement and assign it to the test case. If you do not want to assign a requirement, leave the <none> value selected.
7. Select OK to save the changes.

For more information on assigning automations to test cases in Test Manager, visit Assigning automations to test cases.

Executing test cases

You can execute the automated test cases created in Test Manager directly from SAP Cloud ALM. For detailed steps on how to execute automated test cases in SAP Cloud ALM, visit Executing Automated Test Cases.

Test case reporting

You can check the execution status and data, in real time, from both SAP Cloud ALM, and Test Manager. While Test Manager offers detailed information about the execution, you can see and synchronize the execution status in SAP Cloud ALM, as well.

Synchronizing execution status from Test Manager to SAP

After you trigger the execution of a test case in SAP Cloud ALM, you can track the status and the progress of the test run from the test case list. You can refresh the status and the progress of the test run by selecting Refresh Test Progress.

Next steps

After you execute a test case, you can see the status of the execution both in SAP Cloud ALM and Test Manager. While you are still in the Executed Test Runs section of a test case in SAP Cloud ALM, select Open Execution Log to navigate directly to the execution log of that test case within Test Manager.