focalboard/import/asana/README.md

# Asana importer

This node app converts an Asana json archive into a Focalboard archive. To use:
1. From the Asana Board Menu (dropdown next to board title), select `Export / Print`, and `JSON`
2. Save it locally, e.g. to `asana.json`
3. Run `npm install` from within `focalboard/webapp`
4. Run `npm install` from within `focalboard/import/asana`
5. Run `npx ts-node importAsana.ts -i <asana.json> -o archive.focalboard`
6. In Focalboard, click `Settings`, then `Import archive` and select `archive.focalboard`

## Import scope

Currently, the script imports all cards from a single board, including their section (column) membership, names, and notes. [Contribute code](https://www.focalboard.com/contribute/getting-started/) to expand this.
Import scripts 2021-02-16 21:34:58 +02:00			`# Asana importer`

Update import build instructions 2021-04-13 23:35:50 +02:00			`This node app converts an Asana json archive into a Focalboard archive. To use:`
update documents and import issues (#2141) 2022-01-26 22:35:28 +02:00			1. From the Asana Board Menu (dropdown next to board title), select `Export / Print`, and `JSON`
Asana importer 2021-02-17 22:03:45 +02:00			2. Save it locally, e.g. to `asana.json`
Update import build instructions 2021-04-13 23:35:50 +02:00			3. Run `npm install` from within `focalboard/webapp`
			4. Run `npm install` from within `focalboard/import/asana`
			5. Run `npx ts-node importAsana.ts -i <asana.json> -o archive.focalboard`
			6. In Focalboard, click `Settings`, then `Import archive` and select `archive.focalboard`
Import scripts 2021-02-16 21:34:58 +02:00
Asana importer 2021-02-17 22:03:45 +02:00			`## Import scope`

			`Currently, the script imports all cards from a single board, including their section (column) membership, names, and notes. [Contribute code](https://www.focalboard.com/contribute/getting-started/) to expand this.`