5 commits - KEP-0017.txt
Christian Mollekopf
mollekopf at kolabsys.com
Fri Apr 12 15:24:38 CEST 2013
KEP-0017.txt | 101 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++--
1 file changed, 98 insertions(+), 3 deletions(-)
New commits:
commit 7f0a45cd10ac1f934938e3f3570d7903156bbc11
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Wed Apr 10 17:22:18 2013 +0200
Specification of the freebusy object.
diff --git a/KEP-0017.txt b/KEP-0017.txt
index f739acf..ba4499c 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -199,7 +199,8 @@ Implements:
element components {
element vevent { [[#Event|event]] } |
element vtodo { [[#Todo|todo]] } |
- element vjournal { [[#Journal|journal]] },
+ element vjournal { [[#Journal|journal]] } |
+ element vfreebusy { [[#Freebusy|freebusy]] },
[[#Recurrence exception|recurrence-exception]] *
}
}
@@ -712,6 +713,42 @@ Implements:
{{note|Attachments in separate Mimeparts|Attachments '''SHOULD''' be attached using a seperate Mime-Part. If this technique is used the Attachment '''MUST''' be referenced using the Content-Id(cid:) of the Mimepart in the uri element.}}
{{note|x-label|This property should be replaced with something standard compliant or added to the official standard.}}
+===== Freebusy Property =====
+
+ property-freebusy = element freebusy {
+ element parameters {
+ element fbtype { element text { "BUSY"|"BUSY-TENTATIVE"|"X-OUT-OF-OFFICE" } } ?,
+ element x-event {
+ element uid { [[#UID]] },
+ element summary { [[#Summary]] },
+ element location { [[#Location]] },
+ } ?,
+ }?,
+ element period {
+ element start{ [[#Start date]] },
+ element end { [[#End date]] },
+ }*
+ }
+
+''A collection of Freebusy Periods.''
+
+* "fbtype": The type of freebusy information. This parameter '''SHALL''' default to "BUSY".
+:* "BUSY": Indicates that the time interval is busy.
+:* "BUSY-TENTATIVE": Indicates that the time interval is busy because one or more events have been tentatively scheduled for that interval.
+:* "X-OUT-OF-OFFICE": Marks that the [[#Organizer]] of the freebusy object is out of office.
+* "x-event": Meta-Information about which calendar object resulted in the contained periods. When used, this freebusy property '''SHALL''' only contain periods of the given calendar object.
+:* "uid": [[#UID]] of the calendar object.
+:* "summary": [[#Summary]] of the calendar object.
+:* "location": [[#Location]] of the calendar object.
+
+The cal-address '''MUST''' be a valid [[#Mailto URI]].
+A contact '''MAY''' be referenced using the [[#UID|uri-uid]].
+
+Implements:
+* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.2.6 section-3.8.2.6]
+
+{{note|X-OUT-OF-OFFICE|BUSY-UNAVAILABLE would be a standard value, which could likely server that same purpose as OUT-OF-OFFICE.}}
+
==== Alarm ====
property-trigger = element trigger {
@@ -913,6 +950,27 @@ An object representing an journal entry. Journal entries '''SHALL''', as opposed
Implements:
* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.6.3 section-3.6.3]
+==== Freebusy ====
+
+ freebusy = element vfreebusy {
+ element properties {
+ element uid { [[#UID|text-uid]] },
+ element dtstamp { [[#Last modification date]] },
+ element dtstart { [[#Start date]] },
+ element dtend { [[#End date]] } ? |
+ element organizer { [[#Organizer]] } ?
+ element freebusy { [[#Freebusy Property]] } *,
+ }
+ }
+
+''An object representing a collection of free or busy time information.''
+
+* Content-Type: application/calendar+xml
+* X-Kolab-Type: application/x-vnd.kolab.freebusy
+
+Implements:
+* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.6.4 section-3.6.4]
+
=== xCard based objects ===
All xCard based objects '''MUST''' fully comply to {{rfc|6351}}<ref name="rfc6351" />.
commit 1d499bf11edffe71b447a392cdce3f91fba2f97e
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Wed Apr 10 17:14:44 2013 +0200
File definition
diff --git a/KEP-0017.txt b/KEP-0017.txt
index 912e6b0..f739acf 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -1507,6 +1507,26 @@ The vcard:kind element '''MUST''' have the value "group".
{{note|structure: attachment|Points to an xCal property? Maybe move the attachment to the generic section.}}
+=== File ===
+
+ file = element file {
+ attribute version { [[#Kolab XML Version]] },
+ element uid { [[#UID|value-uid]] },
+ element prodid { [[#Product ID|value-productid]] },
+ element creation-date { [[#Creation date|value-creation-date]] },
+ element last-modification-date { [[#Last modification date|value-lastmodified-date]] },
+ element categories { [[#Categories|value-category]] } *,
+ element classification { [[#Classification|value-classification]] } ?,
+ element file { [[#Attachment]] },
+ element note { [[#String]] } ?,
+ element x-custom { [[#Kolab Custom Property]]} *
+ }
+
+''A snapshot of a file.''
+
+* Content-Type: application/vnd.kolab+xml
+* X-Kolab-Type: application/x-vnd.kolab.file
+
==== Properties ====
=== Configuration ===
commit 09e5538877d7df5a2a99b251c2b30a2bc56d9075
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Wed Apr 10 17:12:12 2013 +0200
Make clear that an exception replaces the original event definition.
diff --git a/KEP-0017.txt b/KEP-0017.txt
index 4906438..912e6b0 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -377,7 +377,7 @@ A recurrence exception can be identified as exception by the presence of the [[#
A recurrence exception '''MUST''' be of the same type as the base object.
-A recurrence exception '''SHALL''' only specify what should be changed from the base object.
+A recurrence exception '''SHALL''' copy ALL properties of the base event, and adjust as required, and it '''SHALL NOT''' be applied on top of the orginial event properties (The exception replaces the complete original event definition for the specific occurrence).
A recurrence exception '''MUST NOT''' define a new recurrence rule using any of [[#Recurrence rule]], [[#Recurrence date]], [[#Exception date]]
commit 193c7a2a209f2263fa6641d957cb1195e8023aed
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Wed Apr 10 16:15:35 2013 +0200
xcal url description
diff --git a/KEP-0017.txt b/KEP-0017.txt
index 1fca271..4906438 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -601,6 +601,21 @@ A contact '''MAY''' be referenced using the [[#UID|uri-uid]].
Implements:
* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.4.3 section-3.8.4.3]
+===== Object URL =====
+
+ property-url = element url {
+ element uri { [[#URI|xsd:anyURI]] }
+ }
+
+''A URL associated with the calendar object.''
+
+The URL '''MAY''' point to a more dynamic version of the same calendar object, or it may also point to a website related to the calendar object.
+
+{{note|Example: URL| An example for a more dynamic version of the same object could be: "http://example.com/pub/calendars/jsmith/mytime.ics".}}
+
+Implements:
+* {{rfc|5545}} [https://tools.ietf.org/html/rfc5545#section-3.8.4.6 section-3.8.4.6]
+
===== Attendee =====
property-attendee = element attendee {
@@ -806,6 +821,7 @@ Implements:
element percent-complete { [[#Percent complete]] } ?,
element location { [[#Location]] } ?,
element organizer { [[#Organizer]] } ?
+ element url { [[#Object URL]] } ?,
element attendee { [[#Attendee]] } *,
element attach { [[#Attachment]] } *,
element x-custom { [[#Kolab Custom Property]] } *
@@ -849,6 +865,7 @@ Implements:
element status { [[#Status]] } ?,
element location { [[#Location]] } ?,
element organizer { [[#Organizer]] } ?
+ element url { [[#Object URL]] } ?,
element attendee { [[#Attendee]] } *,
element attach { [[#Attachment]] } *,
element x-custom { [[#Kolab Custom Property]] } *
commit 4b5e7fc801c593c9e28af36d65b7a3ef50a45993
Author: Christian Mollekopf <mollekopf at kolabsys.com>
Date: Wed Apr 10 02:53:12 2013 +0200
The '@' should also be encoded.
diff --git a/KEP-0017.txt b/KEP-0017.txt
index 7ff4720..1fca271 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -1678,7 +1678,7 @@ In case the name is included, URL-reserved characters '''MUST''' be encoded.
Example:
- mailto:John%20Doe%3cjdoe at example.com%3e
+ mailto:John%20Doe%3cjdoe%40example.com%3e
== Contact URI ==
More information about the commits
mailing list