luisgulo/focalboard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
focalboard/import/jira
History
Chen-I Lim 0e10f52317
Import jira (#1561) 
* 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>
2021-10-20 09:13:53 -07:00
..
test Import jira (#1561) 2021-10-20 09:13:53 -07:00
.gitignore Import jira (#1561) 2021-10-20 09:13:53 -07:00
importJira.ts Import jira (#1561) 2021-10-20 09:13:53 -07:00
jiraImporter.test.ts Import jira (#1561) 2021-10-20 09:13:53 -07:00
jiraImporter.ts Import jira (#1561) 2021-10-20 09:13:53 -07:00
package-lock.json Import jira (#1561) 2021-10-20 09:13:53 -07:00
package.json Import jira (#1561) 2021-10-20 09:13:53 -07:00
README.md Import jira (#1561) 2021-10-20 09:13:53 -07:00
tsconfig.json Import jira (#1561) 2021-10-20 09:13:53 -07:00
utils.ts Import jira (#1561) 2021-10-20 09:13:53 -07:00

README.md

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 to expand this.