Asana integration

Authentication

Supported authentication methods

Personal token

To proceed with this authentication type you need to obtain API token from Asana. Steps below will instruct you how to do that.

Open Asana. Reveal user menu by clicking on your avatar icon in header and then click "My Profile Settings..." there.

Reveal user menu

In "My Profile Settings" popup switch to Apps tab. Click "Manage Developer Apps" at its bottom.

Profile settings

Now, we're interested in "Personal Access Tokens" area. Click "+ Create New Personal Access Token" link in there. Provide your token with unique name and finally click "Create".

Create token

Don't forget to copy the token. Once hidden, it won't appear again any more.

Now, when you've obtained a token, lets configure integration in Bugsee. Select "Personal token" authentication type and click "Next".

Select personal token

Paste generated token into "Personal token" field and click "Next" to proceed.

Paste personal token

OAuth

Select "OAuth" authentication type and click "Next".

Select OAuth

You will be presented with the following window asking you to grant Bugsee permissions to access you Asana. Click "Allow" to give Bugsee requested permissions.

Grant permissions

Configuration

We describe here only specific configuration steps for Asana. Generic steps are described in configuration section. Refer to it for more details.

All the projects in Asana are bound to workspaces. So, if you have more than one workspace, you will be prompted to chose the workspace:

Choose workspace

Custom recipes

Bugsee can accommodate all these customizations with the help of custom recipes. This section provides a few examples of using custom recipes specifically with Asana. For basic introduction, refer to custom recipe documentation.

Setting tags field

Bugsee can't map it's own issues labels field to Asana tags. But you can specify appropriate tags via custom field inside custom recipes:

function create(context) {
    // ....

    return {
        // ...
        custom: {
            // This example sets tag by its ID
            tags: ["1150465793891637"]
        }
    };
}

You can find ID of the tag in URL of your tag's page:

Tag's ID in the tag's URL