vCard Format Extension for JSContact

This property is defined by the following notation:¶

created       = "CREATED" createdparam ":" timestamp

createdparam  = *(
                 ;
                 ; The following are OPTIONAL,
                 ; but MUST NOT occur more than once.
                 ;
                 (";" "VALUE" "=" "timestamp") /
                 ;
                 ; The following are OPTIONAL,
                 ; and MAY occur more than once.
                 ;
                 (";" any-param)
                 ;
                 )

This property is defined by the following notation:¶

deflanguage       = "DEFLANGUAGE" any-param ":" Language-Tag
               ; Language-Tag is defined in RFC6350, Section 4.

This property defines the grammatical gender that the contact prefers to be addressed by or referred at in written or spoken form. For example, the German language distinguishes by grammatical gender in salutations such as "Sehr geehrte" (feminine) and "Sehr geehrter" (masculine). Multiple occurrences of this property MUST be distinguished by the LANG parameter.¶

This property is defined by the following notation:¶

gramgender       = "GRAMGENDER" gramgender-param
                      ":" gramgender-value

gramgender-param =
                *(
                 ;
                 ; The following are OPTIONAL,
                 ; but MUST NOT occur more than once.
                 ;
                 (";" language-param) /
                 ;
                 ; The following are OPTIONAL,
                 ; and MAY occur more than once.
                 ;
                 (";" any-param)
                 ;
                 )

gramgender-value = "animate" /
                   "common" /
                   "feminine" /
                   "inanimate" /
                   "masculine" /
                   "neuter" /
                   iana-token /
                   x-name

This property is defined by the following notation:¶

pronouns       = "PRONOUNS" pronouns-param ":" text

pronouns-param =
                *(
                 ;
                 ; The following are OPTIONAL,
                 ; but MUST NOT occur more than once.
                 ;
                 (";" language-param) /
                 (";" pref-param) /
                 (";" type-param) /
                 (";" altid-param) /
                 ;
                 ; The following are OPTIONAL,
                 ; and MAY occur more than once.
                 ;
                 (";" any-param)
                 ;
                 )

This property is defined by the following notation:¶

socialpr       = "SOCIALPROFILE" socialpr-param ":"
                                 socialpr-value

socialpr-param = "VALUE=uri" / "VALUE=text" /
                 service-type-param / any-param

socialpr-value = URI / text

This parameter MAY be set on any property where conveying authorship is desired. It identifies the author as a URI [RFC3986]. Since every valid URI includes the COLON (U+003A) character, the parameter value MUST be quoted. Note that as an alternative or in addition to this parameter, the AUTHOR-NAME parameter allows naming an author as free-text value (see Section 4.2).¶

This parameter MAY be set on any property where conveying authorship is desired. It names the author as a free-text value. The parameter value MUST NOT be empty. Implementations MUST take care to quote the name part, if otherwise the part would not be a valid param-value (see Section 3.3 of [RFC6350]). Note that as an alternative or in addition to this parameter, the AUTHOR parameter allows identifying an author by URI (see Section 4.1).¶

This parameter MAY be set on any property to define the point in time when the property was created. The value MUST be a valid TIMESTAMP value as defined in Section 4.3.5 of [RFC6350]. Generally, updating a property value SHOULD NOT change the creation timestamp.¶

This property parameter SHOULD be specified on an property if the property value is derived from some other properties in the same vCard. When present with a value of true, clients MUST NOT update the property.¶

For an example, an implementation may derive the value of the FN property from the name components of the N property by use of the FMT (Section 4.5) parameter. It indicates this fact by setting the DERIVED parameter on the FN property to true.¶

The N and ADR properties use structured value types to define the constituent components of a name or address. In contrast, the FN property and LABEL parameter contain full names or addresses as a single TEXT value, which might redundantly redefine the information in their structured value counterparts and bears the risk of their values going out of sync. Instead, implementations should be guided how to form a full name or address of a given N or ADR property. This is what the FMT parameter aims to achieve. In addition to the component values, it also allows to define what values implementations SHOULD insert in between components, such that the resulting name or address is formatted appropriately and locale-specific.¶

The FMT parameter value is a structured type value. It consists of a sequence of formatting instructions, where a formatting instruction defines what value to concatenate to the result TEXT value. There are two kinds of formatting instruction:¶

1. A positional. This instructs to concatenate to the result the value of a structured property component value at a specified position. A position consists of a numeric index of a component in the structured value, optionally followed by a COMMA (U+002C) character and the index of a value within that component. The zero index selects the first component or value, respectively. The second index by default is zero, in which case it MAY be omitted, otherwise it MUST NOT be omitted.¶

   If a positional instruction contains a position of a non-existent or empty component value, then the entire FMT parameter MUST be considered invalid and MUST be ignored.¶

2. A separator. This instructs to concatenate to the result a verbatim value defined in this formatting instruction. It starts with the LATIN SMALL LETTER S (U+0073) character, followed by COMMA (U+002C), followed by zero or more Section 3.3 of [RFC6350] characters, where the COMMA (U+002c) and SEMICOLON (U+003B) character MUST be escaped according to the rules defined in Section 3.4 of [RFC6350].¶

The first entry in the sequence of formatting instructions either MUST be the empty string or it MUST be a separator formatting instruction. If the first entry is a separator formatting instruction, then this defines the default separator value to insert in between the values indicated by two consecutive positional formatting instructions. Any separator formatting instruction in later entries has higher precedence than this default separator. If the first entry is the empty string, the default separator is undefined and implementation-specific. The FMT parameter value either includes exactly one separator formatting instruction for the default separator, or an optional default separator followed by at least one formatting instruction (see Format definition).¶

Some implementations might not support the FMT parameter. For backwards compatibility, implementations SHOULD generate the FN property based on the N property and FMT instructions. In this case, they SHOULD set the DERIVED (Section 4.4) parameter on the FN property. They MAY generate a LABEL parameter for the ADR property.¶

The following examples demonstrates how to generate the same value as the FN property value using the FMT parameter. The first format instruction defines a single SPACE (U+0020) character as default to separate two component values. The next format instructions select the first value of the second component of the N property value (the given name), followed by the first value of the first component in the N property value (the surname).¶

FN;DERIVED=TRUE::Rene van der Harten
N;FMT="s, ;1,0;0,0":van der Harten;Rene,J.;Sir;R.D.O.N.

where the positions can be reduced to shorter form¶

FN;DERIVED=TRUE::Rene van der Harten
N;FMT="s, ;1;0":van der Harten;Rene,J.;Sir;R.D.O.N.

An implementation may decide to not explicitly define a default separator. Assuming that the implementation uses space to separate name components, the FMT parameter value would then be for example:¶

FN;DERIVED=TRUE:Rene van der Harten
N;FMT=";1;0":van der Harten;Rene,J.;Sir;R.D.O.N.

The following example demonstrates how the honorific suffix could be preceded by the SEMICOLON (U+003B) and SPACE (U+0020) characters.¶

FN;DERIVED=TRUE:Rene van der Harten; R.D.O.N.
N;FMT=";1;0;s,\; ;3":van der Harten;Rene,J.;Sir;R.D.O.N.

This parameter uniquely identifies a property among all of its siblings with the same name within a vCard. A valid PROP-ID value must be of 1 and a maximum of 255 octets in size, and it MUST only contain the ASCII alphanumeric characters (A-Za-z0-9), hyphen (-), and underscore (_). The identifier only has the purpose to uniquely identify siblings, its value has no other meaning. If an application makes use of PROP-ID it SHOULD assign a unique identifier to each sibling property of the same name within their embedding component. The same identifier MAY be used for properties of a different name, and it MAY also be assigned to a same-named property that is not a sibling.¶

Resolving duplicate identifier conflicts is specific to the application. Similarly, handling properties where some but not all siblings have a PROP-ID is assigned, is application-specific.¶

This parameter MAY be specified on a IMPP or SOCIALPROFILE property to name the online service associated with that property value. Its value is case-sensitive, its letter cases MUST be preserved.¶

Several vCard address book implementations currently use an experimental X-SERVICE-TYPE parameter. This specification provides an IANA-registered parameter for the same purpose.¶

This parameter MAY be specified on a IMPP or SOCIALPROFILE property to name the user with that property value. Its value is case-sensitive, its letter cases MUST be preserved. The IMPP or SOCIALPROFILE value type MUST be URI.¶

This value can be used with the "TYPE" parameter applied on the "ADR" property.¶

This value can be used with the "TYPE" parameter applied on the "ADR" property.¶