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.
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:
| ||||||||||||||||||||||||
| Subreport | The following subreports are available:
| ||||||||||||||||||||||||
| Action on 403 Error | Select the action to perform when request to fetch subtasks for particular task id is failed with 403 (no access error). Skip failed record and continue will skip failed task and continue with remaining tasks. | ||||||||||||||||||||||||
| Workspace | Select the workspace you want to retrieve data for. | ||||||||||||||||||||||||
| Tasks Completed Since (optional) | 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. | ||||||||||||||||||||||||
| Action On 403 Error | The connector will fail with an error message as 403 - No Access , if the user running the connector does not have access to the details of a task in the task list. You have the option where the connector can ignore these errors and continue, by selecting Skip failed record and continue . If you want the connector to fail when a 403 error occurs, the you can select the Throw Exception option. The default behavior is to Throw Exception . |
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?
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?
Are there any API limits that I need to be aware of?
Asana does not document any limits in their API.