How to integrate Asana with SSRS

Integrate SSRS and Asana
Integrate SSRS and Asana

Learn how to quickly and efficiently connect Asana with SSRS for smooth data access.

Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required. You can do it all using the high-performance Asana ODBC Driver for SSRS (often referred to as the Asana Connector). We'll walk you through the entire setup.

Ready to dive in? Download the product to jump right in, or follow the step-by-step guide below to see how it works.

Video Tutorial

This video covers the following topics and more, so please watch carefully. After watching the video, follow the steps outlined in this article:

  • How to download and install the required PowerPack for Asana integration in SSRS
  • How to configure the connection for Asana
  • Features of the ZappySys API Driver (Authentication / Query Language / Examples / Driver UI)
  • How to use the Asana in SSRS

Create data source in ZappySys Data Gateway

In this section we will create a data source for Asana in the Data Gateway. Let's follow these steps to accomplish that:

  1. Download and install ODBC PowerPack (if you haven't already).

  2. Search for gateway in the Windows Start Menu and open ZappySys Data Gateway Configuration:

    Open ZappySys Data Gateway Service Manager
  3. Go to the Users tab and follow these steps to add a Data Gateway user:

    • Click the Add button
    • In the Login field enter a username, e.g., john
    • Then enter a Password
    • Check the Is Administrator checkbox
    • Click OK to save
    Data Gateway - Add User
  4. Now we are ready to add a data source:

    • Click the Add button
    • Give the Data source a name (have it handy for later)
    • Then select Native - ZappySys API Driver
    • Finally, click OK
    AsanaDSN
    ZappySys API Driver
    Data Gateway - Add data source
  5. When the Configuration window appears give your data source a name if you haven't done that already, then select "Asana" from the list of Popular Connectors. If "Asana" is not present in the list, then click "Search Online" and download it. Then set the path to the location where you downloaded it. Finally, click Continue >> to proceed with configuring the DSN:

    AsanaDSN
    Asana
    ODBC DSN Template Selection
  6. Now it's time to configure the Connection Manager. Select Authentication Type, e.g. Token Authentication. Then select API Base URL (in most cases, the default one is the right one). More info is available in the Authentication section.

    Asana authentication
    Here is how to obtain a Personal Access Token (PAT) in Asana:
    1. Open My apps in Asana portal and click Create new token button: Create Personal Access Token in Asana
    2. Once a popup opens, name your new token: Name Personal Access Token in Asana
    3. Then click Copy button to copy the token: Use Personal Access Token to get Asana data via REST API
    4. Now go to SSIS package or ODBC data source and use this token in Personal Access Token authentication configuration.
    5. Choose Default Workspace and Default Project to work with.
    6. Click Test Connection to confirm the connection is working.
    7. Done! Now you are ready to use Asana Connector!
    API Connection Manager configuration

    Just perform these simple steps to finish authentication configuration:

    1. Set Authentication Type to Personal Access Token [Http]
    2. Optional step. Modify API Base URL if needed (in most cases default will work).
    3. Fill in all the required parameters and set optional parameters if needed.
    4. Finally, hit OK button:
    AsanaDSN
    Asana
    Personal Access Token [Http]
    https://app.asana.com/api/1.0
    Required Parameters
    Enter Token (Personal Access Token - PAT) Fill-in the parameter...
    Default Workspace Fill-in the parameter...
    Default Project Fill-in the parameter...
    Optional Parameters
    RetryMode RetryWhenStatusCodeMatch
    RetryStatusCodeList 429
    RetryCountMax 5
    RetryMultiplyWaitTime True
    ODBC DSN HTTP Connection Configuration
    Asana authentication
    Here is how to register an OAuth app in Asana:
    1. Open My apps in Asana portal and click Create new app button: Create new OAuth app in Asana
    2. Once a popup opens, name your app and check two options, and click Create app button: Name OAuth app in Asana
    3. Then copy Client ID and Client secret and save them in a file (we will need them for authentication): Use OAuth app to get Asana data via REST API
    4. Continue by selecting OAuth menu item on your left and click Add redirect URL button (you can have your own or use https://zappysys.com/oauth): Add redirect URL to Asana OAuth app
    5. Proceed by clicking on the Manage distribution section on your left.
    6. Then specify workspaces your app needs to access (use Any workspace to access them all): Choose distribution method in Asana OAuth app
    7. Once you do that, click Save changes button.
    8. Now go to SSIS package or ODBC data source and use Client ID, Client Secret, and Redirect URL in OAuth app authentication configuration.
    9. When you are done with that, click Generate Token button to generate Access and Refresh Tokens.
    10. Choose Default Workspace and Default Project to work with.
    11. Click Test Connection to confirm the connection is working.
    12. Done! Now you are ready to use Asana Connector!
    API Connection Manager configuration

    Just perform these simple steps to finish authentication configuration:

    1. Set Authentication Type to OAuth app [OAuth]
    2. Optional step. Modify API Base URL if needed (in most cases default will work).
    3. Fill in all the required parameters and set optional parameters if needed.
    4. Press Generate Token button to generate the tokens.
    5. Finally, hit OK button:
    AsanaDSN
    Asana
    OAuth app [OAuth]
    https://app.asana.com/api/1.0
    Required Parameters
    ClientId Fill-in the parameter...
    Client Secret Fill-in the parameter...
    Default Workspace (** Select after Token is generated **) Fill-in the parameter...
    Default Project (** Select after Token is generated **) Fill-in the parameter...
    Optional Parameters
    Permissions default
    Redirect URL https://zappysys.com/oauth
    RetryMode RetryWhenStatusCodeMatch
    RetryStatusCodeList 429
    RetryCountMax 5
    RetryMultiplyWaitTime True
    ODBC DSN OAuth Connection Configuration

  7. Once the data source connection has been configured, it's time to configure the SQL query. Select the Preview tab and then click Query Builder button to configure the SQL query:

    ZappySys API Driver - Asana
    Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required.
    AsanaDSN
    Open Query Builder in API ODBC Driver to read and write data to REST API
  8. Start by selecting the Table or Endpoint you are interested in and then configure the parameters. This will generate a query that we will use in SSRS to retrieve data from Asana. Hit OK button to use this query in the next step.

    SELECT * FROM Workspaces
    Configure table/endpoint parameters in ODBC data source based on API Driver
    Some parameters configured in this window will be passed to the Asana API, e.g. filtering parameters. It means that filtering will be done on the server side (instead of the client side), enabling you to get only the meaningful data much faster.
  9. Now hit Preview Data button to preview the data using the generated SQL query. If you are satisfied with the result, use this query in SSRS:

    ZappySys API Driver - Asana
    Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required.
    AsanaDSN
    SELECT * FROM Workspaces
    API ODBC Driver-based data source data preview
    You can also access data quickly from the tables dropdown by selecting <Select table>.
    A WHERE clause, LIMIT keyword will be performed on the client side, meaning that the whole result set will be retrieved from the Asana API first, and only then the filtering will be applied to the data. If possible, it is recommended to use parameters in Query Builder to filter the data on the server side (in Asana servers).
  10. Click OK to finish creating the data source.

  11. Once done, go to the Network Settings tab and Add a firewall rule for inbound traffic:

    Data Gateway - Add firewall rule for inbound connections
    • This will initially allow all inbound traffic.
    • Click Edit IP filters to restrict access to specific IP addresses or ranges.
  12. Crucial Step: After creating or modifying the data source, you must:

    • Click the Save button to persist your changes.
    • Hit Yes when prompted to restart the Data Gateway service.

    This ensures all changes are properly applied:

    ZappySys Data Gateway - Save Changes
    Skipping this step may cause the new settings to fail, preventing you from connecting to the data source.

Read data in SSRS from ZappySys Data Gateway

  1. Open Visual Studio and create a new SSRS project.

  2. Then add a new Shared Data Source (you can create a non-shared data source inside report too):

    Adding a Data Source in SSRS project
  3. Continue with creating the Shared Data Source. Select Microsoft SQL Server as Type and hit Build button to proceed further:

    Configuring a Data Source to access API data in SSRS project
  4. Once a window opens, configure it similarly. Configure "AsanaDSN" as database name. Finally, hit Test Connection and OK:

    AsanaDSN
    Configuring thoroughly a Data Source to access API data in SSRS project
  5. Another window opens, and it should look similarly to this one below which ends the creation of a Data Source:

    DataSource=localhost,5000;Initial Catalog=AsanaDSN
    How Data Source in SSRS project looks like
  6. Now it's time to create a Dataset. If you don't have a report created, in one of the wizard's steps it will look like this:

    SELECT * FROM Workspaces
    Specifying a query in SSRS Dataset to access API data #1
  7. Finally, once you complete the report, similar results will show up:

    ZappySys Data Gateway API data source results

Passing Parameters to SSRS Report / Filter data

If you want to parameterize your report, then refer to this article

Supported Asana Connector actions

Got a specific use case in mind? We've mapped out exactly how to perform a variety of essential Asana operations directly in SSRS, so you don't have to figure out the setup from scratch. Check out the step-by-step guides below:

Conclusion

In this article we showed you how to connect to Asana in SSRS and integrate data without writing complex code — all of this was powered by Asana ODBC Driver.

Download ODBC PowerPack now or ping us via chat if you have any questions or are looking for a specific feature (you can also reach out to us by submitting a ticket):

Explore SSRS connectors

All
Big Data & NoSQL
Database
CRM & ERP
Marketing
Collaboration
Cloud Storage
Reporting
Commerce
API & Files

More Asana integrations

All
Data Integration
Database
BI & Reporting
Productivity
Programming Languages
Automation & Scripting
ODBC applications