Import checklist from My ToDo, Elements Checklist
Import checklists from My ToDo or Elements Checklist into Smart Checklist is available starting from version v6.6.0
How it works:
Navigate to Administration → Manage apps → Smart Checklist Settings.
Click on the "Import Checklists" tab.
Select an app to import from the list:
My ToDo;
Elements Checklist.
Click on the first tab link that redirects you to the "Projects" tab.
Toggle Smart Checklist on for the projects for which the import needs to be done.
Come back to the "Import Checklists" tab.
Select an app to import from the list one more time (My ToDo/Elements Checklist)
Choose one option to import:
Override existing Smart Checklist items - will replace checklist items that you already have in Smart Checklist with the ones from another app.
Append to existing Smart Checklist items - will add checklist items from another app to the bottom of the checklist that you already have.
Add to issues with empty Smart Checklists data only - will run import only for the issues where Smart Checklist is empty. Checklists from the other app will be added.
Click "Run import". The import will start.
You will see the progress bar for the import. The importing process will take some time.
Once it is completed, the date and time of the last import will be displayed. A message with the number of successfully/not migrated checklists will be shown. Additionally, you'll see a link to the detailed log that could be downloaded.
Clicking the Acknowledge button will hide the import progress bar and details of the last import.
To run import one more time do the same steps as described below and click “Re-run import”.
If the source plugin is not installed on the instance you will see this option as grey with a “not installed” tag and it will not be possible to select it from the list.
Migration using API
There is also an option to run the import from another app on a project basis. It can be inconvenient for users to ask the admin to enable/disable all other projects on the settings page, so there is a possibility to run project migration by project admin when it is needed. It can be done using the REST API endpoint.
Start the migration via REST API and check that only selected projects are migrated:
POST /rest/railsware/1.0/migration
Body parameters (application/json) - list of JSON objects:
migrationOption: string
migrationType: string
projectIds: number (optional)
Example
Run migration from Elements Checklist app to Smart Checklist with override option for 2 projects:
{
"migrationOption": "OVERRIDE",
"migrationType": "ELEMENTS",
"projectIds": [11001, 10900]
}
Formatting
You can find the direct formatting conversions that will be applied to checklists during import in this table:
Formatting types | Description | Displayed in Smart Checklist |
---|---|---|
Import from My ToDo | ||
Statuses TO DO |
| |
Links 🔗 |
- [marketplace](https://marketplace.atlassian.com/apps/1211170/my-todo?hosting=datacenter&tab=versions) - link to Atlassian marketplace
- [https://community.atlassian.com/t5/Jira-Service-Management/Setting-default-value-for-priority-field/qaq-p/770467](https://community.atlassian.com/t5/Jira-Service-Management/Setting-default-value-for-priority-field/qaq-p/770467) |
|
User mention |
| |
Date |
| |
Numbered/bullet point hierarchical lists |
| |
Text Formatting |
| |
Mandatory items (flagged items) |
|
|
Import from Elements Checklist | ||
Multiple panels (checklists) 🔢 |
| |
Separators 📏 |
|
|
Blockquotes |
| |
Lists (Ordered/Unordered) |
| |
Tables |
| |
Links 🔗 |
| |
Images |
| |
Text Formatting |
| |
Headers |
| |
Formulas |
|
|
Files |
|
Attribute types
Elements Checklist in its panels can have a structure with different attribute types.
Each checklist panel can have a combination of attribute types. Please find some notes you need to consider before starting the import:
If you want to see Elements Checklist items with a checkbox in Smart Checklist after migration, always add the Checkbox attribute type to the panel.
If Checkbox attribute type doesn’t exist in the panel of Elements Checklist, items will be imported and displayed as a raw text without a checkbox.
The name of all attribute types that are configured for the panel will be rendered in a row separated by
|
withh6
header (like ###### Single text | Component | Date | Issue | Test Number | Version | User mention | Select)All values for the attribute types that are configured for the panel will be rendered in a row separated by
|
Every issue can have multiple panels configured. If this is true, after migration each panel will be rendered with a Panel name as an
h3
header. The name of these attributes will be rendered in a row separated by|
ash6
header and only items after thatWe do not support template migration from Elements Checklist
Check how configured Elements Checklist panels for issue types will be rendered and displayed in Smart Checklist:
Combination of Attribute types | Displayed in Smart Checklist |
---|---|
Text + User + Version + Checkbox | |
Text + Date + Issue + Checkbox | |
Text + Component + Number + Checkbox | |
Calculation + Checkbox | |
Text (multi-line) + Checkbox |
|
Text + Select list + File + Chekbox |