The tap-asana Meltano extractor pulls data from Asana that can then be sent to a destination using a loader.

Alternative variants #

Multiple variants of tap-asana are available. This document describes the default singer-io variant, which is recommended for new users.

Alternative variants are:

Getting Started #

Prerequisites #

If you haven't already, follow the initial steps of the Getting Started guide:

  1. Install Meltano
  2. Create your Meltano project

Installation and configuration #

  1. Add the tap-asana extractor to your project using meltano add : 

    meltano add extractor tap-asana
  2. Configure the settings below using meltano config .

Next steps #

Follow the remaining steps of the Getting Started guide:

  1. Select entities and attributes to extract
  2. Add a loader to send data to a destination
  3. Run a data integration (EL) pipeline
If you run into any issues, learn how to get help.

Capabilities #

Settings #

The settings for extractor tap-asana that are known to Meltano are documented below. To quickly find the setting you're looking for, use the Table of Contents at the top of the page.

client_id #

Client Id for your application from Asana

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set client_id <client_id>

export TAP_ASANA_CLIENT_ID=<client_id>

client_secret #

Client Secret for your application from Asana

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set client_secret <client_secret>

export TAP_ASANA_CLIENT_SECRET=<client_secret>

redirect_uri #

The redirect URI for oauth flow completion, this is provided by Asana during oauth setup

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set redirect_uri <redirect_uri>

export TAP_ASANA_REDIRECT_URI=<redirect_uri>

refresh_token #

Full instructions for how to generate client credentials and subsequently the refresh token via curl or postman here https://developers.asana.com/docs/oauth

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set refresh_token <refresh_token>

export TAP_ASANA_REFRESH_TOKEN=<refresh_token>

start_date #

The date from which to start syncing records

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set start_date YYYY-MM-DDTHH:MM:SSZ

export TAP_ASANA_START_DATE=YYYY-MM-DDTHH:MM:SSZ

request_timeout #

The timeout in seconds for a request to the Asana API

How to use #

Manage this setting using meltano config or an environment variable: 

meltano config tap-asana set request_timeout 30

export TAP_ASANA_REQUEST_TIMEOUT=30

Looking for help? #

If you're having trouble getting the tap-asana extractor to work, look for an existing issue in its repository, file a new issue, or join the Meltano Slack community and ask for help in the #plugins-general channel.

Found an issue on this page? #

This page is generated from a YAML file that you can contribute changes to. Edit it on GitHub!