Asana
Table of Contents
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:
Installation and configuration #
-
Add the
tap-asana
extractor to your project usingmeltano add
:meltano add extractor tap-asana
-
Configure the settings below using
meltano config
.
Next steps #
Follow the remaining steps of the Getting Started guide:
- Select entities and attributes to extract
- Add a loader to send data to a destination
- Run a data integration (EL) pipeline
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
#
-
Environment variable:
TAP_ASANA_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
#
-
Environment variable:
TAP_ASANA_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
#
-
Environment variable:
TAP_ASANA_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
#
-
Environment variable:
TAP_ASANA_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
#
-
Environment variable:
TAP_ASANA_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
#
-
Environment variable:
TAP_ASANA_REQUEST_TIMEOUT
- Default:
30
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!