missing CSV column description for timesheets

kimai · Jan 13, 2024 · c083429 · c083429
1 parent 2d96244
commit c083429
Showing 1 changed file with 25 additions and 22 deletions.
diff --git a/_documentation/plugin-import.md b/_documentation/plugin-import.md
@@ -90,30 +90,33 @@ This will import timesheets and create these elements on the fly:
 - missing tags
 - missing users
 
-| Attribute      | Supported field names                                     |
-|----------------|-----------------------------------------------------------|
-| Duration       | timesheet duration in seconds                             |
-| Tags           | comma separated list of tag-names                         |
-| Exported       | whether the timesheet should be marked as exported or not |
-| Rate           | TODO ...                                                  |
-| HourlyRate     | TODO ...                                                  |
-| InternalRate   | TODO ...                                                  |
-| FixedRate      | TODO ...                                                  |
-| Billable       | TODO ...                                                  |
-| Description    | TODO ...                                                  |
-| Tags           | TODO ...                                                  |
-| Project        | TODO ...                                                  |
-| Customer       | TODO ...                                                  |
-| Activity       | TODO ...                                                  |
-| Begin          | TODO ...                                                  |
-| End            | TODO ...                                                  |
-| Date           | TODO ...                                                  |
-| From           | TODO ...                                                  |
-| To             | TODO ...                                                  |
-| User           | Username                                                  |
-| Email          | User email (required when creating users)                 |
+| Attribute    | Supported field names                                                                   |
+|--------------|-----------------------------------------------------------------------------------------|
+| Duration     | Timesheet duration in seconds (if skipped, will be calculated from start and end times) |
+| Tags         | Comma separated list of tag-names                                                       |
+| Exported     | Whether the timesheet should be marked as exported or not (1 or 0)                      |
+| Rate         | The rate as an integer                                                                  |
+| HourlyRate   | The hourly rate as an integer                                                           |
+| InternalRate | The internal rate as an integer                                                         |
+| FixedRate    | The fixed rate as an integer                                                            |
+| Billable     | Whether the entry should be marked as billable or not (1 or 0)                          |
+| Description  | Description of the entry as string                                                      |
+| Project      | Name of the project as string                                                           |
+| Customer     | Name of the customer as string                                                          |
+| Activity     | Name of the activity as string                                                          |
+| Begin        | Start date-time in the format: `YYYY-MM-DD HH:MM:SS`                                    |
+| End          | End date-time in the format: `YYYY-MM-DD HH:MM:SS`                                      |
+| Date         | Date in the format: `YYYY-MM-DD` (only used in combination with `From` and `To`         |
+| From         | Start time in the format: `HH:MM:SS`                                                    |
+| To           | End time in the format: `HH:MM:SS`                                                      |
+| User         | Username                                                                                |
+| Email        | User email (required when creating users)                                               |
 {: .table }
 
+Supply one of these combinations:
+- `Begin` and `End`  
+- `Date` with `From` and `To` 
+
 ### User handling
 
 If you let Kimai create new users on the fly, make sure that you configured the default timezone for new users at [System > Settings]({% link _documentation/configurations.md %}) before the import.