Knowledge Base

Jira / Azure DevOps Integration

The Celoxis - JIRA or Celoxis - Azure DevOps integration allows you to seamlessly sync data between Celoxis and your work management tool, ensuring that your project management and issue-tracking workflows are in sync.

The different Issue types in JIRA/DevOps will be created as Tasks in Celoxis.

This integration enables you to leverage the strengths of both platforms, enhancing collaboration and productivity within your team.

Prerequisites

Before you begin the integration process, ensure that you have the following prerequisites:

• Administrative privileges in Celoxis to configure the integration.
• Understanding of your project KEY that needs to be synced into Celoxis.

Integration Steps

Follow these steps to integrate Celoxis with JIRA:

1. Setup the Integration

   1. Log in to your Celoxis account.
   2. Navigate to Admin > Integrations.
   3. Click on the JIRA or DevOps tab as you need and check the Enable box.
      • Jira
      • Azure Devops
      1. Under the URL: Enter the URL of your JIRA instance.
      2. Under Username, enter the username of email address of the user who has access to the projects to be synced.
      3. Under API Token, paste the token that you generated in JIRA. For details on API Token, refer here.

      1. Under REST API EndPoint Base URL: Enter the URL of your DevOps instance.
      2. Under PAT, paste the token you generated in DevOps. For steps, refer here.
   4. If you use Story Points in JIRA for estimation, you need to enter the equivalent hour's conversion under 1 Story Point = ? Effort Hours. Celoxis will then populate the Planned Effort field against the task.
   5. However, if you use the Original Estimate field in JIRA/DevOps, you can check the Prefer original estimate over the story points checkbox so that the Planned Effort = Original Estimate.
   6. Under the Timecode drop-down, select the Activity Code that will be used to submit the Worklog time entries against the task.
   7. Once done, click on Save.

2. Steps in JIRA / Azure DevOps:

   You only need to know the project key for JIRA or the Project Name for DevOps, which will be mapped to the respective projects in Celoxis.

3. Mapping your project in Celoxis:

   1. When creating or editing the project, navigate to the Advanced tab.
   2. Scroll down till you see the INTEGRATION section.
   3. Select Jira/Devops under the first dropdown and then proceed to enter the project key from JIRA here. If you have integrated with DevOps, the project name needs to be entered here.
      
   4. Click on Save.
   5. Now, navigate to the Gantt of the project, where you will see the Sync with Jira or Sync with DevOps button on the toolbar depending on the integration setup.
   6. Click this to fetch all the issues in Celoxis.
   7. Whenever changes are made in Jira/DevOps, and you need to see the latest updates, click this button.

How It Works

The integration works by establishing a connection between the two platforms and automatically syncing data based on the mapping configuration.

• Jira
• Azure Devops

When an addition/change is made in JIRA/DevOps against any of the fields mentioned above, the integration automatically updates the corresponding fields in Celoxis only after you click on the Sync..button.

Benefits of Integration

1. Reduced Manual Work: Automatically create Celoxis tasks for new Jira issues, eliminating duplicate data entry.
2. Improved Resource Management: Visualize team workload across Celoxis and Jira for better resource allocation. This helps with project prioritization and managing a balanced workload.
3. Streamlined Release Management: Visualize your sprint delivery to track deliverables and get clarity of the delivery process.
4. Track Plan vs. Actual: With Worklogs data synced in, you get transparency between the Plan and Actual Effort to track efficiency.
5. Enhanced Visibility: Maintain a single source of truth for your leadership to track status and understand the overall progress across sprints.