| Example | Work package attribute | mapped iCal attribute | iCal notes |
|---|---|---|---|
| OpenProject GmbH//OpenProject Core Project//EN | Container calendar and company | PRODID | This is a MUST in iCal and specifies who created this iCal and for what and its never represented in the UI |
| V1.0 | Version of the iCal | VERSION | This is the version of iCal and is a MUST and it is not represented in the UI |
| - | Work package (type of calendar entry) | VEVENT or VJOURNAL | VJOURNAL seemed the most ideal event as basically a Journal entry without need to be a meeting or a event but it is not displayed properly in a lot of calendars therefore I tried also a normal VEVENT. |
| @community.openproject.com | Calendar entry ID | UID (id) | This is a MUST in iCAL and must be unique for each calendar entry in all the iCal and therefore is recommended to use specific methods of creation explained here |
| Work package ID | IANA (text) | This can be added in the calendar entry as a "IANA" extra property. All compliant applications are expected to be able to parse but it can be that they are ignored. | |
| .../openproject/work_packages/15339 | Work package URL | URL (link) or LOCATION | Not clear if this information is shared with the iCal "URI" or should be included as an LOCATION to be displayed (or in the description) |
| Share project calendars using the iCalendar format | Subject | SUMMARY (text) | The subject could be directly matched as the "SUMMARY" of the calendar entry |
| Delivering the first version of the new fancy product. | Description | DESCRIPTION (text) | The description is always displayed in the calendar entries. We need to decide what is the content we want to display in this description as I assume we don't want to show the full WP description here. |
| closed | Status | CATEGORIES (text) | "STATUS" is limited to the type of entry journal and there is not a lot of options, see here |
| Epic | Work package type | CATEGORIES (text) | iCal "TYPE" will not work here as it specifies the type of calendar not of each entry. |
| Medium | Priority | PRIORITY (integer) | "PRIORITY" can be used to see the priority in between the elements of a calendar and they are defined by numbers form 0 to 9 that can be ranged also as LOW, MEDIUM and HIGH |
| Tobias Nöbauer | Author | ORGANIZER (cal-address) or CONTACT (text) |
If we extract the Author and map it as Organizer this could appear in the iCal invite This is even possible with LDAP URI |
| Assignee | CONTACT (text) | We could use the assignee and map it with the "CONTACT" reference in the calendar entry. This is even possible with LDAP URI. But cannot be used if used for Author | |
| 20.01.2023 | Creation date | CREATED (date-time) | Maps the WP creation date with |
| 20.01.2023 | Last modification date | LAST-MODIFIED (date-time) | We could map the last modification date in the activity with the "LAST-MODIFIED" |
| Start date | DTSTART (date) | ||
| Finish date | DTEND or DUE (date) | Need to see what works better if "DTEND" or "DUE" | |
| Duration | DURATION (duration) | ||
|
|
Parent work package | RELATED-TO | Can be used to establish if the work package is related to any other calendar entries (WP) |
| - | Any other information | COMMENT (text) | Everything can be always added to an extra section besides the description called "COMMENT" |
| - | Extra custom values | IANA (text) or X- (text with other type acceptance) | This are extra full custom properties that all compliant applications are expected to be able to parse but it can be that they are ignored. |
| Work package attribute | mapped iCal attribute | OX | Thunderbird | Mailbox | Outlook | Yahoo | Google Calendar | Google Calendar (Android) | Calendar (MAC) | Calendar (iOS) | BusyCal | OneCalendar | Fantastical |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Container calendar and company | PRODID | - | - | - | - | - | - | - | - | - | - | - | - |
| Version of the iCal | VERSION | - | - | - | - | - | - | - | - | - | - | - | - |
| Work package (type of calendar entry) | VEVENT or VJOURNAL | - | - | - | - | - | - | - | - | - | - | - | - |
| Calendar entry ID | UID (id) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed |
| Work package ID | IANA (text) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Displayed with the IANA name | Not displayed | Not displayed |
| Work package URL | URL (link) or LOCATION | Location | URL or Location | Location | Location | Location | Location | Location | URL or Location | URL or Location | URL | Location | Location |
| Subject | SUMMARY (text) | Title | Title | Subject | Title | Event title | Title | Title | Event name | Event name | Event name | Subject | Subject |
| Description | DESCRIPTION (text) | Description | Description | Description | Description | Description | Description | Description | Notes | Notes | Description | Description | Description |
| Status | CATEGORIES (text) | Not displayed | Category | Not displayed | Category | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Tags | Not displayed | Not displayed |
| Work package type | CATEGORIES (text) | Not displayed | Category | Not displayed | Category | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Tags | Not displayed | Not displayed |
| Priority | PRIORITY (integer) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Priority | Not displayed | Not displayed |
| Author | ORGANIZER (cal-address) or CONTACT (text) | Not displayed (it display you as organiser) | Organizer | Not displayed (it display you as organiser) | Not displayed | Invited (organiser) | Invitee (organiser) | Invitee (organiser) | Invitee (organiser) | Invitee (organiser) | Organiser | People (organiser) | Invitee (organiser) |
| Assignee | CONTACT (text) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Invitees | Not displayed | Not displayed |
| Creation date | CREATED (date-time) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed |
| Last modification date | LAST-MODIFIED (date-time) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Edited | Not displayed | Not displayed |
| Start date | DTSTART (date) | Starts on | Start date | Starts on | Start date | Start date | Start date | Start date | Start date | Start date | Start date | Start | Start |
| Finish date | DTEND or DUE (date) | Ends on | End date | Ends on | End date | End date | End date | End date | Finish date | Finish date | Due date | End | End |
| Duration | DURATION (duration) | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed | Established by dates but not displayed |
| Parent work package | RELATED-TO | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed |
| Any other information | COMMENT (text) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed |
| Extra custom values | IANA (text) or X- (text with other type acceptance) | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Not displayed | Displayed with the X- or IANA name | Not displayed | Not displayed |