History

Paul Esch-Laurent 42ddbbdd69 Update URL to docs page for migrating and reference `.boardarchive` (#4043 ) * chore: update docs URL for import/export/migrate * chore: reference `.boardarchive` in import scripts & READMEs		2022-10-19 13:33:06 -06: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	Update URL to docs page for migrating and reference `.boardarchive` (#4043 )	2022-10-19 13:33:06 -06:00
jiraImporter.test.ts	fix jira import	2022-03-31 22:19:04 -04:00
jiraImporter.ts	Update URL to docs page for migrating and reference `.boardarchive` (#4043 )	2022-10-19 13:33:06 -06:00
package-lock.json	Bump minimist from 1.2.5 to 1.2.6 in /import/jira (#2614 )	2022-03-23 17:32:25 -06:00
package.json	Bump minimist from 1.2.5 to 1.2.6 in /import/jira (#2614 )	2022-03-23 17:32:25 -06:00
README.md	Update URL to docs page for migrating and reference `.boardarchive` (#4043 )	2022-10-19 13:33:06 -06: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

Jira importer

This node app converts a Jira xml export into a Focalboard archive. To use:

Open Jira advanced search, and search for all the items to export
Select Export, then Export XML
Save it locally, e.g. to jira_export.xml
Run npm install from within focalboard/webapp
Run npm install from within focalboard/import/jira
Run npx ts-node importJira.ts -i <path-to-jira.xml> -o archive.boardarchive (also from within focalboard/import/jira)
In Focalboard, click Settings, then Import archive and select archive.boardarchive

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:

Contribute code to expand this.