Hello everyone, today we present the Asana integration available on our platform: Cenit.io. Asana is a Free Project Management for Teams, designed to enable teamwork without email.
In the video, we will show how to install the Asana collection in our tenant, through the Shared Collection's pull action.
Then we show the created objects in the collection, such as Webhooks, Schemas, Data types and Flows. those elements enable the communication through the Asana API.
At the end will be include working examples too.
1. To access to the tenant in Cenit.io, you should sign in at cenithub.com, which will prompt you for your username and password. If you are not registered, you can create a free account by Signing Up.
2. Click the Data Integrator button, this redirect to Cenit.io, where we can see in the Dashboard the components already installed. Now, proceed to the Shared Collection menu option and list the available integrations. Find and select the Asana-1.0.0 shared collection, now we pull. Remember that you need your credentials from Asana, which means your username and password.
3. After successfully pulled, the Dashboard displays a group of objects that allows us to interact with the service, like Webhooks and Connections.
4. To see the integration schemas installed with Asana, click on on the Schemas Tab, then you’ll see, all the related schemas. For example if we want see the json schema for 'Project'. We need find it and then click on Edit option, now you can see all the attributes and properties of this Asana Project.
5. You can also load the Data Type related to this Project schema. If everything is ok you’ll see a notification that say “project.json loaded” . At the bottom shows Data Type Asana Project, but at the beginning it don't have instances.
6. Another important element that we see are the WebHooks, such as: List User, Create Project, Create Task. These will be our examples with Asana API. To create a Project, you’ll see that used method is by Post.
7. We can see our integration flows. like List Projects, Create Project, Create Task. You’ll notice that the last one has a Export Translator type.
8. To build this integration, we make a few translator like Export Model, that allow you export the Cenit Model to Asana API, another was Update Model and Import List.
Now let us show you some working examples, to take a better idea to this integration with Asana. Go to app.asana.com and set your credentials, username and password. Remember that if you don’t have an account, you need create it.
For the first example 'Create a Task'
Once inside Asana website, we can see at the left side all the created projects list. You’ll notice Test Integration, well this is our project.
Now, we must create a Task from Cenit.io, then send it to Asana. To make this step, we should import a valid json schema for a Task, here one of the most important thing is locate the workspace and task name.
When you select the Basic Json Translator Importer, you notice that appear a new Task in Cenit.io. Now you can send this Task to Asana trough Flow -> Create Task. If we update Asana view and it’ll show the task created with the defined attributes in the json schema.
For the second example 'Create a Project'
In this case Cenit.io will be a bridge, because we’ll use the HttpRequester tool, to send requests to Cenit and it turn send the processed information to Asana. We installed HttpRequester tool, because is a good plugin in Firefox that allows make easy http requests.
Then we must put in the header the X-User-Access-Token and X-User-Access-Key, these are in my Cenit.io account. Don’t forget the Cenit.io url too.
If you remember in the first example, we have only one project named “Test Integration”
Now we must create a new json schema related with the new project, that means with different name, and don’t forget the workspace, for this case we use the workspace in Example 1)
If we update Asana view and it’ll show the project created with the defined attributes in the json schema.
In our last example 'List of Users’
We want that Cenit.io list all the users and check this information with Asana, and for that we use the HttpRequester tool.
That’s all, I hope that you have found interesting and useful this material.
Back to blog Get in touch