See the supported connectors for Application Integration.

Upload and download test cases

This document describes how to upload and download 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 permissions that you need to upload and download test cases, ask your administrator to grant you the Application Integration Editor (roles/integrations.integrationEditor) IAM role on project. For more information about granting roles, see Manage access to projects, folders, and organizations.

    This predefined role contains the permissions required to upload and download test cases. To see the exact permissions that are required, expand the Required permissions section:

    Required permissions

    The following permissions are required to upload and download test cases:

    • Upload a test case: integrations.googleapis.com/testCases.create
    • Download a test case: integrations.googleapis.com/testCases.get

    You might also be able to get these permissions with custom roles or other predefined roles.

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

Upload a test case

To upload 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. To upload a test case from your local machine, from the Test Case list, select Upload a test case.

API

Call the projects.locations.integrations.versions.testCases.upload 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:upload

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

The request body contains the content of the file in a string format and the file format. The valid file formats are .json and .yaml.

Download a test case

To download a test case for an integration version, 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 that contains test cases.

    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 download.

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

  6. Click Download.

API

Call the projects.locations.integrations.versions.testCases.download method. For example:

POST https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases/TEST_CASE_ID

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 download

What's next