Content
View differences
Updated by Andrej Sandorf 28 days ago
### **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** ### Phase 1: Support basic custom fields
Basic fields are already migrated in <mention class="mention" data-id="73147" data-type="work_package" data-text="###73147">###73147</mention> data-text="#73147">#73147</mention> (coming in v17.4.0)
**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 * Text Field (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">#73147</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 line)
* Text Field (multi-line)
* Date 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">#73147</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
* Checkboxes
_as a multi-select 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">#73956</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">#73956</mention> <br>- Currently imported as boolean custom field_
* Radio Buttons
_as a single select list</p></td></tr></tbody></table></figure>
**Currently, no matching list_
* URL Field
* Number Field
* Select List (single choice)
* Select List (multiple choice)
* Select List (cascading)
* User Picker (single user)
_project members only_
* User Picker (multiple users)
_project members only_
### Phase 2: Support advanced custom field type available on OpenProject side:** fields
<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 <mention class="mention" data-id="32646" data-id="74137" data-type="work_package" data-text="#32646">#32646</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 data-text="#74137">#74137</mention>
_Still 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> 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
* Text Field (multi-line)
* Date
* Checkboxes
_as
* Radio Buttons
_as
**Currently, no matching
* URL Field
* Number Field
* Select List (single choice)
* Select List (multiple choice)
* Select List (cascading)
* User Picker (single user)
_project members only_
* User Picker (multiple users)
_project members only_
### Phase 2: Support advanced
<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
_Still