export¶
Export Jira issues to JSON or XLSX format.
Usage¶
Flags¶
| Flag | Description |
|---|---|
--jql |
JQL query to search issues |
--keys |
Comma-separated issue keys to export |
--json |
Output JSON file path |
--xlsx |
Output XLSX file path |
--from-json |
Read issues from existing JSON file instead of querying |
--include-parents |
Include parent issues in export |
--sheet |
Sheet name for XLSX export (default: "issues") |
Plus global flags.
Examples¶
Export to JSON¶
# Export search results to JSON
gojira export --jql "project = FOO" --json issues.json
# Export specific issues
gojira export --keys FOO-1,FOO-2,FOO-3 --json output.json
Export to Excel¶
# Export to XLSX
gojira export --jql "project = FOO AND status = Open" --xlsx report.xlsx
# Custom sheet name
gojira export --jql "project = FOO" --xlsx report.xlsx --sheet "Open Issues"
Export Both Formats¶
# Export to both JSON and XLSX
gojira export --jql "project = FOO" --json backup.json --xlsx report.xlsx
Include Parent Issues¶
When exporting sub-tasks or stories linked to epics, include the parent issues:
Convert JSON to XLSX¶
If you have an existing JSON export, convert it to XLSX:
Output¶
JSON Output¶
The JSON file contains the full issue data including all fields:
{
"issues": [
{
"key": "FOO-123",
"fields": {
"summary": "Fix login bug",
"status": {"name": "Open"},
...
}
}
]
}
XLSX Output¶
The Excel file contains a table with columns:
- Key
- Type
- Status
- Priority
- Summary
- Assignee
- Created
- Updated
- And more...
Use Cases¶
Backup Issues¶
# Regular backup of project issues
gojira export --jql "project = FOO" --json "backup-$(date +%Y%m%d).json"
Generate Reports¶
# Sprint report
gojira export --jql "project = FOO AND sprint = 'Sprint 42'" --xlsx sprint-42.xlsx
# Unresolved bugs report
gojira export --jql "project = FOO AND type = Bug AND resolution is EMPTY" --xlsx bugs.xlsx