To integrate Test Collab with Asana, you should have Asana Personal access token ready with you.
Here are the steps to get your Token generated, in case you do not know:
Being on Asana opt to goto "My Profile Settings...", You will be shown a popup similar to the one being shown below.
Under Apps tab click on "Manage Personal Apps". You will then be directed to "Developer App Management" page
Create a new personal access token by clicking the given link.
Enter the description of app you want the access token for.
A new token will be generated and made available temporarily for copying. Make sure you get the new token copied as the same would not be made available again and in case you have not copied it then you would need to generate a new token.
Configuring application wide integration settings for Asana in Test Collab:
Navigate to Main Dashboard > Settings > Issue Manager and provide the Personal access token (in place of username) after selecting Asana from the drop down available on the issue manager integration settings page.
You also have an option of allowing the reported issue to be resolved / closed automatically when the related test case passes by checking "Resolve reported issues when a failed test case is marked as passed". When you check this you will be prompted to provide the status code that Asana uses for resolved issues, you need to enter the same for "Status code for resolved".
Project wise integration settings
When it comes to project wise setting for Asana, you will get the list of fields that are important for configuration. The list includes :
For these fields lists of options will automatically be fetched from Asana on the basis of credentials provided by you during configuring application wide settings.
You can also add other fields including any custom field using "Add user defined field" from the drop down, clicking this you will get a text box in place of drop down to enter the name of the field.
Once the values for all fields have been provided you can save and test the settings by creating a sample issue in Asana.
Once you have configured Asana as an issue manager , bugs can now be automatically reported into Asana if a test case fails while execution and the tester has opted to report. More information on this is available here.
You can also get requirements from Asana linked with test cases in Test Collab so that you can have a better traceability and coverage analysis. For details on requirements management please refer relevant article.