See the supported connectors for Application Integration.

Run test cases

Preview — Test cases

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This document describes how to run test cases for your integrations. For information about test cases, supported test configurations, and its limitations, see Introduction to test cases.

Before you begin

• To get the permission that you need to run test cases, ask your administrator to grant you the Application Integration Invoker (roles/integrations.integrationInvoker) IAM role on project. For more information about granting roles, see Manage access to projects, folders, and organizations.

  This predefined role contains the integrations.googleapis.com/testCases.invoker permission, which is required to run test cases.

  You might also be able to get this permission with custom roles or other predefined roles.

• Ensure that you have a test case in the integration. For information about how to create a test case, see Create Test Cases.

Run a test case

To run a test case, select one of the following options:

Console

1. In the Google Cloud console, go to the Application Integration page.

   Go to Application Integration

2. In the navigation menu, click Integrations.

   The Integrations page appears listing all the integrations available in the Google Cloud project.

3. Select an existing integration for which you want to create a test.

   This opens the integration in the integration editor.

4. Click Test Case and then click Open test cases. The Test Cases pane appears with a list of test cases for the current integration version.
5. Select the test case that you want to run.

   In the Integration editor page, the designer canvas displays Test case mode is active.

6. Click Test. The Run test case page appears. Then, do the following:
   1. Enter the Execution deadline.
   2. Click Run test.

      You can view logs for your test cases. To view and inspect the execution logs of the test run, click View logs.

API

Call the projects.locations.integrations.versions.testCases.executeTest method and provide any relevant parameters. For example:

POST https://integrations.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION}/testCases/TEST_CASE_ID:executeTest

Replace the following:

• PROJECT_ID: the ID of the Google Cloud project
• LOCATION: the region where the integration is located
• INTEGRATION_NAME: the name of the integration
• INTEGRATION_VERSION: the version of the integration
• TEST_CASE_ID: the ID of the test case that you want run

View test case execution logs

You can view the test case executions logs on the Logs page. For information about how to view the logs, see View execution logs in Application Integration.

What's next

• Learn about test cases.

• Learn how to do the following:

  • Create test cases.
  • Configure test cases.
  • Copy and delete test cases.
  • Upload and download test cases.