1 Nextcloud specific properties

Thomas Citharel edited this page 2022-01-24 18:59:17 +01:00

Table of Contents

• Nextcloud-specific CalDAV properties
• General
• Groups
• Sharing
• Share invitations
• List sharees
• Manage shares
• Search
• Birthday calendar
• Subscriptions
• Calendar trashbin
• Nextcloud-specific iCalendar properties
• Birthday calendar

Nextcloud-specific CalDAV properties

General

• {http://owncloud.org/ns}read-only whether the collection or object is read-only

Groups

• {http://owncloud.org/ns}groups exposes contacts groups (from CATEGORIES vcard property)
• {http://owncloud.org/ns}group contact group name

Sharing

This part mixes files, address book and calendar sharing, so not everything might be relevant!

• {http://owncloud.org/ns}principal ?
• {http://owncloud.org/ns}owner-principal to identify the principal for the calendar owner
• {http://owncloud.org/ns}owner-displayname to identify the the calendar owner's display name
• {http://owncloud.org/ns}group-share if the share is a group share ?
• {http://owncloud.org/ns}share-types the type of shares (see OCP\Share\IShare)

Share invitations

• {http://owncloud.org/ns}invite to list invitations
  • {http://owncloud.org/ns}organizer to identify the event organizer
    • {http://owncloud.org/ns}common-name
    • {http://owncloud.org/ns}first-name
    • {http://owncloud.org/ns}last-name
  • {http://owncloud.org/ns}user to identify the event organizer
    • {http://owncloud.org/ns}common-name
    • {http://owncloud.org/ns}summary
    • {http://owncloud.org/ns}invite-accepted
    • {http://owncloud.org/ns}access
      • {http://owncloud.org/ns}read
      • {http://owncloud.org/ns}read-write

List sharees

• {http://nextcloud.org/ns}sharees gives a list of
  • {http://nextcloud.com/ns}sharee a sharee with the following children properties
    • {http://nextcloud.com/ns}id
    • {http://nextcloud.com/ns}display-name
    • {http://nextcloud.com/ns}type

Manage shares

• {http://owncloud.org/ns}share for sharing
  • {http://owncloud.org/ns}set sharees to add
  • {http://owncloud.org/ns}remove sharees to remove
  • Sharee representation
    • {http://owncloud.org/ns}read-write if the share is read-only
    • {http://owncloud.org/ns}summary a comment on the share
    • {http://owncloud.org/ns}common-name a common name for the sharee (maps to {DAV:}displayname)

Search

• {http://nextcloud.com/ns}calendar-search for CalDAV search, as well as the following prop filters
  • {http://nextcloud.com/ns}comp-filter
  • {http://nextcloud.com/ns}prop-filter
  • {http://nextcloud.com/ns}param-filter
  • {http://nextcloud.com/ns}search-term
  • {http://nextcloud.com/ns}limit
  • {http://nextcloud.com/ns}offset

Birthday calendar

• {http://nextcloud.com/ns}enable-birthday-calendar for birthday calendars

Subscriptions

• {http://nextcloud.com/ns}refresh-interval for the subscriptions refresh-interval
  Should be replaced DAV:subscription-suggested-refresh-interval in the long-term. See the draft-ietf-calext-serverside-subscriptions draft.

Calendar trashbin

• {http://nextcloud.com/ns}deleted-at for deleted calendars in the trashbin
• {http://nextcloud.com/ns}trash-bin to identify the trashbin collection

Nextcloud-specific iCalendar properties

Birthday calendar

• X-NEXTCLOUD-BC-FIELD-TYPE on a birthday calendar event, one of BDAY, DEATHDATE or ANNIVERSARY
• X-NEXTCLOUD-BC-UNKNOWN-YEAR on a birthday calendar event, one of 1 or 0 if the birthday year is unknown (or before unix time)
• X-NEXTCLOUD-BC-YEAR on a birthday calendar event, the birthday year if we had X-APPLE-OMIT-YEAR in the vcard data