TestOps logo
Try TestOps

Asana

This integration is available starting with Allure TestOps version 26.3.1.0

The Asana integration lets Allure TestOps link Asana tasks to test artifacts inside your Asana workspace. It covers:

  • Linking Asana tasks to test cases, launches, defects, and mutes;
  • Searching for existing Asana tasks from Allure TestOps using a task ID;
  • Linking existing Asana tasks or creating new ones from defects in Allure TestOps;
  • Providing launch execution status to a linked Asana task.

1. Create the Asana Personal Access Token

  1. In Asana, click your profile picture in the upper-right corner and select Settings.
  2. Open the Apps tab.
  3. Click View developer console.
  4. Click Create new token.
  5. Enter a name for the token and create it.
  6. Copy the generated Personal Access Token. Save it for the next steps.

2. Add the global Asana integration

An instance administrator should:

  1. Open Administration → Integrations in Allure TestOps.

  2. Click + Add integration.

  3. Select Asana.

  4. Fill in the fields:

    • Name: a stable name for the integration, for example Asana;
    • Endpoint: the Asana web URL, https://app.asana.com;
    • Endpoint for REST API calls: https://app.asana.com/api/1.0 for Asana Cloud, or the proxy endpoint approved by your organization.

  5. Click Add integration.

3. Enable Asana in an Allure TestOps project

  1. Go to Administration → Integrations.
  2. Find and open your Asana integration.
  3. Go to the Projects tab.
  4. Click + next to the search field.
  5. Select the target Allure TestOps project.
  6. Under Projects used for task search, add the Asana project GID. You can find it in the Asana project URL, for example, in https://app.asana.com/0/1201234567890123/list the GID is 1201234567890123. Add a GID for each Asana project whose tasks Allure TestOps should suggest.
  7. In the Personal access token field, paste the token created in step 1.
  8. Click Test connection. If the credentials are correct, a Connection established message appears.
  9. Click Add integration.

In an Allure TestOps project:

  1. Go to Settings → Integrations.
  2. Under Available integrations, find the Asana integration and click Add integration.
  3. Under Projects used for task search, add the Asana project GID for each Asana project whose tasks Allure TestOps should suggest, as described in the previous tab.
  4. In the Personal access token field, paste the token created in step 1.
  5. Click Test connection. If the credentials are correct, a Connection established message appears.
  6. Save the project integration.

Verify the integration

Check both the link flow and the defect flow:

  1. Open a test case in Allure TestOps and add an issue link.
    1. Confirm that the Asana picker can find tasks by Task ID.
  2. Open a launch in Allure TestOps, click Edit, and add an issue link.
    1. Confirm that the Asana picker can find tasks by Task ID.
  3. Open a defect in Allure TestOps and verify that the Asana integration can:
    1. Create a new Asana task;
    2. Link the defect to an existing Asana task.
© Qameta Software Inc. All rights reserved.