summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Mollekopf <mollekopf@kolabsys.com>2013-04-10 15:22:18 (GMT)
committerChristian Mollekopf <mollekopf@kolabsys.com>2013-04-10 15:22:18 (GMT)
commit7f0a45cd10ac1f934938e3f3570d7903156bbc11 (patch)
tree9bcbb9e9ac8b933322bd1d8de3e8a66ca9832fb8
parent1d499bf11edffe71b447a392cdce3f91fba2f97e (diff)
downloadkeps-7f0a45cd10ac1f934938e3f3570d7903156bbc11.tar.gz
Specification of the freebusy object.
-rw-r--r--KEP-0017.txt60
1 files changed, 59 insertions, 1 deletions
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" />.