Asana Connector for SSIS : Make generic REST API request (bulk write)

Video tutorial

Watch this quick video to see the integration in action. It walks you through the end-to-end setup, including:

• Installing the SSIS PowerPack
• Configuring a secure connection to Asana
• Working with Asana data directly inside SSIS
• Exploring advanced API Source features

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

Prerequisites

Before we begin, make sure the following prerequisites are met:

1. SQL Server Data Tools (SSDT) designer installed for Visual Studio.
2. SQL Server Integration Services Projects 2022+ Visual Studio extension installed.
3. SSIS PowerPack is installed.

Make generic REST API request in SSIS

1. Open Visual Studio and click Create a new project.

2. Select Integration Services Project. Enter a name and location for your project, then click OK.

3. From the SSIS Toolbox, drag and drop a Data Flow Task onto the Control Flow surface, and double-click it:

   

4. Make sure you are in the Data Flow Task designer:

   

5. Read the data from the source, using any desired source component. You can even make an API call using the ZappySys JSON/XML/API Source and read data from there. In this example, we will use an OLE DB Source component to read real-time data from a SQL Server database.

6. From the SSIS Toolbox drag and drop API Destination (Predefined Templates) on the Data Flow Designer surface and connect source component with it, and double click to edit it.
   

7. Select New Connection to create a new connection:
   

   API Destination - Asana

   Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required.

   

8. To configure the Asana connector, choose one of the following methods:

   • Choose from Popular Connector List: Select a pre-installed service directly from the dropdown menu.
   • Search Online: Use this to find and download a new connector file to your computer.
   • Use Saved/Downloaded File: Once the file is downloaded, browse your local drive to load it into the configuration.

   After that, just click Continue >>:

   Asana

   

9. Proceed with selecting the desired Authentication Type. Then select API Base URL (in most cases default one is the right one). Finally, fill in all the required parameters and set optional parameters if needed. You may press a link Steps to Configure which will help set certain parameters. More info is available in Authentication section.

   Personal Access Token

   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:
   2. Once a popup opens, name your new token:
   3. Then click Copy button to copy the token:
   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:

   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

   

   Find full details in the Asana Connector authentication reference.

   OAuth app

   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:
   2. Once a popup opens, name your app and check two options, and click Create app button:
   3. Then copy Client ID and Client secret and save them in a file (we will need them for authentication):
   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):
   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):
   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:

   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

   

   Find full details in the Asana Connector authentication reference.

10. Select Generic Table (Bulk Read / Write) table from the dropdown, then select Insert, Update as operation, and hit Preview Data:

    

    API Destination - Asana

    Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required.

    Asana

    Generic Table (Bulk Read / Write)

    Insert, Update

    Required Parameters
    Url	Fill-in the parameter...
    Request Method	Fill-in the parameter...
    Optional Parameters
    IsMultiPart
    Filter
    Request Format (Content-Type)	Default
    Body	{$rows$}
    JsonOutputFormat	Multicontent
    DoNotOutputNullProperty
    Batch Size (Default=1)	1
    Meta Detection Order	StaticDynamicVirtual
    Input Columns - For Mapping (e.g. MyCol1:string(10); MyCol2:int32 ...) - Use bool, int32, int64, datetime, decimal, double
    Output Columns (e.g. MyCol1:string(10); MyCol2:int32 ...) - Use bool, int32, int64, datetime, decimal, double
    Request Format
    Response Format	Default
    Headers	Accept: */* || Cache-Control: no-cache
    Csv - Column Delimiter	,
    Csv - Row Delimiter	{NEWLINE}
    Csv - Quote Around Value	True
    Csv - Always Quote regardless type
    Encoding
    CharacterSet
    Writer DateTime Format
    Csv - Has Header Row	True
    Xml - ElementsToTreatAsArray
    Layout Map	<?xml version="1.0" encoding="utf-8"?> <!-- Example#1: Output all columns --> <settings> <dataset id="root" main="True" readfrominput="True" /> <map src="*" /> </settings> <!-- Example#2: Records under array <?xml version="1.0" encoding="utf-8"?> <settings singledataset="True"> <dataset id="root" main="True" readfrominput="True" /> <map name="MyArray" dataset="root" maptype="DocArray"> <map src="OrderID" name="OrderID" /> <map src="OrderDate" name="OrderDate" /> </map> </settings> --> <!-- Example#3: Records under nested section <?xml version="1.0" encoding="utf-8"?> <settings> <dataset id="dsRoot" main="True" readfrominput="True" /> <map name="NestedSection"> <map src="OrderID" name="OrderID_MyLabel" /> <map src="OrderDate" name="OrderDate_MyLabel" /> </map> </settings> -->

    

11. Finally, map the desired columns:

    API Destination - Asana

    Read and write Asana data effortlessly. Integrate, manage, and automate tasks, projects, workspaces, and time entries — almost no coding required.

    

12. That's it; we successfully configured the POST API Call. In a few clicks we configured the Asana API call using ZappySys Asana Connector

    

Asana Connector actions

Need another use case? Pick the next Asana action in SSIS below.

• Download Attachment
• Download Multiple Attachments
• Get Allocations
• Get Attachments (For Project refer to Key-Resources Upload only)
• Get Goals
• Get Memberships
• Get Portfolio Custom Fields
• Get Portfolios
• Get Project (Single)
• Get Project Custom Fields
• Get Project Section
• Get Project Sections
• Get Projects
• Get Sub Tasks
• Get Tags
• Get Task (Single)
• Get Tasks
• Get Time Tracking Entries
• Get User (Single)
• Get User Task Lists
• Get Users
• Get Workspace (Single)
• Get Workspace Custom Fields
• Get Workspace Tasks
• Get Workspace Teams
• Get Workspaces
• Search Tasks (Advanced Filter)
• Make Generic REST API Request

Conclusion

You now know how to make generic REST API request (bulk write) in SSIS without writing complex code. Asana Connector handled pagination and authentication automatically.

Ready to get started? Download the trial or ping us via chat if you need help: