summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Mollekopf <mollekopf@kolabsys.com>2012-03-16 19:08:01 (GMT)
committerChristian Mollekopf <mollekopf@kolabsys.com>2012-03-16 19:08:01 (GMT)
commitedc418bf2bffc8595fbd1ed8bbb7e6b5e8f424b3 (patch)
tree272f4df884a96c01fd845a8dadb01a519bbeb649
parentea57645977cc3dddf048381db2a7da46b8546e32 (diff)
downloadkeps-edc418bf2bffc8595fbd1ed8bbb7e6b5e8f424b3.tar.gz
Fix Affiliation/Role/Title
-rw-r--r--KEP-0017.txt47
1 files changed, 30 insertions, 17 deletions
diff --git a/KEP-0017.txt b/KEP-0017.txt
index a6d2aff..ac7a56c 100644
--- a/KEP-0017.txt
+++ b/KEP-0017.txt
@@ -991,13 +991,32 @@ Implements:
{{note|Needs clarification: Type| do we need to indicate the type where this points?}}
{{note|Needs clarification: cardinality| do we need multiple fb urls?}}
+===== Title =====
+
+ property-title = element title {
+ element text { [[#String]] }
+ }
+
+''Specifies a position or profession of the contact.''
+
+In contrast to [[#Role]], this property denotes a general profession/occupation of the contact, and is not bound to a specifc organization.
+
+Examples:
+ * "Computer Scientist"
+
+Implements:
+* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-6.6.1 section-6.6.1]
+
+{{note|Possible error in vCard RFC|The reference in the vCard RFC to CCITT.X520.1988:Title is likely wrong and should be CCITT.X520.1988:Business Category. This would align with the example in the vCard RFC and is how we're using it.}}
+
===== Affiliation =====
Affiliation specific elements are grouped by a "group" element.
The "group" element is the xCard equivalent to the "group construct" as specified in {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-3.3 section-3.3] and is specified in {{rfc|6351}} [http://tools.ietf.org/html/rfc6351#section-5 section-5].
+A contact '''MAY''' be associated with multiple organizations by using multiple affiliation groups.
+
{{note|Implementation note|This corresponds to kaddressbooks business tab}}
-{{note|Needs clarification: name element|maybe the name element should be used for identification of the affiliation instead (not sure if this is actually necessary). If all implementations just support multiple generic affiliations its not needed, but if i.e. one supports multiple affiliations and kontact only supports a business affiliation kontact could identify the business affiliation based on the name (although thats likely to break when used this way)}}
====== Organization ======
@@ -1007,8 +1026,6 @@ The "group" element is the xCard equivalent to the "group construct" as specifie
''A organization associated with the contact''
-A contact '''MAY''' be associated with multiple organizations by using multiple org properties.
-
A single "org" property '''MUST''' be used for only one organization.
Organizations are of no specific type.
@@ -1038,28 +1055,25 @@ Implements:
{{note|Implementation note: Roundcube|roundcube does not support this property, but only the photo}}
{{note|Purpose|The purpose of this property was changed so the logo is now associated with the affiliated organization and not the "object the vCard presents" as the RFC puts it, which is how it is also used in Kontact}}
-====== Title ======
-
- property-title = element title {
- element text { [[#String]] }
- }
-
-''Specifies a position or job of the contact within the organization.''
-
-Implements:
-* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-6.6.1 section-6.6.1]
-
====== Role ======
property-role = element role {
element text { [[#String]] }
}
-''Specifies a role of the contact within the organization.''
+''Specifies a role/function of the contact within the organization.''
+
+In contrast to [[#Title]], this property denotes a specific role/function within an organization, and not a generic profession/occupation.
+
+Examples:
+ * "Systems Architect"
+ * "Manager,Distributed Applications"
Implements:
* {{rfc|6350}} [https://tools.ietf.org/html/rfc6350#section-6.6.2 section-6.6.2]
+{{note|Possible error in vCard RFC|The reference in the vCard RFC to CCITT.X520.1988:Business Category is likely wrong and should be CCITT.X520.1988:Title. This would align with the example in the vCard RFC and is how we're using it.}}
+
====== Manager ======
property-manager = element x-manager {
@@ -1423,11 +1437,11 @@ Implements:
element n { [[#Name Components]] } ?,
element note { [[#Note]] } ?,
element fburl { [[#Freebusy URL]] } ?,
+ element title { [[#Title]] } *,
element group {
attribute name { [[#Affiliation|"Affiliation"]] },
element org { [[#Organization]] },
element logo { [[#Logo]] } ?,
- element title { [[#Title]] } *,
element role { [[#Role]] } *,
element x-manager { [[#Manager]] } *,
element x-assistant { [[#Assistant]] } *,
@@ -1722,7 +1736,6 @@ Example:
Clients SHALL either use a [[#UID|uri-uid]] to reference a Contact object or a [[#Mailto URL]] to specify a single email address.
Clients MUST be able to deal with both [[#UID|uri-uid]] and [[#Mailto URL]].
-
==== Geo URI ====
A geographic location identifier '''MUST''' conform to {{rfc|5870}}<ref name="rfc5870">{{rfc|5870}} A Uniform Resource Identifier for Geographic Locations ('geo' URI)</ref>.