# Epic JIM-55 - Support advanced custom fields migration

Project: Stream Jira to OpenProject data Migrator
Status: new
URL: https://community.openproject.org/work_packages/JIM-55

## Detailed specification

### Motivation and background information

### Acceptance criteria

### Out of scope

| Attribute | Value |
| --- | --- |
| Mockups |  |

## Planning

| Attribute | Value |
| --- | --- |
| Roadmap | 2027 Q1 |
| Date |  |
| Votes |  |
| List | RM Jira Migrator, RM Jira exit |
| Target versions | 18.1.0 |
| Sprint |  |
| Backlog bucket |  |
| Relevance | Showstopper — Go-Live Blocker |

## Subitems

| ID | Type | Subject | Status | Assignee | Target versions | Project | Priority | Spent time |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| JIM-72 | Feature | Custom field of type array of Boolean | new |  |  | Stream Jira to OpenProject data Migrator | Medium |  |
| JIM-73 | Feature | Mapping option for users to specify the format of Jira Multiline Custom Field | new |  |  | Stream Jira to OpenProject data Migrator | Medium |  |
| JIM-74 | Feature | Custom field of type array of Radio buttons | new |  |  | Stream Jira to OpenProject data Migrator | Medium |  |
| JIM-110 | Feature | Migration of custom fields of type checklist | needs clarification |  |  | Stream Jira to OpenProject data Migrator | High |  |
| JIM-211 | Open Point | How to migrate custom field field context | new |  |  | Stream Jira to OpenProject data Migrator | Medium |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Module |
| --- | --- | --- | --- | --- | --- | --- |
| JIM-211 | Open Point | How to migrate custom field field context | new |  |  |  |

## Details

| Attribute | Value |
| --- | --- |
| Module | Integrations / Jira |
| Enterprise plan | Community (COM) |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Wieland Lindenthal |
| Product manager | Kristine Jetzke |
| Feature Lead |  |
| Designer | Marc Alcobé |
| Developers | OP Dev Pro Team |
| Requested by |  |
| Interest by | Home (224196000003952096) |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work | · Σ 40d 0h |

## Description

### **Exact mappings still need to be defined.**

Some are easy to migrate. Others don't, because OpenProject side does not have it implemented yet.

**Technical notes**

Basic fields are already migrated in <mention class="mention" data-id="73147" data-type="work_package" data-text="###73147">\#\#\#73147</mention> 

**Partial data migration**:

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table">
<thead class="op-uc-table--head"><tr class="op-uc-table--row">
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Jira field type</p></th>
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Jira CF schema</p></th>
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Possible OP target</p></th>
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Notes</p></th>
</tr></thead>
<tbody>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">User Picker (single user)</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "user"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:userpicker"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">user</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">project members are already migrated in <mention class="mention" data-id="73147" data-type="work_package" data-text="#73147"><mention class="mention" data-id="73147" data-type="work_package" data-text="#73147">#73147</mention></mention> </p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell" style="border-bottom:1px solid rgba(9, 30, 66, 0.14);padding:7px 10px;vertical-align:top;"><p class="op-uc-p">User Picker (multiple users)</p></td>
<td class="op-uc-table--cell" style="border-bottom:1px solid rgba(9, 30, 66, 0.14);padding:7px 10px;vertical-align:top;"><p class="op-uc-p"><code class="op-uc-code">"type": "array"</code><br><code class="op-uc-code">"items": "user"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiuserpicker"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">user</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">project members are already migrated in <mention class="mention" data-id="73147" data-type="work_package" data-text="#73147"><mention class="mention" data-id="73147" data-type="work_package" data-text="#73147">#73147</mention></mention> </p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Labels</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "array"</code><br><code class="op-uc-code">"items": "string"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:labels"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">list</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">- Currently imported as a list custom field<br>- Allows users to either select <br>  from an existing label or create new ones</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Radio Buttons</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "option"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">list</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><mention class="mention" data-id="73956" data-type="work_package" data-text="#73956"><mention class="mention" data-id="73956" data-type="work_package" data-text="#73956">#73956</mention></mention> <br>- Currently imported as a single select list</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Radio Buttons</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "option"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">list</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><mention class="mention" data-id="73956" data-type="work_package" data-text="#73956"><mention class="mention" data-id="73956" data-type="work_package" data-text="#73956">#73956</mention></mention> <br>- Currently imported as a single select list</p></td>
</tr>
</tbody>
</table></figure>

**Currently, no matching custom field type available on OpenProject side:**

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table">
<thead class="op-uc-table--head"><tr class="op-uc-table--row">
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Jira field type</p></th>
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Example Jira CF</p></th>
<th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Notes</p></th>
</tr></thead>
<tbody>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Date Time Picker</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "datetime"</code><br><code class="op-uc-code">"custom": "com.atlassian.jira.plugin.system.customfieldtypes:datetime"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><mention class="mention" data-id="32646" data-type="work_package" data-text="#32646"><mention class="mention" data-id="32646" data-type="work_package" data-text="#32646">#32646</mention></mention>  <br> </p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell">
<p class="op-uc-p">Customer Request Type</p>
<p class="op-uc-p"><br data-cke-filler="true"></p>
</td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "sd-customerrequesttype"</code><br><code class="op-uc-code">"custom": "com.atlassian.servicedesk:vp-origin"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Template Type</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "any"</code><br><code class="op-uc-code">"custom": "com.intenso.jira.issue-templates:issue-templates-customfield"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Epic Link</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "any"</code><br><code class="op-uc-code">"custom": "com.pyxis.greenhopper.jira:gh-epic-link"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Rank</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">"type": "any"</code><br><code class="op-uc-code">"custom": "com.pyxis.greenhopper.jira:gh-lexo-rank"</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Components</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">components</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Group picker (single or multi-select)</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">multi-grouppicker</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">allows users to select groups defined<br> in the Atlassian administration Directory</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Space picker</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">unlike the Parent field which associates<br> work to a space, this field creates a label<br> using a space name</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Assets</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">commonly used in Jira Service Management spaces. <br>More about setting up Asset fields</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p">Team</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">allows you to select Atlassian Teams in your site</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">version</code> single</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">version-picker</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">Do we create versions? Those will be global</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">array</code> of <code class="op-uc-code">version</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">array</code> of <code class="op-uc-code">version</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">array</code> of <code class="op-uc-code">issuelink</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">issuelinks</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><br data-cke-filler="true"></p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">any</code> — sprint</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">gh-sprint</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">State, board, date info</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">any</code> — epic link</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">gh-epic-link</code></p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">(issue key, e.g. <code class="op-uc-code">PROJ-42</code>)</p></td>
</tr>
<tr class="op-uc-table--row">
<td class="op-uc-table--cell"><p class="op-uc-p"><code class="op-uc-code">any</code> — unknown plugins</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">Various Atlassian plugins</p></td>
<td class="op-uc-table--cell"><p class="op-uc-p">Produces raw JSON string dump</p></td>
</tr>
</tbody>
</table></figure>
