Skip to content

Commit

Permalink
Add note on restrictions for XLS and CSV export
Browse files Browse the repository at this point in the history
  • Loading branch information
oliverguenther committed Sep 11, 2023
1 parent 18f0f1c commit 94f3842
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions docs/user-guide/work-packages/exporting/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,14 +82,30 @@ OpenProject can export the table for Microsoft Excel with the following options:

![OpenProject_work_package_export_excel_relations](openproject_pdf_table_export_relations.png)

### Limitations

The OpenProject XLS export currently does not respect all options in the work package view being exported form:

- The order of work packages in a manually sorted query is not respected. This is known limitation (Ticket https://community.openproject.org/projects/openproject/work_packages/34971/activity)
- The hierarchy of work packages as displayed in the work package view. The exported XLS is always in "flat" mode.

## CSV export

OpenProject can export the table into a comma-separated CSV. This file will be UTF-8 encoded.

> **Note**: To open CSV exported files into Microsoft Excel, ensure you set the encoding to UTF-8. Excel will not auto-detect the encoding or ask you to specify it, but simply open with a wrong encoding under Microsoft Windows.

![OpenProject_work_package_export_csv](openproject_export_csv.png)

### Limitations

The OpenProject CSV export currently does not respect all options in the work package view being exported form:

- The order of work packages in a manually sorted query is not respected. This is known limitation (Ticket https://community.openproject.org/projects/openproject/work_packages/34971/activity)
- The hierarchy of work packages as displayed in the work package view. The exported CSV is always in "flat" mode.


## Atom (XML) export

OpenProject can export the table into a XML-based atom format. This file will be UTF-8 encoded.
Expand Down

0 comments on commit 94f3842

Please sign in to comment.