Asana Connector

Intro

Asana is a cloud-based project management platform that helps users track projects, tasks, stories, and other project-related workflows. To learn more about the Asana API, visit their page (https://asana.com/developers/documen…arted/overview ).

You connect to your Asana account in the Data Center. This topic discusses the fields and menus that are specific to the Asana connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to your Asana account and create a DataSet, you must have the email address you use to log into Asana, as well as your Asana password. Alternatively, you can use Google credentials to connect.

Connecting to Your Asana Account

This section enumerates the options in the Credentials and Details panes in the Asana Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

The Domo Asana connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click Connect (or select Add Account if you have existing Asana accounts in Domo) to open the Asana OAuth screen where you can enter your Asana or Google credentials. Once you have entered valid credentials, you can use the same account any time you go to create a new Asana DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Note: If you are already logged into Asana when you connect in Domo, you are authenticated automatically when you click Add account. If you want to connect to an account that is different from the one you are logged into, you must first log out of Asana.

You will also need an API Key for your Asana account. Any user can get their own API key by visiting the Account Settings dialog and clicking on the Apps tab. The API key is located at the bottom of this dialog box.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select. If you select the “Tasks” report, a “Subreport” menu appears from which you may select a secondary report.

Menu	Description
Report	Select the Asana report you want to run. The following reports are available: Attachments This report pulls your asana attachments for a specified workspace. Custom Fields This report pulls your asana custom fields for a specified workspace. Goals This report pulls your asana custom fields for a specified workspace. It is available only with Asana Advanced, Enterprise, Enterprise+, Legacy Business, and Legacy Enterprise plans. Projects This report gets all projects in a workspace. Stories This report gets all stories in a workspace. Subtasks This report gets all subtasks in a workspace. Subtasks For Team This report gets all subtasks for selected team in a workspace. Tags This report gets all tags made on all tasks in a workspace. Tasks This report gets all tasks in a workspace. Teams This report gets all teams in a workspace. Time Tracking Entries This report returns time tracking entries for a task. Users This report gets all users on a workspace. Workspaces This report gets all workspaces for a client.
Subreport	The following subreports are available: Subreport Description Custom Fields This report gets all tasks in a workspace enhanced with custom fields data. Custom Field Settings Returns array of Custom Field Settings data. Followers This report gets all tasks in a workspace enhanced with followers data. Hearts This report gets all tasks in a workspace enhanced with hearts data. Memberships This report gets all tasks in a workspace enhanced with memberships data. None This report gets all tasks in a workspace. Projects This report gets all tasks in a workspace enhanced with task projects. Tags This report gets all tasks in a workspace enhanced with tags data.
Workspace	Select the workspace you want to retrieve data for.
Tasks Completed Since	Select the date to return tasks that are either incomplete or those which have been completed till this date. ( Note: For reports Subtasks and Subtaks For Team , it will bring subtasks for the tasks which are incomplete or completed since this date.)
Use Extended Run (checkbox)	Select the checkbox if you have large amounts of data, which will take more than 24 hours to import. Connector runs that take more than 24 hours may be canceled. The Extended Run functionality allows the connector to import as much data as possible during each 24 hour block, and resume the data import without user intervention in the next available 24 hour block.
Exclude Nested Subtasks (checkbox)	Select the checkbox if you don’t want to import subtasks that are nested under other subtasks.
Disable 404 error warnings	Select this option to disable 404 error warnings.
Action On 403 Error	Select how to handle a 403 error. You can skip failed records and continue processing, or throw an exception. Select the action to perform if a request to fetch subtasks for a specific task ID fails with a 403 - No Access error (which occurs if the user running the connector lacks permission to view a task’s details). Skip failed record and continue: The connector will ignore the 403 error, skip the inaccessible task, and continue processing the remaining tasks in the list. Throw Exception: The connector will immediately stop execution and fail with a 403 error if an inaccessible task is encountered. (Default behavior)
Team	Select the team.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

FAQ

How often can the data be updated?

DataSets can be updated as often as once an hour.

Are there any API limits that I need to be aware of?

Asana does not document any limits in their API.