/
Migrate from Easy Links for Jira

Migrate from Easy Links for Jira

You you must install My JQL Fields & Functions version 25.1.15 or later and activate license for it. If you have any questions, please reach out to our support team at https://addonix.atlassian.net/servicedesk/customer/portals.

Migrate Custom Fields

  1. Open Custom Fields page - /secure/admin/ViewCustomFields.jspa

  2. Filter by type like this:

    image-20250224-120101.png

  3. Call REST API to create new custom fields.

GET https://{jira.domain}/rest/jqlfields/1.0/easylinks/migrate/cf

  1. After that actions you will created custom fields with the same names and contexts:

    image-20250224-120153.png

Migrate Plugin config for Custom Fields

  1. Check configs for JQL Fields:

    • Linker - /secure/JqlLinkerFieldsConfiguration.jspa

    • Multi Linker - /secure/JqlMultiLinkerFieldsConfiguration.jspa

  2. To Copy configs from Easy Links call REST API:

GET https://{jira.domain}/rest/jqlfields/1.0/easylinks/migrate/config

  1. Check JQL Fields config again.

Migrate Screens for Custom Fields

  1. If all previous steps success now you can migrate Screens for Customs Fields.

  2. This action replace old Easy Links fields with new one for JQL Fields.

  3. Call REST API:

GET https://{jira.domain}/rest/jqlfields/1.0/easylinks/migrate/screens

  1. Check Field Screens on Custom Fields page - /secure/admin/ViewCustomFields.jspa

  2. For all Easy Links fields screens count must be equals 0.

Migrate Custom Field Values

  1. Now you can copy values from Easy Links fields to JQL Fields.

  2. Call REST API.

GET https://{jira.domain}/rest/jqlfields/1.0/easylinks/migrate/values

  1. This action can continue for a long time. Depends on the number of tasks with non-empty Easy Links field values. For 10к issues with non-empty Easy Links fields it takes about 5 minutes.