0e10f52317
* Load and parse xml * Priority and status * Replace foreach * type property * explicitArray false * Parse description html * Use turndown to convert html * Allow optional priority * Import assignee and reporter as Select * Store original URL * Created date * Created date * Update readme * .gitignore * Update readme * Update import readme * Fix readme * Update import/jira/README.md Fix typo. Co-authored-by: Scott Bishel <scott.bishel@mattermost.com> * Remove commented out line * Add basic Jest test * Test that import was complete Co-authored-by: Scott Bishel <scott.bishel@mattermost.com>
23 lines
994 B
Markdown
23 lines
994 B
Markdown
# Jira importer
|
|
|
|
This node app converts a Jira xml export into a Focalboard archive. To use:
|
|
1. Open Jira advanced search, and search for all the items to export
|
|
2. Select `Export`, then `Export XML`
|
|
3. Save it locally, e.g. to `jira_export.xml`
|
|
4. Run `npm install` from within `focalboard/webapp`
|
|
5. Run `npm install` from within `focalboard/import/jira`
|
|
6. Run `npx ts-node importJira.ts -i <path-to-jira.xml> -o archive.focalboard` (also from within `focalboard/import/jira`)
|
|
7. In Focalboard, click `Settings`, then `Import archive` and select `archive.focalboard`
|
|
|
|
## Import scope and known limitations
|
|
|
|
Currently, the script imports each item as a card into a single board. Note that Jira XML export is limited to 1000 issues at a time.
|
|
|
|
Users are imported as Select properties, with the name of the user.
|
|
|
|
The following aren't currently imported:
|
|
* Custom properties
|
|
* Comments
|
|
* Embedded files
|
|
|
|
[Contribute code](https://www.focalboard.com/contribute/getting-started/) to expand this.
|