Use the ScriptRunner Migration Agent

To start, open the ScriptRunner Migration Agent and log in with your Atlassian ID or email.

Analyse a script

You can use the ScriptRunner Migration Agent to convert a Data Center to Cloud script if the feature is supported. When you choose to analyse a script, the ScriptRunner Migration Agent:

Analyses your script.
Determines what is possible in Cloud.
Creates a Cloud script.
Iterate until until no compilation errors remain.

Follow these steps to analyse a script:

Select Analyse a single script.
Copy the script you want to convert.
Paste the script into the script analysis area.
Select Analyse my script.
If a script is produced for you, copy it into your Cloud instance and test to see if it works.

You can come back to the Migration Agent to deal with any error handling.

Note: This process will take time.

Answer queries

You can use the Migration Agent to answer questions about the product. When you send this question, the Migration Agent:

Determines what is possible in Cloud.
Creates a Cloud script.
Iterates until no compilation errors remain.

Note: You can use the Chat section of the Migration Agent to help convert Data Center scripts to Example: Advanced usage/report creation.

Follow these steps to ask the ScriptRunner Migration Agent a question:

Make sure you select the correct platform you wish to discuss with the Migration Agent.
Note: Currenly only Jira is supported.
Enter your query into the chat dialog box and select Send.
See Best Practices for more details on how to write your query.
If a script is produced for you, copy it into your Cloud instance and test to see if it works.

You can come back to the Migration Agent to address any error handling.

Example: Advanced usage/report creation

If you used the Migration Agent to answer multiple queries and create scripts, you can generate a report at the end of the chat process. Use and adapt the following example prompt, then paste it into the chat dialog box to create a detailed report:

Consolidate the outputs of this process in to a single report, you can iterate over this report to produce the highest quality. The different sections should be clearly outlined. Wiki markdown can be used for tables. Use the following sections as a template but add other sections as appropriate. Provide an index at the top to enable quick access to different sections do not use the section numbering below but retain the hierarchy.

1. Migration Analysis Summary
   a. What the original script does
   b. Overview of key migration challenges
   c. Migration strategy
2. Refactored Cloud script as a code block
3. Implementation Guide
   a. Important Notes
      i.   Custom Field IDs
      ii.  JQL Query changes
      iii. Permissions
      iv.  Any other notes or further customisation requirements (eg replacement of unique IDs in the script)
   b. Deployment Steps
   c. Details of any manual adjustments still required
   d. Testing Recommendations
4. Original data centre script as a code block
5. Data Center vs Cloud Migration Comparison
   a. Original Data Center Script Issues
   b. Key Improvements in Cloud Version
   c. Migration Benefits
6. Key changes Made
   a. Removed Data Center Dependencies and where have HAPI Methods been used
   b. Improved Error Handling
   c. Automatic Benefits
   d. Before vs After Comparison
7. Optional Enhancements