Script migration process

The table below outlines the steps to perform automated script migration using a tool such as Jira Cloud Migration Assistant (JCMA) or Configuration Manager for Jira (CMJ).

Step 1: Migrate the Jira instance using a tool	Update the sil.aliases properties file. For details, see SIL aliases. Search code for hard-coded custom field IDs. Convert hard-coded custom field IDs to aliases.
Step 2: Validate post function and Listener scripts	Starting with the post function and listener script types will quickly expose potential major issues. These scripts are more likely to contain project names, issue type names, and other configuration-specific elements that may need to be resolved. Early identification of discrepancies in these names lets you minimize the impact on the project and resolve potential issues that require Jira changes. In SIL Manager, run the syntax check on each script to validate the code. If you discover any name conflicts, use find/replace to search for similar issues across all scripts.
Step 3: Validate Scheduler scripts, Webhooks, SIL Panel, and SIL Runner Gadget scripts	Scripts of these types should migrate easily. Any major issues would have been caught and resolved earlier in the process. In SIL Manager, run the syntax check on each script to validate the code. If you discover any name conflicts, use find/replace to search for similar issues across all scripts.
Step 4: Convert Mail handler scripts	The changes required by mail handler scripts are minor and this conversion effort should be minimal. For details, see the Mail handler scripts section.
Step 5: Convert JQL function scripts	Due to the nature of the changes, JQL scripts require more extensive updates than other script types during migration. SIL provides utility scripts that can help with JQL-related migration in two ways: To scan your existing JQL filters and identify where DC keywords are used that won't work in Jira Cloud. To automatically update those JQL filters to use the Cloud-compatible keywords. For details, see the Scripted JQL functions/keywords section.
Step 6: Convert Live Fields scripts	Live Fields in Jira Cloud uses JavaScript and Atlassian APIs, unlike Data Center, which uses SIL. The cloud version of Live Fields has more limited functionality than the Data Center version. Converting these scripts requires significant work, including developing workarounds where Cloud features are missing. For details, see the Live Fields section.