Jira Integration - Projects Field Mappings

This article explains the Jira Projects to OnePlan Plans default field mappings for your integration. 

To complete the Jira integration setup, you must complete:

1. Jira Integration - OnePlan Setup
2. Jira Integration - Jira Setup
3. (You are here) Jira Integration - Epics Field Mappings or Jira Integration - Projects Field Mappings (depending on your integration)
4. Jira Integration - Custom Types Settings
5. Jira Integration - Essential Settings

Check the Field Mappings

After the integration is installed, it is best practice to check the default field mappings for errors or missing mappings. 

After reviewing the field mappings, continue on to Jira Integration - Custom Types Settings.

Integration Information

Functionality

This integration has these main use cases for functionality.

1. Create/Update project in Jira

2. On creation, user is able to select Jira project types

3. Create/Update plan in OnePlan

4. Create/Update backlog in OnePlan from Jira issue types associated with the connected project

5. Issue types synchronized are based on the ones specified in OneConnect

Scheduled Jobs

The following scheduled jobs are installed by default.

1. SynchLookups

   • Synchronize all available Jira Project Types into OnePlan choice fields

2. OnePlanUpdate

   • Create/Update plan in OnePlan

   • Create/Update backlog in OnePlan

3. OnePlanPublish

   • Create/Update project in Jira

Default Fields Created

In OnePlan:

• Jira Project Types

  • Created on the Plan level field and is used for specifying which Jira Project Type to be used when creating project in Jira

  • Type: Choice field

  • SynchJiraProjectTypes will be the job that runs the synchronization to fill out the project types

Default Field Mappings

Plans (OnePlan) <--> Epics (Jira)

OnePlan Fields	Jira Fields
Name	Project Name
Jira Project Names	Project Type
Owner	Lead

Backlog (OnePlan) <--> Issues (Jira)

OnePlan Fields	Jira Fields
Name	Summary
Parent ID (Structure)	Parent Issues ID

Lookup Tables (OnePlan) <--> Project Types

OnePlan Fields	Jira Fields
Jira Project Type (Plan)	Type Name