Configuring a Connection
The connector comes with a connection builder which allows you to build and test your connection settings outside of Tableau. It also allows you to create a connection string, which can be used to provide options not listed in the connection dialog in Tableau.
Configuring a Connection Builder
There are two ways to access the connection builder:
- On Windows, there will be a shortcut called Connection Builder in the start menu, under the CData Asana Tableau Data Connector folder.
- The connection builder can also be started by going to the driver install directory (by default, C:/Program Files/CData/CData Tableau Connector for Asana and running the .jar file in the lib directory.
In the connection builder, you can set values for connection properties and click the Test Connection button to validate that they work. You can also use the Copy to Clipboard button to save the connection string for use with Tableau.
Connecting to Asana
You can optionally set the following to refine the data returned from Asana.
- WorkspaceId: Set this to the globally unique identifier (gid) associated with your Asana Workspace to only return projects from the specified workspace. To get your workspace id, navigate to https://app.asana.com/api/1.0/workspaces while logged into Asana. This displays a JSON object containing your workspace name and Id.
- ProjectId: Set this to the globally unique identifier (gid) associated with your Asana Project to only return data mapped under the specified project. Project IDs can be found in the URL of your project's Overview page. This will be the numbers directly after /0/.
Connect Using OAuth Authentication
You must use OAuth to authenticate with Asana. OAuth requires the authenticating user to interact with Asana using the browser. For more information, refer to Using OAuth Authentication.
See Getting Data for the next step, which includes authenticating to the Asana APIs.