Jira Integration


In many organizations, Jira is still the key software for developers, while project managers and PMO want to use a project management software and still have visibility into resource workloads.

With this integration, you will be able to automatically create tasks in Celoxis when issues are created in Jira. Also, when issues are updated in Jira, the corresponding tasks in Celoxis will be automatically updated.

Zapier

Celoxis integrates with Jira and many other apps using Zapier. Zapier is a cloud-based service that allows you to build powerful integrations between different systems without writing code. For more information, visit their website: zapier.com.

Zap

An automation in Zapier is called a zap. A zap connections two apps - a trigger app and an action app. The trigger app notifies the zap about an event and the zap then performs an action in the action app. In our case, the trigger app is Jira because it will notify our zap when an issue is created or updated. The action app, in our case, is Celoxis because that is where our zap will create and update tasks. In this guide, we will be building two zaps:

  • Zap #1 — when an issue is created in Jira, create a task in Celoxis.
  • Zap #2 — when an issue is updated in jira, update the corresponding task in Celoxis.
Let's see how Jira, Zapier and Celoxis all fit together: From the above diagram, you can see that Jira and Celoxis can even be on our intranet provided they have access from the internet. It may be possible to configure internet access only from Zapier.


Zap #1 – New issue in Jira → Create task in Celoxis

  1. Make a Zap
  2. Choose Jira as the Trigger App
  3. Select the "New Issue" jira trigger
  4. Connect with Jira
    If you use Zapier and have connected with Jira, you can use that account. Otherwise, click on Connect an Account to create a new connection with Jira.
  5. Enter Jira credentials
    Notice the forward slash at the end of the Base Url.
  6. Test your newly added connection
    Click on the Test button to verify the validity of the credentials.
  7. You connection is valid
    If invalid, enter the correct details and try again.
  8. Select a Jira project
    Only issues in this project will be monitored by this Zap.
  9. Pick a Jira sample
    Pick a sample issue with the most details. The fields in this sample issue will be helpful later on.
  10. Choose Celoxis as the action app
  11. Select the "Create Task" action
  12. Connect with Celoxis
    Click on Connect an Account to enter your connection details.
  13. Enter your connection details
    Our support team will help you get your access token.
  14. Test the newly added connection
    Click on the Test button to verify the validity of the credentials.
  15. Your connection is valid
    If invalid, enter the correct details and try again.
  16. Map Jira fields to Task fields
    The task that will be created in Celoxis will have fields as per the mapping you set. A sample mapping is shown below. The most important of them is the External Key field. This should be mapped to the Jira Key field. If you do not set this up, the 2nd zap will not work correctly. The rest of the mappings are straghtforward.
  17. Test this Zap
    This will create a task in Celoxis.
  18. Turn this Zap on
After you turn the Zap on, if issues are created in Jira in the project you selected, tasks will automatically be created in Celoxis based on the fields mapped above after 5-15 minutes depending on your plan with Zapier.

  1. Make a Zap
  2. Select Jira as the trigger app
  3. Select the "Updated Issue" Jira trigger
  4. Select Jira account
    If you have more than one connections, use the same account that your created for the first app.
  5. Select Jira project
    Select the same project that you selected in the first zap.
  6. Select Jira sample
    Select a sample issue. Its fields will be used in mapping later on.
  7. Select Celoxis as the action app
  8. Select the "Find Task" action
  9. Select Celoxis account
    Use the same connection that you used in the first zap.
  10. Use External Key
    Map the External Key field to the Jira Key field. This will help the Zap find the corresponding task in Celoxis.
  11. Test the Find Task action
  12. Select Celoxis action app
    Now we will be updating the task in Celoxis.
  13. Select the "Update Task" action
  14. Select Celoxis account
    Use the same connection that you used in the first zap.
  15. Map Fields
    Note how the task field is mapped to use the task found out in the previous step. Rest of the fields are used as a sample.
  16. Test the Zap
  17. Turn the Zap on
Now after an issue has been updated in the project selected in the above Zap, the corresponding task will be updated in Celoxis based on the fields mapped above after 5-15 minutes depending on your plan with Zapier.