Usage
To avoid problems, you should divide the migration into single steps. Make sure that proceed the migration in the correct order:
Synchronization of versions and components
Example...{ "configurationName":"My Configuration", "remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteDefaultIssueType":"Support Task", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"project = 'iPad App'", "versionSync":"true", "componentSync":"true", "lastSyncedCommentIdField":"18300", "fieldMappings":[ ], "userMapping":{ "tom.testuser":"abcdef01234567890abcdef0", "michael.manager":"01234567890abcdef0123456" } }
Migration of all Epic issues
Example...{ "configurationName":"My Configuration", "remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"project = 'iPad App'and issuetype = epic", "attachmentSync":"true", "issueSync":"true", "lastSyncedCommentIdField":"18300", "remoteDefaultUserId":"", "remoteDefaultPriority":"3", "remoteDefaultBoard":"14", "remoteDefaultIssueType":"Support Task", "fieldMappings":[ { "localField":"summary", "remoteField":"summary" }, { "localField":"issuetype", "remoteField":"issuetype", "remoteFieldPrefix":null, "applyMap":"issueTypeMapping" }, { "localField":"assignee", "remoteField":"assignee" }, { "localField":"reporter", "remoteField":"reporter" }, { "localField":"description", "remoteField":"description" }, { "localField":"components", "remoteField":"components" }, { "localField":"duedate", "remoteField":"duedate" }, { "localField":"environment", "remoteField":"environment" }, { "localField":"labels", "remoteField":"labels" }, { "localField":"fixVersions", "remoteField":"fixVersions" }, { "localField":"10002", "remoteField":"10043" }, { "localField":"versions", "remoteField":"versions" }, { "localField":"11601", "remoteField":"10086" }, { "localField":"10203", "remoteField":"10010" }, { "localField":"10208", "remoteField":"10087" }, { "localField":"priority", "remoteField":"priority" }, { "localField":"resolution", "remoteField":"resolution" }, { "localField":"key", "remoteField":"10091" } ], "remoteStatusField": "status", "remoteTransitions": { "Open": { "In Progress": "In progress", "Done": "Done", "Po Accepted Story": "Po Accepted Story", "Ready For Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On Hold": "On Hold", "Trash": "Trash", "Open": "Open" } }, "userMapping":{ "tom.testuser":"abcdef01234567890abcdef0", "michael.manager":"01234567890abcdef0123456" }, "priorityMapping":{ "1":"10000", "2":"10001", "3":"10002", "10000":"10003", "4":"10004", "5":"10005", "10100":"2", "10101":"3", "10102":"4", "10200":"10006", "10201":"10007", "10300":"10008" }, "resolutionMapping":{ "6":"10014", "1":"10008", "2":"10009", "3":"10002", "4":"10010", "5":"10004", "7":"10000", "8":"10012", "9":"10013", "10":"10011", "10000":"10001", "10100":"10003" }, "issueTypeMapping":{ "Bug":"Bug", "Task":"Task", "Epic":"Epic", "Story":"Story", "Support Task":"Support Task", "Explo":"Explo" } }
Migration of all non-Epic and non-Subtask issues
Example...{ "configurationName":"My Configuration", "remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"project = 'iPad App' and issuetype != epic and issuetype != Sub-task and project = backend AND reporter in (tom.testuser, michael.manager)", "attachmentSync":"true", "issueSync":"true", "lastSyncedCommentIdField":"18300", "remoteDefaultUserId":"5ce66df727454f0fe4582112", "remoteDefaultPriority":"3", "remoteDefaultBoard":"14", "remoteDefaultIssueType":"Support Task", "fieldMappings":[ { "localField":"summary", "remoteField":"summary" }, { "localField":"issuetype", "remoteField":"issuetype", "remoteFieldPrefix":null, "applyMap":"issueTypeMapping" }, { "localField":"assignee", "remoteField":"assignee" }, { "localField":"reporter", "remoteField":"reporter" }, { "localField":"description", "remoteField":"description" }, { "localField":"components", "remoteField":"components" }, { "localField":"duedate", "remoteField":"duedate" }, { "localField":"environment", "remoteField":"environment" }, { "localField":"labels", "remoteField":"labels" }, { "localField":"fixVersions", "remoteField":"fixVersions" }, { "localField":"10002", "remoteField":"10043" }, { "localField":"versions", "remoteField":"versions" }, { "localField":"11601", "remoteField":"10086" }, { "localField":"10208", "remoteField":"10087" }, { "localField":"priority", "remoteField":"priority" }, { "localField":"resolution", "remoteField":"resolution" }, { "localField":"10201", "remoteField":"10013", "remoteFieldPrefix":null, "applyMap":"epicMapping" }, { "localField":"key", "remoteField":"10091" }, { "localField":"10005", "remoteField":"10018", "remoteFieldPrefix":null, "applyMap":"sprintMapping" } ], "remoteStatusField": "status", "remoteTransitions": { "In progress": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Done": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Po Accepted Story": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Ready For Review": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "In Review": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Rejected": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Blocked": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "On Hold": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Trash": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" }, "Open": { "In Progress": "In progress", "Done": "Done", "PO accepted Story": "Po Accepted Story", "Ready for Review": "Ready For Review", "In Review": "In Review", "Rejected": "Rejected", "Blocked": "Blocked", "On hold": "On Hold", "Trash": "Trash", "Open": "Open" } }, "userMapping":{ "tom.testuser":"abcdef01234567890abcdef0", "michael.manager":"01234567890abcdef0123456" }, "priorityMapping":{ "1":"10000", "2":"10001", "3":"10002", "10000":"10003", "4":"10004", "5":"10005", "10100":"2", "10101":"3", "10102":"4", "10200":"10006", "10201":"10007", "10300":"10008" }, "resolutionMapping":{ "6":"10014", "1":"10008", "2":"10009", "3":"10002", "4":"10010", "5":"10004", "7":"10000", "8":"10012", "9":"10013", "10":"10011", "10000":"10001", "10100":"10003" }, "issueTypeMapping":{ "Bug":"Bug", "Task":"Task", "Epic":"Epic", "Story":"Story", "Support Task":"Support Task", "Explo":"Explo", "Sub-task":"Sub-task" }, "boardMapping":{ "612":"17" } }
Migration of all Subtask issues
Example...{ "configurationName":"My Configuration", "remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"issuetype = Sub-task AND project = 'iPad App' AND reporter in (tom.testuser, michael.manager)", "attachmentSync":"true", "issueSync":"true", "lastSyncedCommentIdField":"18300", "remoteDefaultUserId":"", "remoteDefaultPriority":"3", "remoteDefaultBoard":"14", "remoteDefaultIssueType":"Support Task", "fieldMappings":[ { "localField":"summary", "remoteField":"summary" }, { "localField":"issuetype", "remoteField":"issuetype", "remoteFieldPrefix":null, "applyMap":"issueTypeMapping" }, { "localField":"assignee", "remoteField":"assignee" }, { "localField":"reporter", "remoteField":"reporter" }, { "localField":"description", "remoteField":"description" }, { "localField":"components", "remoteField":"components" }, { "localField":"duedate", "remoteField":"duedate" }, { "localField":"environment", "remoteField":"environment" }, { "localField":"labels", "remoteField":"labels" }, { "localField":"fixVersions", "remoteField":"fixVersions" }, { "localField":"10002", "remoteField":"10043" }, { "localField":"versions", "remoteField":"versions" }, { "localField":"11601", "remoteField":"10086" }, { "localField":"10208", "remoteField":"10087" }, { "localField":"priority", "remoteField":"priority" }, { "localField":"resolution", "remoteField":"resolution" }, { "localField":"10201", "remoteField":"10013", "remoteFieldPrefix":null, "applyMap":"epicMapping" }, { "localField":"key", "remoteField":"10091" } ], "remoteStatusField":"status", "remoteTransitions":{ "In progress":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Done":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Po Accepted Story":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Ready For Review":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "In Review":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Rejected":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Blocked":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "On Hold":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Trash":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Open":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" } }, "userMapping":{ "tom.testuser":"abcdef01234567890abcdef0", "michael.manager":"01234567890abcdef0123456" }, "priorityMapping":{ "1":"10000", "2":"10001", "3":"10002", "10000":"10003", "4":"10004", "5":"10005", "10100":"2", "10101":"3", "10102":"4", "10200":"10006", "10201":"10007", "10300":"10008" }, "resolutionMapping":{ "6":"10014", "1":"10008", "2":"10009", "3":"10002", "4":"10010", "5":"10004", "7":"10000", "8":"10012", "9":"10013", "10":"10011", "10000":"10001", "10100":"10003" }, "statusMapping":{ "Analysis":"Analysis" }, "issueTypeMapping":{ "Bug":"Bug", "Task":"Task", "Epic":"Epic", "Story":"Story", "Support Task":"Support Task", "Explo":"Explo", "Sub-task":"Sub-task" } }{ "configurationName":"My Configuration", "remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"issuetype = Sub-task AND project = 'iPad App' AND reporter in (tom.testuser, michael.manager)", "attachmentSync":"true", "issueSync":"true", "lastSyncedCommentIdField":"18300", "remoteDefaultUserId":"", "remoteDefaultPriority":"3", "remoteDefaultBoard":"14", "remoteDefaultIssueType":"Support Task", "fieldMappings":[ { "localField":"summary", "remoteField":"summary" }, { "localField":"issuetype", "remoteField":"issuetype", "remoteFieldPrefix":null, "applyMap":"issueTypeMapping" }, { "localField":"assignee", "remoteField":"assignee" }, { "localField":"reporter", "remoteField":"reporter" }, { "localField":"description", "remoteField":"description" }, { "localField":"components", "remoteField":"components" }, { "localField":"duedate", "remoteField":"duedate" }, { "localField":"environment", "remoteField":"environment" }, { "localField":"labels", "remoteField":"labels" }, { "localField":"fixVersions", "remoteField":"fixVersions" }, { "localField":"10002", "remoteField":"10043" }, { "localField":"versions", "remoteField":"versions" }, { "localField":"11601", "remoteField":"10086" }, { "localField":"10208", "remoteField":"10087" }, { "localField":"priority", "remoteField":"priority" }, { "localField":"resolution", "remoteField":"resolution" }, { "localField":"10201", "remoteField":"10013", "remoteFieldPrefix":null, "applyMap":"epicMapping" }, { "localField":"key", "remoteField":"10091" } ], "remoteStatusField":"status", "remoteTransitions":{ "In progress":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Done":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Po Accepted Story":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Ready For Review":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "In Review":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Rejected":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Blocked":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "On Hold":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Trash":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" }, "Open":{ "In Progress":"In progress", "Done":"Done", "PO accepted Story":"Po Accepted Story", "Ready for Review":"Ready For Review", "In Review":"In Review", "Rejected":"Rejected", "Blocked":"Blocked", "On hold":"On Hold", "Trash":"Trash", "Open":"Open" } }, "userMapping":{ "tom.testuser":"abcdef01234567890abcdef0", "michael.manager":"01234567890abcdef0123456" }, "priorityMapping":{ "1":"10000", "2":"10001", "3":"10002", "10000":"10003", "4":"10004", "5":"10005", "10100":"2", "10101":"3", "10102":"4", "10200":"10006", "10201":"10007", "10300":"10008" }, "resolutionMapping":{ "6":"10014", "1":"10008", "2":"10009", "3":"10002", "4":"10010", "5":"10004", "7":"10000", "8":"10012", "9":"10013", "10":"10011", "10000":"10001", "10100":"10003" }, "statusMapping":{ "Analysis":"Analysis" }, "issueTypeMapping":{ "Bug":"Bug", "Task":"Task", "Epic":"Epic", "Story":"Story", "Support Task":"Support Task", "Explo":"Explo", "Sub-task":"Sub-task" } }
Migration of all issue links
Example...{ "configurationName":"My Configuration","remoteJira":"https://cwxexample.atlassian.net", "remoteUsername":"", "remotePassword":"", "username":"tom.testuser", "issueKeyField":"18200", "remoteDefaultProject":"CWX", "remoteDefaultIssueType":"Task", "remoteTransition":"", "onSuccessLocalTransition":"", "escalationMailAddress":"tom.testuser@example.com", "jql":"project = iPad App", "linkSync":"true", "fieldMappings":[ ], "remoteStatusField": "status", "issueLinkTypeMapping":{ "10000":"10000", "10001":"10001", "10002":"10002", "10700":"10201", "10003":"10003" } }