Transit is a command line tool for exporting and importing worklogs from Tempo using Tempo API Jira Tempo doesn't support worklogs import / export if you which to move project to other instance. With this tool you can sync worklogs from system to another and keep worklog history up-to-date.
| Parameter | Required? | Default | Description | Possible values |
|---|---|---|---|---|
| mode | Yes | export | Operation mode | import, export |
| start | Yes for export | - | Start of date range to export. Format YYYY-MM-DD | 2019-01-01 |
| end | Yes for export | - | End of date range to export. Format YYYY-MM-DD | 2019-01-01 |
| project | Yes for export | DEFAULT_PROJECT environment variable | JIRA Project key to export worklogs | BUILD, KNI |
| file | Yes for import | - | Exported worklog file to import | BUILD_2015-09-01_2015-12-31.json |
| parse | No | true | Parse raw Tempo worklog before importing (set false when reimporting errored rows) | true, false |
| excludeUsers | No | - | List of author accound ids to exclude from export | XXX:123,XXX:456 |
| includeUsers | No | - | List of author accound ids to include in export | XXX:123,XXX:456 |
| Variable | Purpose | Type | Example |
|---|---|---|---|
| outDir | Directory to output exported worklogs | string | './exports' |
| DEFAULT_PROJECT | Set default project JIRA key | string | 'BUILD' |
| EXPORT_TEMPO_TOKEN | Tempo API token for exporting | string | 'XX232SS' |
| IMPORT_TEMPO_TOKEN | Tempo API token for importing | string | 'XX232SS' |
If using yarn.
yarn start --start=2019-01-01 --end=2019-01-03
Or using npm
npm run start -- --start=2019-01-01 --end=2019-01-03
If using yarn.
yarn start --mode=import --file=BUILD_2015-09-01_2015-12-31.json
Or using npm.
npm run start -- --mode=import --file=BUILD_2015-09-01_2015-12-31.json
This tool is developed with Typescript 3.7 Couple of other dependencies are needed also:
- minimist - for easier command line argument usage
- dotenv - for .env file usage
- node-fetch - for interacting with http services