Hi Jelmer,

On 30 Jan 2017, at 01:13, Jelmer Vernooij <jelmer@jelmer.uk> wrote:

When using the inf-it clients against my CardDAV/CalDAV server I notice that it requests a few custom properties.
Are these properties and their purpose documented somewhere?

The ones I have seen are:
- {http://inf-it.com/ns/dav/}headervalue

headervalue property is "hidden" property used internally by our company, but the meaning is not secret ... it is the similar thing as (from config,js):

// - hrefLabel
//   This option sets the server name in the resource header (useful if
//   you want to see custom resource header above the collections).
//   You can use the following variables in the value:
//     %H = full hostname (including the port number)
//     %h = full hostname (without the port number)
//     %D = full domain name
//     %d = only the first and second level domain
//     %P = principal name
//     %p = principal name without the @domain.com part (if present)
//     %U = logged user name
//     %u = logged user name without the @domain.com part (if present)
//   If undefined, empty or or null then '%d/%p [%u]' is used.
//   Examples: 
//     hrefLabel: '%d/%p [%u]'
//     hrefLabel: '%D/%u'
//   This property is supported in:
//     globalAccountSettings
//     globalNetworkCheckSettings
//     globalNetworkAccountSettings (available in auth module only)

We use this property do group collections (each person has one calendar) into "Support", "Sales", "Service", etc. There is also a special "trick" with this hidden property - the value can be a simple text or something like "001#Support", "002#Sales", "003#Service" thus you can sort the groups (the "001#", "002#" is not shown in the interface, but it is used for sorting) - the result in the interface will be something like:

[Support]
Person 1 calendar (headervalue: "001#Support")
Person 2 calendar (headervalue: "001#Support")
...
[Sales]
Person 3 calendar (headervalue: "002#Sales")
Person 4 calendar (headervalue: "002#Sales")
...
[Service]
...

- {http://inf-it.com/ns/dav/}settings

it contains the JSON representation of current settings such as: loaded calendars (e.g. loaded delegated calendars), enabled calendars (checkbox in the interface) and much more ... so next time you login you will see the same calendars you loaded/enabled during the previous "session" ... these settings can be "reset/ignored" if you press the shift button when clicking to the login (arrow) icon

- {http://inf-it.com/ns/dav/}addressbook-color; analogous to {http://apple.com/ns/ical/}calendar-color I'm guessing

the calendar-color is a property used by Apple (it is the color of calendar you see in the interface - hex notation such as: #ff00c5), the "addressbook-color" is our property, because we have colorful interface also for addressbooks (hex notation) ... you can set the hex color also in the interface - hold the shift button and click to the collection color (it will show not only the color picker but also the hex value)

Is this a complete list?

yes


Cheers,


JM


Thanks,

Jelmer