Jira Integration

Jira Integration #

With the Jira Integration, Project Managers create a connection between Jira and LiquidPlanner, which pulls Jira Projects into the Scheduled Collection for prioritization, forecasting, and scenario modeling. The scheduling algorithm uses the Jira Time Remaining field to calculate start and finish dates in LiquidPlanner. Once the schedule has been calculated, the integration returns the most up-to-date project planning information to Jira through a manual sync.

To pull in a project with the Jira Integration, navigate to Projects in the left-side navigation. This takes you to Portfolio View in the Scheduled Collection. Projects are added to Packages in this view. Use the toggle to expand a Package.

Select the Add Project field to activate the Add Jira Project button. Project Manager access or above is needed in order to create projects through the integration. The Add Jira Project button opens the integration window where you establish the connection between LiquidPlanner and any of your Jira instances.

Through the course of the integration, you’ll be prompted to customize the project set up through filtering and field mapping. When that is completed, each of the incoming issues will be transformed into LiquidPlanner tasks with default attributes applied.

Additionally, the project folder in LiquidPlanner will have a custom project data field for Project Lead that maps to the corresponding field on the Jira Project.

The assignee in Jira will map to a Member or Resource in LiquidPlanner. Resources will be created on your behalf for all Assignable Users in the Jira project if they don’t already exist in LiquidPlanner.

Visit Administration in the left-side navigation to view the number of Resources available and make sure you have enough to complete the project integration. Use the Support & Feedback link in the user menu to request more Resources.

At the Instance and Credentials step, you have the option to add a new instance or connect to one that you had previously selected. You will always need to provide an email address to pull a project in from Jira.

• +New Instance: Connect to your Jira account and choose a new instance. An authorization window will open requesting access to your Atlassian account. Choose your account and select Accept.
• Email Provided: Choose the email address that established the connection.
• Available Jira Instance: If you have previously integrated then those instances will be listed here.

After connecting to the Jira instance you’re ready to choose a project from the drop down menu under Jira Project. The list will include all of the projects that you have access to in the connected Jira instance. Once the project is selected, you can set up the filters for issue type, issue status and created date.

The Issue Count in the lower left corner tells you the number of Jira issues that will come in as LiquidPlanner tasks when set up is complete. The User Count shows you a count of how many new users will be pulled in when set up is complete.

Use the “Next” button to save the filters and move to the next step.

In Sync Settings, choose your preferred option from the Pull Worklogs drop-down. The following options are available and will vary depending on your instance:

• Do Not Pull any Worklogs: No Worklogs (Time Entries) are pulled into LiquidPlanner.
• Pull from Jira:  Pull Worklogs (Time Entries) from Jira into LiquidPlanner.
• Pull from Tempo Timesheets: Pull Tempo Timesheet entries into LiquidPlanner. This option only displays if Tempo Timesheets is installed on your instance.
• Cost Code: Select a cost code that is applied to Jira time entries in the selected project. This option only displays after you select to pull from either Jira or Tempo Timesheets. Note: After you select a cost code and complete the integration, you cannot change the cost code.

In addition to the attributes that are applied automatically through the integration process there are optional fields that can be mapped through this step.

Select +Jira Field to add additional Jira fields that you would like to map to LiquidPlanner. Select +LiquidPlanner Field to add additional LiquidPlanner fields that you would like to map to LiquidPlanner.

If you choose to pull the issue Due Date from Jira, it can be mapped to either a custom date field that you have created, or to the Target Finish date, which is the deadline in LiquidPlanner. The benefit of mapping to Target Finish is that you will be alerted if you are at risk of missing the Jira Due Date. Learn more about Target Dates and alerting in the Academy. You can also select Enable Two-Way Sync to create a two-way sync between the Jira Due Date and the LiquidPlanner Finish Date.

The remaining options are LiquidPlanner system fields that can be pushed back into Jira custom fields. They can be mapped to existing fields in your project, or you can create new ones for this integration.

• Target Finish is the deadline date in LiquidPlanner. Work can Keep Scheduling past this date or Stop Scheduling. When the Expected Finish is after a Target Finish, schedule bars turn red and alerts identify work that has Schedule Risk.
• Target Start is the date you would like to begin. It could start later, based on the status of higher priority work.
• Expected Start: when you are most likely to begin, based on the status of higher priority work (calculated by the scheduling engine).
• Expected Finish: the date you’re working toward, the likely finish date (calculated by the scheduling engine).
• Latest Finish: how long it could take if worst case estimates comes into play (calculated by the scheduling engine).

When mapping is complete, Next will take you to Remaining Estimates where you will establish the formula for converting Jira’s Time Remaining field into a ranged estimate for the scheduling algorithm.

LiquidPlanner uses ranged estimates to statistically calculate your project schedule. Ranged estimates provide a natural way to account for the uncertainty and incorporate it into your plans for a more realistic forecast. In this step you’ll provide a percentage value which will be used to calculate the low and high estimate from the Jira “Time remaining” field.

For example, if “Time remaining” is 100h, 20% would set the range at 80h – 120h.

Learn more in the Remaining Estimate video in the Academy.

At this last step, Launch closes the integration window and creates a new project instantly, with tasks generated shortly after the sync completes. You may navigate away from the project while the sync is in progress.

When a project has been pulled in from Jira, it can be synced and modified through the drop down menu under the Jira Integration button.

• Sync Both Ways: Pull in the latest Jira updates, including new issues, and send LiquidPlanner schedule data back into the Jira Project. Specific updates that can be sent back to Jira include a task status change, re-assignments from one person to another, task priority position (overrides Jira issue rank) and Priority custom fields.
• One Way Sync From Jira: Select to only pull in data from Jira. This sync is recommended if you want to work with the latest data from Jira in LiquidPlanner without sending anything back to your Jira project.
• Modify Setup: this link takes you back to integration setup window where you can edit filters, mapping and remaining estimate calculations. Changes take effect the next time you sync.
• Alerts: You will be alerted when there are sync errors. A few of the more common errors are listed below.
  • The workspace doesn’t have enough Resources for Assignable Users in Jira.
  • The issue was deleted in Jira, and a task still exists in LiquidPlanner.
  • Authentication failed due to invalid credentials.

Important: After you log work in LiquidPlanner and perform a two-way sync, you may experience your Latest Finish dates changing for some tasks on each sync. This behavior is expected because time tracking and estimate data are always a one-way pull from Jira into LP.

By selecting a task on the list and visiting the Properties, you can view additional data that was pulled in from Jira. You can view the Issue Key and select it to open the issue directly in Jira. Additional information includes the Project Name, Issue Type, Priority, and Epic fields.