Jira Integration - Epics Field Mappings

This article explains the Jira Epics 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

The following video walks though the default field mappings for the Jira Epics and OnePlan Plans integration.

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 Epic level item type in Jira

2. On creation, user will be required to specify the Project where the epic will belong in Jira

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

   • Used to synchronize “Project Names” and “Jira Issue Priority” as choice values in OnePlan

2. OnePlanUpdate

   • Create/Update plan in OnePlan

   • Create/Update backlog in OnePlan

3. OnePlanPublish

   • Create/Update Epic level item type in Jira

Default Fields Created

In OnePlan:

• Jira Project Names

  • Created on the Plan level field and is used for specifying which Project the plan will belong in Jira (Epic Level)

  • Type: Choice field

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

Default Field Mappings

Plans OnePlan)  Epics (Jira)

OnePlan Fields	Direction	Jira Fields
Name		Summary
Owner		Assignee
Jira Project Names		Project Name (Epic)

Backlog (OnePlan)  Issues (Jira)

OnePlan Fields	Direction	Jira Fields
Name		Summary
Parent ID (Structure)		Parent Issues ID
Item Type		Issue Type
Assigned To		Assignee
Points		Story Points
Iteration (OnePlan System)		Sprint Name (With Board)
Start		Start Date (Sprint)
Due		End Date (Sprint)
Status		Status
Effort		Original Estimate

Lookup Tables (OnePlan)  Lookup Epics

OnePlan Fields	Direction	Jira Fields
Jira Project Names (Plan)		Project Names