<?xml version="1.0"encoding="utf-8"?>encoding="UTF-8"?> <!DOCTYPE rfc [ <!ENTITY nbsp " "> <!ENTITY zwsp "​"> <!ENTITY nbhy "‑"> <!ENTITY wj "⁠"> ]><?xml-stylesheet type="text/xsl" href="rfc2629.xslt"?> <?rfc toc="yes"?> <?rfc tocompact="yes"?> <?rfc tocdepth="4"?> <?rfc compact="yes"?> <?rfc subcompact="yes"?> <?rfc sortrefs="yes"?> <?rfc symrefs="yes"?> <?rfc iprnotified="no"?><rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="IETF" category="std" consensus="true"docName="draft-ietf-calext-jscontact-vcard-13"docName="draft-ietf-calext-jscontact-vcard-14" number="9555" ipr="pre5378Trust200902" tocInclude="true" tocDepth="4" sortRefs="true" symRefs="true" updates="6350" obsoletes="" xml:lang="en" version="3"> <!-- xml2rfc v2v3 conversion 3.12.10 --> <front> <titleabbrev="jscontact-vcard">JSContact:abbrev="JSContact: Converting from and to vCard">JSContact: Converting from and to vCard</title> <seriesInfoname="Internet-Draft" value="draft-ietf-calext-jscontact-vcard-13"/>name="RFC" value="9555"/> <author fullname="Mario Loffredo" initials="M." surname="Loffredo"> <organization>IIT-CNR/Registro.it</organization> <address> <postal> <street>ViaMoruzzi,1</street>Moruzzi, 1</street> <city>Pisa</city><country>IT</country><country>Italy</country> <code>56124</code> </postal> <email>mario.loffredo@iit.cnr.it</email> <uri>https://www.iit.cnr.it</uri> </address> </author> <author fullname="Robert Stepanek" initials="R." surname="Stepanek"> <organization>Fastmail</organization> <address> <postal><street>PO<extaddr>PO Box234, Collins St234</extaddr> <street>Collins St. West</street> <city>Melbourne</city><country>AU</country> <code>VIC 8007</code><region>VIC</region> <code>8007</code> <country>Australia</country> </postal> <email>rsto@fastmailteam.com</email> <uri>https://www.fastmail.com</uri> </address> </author> <dateyear="2023" month="September" day="18"/> <area>Applications</area>year="2024" month="May"/> <area>art</area> <workgroup>calext</workgroup> <keyword>JSON</keyword> <keyword>contacts</keyword> <keyword>vCard</keyword> <keyword>jCard</keyword> <abstract> <t>This document defines how to convert contact information between the JSContact and vCard data formats.To achieve this, it updates RFC I-D.ietf-calext-jscontact (JSContact) by registering newIt defines conversion rules for every JSContactproperties. Similarly, it updates RFC 6350 (vCard) by registeringand vCard element registered at IANA at the time of publication. It also defines new JSContact properties as well as vCard properties andparameters.</t>parameters, to support converting arbitrary or unknown JSContact and vCard elements.</t> </abstract> </front> <middle> <section> <name>Introduction</name> <section> <name>Motivation</name> <t>The JSContact data model and format <xreftarget="I-D.ietf-calext-jscontact"/>target="RFC9553"/> aims to be an alternative to the widely used vCard standard <xref target="RFC6350"/>standardand jCard format <xref target="RFC7095"/>.</t> <t>While applications might prefer JSContact to exchange contact card data with other systems, they are likely to interoperate with services and clients that only support vCard or jCard. Similarly, existing contact data providers and consumers already using vCard or jCard might also want to represent their contact dataalsoin JSContact.</t> <t>To achieve this, this document defines standard rules to convert contact data between JSContact and vCard (and consequently jCard). </t> </section> <section anchor="notational-conventions" numbered="true" toc="default"> <name>Notational Conventions</name> <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as described inBCP 14BCP 14 <xref target="RFC2119" format="default" sectionFormat="of" derivedContent="RFC2119"/> <xref target="RFC8174" format="default" sectionFormat="of" derivedContent="RFC8174"/> when, and only when, they appear in all capitals, as shown here.</t> </section> <section anchor="abnf-notations"> <name>ABNF Notations</name> <t>The ABNF definitions in this document use the notations of <xref target="RFC5234"/>. ABNF rules not defined in this documenteitherare defined in either <xref target="RFC5234"/> (such as the ABNF for CRLF, WSP, DQUOTE, VCHAR, ALPHA, and DIGIT) or <xref target="RFC6350"/>. </t> </section> </section> <section anchor="vcard-jscontact-conversion"> <name>Converting vCard to JSContact</name> <t>This section contains the conversion rules from the vCard to the JSContact Card. It follows the same structure asthevCard v4 <xreftarget="RFC6350">vCard v4</xref>.target="RFC6350"/>. Properties and parameters of vCard extension RFCs, includingthethose described in "vCard Format Extension for JSContact" <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions">vCard JSContact Extension</xref> aretarget="RFC9554"/>, have been added to the appropriate subsections.</t> <section> <name>Generalrules</name>Rules</name> <section> <name>The<tt>uid</tt> property</name>Card uid Property</name> <t>The UID property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.6" sectionFormat="of"/>) in vCard is optional, but the<tt>uid</tt>Card object's uid propertyin JSContact(<xref target="RFC9553" derivedContent="RFC9553" section="2.1.9" sectionFormat="of"/>) is mandatory. Implementations that convert a vCard without a UID property <bcp14>MUST</bcp14> generate a unique identifier asavalue for the<tt>uid</tt>uid property. This value <bcp14>SHOULD</bcp14> be the same when converting the same vCard multiple times, but how to achieve this is implementation-specific.</t> </section> <section> <name>Choosingidentifiers</name>Identifiers</name> <t>Multivalued properties in JSContacttypicallyare typically represented as a JSON object where the object keys are of the<tt>Id</tt>Id type (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.1" sectionFormat="of"/>) and the object values are the converted vCard property. In the absence of the PROP-ID parameter (see <xref target="vcard-param-propid"/>), implementations are free to choose any identifier as key for such entries. Whatever identifier generation scheme implementations use, they <bcp14>MUST</bcp14> generate values that are valid according to the definition of the<tt>Id</tt>Id type in <xreftarget="I-D.ietf-calext-jscontact"/>.target="RFC9553"/>. For example, this could be an incrementing number across all<tt>Id</tt>sidentifier keys in the Card object or only unique within one JSON object.</t> </section> </section> <section anchor="vcard-types"> <name>vCard Value Data Types</name> <section> <name>BOOLEAN</name><t>This<t>The BOOLEAN type (<xref target="RFC6350" derivedContent="RFC6350" section="4.4" sectionFormat="of"/>) converts to the JSContact<tt>Boolean</tt> type.</t>Boolean type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t> </section> <section anchor="vcard-type-datetime"> <name>DATE, TIME, DATE-TIME, DATE-AND-OR-TIME, and TIMESTAMP</name> <t>The TIMESTAMP typegenerally(<xref target="RFC6350" derivedContent="RFC6350" section="4.3.5" sectionFormat="of"/>) converts to the<tt>UTCDateTime</tt>. ItUTCDateTime type (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.5" sectionFormat="of"/>), except for anniversaries. For anniversaries, it converts to the<tt>Timestamp</tt>Timestamp typefor anniversaries.</t>(<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>).</t> <t>The DATE type (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.1" sectionFormat="of"/>) converts tothe <tt>PartialDate</tt> type, which only is relevanta PartialDate object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>) when used foranniversaries. This does not apply toan anniversary, unless the DATEvalues thatvalue onlydefinecontains a month or aday.</t>day (but not both).</t> <t>TheTIME, DATE-TIME, DATE-AND-OR-TIMEfollowing temporal typesand DATE type values that only define a month or daydo not convert to a JSContact datetime type. Instead, vCard properties or parameters having suchvaluesvalue types convertto the propertiesas defined in <xref target="new-jscontact"/>.</t> <ul> <li>TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.2" sectionFormat="of"/>)</li> <li>DATE-TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.3" sectionFormat="of"/>)</li> <li>DATE-AND-OR-TIME (<xref target="RFC6350" derivedContent="RFC6350" section="4.3.4" sectionFormat="of"/>)</li> <li>DATE type values that only define a month or day (but not both)</li> </ul> </section> <section> <name>INTEGER</name><t>This<t>The INTEGER type (<xref target="RFC6350" derivedContent="RFC6350" section="4.5" sectionFormat="of"/>) converts to the JSContact<tt>Int</tt>Int and<tt>UnsignedInt</tt> types.</t>UnsignedInt types (<xref target="RFC9553" derivedContent="RFC9553" section="1.4.2" sectionFormat="of"/>).</t> </section> <section> <name>FLOAT</name><t>This<t>The FLOAT type (<xref target="RFC6350" derivedContent="RFC6350" section="4.6" sectionFormat="of"/>) converts to the JSContact<tt>Number</tt> type.</t>Number type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t> </section> <section> <name>LANGUAGE-TAG</name><t>This<t>The LANGUAGE-TAG type (<xref target="RFC6350" derivedContent="RFC6350" section="4.8" sectionFormat="of"/>) converts to the JSContact<tt>String</tt> type.</t>String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>). The value <bcp14>MUST</bcp14> be a language tag as defined in <xref target="RFC5646"/>.</t> </section> <section> <name>TEXT</name><t>This<t>The TEXT type (<xref target="RFC6350" derivedContent="RFC6350" section="4.1" sectionFormat="of"/>) converts to the JSContact<tt>String</tt> type.</t>String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>).</t> </section> <section> <name>URI</name><t>This<t>The URI type (<xref target="RFC6350" derivedContent="RFC6350" section="4.2" sectionFormat="of"/>) converts to the JSContact<tt>String</tt> type.</t>String type (<xref target="RFC9553" derivedContent="RFC9553" section="1.3.2" sectionFormat="of"/>). The value <bcp14>MUST</bcp14> be a URI as defined in <xref target="RFC3986" sectionFormat="of" section="3"/></t> </section> <section> <name>UTC-OFFSET</name><t>This<t>The UTC-OFFSET type (<xref target="RFC6350" derivedContent="RFC6350" section="4.7" sectionFormat="of"/>) either converts to a<tt>String</tt>String value containing an IANATimeZoneTime Zone Database entry name (see <xreftarget="vcard-prop-tz"/>),target="vcard-prop-tz"/>) oritdoes not convert to any JSContact type. For the latter, vCard properties or parameters having such values<bcp14>MAY</bcp14>convertto JSContactas defined in <xref target="new-jscontact"/>. </t> </section> </section> <section anchor="vcard-parameters"> <name>vCard Parameters</name> <t>This section contains the conversion rules for vCard parameters. A rule typicallyonlyapplies only for specific vCard properties. To convert a vCard parameter on an arbitrary vCard property, see <xref target="jscontact-prop-vcardparams"/>.</t> <section anchor="vcard-param-altid"> <name>ALTID</name><t>This<t>The ALTID parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.4" sectionFormat="of"/>) does not convert to an IANA-registered property in JSContact, but several conversion rules make use of this parameter to combine multiple vCard properties into a single JSContact object instance. For an example ofthisthis, see <xref target="vcard-prop-adr"/>. To preserve the verbatim value of the ALTID parameter, set the JSContact properties defined in <xref target="new-jscontact"/>.</t> </section> <section anchor="vcard-param-author"> <name>AUTHOR</name> <t>The AUTHOR parametervalue of(<xref target="RFC9554" derivedContent="RFC9554" section="4.1" sectionFormat="of"/>) on avCardNOTE property converts to the<tt>uri</tt>Author object's uri propertyof the(<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>). That Author objectfor this note.</t> <t>Note: This parameterisdefined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>set as the value of the Note object's author property (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-author-name"> <name>AUTHOR-NAME</name> <t>The AUTHOR-NAME parametervalue of(<xref target="RFC9554" derivedContent="RFC9554" section="4.2" sectionFormat="of"/>) on avCardNOTE property converts to the<tt>name</tt>Author object's name propertyof the(<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>). That Author objectfor this note.</t> <t>Note: This parameterisdefined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>set as the value of the Note object's author property.</t> </section> <section anchor="vcard-param-calscale"> <name>CALSCALE</name><t>This<t>The CALSCALE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.8" sectionFormat="of"/>) set on a BDAY,DEATHDATEDEATHDATE, or ANNIVERSARY property converts to the<tt>calendarScale</tt>PartialDate object's calendarScale propertyof(<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-cc"> <name>CC</name> <t>The CC parameter (<xref target="RFC8605" derivedContent="RFC8605" section="3.1" sectionFormat="of"/>) on an ADR property converts to the<tt>PartialDate</tt> object type.</t>Address object's countryCode property (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-created"> <name>CREATED</name> <t>The CREATED parametervalue of(<xref target="RFC9554" derivedContent="RFC9554" section="4.3" sectionFormat="of"/>) on avCardNOTE property converts to the<tt>created</tt> property of theNoteobject.</t> <t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>object's created property (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-derived"> <name>DERIVED</name><t>If this<t>The DERIVED parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.4" sectionFormat="of"/>) does not convert to JSContact. If the DERIVED parameter is set to<tt>true</tt>"true" on a vCard property, then implementations <bcp14>MAY</bcp14> choosetonot to convert thatproperty. Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>property.</t> </section> <section anchor="vcard-param-geo"> <name>GEO</name><t>This<t>The GEO parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.10" sectionFormat="of"/>) set on an ADR property converts to theJSContact <tt>coordinates</tt>Address object's coordinates propertyof the <tt>Address</tt> object that represents the vCard ADR.</t>(<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-group"> <name>GROUP</name><t>This<t>The GROUP parameter (<xref target="RFC7095" derivedContent="RFC7095" section="7.1" sectionFormat="of"/>) does not convert to JSContact. It exclusively is for use in jCard(see <xref target="RFC7095" section="7.1"/>). Itand <bcp14>MUST NOT</bcp14> be set in avCard. PreservingvCard.</t> <t>Preserving the exact group name when converting from vCard to JSContact and back to vCard is not necessary. Any group identifiers will do, as long as the resulting vCard groups its properties equally to the original vCard. Implementations that still wish to preserve the exact property group name of a vCard property <bcp14>MAY</bcp14> set the<tt>group</tt>jCard "group" parameter in the JSContact properties<tt>vCardProps</tt>vCardProps or<tt>vCardParams</tt>vCardParams as defined in <xref target="new-jscontact"/>.</t> <figure anchor="group_conversion_params"><name>An example how<name>Example of How topreservePreserve thegroup nameGroup Name in<tt>vCardParams</tt>vCardParams duringconversion.</name> <artwork><![CDATA[Conversion</name> <sourcecode type="text/plain"><![CDATA[ item1.TEL;VALUE=uri:tel:+1-555-555-5555 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "phones": { "p1": { "number": "tel:+1-555-555-5555", "vCardParams" : { "group" : "item1" } } }]]></artwork>]]></sourcecode> </figure> <figure anchor="group_conversion_props"><name>An example how<name>Example of How topreservePreserve thegroup nameGroup Name in<tt>vCardProps</tt>vCardProps duringconversion.</name> <artwork><![CDATA[Conversion</name> <sourcecode type="text/plain"><![CDATA[ item2.X-FOO:bar ]]></sourcecode> <sourcecode type="json"><![CDATA[ "vCardProps": [ ["x-foo", { "group": "item2" }, "unknown", "bar"] ]]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-param-index"> <name>INDEX</name><t>This<t>The INDEX parameter (<xref target="RFC6715" derivedContent="RFC6715" section="3.1" sectionFormat="of"/>) set on the EXPERTISE, HOBBY,INTERESTINTEREST, and ORG-DIRECTORY propertiesdefined in <xref target="RFC6715"/>converts to theJSContact <tt>listAs</tt> property of the <tt>PersonalInfo</tt>PersonalInfo (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) and<tt>Directory</tt> objects.</t>Directory (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) objects' listAs property.</t> </section> <section anchor="vcard-param-language"> <name>LANGUAGE</name><t>This<t>The LANGUAGE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.1" sectionFormat="of"/>) converts to an entry in the<tt>localizations</tt>Card object's localizations property (<xref target="RFC9553" derivedContent="RFC9553" section="2.7.1" sectionFormat="of"/>) forthethat vCard propertythaton which this parameter is set on. The value of the LANGUAGE parameter defines the language tag key in the<tt>localizations</tt>localizations property.</t> <t>This specification does not define a single standard conversion rule for how to convert the property values. Instead, building the localizations value is implementation-specific.</t> <t>Two options to populate the localizations property are:</t> <ul> <li>One PatchPerper Property: For each vCard property with a LANGUAGE parameter, set the complete path in the PatchObject to the JSContact property that the vCard property converts to. The value of the patch is the converted property value. This is simple to process and adequate if the vCard only contains a few properties with the LANGUAGE parameter.</li> <li>Bundle Patches by Parent: If a PatchObject contains multiple paths that have the same parent paths, then it might be possible to combine these patches into one patch that patches the parent property. This is possible if the property in the Card is patched in its entirety.</li> </ul> <t>Generally, localizations only localize properties that are present in the non-localized version of this Card. <xref target="language-patch-dominant-language"/> illustrates this.</t> <figure anchor="language-patch-dominant-language"> <name>LANGUAGEconversion example: one dominant language</name> <artwork><![CDATA[Conversion Example: One Dominant Language</name> <sourcecode type="text/plain"><![CDATA[ FN;LANGUAGE=EN:John DoeTITLE;LANGUAGE=EN:Boss TITLE;LANGUAGE=fr:PatronTITLE;ALTID=1;LANGUAGE=EN:Boss TITLE;ALTID=1;LANGUAGE=fr:Patron ]]></sourcecode> <sourcecode type="json"><![CDATA[ "language": "en", "name": { "full": "John Doe" }, "titles": { "t1": { "name": "Boss" } }, "localizations": { "fr": { "titles/t1/name": "Patron" } }]]></artwork>]]></sourcecode> </figure> <t>As a special case, if one or more vCard properties of the same type do not have the LANGUAGE parameter set,then chooseadd them to the non-localized Card. Convert any with LANGUAGE parameters to the localizations property. <xref target="language-patch-no-language"/> illustrates this.</t> <figure anchor="language-patch-no-language"> <name>LANGUAGEconversion example: propertyConversion Example: Property withoutlanguage</name> <artwork><![CDATA[Language</name> <sourcecode type="text/plain"><![CDATA[ FN:John DoeTITLE:Boss TITLE;LANGUAGE=fr:PatronTITLE;ALTID=1:Boss TITLE;ALTID=1;LANGUAGE=fr:Patron ]]></sourcecode> <sourcecode type="json"><![CDATA[ "name": { "full": "John Doe" }, "titles": { "t1": { "name": "Boss" } }, "localizations": { "fr": { "titles/t1/name": "Patron" } }]]></artwork>]]></sourcecode> </figure><t>As the least preferred option, <xref target="language-patch-no-dominant"/> illustrates how all vCard properties of the same type have the LANGUAGE parameter set, but none of their language tags match the language of the main Card. In this case, implementations <bcp14>MAY</bcp14> choose to add the localized vCard properties only to the localizations object.</t></section> <section anchor="vcard-param-label"> <name>LABEL</name> <t>Thefollowing example uses non-ASCII characters to demonstrate multilingual content. The ASCII-formatted version of this specification might not show the correct characters. Please referLABEL parameter (<xref target="RFC6350" derivedContent="RFC6350" section="6.3.1" sectionFormat="of"/>) on an ADR property converts to theHTML or PDF versions instead.</t> <figure anchor="language-patch-no-dominant"> <name>LANGUAGE conversion example: conflicting LANGUAGEAddress object's full propertyand parameter values</name> <artwork><![CDATA[ LANGUAGE:es FN:Gabriel García Márquez TITLE;LANGUAGE=en:Boss TITLE;LANGUAGE=fr:Patron "language": "es", "name" { "full": "Gabriel García Márquez" }, "localizations": { "en": { "titles": { "t1": { "name": "Novelist" } }, "fr": { "titles": { "t1": { "name": "Écrivain" } } } ]]></artwork> </figure>(<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-level"> <name>LEVEL</name> <t>The LEVEL parameter<xref target="RFC6715"/>(<xref target="RFC6715" derivedContent="RFC6715" section="3.2" sectionFormat="of"/>) converts to the<tt>level</tt>PersonalInfo object's level propertyof the <tt>PersonalInfo</tt> type.(<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>). If this parameter is set on the EXPERTISE property, then its values convertas:as follows: </t> <ul spacing="compact"> <li>"beginner" converts to "low";</li> <li>"average" converts to"medium";</li>"medium"; and</li> <li>"expert" converts to "high".</li> </ul> <t>In all othercasescases, the values convert verbatim, but lowercase <bcp14>MUST</bcp14> be used for the JSContact value.</t> </section> <section anchor="vcard-param-mediatype"> <name>MEDIATYPE</name><t>This<t>The MEDIATYPE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.7" sectionFormat="of"/>) converts to the<tt>mediaType</tt>Resource object's mediaType propertyof the <tt>Resource</tt> object type.</t>(<xref target="RFC9553" derivedContent="RFC9553" section="1.4.4" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-phonetic"> <name>PHONETIC</name><t>This<t>The PHONETIC parameteras well as(<xref target="RFC9554" derivedContent="RFC9554" section="4.6" sectionFormat="of"/>) converts to the Name (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) and Address (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) objects' phoneticSystem property unless the<xref target="vcard-param-script">SCRIPT</xref>parameterset on a N or ADRvalue is "script", in which case the phoneticSystem propertyconvert to JSContact as follows:</t> <t>the valuesis not set.</t> <t>The value of the<tt>phonetic</tt>, <tt>phoneticScript</tt> and <tt>phoneticSystem</tt> properties ofSCRIPT parameter converts to theNameComponent and Name or AddressComponent and Address object types, respectively.</t>phoneticScript property (see <xref target="vcard-param-script"/>).</t> <t>The related N or ADR property is defined by the vCard ALTID parameter. The conversion rules for the <xref target="vcard-prop-n">N</xref> and <xref target="vcard-prop-adr">ADR</xref> properties define how the vCard components convert to JSContact.</t> <t>Thevaluecomponent values of thePHONETIC parameter converts to the <tt>phoneticSystem</tt>propertyunless it is <tt>script</tt>, inon whichcasethe<tt>phoneticSystem</tt> property is not set. The value of the SCRIPTPHONETIC parameterconverts to the <tt>phoneticScript</tt> property.</t> <t>The values of the components in the property valueis set convert tovalues the <tt>phonetic</tt> properties forthe respective NameComponent orAddressComponent.</t>AddressComponent objects' phonetic properties.</t> <t>If more than one propertyhavinghas the PHONETIC parameter set and relates to the same property, then they convert to the Card<tt>localizations</tt>object's localizations property according to their LANGUAGE parameter values as outlined in <xref target="vcard-param-language"/>.</t> <figure anchor="phonetic_conversion"> <name>PHONETICconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ LANGUAGE=zh-Hant N;ALTID=1;LANGUAGE=zh-Hant:孫;中山;文,逸仙;; N;ALTID=1;PHONETIC=jyut; SCRIPT=Latn;LANGUAGE=yue:syun1;zung1saan1;man4,jat6sin1;; ]]></sourcecode> <sourcecode type="json"><![CDATA[ "language": "zh-Hant", "name": { "components": [ { "kind": "surname", "value": "孫" }, { "kind": "given", "value": "中山" }, { "kind": "given2", "value": "文" }, { "kind": "given2", "value": "逸仙" } ] }, "localizations": { "yue": { "name/phoneticSystem": "jyut", "name/phoneticScript": "Latn", "name/components/0/phonetic": "syun1", "name/components/1/phonetic": "zung1saan1", "name/components/2/phonetic": "man4", "name/components/3/phonetic": "jat6sin1" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-param-pid"> <name>PID</name><t>This<t>The PID parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.5" sectionFormat="of"/>) converts toan entry inthe<tt>vCardParams</tt> property,vCardParams property; see <xref target="jscontact-prop-vcardparams"/>.</t> </section> <section anchor="vcard-param-pref"> <name>PREF</name><t>This<t>The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) converts to the<tt>pref</tt> property.</t>pref property of the derived JSContact object.</t> </section> <section anchor="vcard-param-propid"> <name>PROP-ID</name> <t>The PROP-ID parametervalue of a vCard property(<xref target="RFC9554" derivedContent="RFC9554" section="4.7" sectionFormat="of"/>) converts to the<tt>Id</tt>Id-typed key of the derived JSContactproperty to which the vCard property converts.</t>object.</t> <figure anchor="propid_conversion"> <name>PROP-IDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ TEL;PROP-ID=PHONE-A;VALUE=uri;PREF=1;TYPE="voice,home" :tel:+1-555-555-5555;ext=5555 TEL;PROP-ID=PHONE-B;VALUE=uri;TYPE=home :tel:+33-01-23-45-67 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "phones": { "PHONE-A": { "contexts": { "private": true }, "features": { "voice": true }, "number": "tel:+1-555-555-5555;ext=5555", "pref": 1 }, "PHONE-B": { "contexts": { "private": true }, "number": "tel:+33-01-23-45-67" } }]]></artwork>]]></sourcecode> </figure><t>Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t></section> <section anchor="vcard-param-script"> <name>SCRIPT</name><t>See<t>The SCRIPT parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.8" sectionFormat="of"/>) converts to the Name (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) or Address (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) objects' phoneticScript property.</t> <t>Also see <xref target="vcard-param-phonetic"/>.</t> </section> <section anchor="vcard-param-service-type"> <name>SERVICE-TYPE</name><t>This<t>The SERVICE-TYPE parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.9" sectionFormat="of"/>) converts to the<tt>service</tt>OnlineService object's service propertyof the <tt>OnlineService</tt> object type. Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>(<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-sortas"> <name>SORT-AS</name><t>This<t>The SORT-AS parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.9" sectionFormat="of"/>) converts to the<tt>sortAs</tt> properties defined for the <tt>Name</tt>, <tt>Organization</tt>Name, Organization, and<tt>OrgUnit</tt> object types.</t>OrgUnit objects' sortAs properties.</t> </section> <section anchor="vcard-param-type"> <name>TYPE</name><t>This<t>The TYPE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.6" sectionFormat="of"/>) converts to either the<tt>contexts</tt>contexts property or the kind property, aswell as property-specific <tt>kind</tt> property valuesdefined in later sections. If notspecifiedotherwisefor a specific JSContact property,specified, the vCard<tt>home</tt>"home" and<tt>work</tt>"work" parameter values convert to the JSContact<tt>private</tt>"private" and<tt>work</tt>"work" contexts, respectively.</t> </section> <section anchor="vcard-param-tz"> <name>TZ</name><t>This<t>The TZ parameterset(<xref target="RFC6350" derivedContent="RFC6350" section="5.11" sectionFormat="of"/>) on an ADR property converts to theJSContact <tt>timeZone</tt>Address object's timeZone propertyof the <tt>Address</tt> object that represents the vCard ADR.(<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>). Also see the conversion of the TZ property in <xref target="vcard-prop-tz"/>.</t> </section> <section anchor="vcard-param-username"> <name>USERNAME</name><t>This<t>The USERNAME parameter (<xref target="RFC9554" derivedContent="RFC9554" section="4.10" sectionFormat="of"/>) converts to the<tt>user</tt>OnlineService object's user propertyof the <tt>OnlineService</tt> object type. Note: This parameter is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>(<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>).</t> </section> <section anchor="vcard-param-value"> <name>VALUE</name><t>This<t>The VALUE parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.2" sectionFormat="of"/>) does not convert to an IANA-registered property in JSContact. To preserve properties with experimental values, see Sections <xreftarget="jscontact-prop-vcardparams"/>target="jscontact-prop-vcardprops" format="counter"/> and <xreftarget="jscontact-prop-vcardprops"/>.</t>target="jscontact-prop-vcardparams" format="counter"/>.</t> </section> </section> <section> <name>General Properties</name> <section> <name>BEGIN and END</name><t>These<t>The BEGIN and END properties do not convert to IANA-registered properties in JSContact.</t> </section> <section anchor="vcard-prop-kind"> <name>KIND</name> <t>The KIND property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.4" sectionFormat="of"/>) converts to the<tt>kind</tt>kind property (<xref target="kind_conversion"/>). Allowed values are those described inSection 6.1.4 of<xreftarget="RFC6350"/>target="RFC6350" sectionFormat="of" section="6.1.4"/> and extended with the values declared in <xref target="RFC6473"/> and <xref target="RFC6869"/>.</t> <figure anchor="kind_conversion"> <name>KINDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ KIND:individual ]]></sourcecode> <sourcecode type="json"><![CDATA[ "kind": "individual"]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-source"> <name>SOURCE</name> <t>The SOURCE property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.3" sectionFormat="of"/>) converts to a Directory object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) in the<tt>directories</tt>Card object's directories property (<xref target="source_conversion"/>). The<tt>kind</tt>Directory object's kind property is set to<tt>entry</tt>."entry". The<tt>uri</tt>uri property is set to the SOURCE property value.</t> <t>The PREF and MEDIATYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="source_conversion"> <name>SOURCEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ SOURCE:https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf ]]></sourcecode> <sourcecode type="json"><![CDATA[ "directories": { "ENTRY-1": { "kind": "entry", "uri": "https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-xml"> <name>XML</name><t>This<t>The XML property (<xref target="RFC6350" derivedContent="RFC6350" section="6.1.5" sectionFormat="of"/>) converts toan entry inthe<tt>vCardProps</tt> property,vCardProps property; see <xref target="jscontact-prop-vcardprops"/>.</t> </section> </section> <section> <name>Identification Properties</name> <section anchor="vcard-prop-anniversary"><name>BDAY,<name>ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE,DEATHPLACE, ANNIVERSARY</name> <t>The BDAYandANNIVERSARYDEATHPLACE</name> <t>The following propertiesand the extensions BIRTHPLACE, DEATHDATE, DEATHPLACE described in <xref target="RFC6474"/> are represented as <tt>Anniversary</tt>all convert to Anniversary objectsincludedin the<tt>anniversaries</tt>Card object's anniversaries property (<xref target="anniversary_conversion"/>):</t> <ul spacing="compact"><li><li>ANNIVERSARY (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.6" sectionFormat="of"/>)</li> <li>BDAY (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.5" sectionFormat="of"/>)</li> <li>BIRTHPLACE (<xref target="RFC6474" derivedContent="RFC6474" section="2.1" sectionFormat="of"/>)</li> <li>DEATHDATE (<xref target="RFC6474" derivedContent="RFC6474" section="2.3" sectionFormat="of"/>)</li> <li>DEATHPLACE (<xref target="RFC6474" derivedContent="RFC6474" section="2.2" sectionFormat="of"/>)</li> </ul> <t>BDAY and BIRTHPLACE convert to<tt>date</tt>an Anniversary object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.1" sectionFormat="of"/>) having the date and<tt>place</tt> where <tt>kind</tt>place properties set. The kind property is set to"birth";</t> <t/> </li> <li>"birth". </t> <t>DEATHDATE and DEATHPLACE convert to<tt>date</tt>an Anniversary object having the date and<tt>place</tt> where <tt>kind</tt>place properties set. The Anniversary object's kind property is set to"death";</t> <t/> </li> <li>ANNIVERSARY"death". </t> <t>ANNIVERSARY converts to<tt>date</tt> where <tt>kind</tt>the Anniversary object's date property. The Anniversary object's kind property is"wedding".</li> </ul> <t>Both birth and death places are represented as instances ofset to "wedding".</t> <t>If the<tt>Address</tt> object.</t> <t>TheBIRTHPLACEandor DEATHPLACEproperties that are represented as geo URIs convertproperty value is of type URI using the "geo:" URI scheme, then it converts to<tt>Address</tt> instances including onlythe<tt>coordinates</tt>Address object's coordinates property. If theURIvalue type isnot a geo URI,TEXT, then it converts to theplace is ignored.</t>Address object's full property. Otherwise, it converts to the vCardProps property; see <xref target="jscontact-prop-vcardprops"/>.</t> <t>The ALTID and LANGUAGE parameters of both the BIRTHPLACE and DEATHPLACE properties convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="anniversary_conversion"><name>BDAY,<name>ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE,DEATHPLACE, ANNIVERSARY conversion example</name> <artwork><![CDATA[and DEATHPLACE Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ BDAY:19531015T231000Z BIRTHPLACE: 123 Main Street\nAny Town, CA 91921-1234\nU.S.A. DEATHDATE:19960415 DEATHPLACE: 5 Court Street\nNew England, ND 58647\nU.S.A. ANNIVERSARY:19860201 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "anniversaries": { "ANNIVERSARY-1" : { "kind": "birth", "date": { "@type": "Timestamp", "utc": "1953-10-15T23:10:00Z" }, "place": { "full": "123 Main Street\nAny Town, CA 91921-1234\nU.S.A." } }, "ANNIVERSARY-2" : { "kind": "death", "date": { "year": 1996, "month": 4, "year": 15 }, "place": { "full": "5 Court Street\nNew England, ND 58647\nU.S.A." } }, "ANNIVERSARY-3" : { "kind": "wedding", "date": { "year": 1986, "month": 2, "day": 1 } } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-fn"> <name>FN</name> <t>The FN property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.1" sectionFormat="of"/>) converts to the Nameobject in the <tt>name</tt> property. Its value converts to the Name object <tt>full</tt>object's full property (<xref target="fn_conversion"/>). If the LANGUAGE parameter is set, then the FN property converts as outlined in <xref target="vcard-param-language"/>. In the unexpected casethatwhere the vCard contains more than one FN property without the LANGUAGE parameter,thenconvert the FN property that has the leastparameters set to the <tt>full</tt> property.parameters. If multiple such FN properties are present, choose any of them. All other FN properties convert to the <xreftarget="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref>target="jscontact-prop-vcardprops">vCardProps</xref> property.</t> <figure anchor="fn_conversion"> <name>FNconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ FN:John Q. Public, Esq. ]]></sourcecode> <sourcecode type="json"><![CDATA[ "name": { "full": "John Q. Public,Esq.",Esq." }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-gender"> <name>GENDER</name><t>This<t>The GENDER property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.7" sectionFormat="of"/>) does notmapconvert to an IANA-registered property in JSContact. To convert this property, see <xref target="jscontact-prop-vcardprops"/>.NoteAlternatively, thealternative JSContact <tt>speakToAs</tt>Card object's speakToAs propertywhichdefines how to address and refer to an individual represented by thecard,Card, as do the newly defined vCard GRAMGENDER and PRONOUNS properties of <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t>target="RFC9554"/>.</t> </section> <section anchor="vcard-prop-gramgender"> <name>GRAMGENDER and PRONOUNS</name> <t>The GRAMGENDER property (<xref target="RFC9554" derivedContent="RFC9554" section="3.2" sectionFormat="of"/>) converts to the<tt>grammaticalGender</tt>SpeakToAs object's grammaticalGender propertyof the <tt>SpeakToAs</tt> object(<xref target="grammatical_gender_pronouns_conversion"/>).</t> <t>The PRONOUNS property (<xref target="RFC9554" derivedContent="RFC9554" section="3.4" sectionFormat="of"/>) converts toan entry inthe<tt>pronouns</tt>SpeakToAs object's pronouns propertyof the <tt>SpeakToAs</tt> object(<xref target="grammatical_gender_pronouns_conversion"/>).</t> <figure anchor="grammatical_gender_pronouns_conversion"> <name>GRAMGENDER and PRONOUNSconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ GRAMGENDER:NEUTER PRONOUNS;PREF=2:they/them PRONOUNS;PREF=1:xe/xir ]]></sourcecode> <sourcecode type="json"><![CDATA[ "speakToAs": { "grammaticalGender": "neuter", "pronouns": { "PRONOUNS-1": { "pronouns": "they/them", "pref": 2 }, "PRONOUNS-2": { "pronouns": "xe/xir", "pref": 1 } } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-n"> <name>N</name> <t>The N property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.2" sectionFormat="of"/>) converts tothea Name object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.1" sectionFormat="of"/>) in the<tt>name</tt>Card object's name property. Each component in the N property structured value converts to a NameComponent in the Name<tt>components</tt>object's components property. The following table shows this relation:</t> <table anchor="n_kind_conversion"> <name>Ncomponents conversion</name>Components Conversion</name> <thead> <tr> <th align="left">N component</th> <th align="left">NameComponent kind</th> <th align="left">Remarks</th> </tr> </thead> <tbody> <tr> <td align="left">Family name</td> <td align="left">surname</td> <td align="left">To vCard: add any<tt>surname2</tt>"surname2" NameComponentvalue in here,to the Family name component, after all<tt>surname</tt>"surname" values.<br/>From vCard: ignore any value that also occurs in the Secondary surname component.</td> </tr> <tr> <td align="left">Given name</td> <td align="left">given</td> <td align="left"/> </tr> <tr> <td align="left">Additional name</td> <td align="left">given2</td> <td align="left"/> </tr> <tr> <td align="left">Honorific prefix</td> <td align="left">title</td> <td align="left"/> </tr> <tr> <td align="left">Honorific suffix</td> <td align="left">credential</td> <td align="left">To vCard: add any<tt>generation</tt>"generation" NameComponentvalue also in here.<br/>Fromto the Honorific suffix component.<br/>From vCard: ignore any value that also occurs in the Generation component.</td> </tr> <tr> <td align="left">Secondary surname</td> <td align="left">surname2</td> <td align="left"/> </tr> <tr> <td align="left">Generation</td> <td align="left">generation</td> <td align="left"/> </tr> </tbody> </table> <t>If the <xref target="vcard-param-jscomps">JSCOMPS</xref> parameter is set, then the Name<tt>isOrdered</tt>object's isOrdered property value is "true", and the<tt>defaultSeparator</tt>defaultSeparator property and anyseparator name components"separator" NameComponent objects are set according to the parameter value. The<tt>components</tt> listorder in the components property <bcp14>MUST</bcp14> adhere to the order of the JSCOMPS parameter value.</t> <t>If the JSCOMPS parameter is not set, then the Name<tt>isOrdered</tt>object's isOrdered property value is"false""false", and the<tt>defaultSeparator</tt>defaultSeparator property <bcp14>MUST NOT</bcp14> be set. The<tt>components</tt> listorder in the components property <bcp14>MUST</bcp14> follow the order of values in the N structured value when read from left to right.</t> <t>If the SORT-AS parameter is set, then its structured value converts to the Name<tt>sortAs</tt>object's sortAs property according to <xref target="n_kind_conversion"/>. An empty or non-existent component value indicates that no sort is defined for this kind.</t> <figure anchor="n_conversion"> <name>Nconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ N;SORT-AS="Stevenson,JohnPhilip":Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.;;Jr.Philip": Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.;;Jr. ]]></sourcecode> <sourcecode type="json"><![CDATA[ "name": { "components":[ { "kind": "surname", "value": "Stevenson" }, { "kind": "given", "value": "John" }, { "kind": "given2", "value": "Philip" }, { "kind": "given2", "value": "Paul" }, { "kind": "title", "value": "Dr." }, { "kind": "credential", "value": "M.D." }, { "kind": "credential", "value": "A.C.P." }, { "kind": "generation", "value": "Jr." } ], "sortAs": { "surname": "Stevenson", "given": "John Philip" } }]]></artwork>]]></sourcecode> </figure> <t>See <xref target="vcard-param-jscomps-examples"/> for examples of using the JSCOMPS parameter forvCard structuredvCard-structured property values.</t> </section> <section anchor="vcard-prop-nickname"> <name>NICKNAME</name><t>A<t>The NICKNAME property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.3" sectionFormat="of"/>) converts to a Nickname object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.2" sectionFormat="of"/>) in the<tt>nicknames</tt>Card object's nicknames property (<xref target="nickname_conversion"/>). The<tt>name</tt>name property is set to the NICKNAME property value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="nickname_conversion"> <name>NICKNAMEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ NICKNAME:Johnny ]]></sourcecode> <sourcecode type="json"><![CDATA[ "nicknames": { "NICK-1": { "name": "Johnny" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-photo"> <name>PHOTO</name><t>A<t>The PHOTO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.2.4" sectionFormat="of"/>) converts toan entrya Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the<tt>media</tt>Card object's media property (<xref target="photo_conversion"/>). Theentry value is a <tt>Media</tt> object whose <tt>kind</tt>Media object's kind property is set to<tt>photo</tt>"photo" and<tt>uri</tt>the uri property is set to the PHOTO value.</t> <t>The PREF and MEDIATYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="photo_conversion"> <name>PHOTOconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ PHOTO:https://www.example.com/pub/photos/jqpublic.gif ]]></sourcecode> <sourcecode type="json"><![CDATA[ "media": { "PHOTO-1": { "kind": "photo", "uri": "https://www.example.com/pub/photos/jqpublic.gif" } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Delivery Addressing Properties</name> <section anchor="vcard-prop-adr"> <name>ADR</name> <t>The ADR property (<xref target="RFC6350" derivedContent="RFC6350" section="6.3.1" sectionFormat="of"/>) converts to an Address object (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1.1" sectionFormat="of"/>) in the<tt>addresses</tt>Card object's addresses property. Each component in theADRADR-structured propertystructuredvalue converts to an AddressComponent in the Address<tt>components</tt>object's components property.</t> <t><xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>target="RFC9554"/> defines newcomponentcomponents for the ADR property. Implementations <bcp14>SHOULD</bcp14> set these new components, even if all their values are the empty string.</t> <t>The following table shows how the ADR component and AddressComponent kind relate:</t> <table anchor="adr_kind_conversion"> <name>ADRcomponents conversion</name>Components Conversion</name> <thead> <tr> <th align="left">ADR component</th> <th align="left">AddressComponent kind</th> <th align="left">Remarks</th> </tr> </thead> <tbody> <tr> <td align="left">post office box</td> <td align="left">postOfficeBox</td> <td align="left"><xref target="RFC6350"/> recommends that this component not be set, but thisnowis now disputable given the new components. Instead, set this component and use the new ADR value format defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">extended address</td> <tdalign="left">apartment (see Remarks)</td>align="left">apartment</td> <td align="left"><t>To vCard:Setset the values of the following components:</t> <ul> <li>room</li> <li>floor</li> <li>apartment</li> <li>building</li> </ul> <t>From vCard:Ignoreignore if the ADR structured value is of the format defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>. Otherwisetarget="RFC9554"/>. Otherwise, convert to<tt>apartment</tt>.</t></td>"apartment".</t></td> </tr> <tr> <td align="left">street address</td> <tdalign="left">name (see Remarks)</td>align="left">name</td> <td align="left"><t>To vCard:Setset the values of the following components:</t> <ul> <li>number</li> <li>name</li> <li>block</li> <li>direction</li> <li>landmark</li> <li>subdistrict</li> <li>district</li> </ul> <t>From vCard:Ignoreignore if the ADR structured value is of the format defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>. Otherwisetarget="RFC9554"/>. Otherwise, convert to<tt>name</tt>.</t></td>"name".</t></td> </tr> <tr> <td align="left">locality</td> <td align="left">locality</td> <td align="left"/> </tr> <tr> <td align="left">region</td> <td align="left">region</td> <td align="left"/> </tr> <tr> <td align="left">postal code</td> <td align="left">postcode</td> <td align="left"/> </tr> <tr> <td align="left">apartment</td> <td align="left">apartment</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">block</td> <td align="left">block</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">building</td> <td align="left">building</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">direction</td> <td align="left">direction</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">district</td> <td align="left">district</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">floor</td> <td align="left">floor</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">landmark</td> <td align="left">landmark</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">room</td> <td align="left">room</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">street number</td> <td align="left">number</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> <tr> <td align="left">subdistrict</td> <td align="left">subdistrict</td> <td>Defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</td>target="RFC9554"/>.</td> </tr> </tbody> </table> <t>If the <xref target="vcard-param-jscomps">JSCOMPS</xref> parameter is set, then the Address<tt>isOrdered</tt>object's isOrdered property value is "true", and the<tt>defaultSeparator</tt>defaultSeparator property and any separator name components are set according to the parameter value. The<tt>components</tt> listorder in the components property <bcp14>MUST</bcp14> adhere to the order of the JSCOMPS parameter value.</t> <t>If the JSCOMPS parameter is not set, then the Address<tt>isOrdered</tt>object's isOrdered property value is"false""false", and the<tt>defaultSeparator</tt>defaultSeparator property <bcp14>MUST NOT</bcp14> be set. The<tt>components</tt> listorder in the components property <bcp14>MUST</bcp14> follow the order of values in the ADR structured value when read from left to right.</t><t>The<ul empty="true"> <li>The LABEL parameter converts to the Address<tt>full</tt> property.</t> <t>Theobject's full property.</li> <li>The GEO parameter converts to the Address<tt>coordinates</tt> property.</t> <t>Theobject's coordinates property.</li> <li>The TZ parameter converts to the Address<tt>timeZone</tt> property.</t> <t>Theobject's timeZone property.</li> <li>The CC parameteras defined in <xref target="RFC8605"/>converts to the Address<tt>countryCode</tt> property.</t>object's countryCode property.</li> </ul> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>. The ADR-specific values of the TYPE parameter defined in Sections5.1<xref target="RFC9554" sectionFormat="bare" section="5.1"/> and5.2<xref target="RFC9554" sectionFormat="bare" section="5.2"/> of <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>target="RFC9554"/> convert to the corresponding entries of the<tt>contexts</tt>contexts property as defined inSection 2.5.1 of<xreftarget="I-D.ietf-calext-jscontact"/>.</t>target="RFC9553" sectionFormat="of" section="2.5.1"/>.</t> <t>The ALTID and LANGUAGE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>. Each possible language-dependent alternativeis represented asconverts to an entry of the PatchObjectmapwhere the key references the<tt>full</tt>full property.</t> <figure anchor="adr_conversion"> <name>ADRconversion example</name> <artwork><![CDATA[ ADR;TYPE=work;CC=US:;;54321Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ ADR;TYPE=work;CC=US: ;;54321 OakSt;Reston;VA;20190;USA;;;;Oak St;54321;;;;;St;Reston;VA;20190;USA;;;;54321;Oak St;;;;;; ]]></sourcecode> <sourcecode type="json"><![CDATA[ "addresses": { "ADDR-1" : { "contexts": { "work": true }, "components": [ { "kind": "number", "value": "54321" }, { "kind": "name", "value": "Oak St" }, { "kind": "locality", "value": "Reston" }, { "kind": "region", "value": "VA" }, { "kind": "postcode", "value": "20190" }, { "kind": "country", "value": "USA" } ], "countryCode":"US","US" } }]]></artwork>]]></sourcecode> </figure> <t>See <xref target="vcard-param-jscomps-examples"/> for examples of using the JSCOMPS parameter forvCard structuredvCard-structured property values.</t> </section> </section> <section> <name>Communications Properties</name> <section anchor="vcard-prop-email"> <name>EMAIL</name><t>An<t>The EMAIL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.2" sectionFormat="of"/>) converts to anentryEmailAddress object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.1" sectionFormat="of"/>) in the<tt>emails</tt>Card object's emails property (<xref target="email_conversion"/>). Theentry value is an <tt>EmailAddress</tt> object. The <tt>address</tt>EmailAddress object's address property is set to the EMAIL value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="email_conversion"> <name>EMAILconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ EMAIL;TYPE=work:jqpublic@xyz.example.com EMAIL;PREF=1:jane_doe@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "emails": { "EMAIL-1": { "contexts": { "work": true }, "address": "jqpublic@xyz.example.com" }, "EMAIL-2": { "address": "jane_doe@example.com", "pref": 1 } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-impp"> <name>IMPP</name><t>An<t>The IMPP property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.3" sectionFormat="of"/>) converts to anentryOnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in the<tt>onlineServices</tt>Card object's onlineServices property (<xref target="impp_conversion"/>). Theentry value is an <tt>OnlineService</tt> object. The <tt>vCardName</tt>vCardName property is set to"impp""impp", and the<tt>uri</tt>uri property is set to the IMPP value.</t> <t>The SERVICE-TYPE, USERNAME,PREFPREF, and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="impp_conversion"> <name>IMPPconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ IMPP;PREF=1:xmpp:alice@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "onlineServices": { "OS-1": { "uri": "xmpp:alice@example.com", "pref": 1, "vCardName": "impp" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-lang"> <name>LANG</name><t>A<t>The LANG property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.4" sectionFormat="of"/>) converts toan entrya LanguagePref object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.4" sectionFormat="of"/>) in the<tt>preferredLanguages</tt>Card object's preferredLanguages property (<xref target="lang_conversion"/>). Theentry value is an <tt>LanguagePref</tt> object. The LanguagePref <tt>language</tt>LANG property valueisconverts to theLANGLanguagePref object's language property value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="lang_conversion"> <name>LANGconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ LANG;TYPE=work;PREF=1:en LANG;TYPE=work;PREF=2:fr LANG;TYPE=home:fr ]]></sourcecode> <sourcecode type="json"><![CDATA[ "preferredLanguages": { "LANG-1": { "language": "en", "contexts": { "work": true }, "pref": 1 }, "LANG-2": { "language": "fr", "contexts": { "work": true }, "pref": 2 }, "LANG-3": { "language": "fr", "contexts": { "private": true } } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-language"> <name>LANGUAGE</name> <t>The LANGUAGE property (<xref target="RFC9554" derivedContent="RFC9554" section="3.3" sectionFormat="of"/>) converts to the<tt>language</tt>Card object's language property (<xref target="languageprop_conversion"/>).</t> <figure anchor="languageprop_conversion"> <name>LANGUAGEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ LANGUAGE:de-AT ]]></sourcecode> <sourcecode type="json"><![CDATA[ "language": "de-AT"]]></artwork>]]></sourcecode> </figure><t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t></section> <section anchor="vcard-prop-socialprofile"> <name>SOCIALPROFILE</name><t>A<t>The SOCIALPROFILE property (<xref target="RFC9554" derivedContent="RFC9554" section="3.5" sectionFormat="of"/>) converts to anentryOnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in the<tt>onlineServices</tt>Card object's onlineServices property (<xref target="socialprofile_conversion"/>). Theentry value is an <tt>OnlineService</tt> object. The <tt>vCardName</tt>vCardName property is set to"socialprofile""socialprofile", or it can be omitted. If thevalue type of theSOCIALPROFILE property value is of type URI, then the<tt>uri</tt>OnlineService object's uri property isset to the SOCIALPROFILE value. Otherwise,set; otherwise, the<tt>user</tt>user property isset to the SOCIALPROFILE value.</t>set.</t> <t>The SERVICE-TYPE, USERNAME,PREFPREF, and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="socialprofile_conversion"> <name>SOCIALPROFILEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ SOCIALPROFILE;SERVICE-TYPE=Mastodon:https://example.com/@foo ]]></sourcecode> <sourcecode type="json"><![CDATA[ "onlineServices": { ... "OS-1": { "service": "Mastodon", "uri": "https://example.com/@foo" } }]]></artwork>]]></sourcecode> </figure><t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t></section> <section anchor="vcard-prop-tel"> <name>TEL</name><t>A<t>The TEL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.4.1" sectionFormat="of"/>) converts toan entrya Phone object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.3" sectionFormat="of"/>) in the<tt>phones</tt>Card object's phones property (<xreftarget="tel_conversion"/>). The entry value is a <tt>Phone</tt> object.</t>target="tel_conversion"/>).</t> <t>The TEL-specific values of the TYPE parameter convert to the<tt>features</tt>features property keys as outlined intable<xref target="tel_type_conversion"/>. Note that <xref target="RFC6350" sectionFormat="of" section="6.4.1"/> defines the defaultTYPE of TELtype to be<tt>voice</tt>,"voice", but the default Phone features property is absent by default. Accordingly, an implementation <bcp14>SHOULD</bcp14> only set the Phone<tt>features</tt>object's features property if the TEL property actually has a TEL-specific TYPE parameter set.</t> <table anchor="tel_type_conversion"> <name>TEL TYPEconversion</name>Conversion</name> <thead> <tr> <th align="left">TYPE value</th> <th align="left">Phone feature</th> </tr> </thead> <tbody> <tr> <td align="left">cell</td> <td align="left">mobile</td> </tr> <tr> <td align="left">fax</td> <td align="left">fax</td> </tr> <tr> <td align="left">main-number</td> <td align="left">main-number</td> </tr> <tr> <td align="left">pager</td> <td align="left">pager</td> </tr> <tr> <td align="left">text</td> <td align="left">text</td> </tr> <tr> <td align="left">textphone</td> <td align="left">textphone</td> </tr> <tr> <td align="left">video</td> <td align="left">video</td> </tr> <tr> <td align="left">voice</td> <td align="left">voice</td> </tr> </tbody> </table> <t>The value of the TEL property converts to the Phone<tt>number</tt>object's number property.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="tel_conversion"> <name>TELconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ TEL;VALUE=uri;PREF=1;TYPE="voice,home":tel:+1-555-555-5555;ext=5555 TEL;VALUE=uri;TYPE=home:tel:+33-01-23-45-67 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "phones": { "PHONE-1": { "contexts": { "private": true }, "features": { "voice": true }, "number": "tel:+1-555-555-5555;ext=5555", "pref": 1 }, "PHONE-2": { "contexts": { "private": true }, "number": "tel:+33-01-23-45-67" } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Geographical Properties</name> <section anchor="vcard-prop-geo"> <name>GEO</name><t>This<t>The GEO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.5.2" sectionFormat="of"/>) converts to the<tt>coordinates</tt>Address object's coordinates propertyof the <tt>Address</tt> object.(<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>). Also see <xref target="combine-geo-props"/> to determine which<tt>Address</tt>Address object instance to convert to.</t> </section> <section anchor="vcard-prop-tz"> <name>TZ</name> <t>The TZ property (<xref target="RFC6350" derivedContent="RFC6350" section="6.5.1" sectionFormat="of"/>) converts an Address object (<xref target="RFC9553" derivedContent="RFC9553" section="2.5.1" sectionFormat="of"/>) in the Card object's addresses property.</t> <t>A value of type TEXT converts to the<tt>timeZone</tt> property in the <tt>Address</tt> object.</t>Address object's timeZone property.</t> <t>A value of type UTC-OFFSET converts to the<tt>timeZone</tt>Address object's timeZone propertyin the <tt>Address</tt> objectif the offset has zero minutes and the hour offset isin the rangebetween -12<= 14:</t>and +14, both inclusively. Note that:</t> <ul> <li>If the hour offset is zero, use the time zone name<tt>Etc/UTC</tt>.</li> <li>Otherwise"Etc/UTC".</li> <li>Otherwise, construct the time zone name with<tt>Etc/GMT</tt>"Etc/GMT" suffixed with the string representation of the reversed sign hour offset, including the sign but excluding leading zeros and minutes. For example, the UTC offset value<tt>-0500</tt>"-0500" converts to<tt>Etc/GMT+5</tt>.</li>"Etc/GMT+5".</li> </ul> <t>For such property values, also see <xref target="combine-geo-props"/> to determine which<tt>Address</tt>Address object instance to convert to.</t> <t>Any other value of type UTC-OFFSET or URI does not convert to an IANA-registered property in JSContact. To convert such property, see <xref target="jscontact-prop-vcardprops"/>.</t> </section> <section anchor="combine-geo-props"> <name>Combininggeographical properties</name>Geographical Properties</name> <t>InvCardvCard, the properties ADR,GEOGEO, and TZ occur independently of each other. In JSContact, they all convert to properties of an<tt>Address</tt>Address object. It is implementation-specific if these vCard properties convert to <em>separate</em> address instances inJSContact,JSContact or if some or all of them convert to the <em>same</em> address. That being said, implementations <bcp14>MUST</bcp14> convert the properties to the <em>same</em> address for the following cases:</t> <ul> <li>The GROUP parameter values of the properties match.</li> <li>The GROUP parameters are not set, but they are set on any other ADR,GEOGEO, and TZ properties.</li> </ul> </section> </section> <section> <name>Organizational Properties</name> <section anchor="vcard-prop-contact-uri"> <name>CONTACT-URI</name><t>A<t>The CONTACT-URI propertyas defined(<xref target="RFC8605" derivedContent="RFC8605" section="2.1" sectionFormat="of"/>) converts to a Link object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.3" sectionFormat="of"/>) in<xref target="RFC8605"/> is represented as an entry ofthe<tt>links</tt>Card object's links property (<xref target="contact_uri_conversion"/>). Theentry value is a <tt>Link</tt> object whose <tt>kind</tt>Link object's kind property is set to<tt>contact</tt>"contact" and<tt>uri</tt>the uri property is set to the CONTACT-URI property value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="contact_uri_conversion"> <name>CONTACT-URIconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ CONTACT-URI;PREF=1:mailto:contact@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "links": { "CONTACT-1": { "kind": "contact", "uri": "mailto:contact@example.com", "pref": 1 } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-logo"> <name>LOGO</name><t>A<t>The LOGO property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.3" sectionFormat="of"/>) converts toan entrya Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the<tt>media</tt>Card object's media property (<xref target="logo_conversion"/>). Theentry value is a <tt>Media</tt> object whose <tt>kind</tt>Media object's kind property is set to<tt>logo</tt>"logo" and<tt>uri</tt>the uri property is set to the LOGO property value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="logo_conversion"> <name>LOGOconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ LOGO:https://www.example.com/pub/logos/abccorp.jpg ]]></sourcecode> <sourcecode type="json"><![CDATA[ "media": { "LOGO-1": { "kind": "logo", "uri": "https://www.example.com/pub/logos/abccorp.jpg" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-member"> <name>MEMBER</name> <t>Theuids of the contact cards composing the group are included inMEMBER property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.5" sectionFormat="of"/>) converts to the<tt>members</tt>Card object's members property (<xreftarget="group_example"/>).</t> <t>In this case,target="group_example"/>). Each MEMBER property value is a key in the members property. The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) does nothave a JSContact counterpart; however, the implementors <bcp14>MAY</bcp14> insert the map entries by order of preference.</t>convert to JSContact.</t> <figure anchor="group_example"> <name>Groupexample</name> <artwork><![CDATA[Example</name> <sourcecode type="text/plain"><![CDATA[ KIND:group FN:The Doe family MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af MEMBER:urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "kind": "group", "name": { "full": "The Doe family" }, "uid": "urn:uuid:ab4310aa-fa43-11e9-8f0b-362b9e155667", "members": { "urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af": true, "urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519": true }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-org"> <name>ORG</name><t>An<t>The ORG property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.4" sectionFormat="of"/>) converts to anentryOrganization object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.3" sectionFormat="of"/>) in the<tt>organizations</tt>Card object's organizations property (<xref target="org_conversion"/>). Theentry value is an <tt>Organization</tt> object whose <tt>name</tt>Organization object's name propertycontainsis set to the ORG property organizationalname, and the <tt>units</tt>name component. The Organization object's units property is an array of<tt>OrgUnit</tt>OrgUnit objects that eachcontaining thecontain an organizational unit nameincomponent value of the<tt>name</tt> property.</t>ORG property value.</t> <t>Implementations <bcp14>MAY</bcp14> allow representation of organizational units without the organizational name. In this case, the first component of the ORG value <bcp14>MUST</bcp14> be an empty string (e.g., ORG:;DepartmentA).</t> <t>TheALTID,ALTID and LANGUAGE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <t>The first item of the comma-separated SORT-AS parameter value converts to the<tt>sortAs</tt>sortAs property of the<tt>Organization</tt>Organization object. The subsequent items convert to the<tt>sortAs</tt>sortAs property of the corresponding<tt>OrgUnit</tt>OrgUnit object.</t> <t>The TYPE parameter converts according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="org_conversion"> <name>ORGconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ ORG;SORT-AS="ABC":ABC\, Inc.;North American Division;Marketing ]]></sourcecode> <sourcecode type="json"><![CDATA[ "organizations": { "ORG-1": { "name": "ABC, Inc.", "units":[ { "name": "North American Division" }, { "name": "Marketing" } ], "sortAs": "ABC" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-related"> <name>RELATED</name><t>This<t>The RELATED property (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.6" sectionFormat="of"/>) converts toan entry inthe<tt>relatedTo</tt>Card object's relatedTo property (<xref target="related_conversion"/>). The property value converts to the key in the<tt>relatedTo</tt>relatedTo property. The TYPE parameters convert to the<tt>relation</tt> of the <tt>Relation</tt> object value.Relation object's relation property (<xref target="RFC9553" derivedContent="RFC9553" section="2.1.8" sectionFormat="of"/>). Any other parameters convert as defined in <xref target="jscontact-prop-vcardparams"/>.</t> <figure anchor="related_conversion"> <name>RELATEDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ RELATED;TYPE=friend:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6 RELATED;TYPE=contact:https://example.com/directory/john.vcf RELATED;VALUE=text:Please contact my deputy John for any inquiries. ]]></sourcecode> <sourcecode type="json"><![CDATA[ "relatedTo" : { "urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6" : { "relation" : { "friend" : true } }, "https://example.com/directory/john.vcf" : { "relation" : { "contact" : true } }, "Please contact my deputy John for any inquiries." : { "relation" : { } } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-title"> <name>TITLE and ROLE</name><t>Both<t>The TITLE (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.1" sectionFormat="of"/>) and ROLE (<xref target="RFC6350" derivedContent="RFC6350" section="6.6.2" sectionFormat="of"/>) propertiesare represented as entries ofconvert to a Title object (<xref target="RFC9553" derivedContent="RFC9553" section="2.2.5" sectionFormat="of"/>) in the<tt>titles</tt>Card object's titles property (<xref target="title_role_conversion"/>). Theentry value is a <tt>Title</tt> object whose <tt>kind</tt>Title object's kind property is set to<tt>title</tt>"title" or<tt>role</tt>"role" for the TITLE and ROLE vCard properties, respectively. The<tt>name</tt>name property is set to the vCard property value.</t> <t>The value of the<tt>organization</tt>organizationId property can be derived if the TITLE or ROLE property is a member of a vCard property group and if exactly one other ORG propertyalsois also a part of that group.</t> <t>The ALTID and LANGUAGE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="title_role_conversion"> <name>TITLE and ROLEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ TITLE:Research Scientist group1.ROLE:Project Leader group1.ORG:ABC, Inc. ]]></sourcecode> <sourcecode type="json"><![CDATA[ "titles": { "TITLE-1": { "kind": "title", "name":"Project Leader""Research Scientist" }, "TITLE-2": { "kind": "role", "name":"Research Scientist", "organization":"Project Leader", "organizationId": "ORG-1" } }, "organizations": { "ORG-1": { "name": "ABC, Inc." } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Personal Information Properties</name> <section anchor="vcard-prop-expertise"> <name>EXPERTISE</name><t>An<t>The EXPERTISE propertyas defined in <xref target="RFC6715"/> is represented as(<xref target="RFC6715" derivedContent="RFC6715" section="2.1" sectionFormat="of"/>) converts to a<tt>PersonalInfo</tt>PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the<tt>personalInfo</tt>Card object's personalInfo property (<xref target="expertise_conversion"/>). The<tt>kind</tt>PersonalInfo object's kind property is set to "expertise".</t> <t>The INDEXparameter convertsand LEVEL parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="expertise_conversion"> <name>EXPERTISEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ EXPERTISE;LEVEL=beginner;INDEX=2:Chinese literature EXPERTISE;INDEX=1;LEVEL=expert:chemistry ]]></sourcecode> <sourcecode type="json"><![CDATA[ "personalInfo": { "PERSINFO-1" : { "kind": "expertise", "value": "Chinese literature", "level": "low", "listAs": 2 }, "PERSINFO-2" : { "kind": "expertise", "value": "chemistry", "level": "high", "listAs": 1 } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-hobby"> <name>HOBBY</name><t>A<t>The HOBBY propertyas defined in <xref target="RFC6715"/> is represented as(<xref target="RFC6715" derivedContent="RFC6715" section="2.2" sectionFormat="of"/>) converts to a<tt>PersonalInfo</tt>PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the<tt>personalInfo</tt>Card object's personalInfo property (<xref target="hobby_conversion"/>). The<tt>kind</tt>PersonalInfo object's kind property is set to "hobby".</t> <t>The INDEXparameter convertsand LEVEL parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="hobby_conversion"> <name>HOBBYconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ HOBBY;INDEX=1;LEVEL=high:reading HOBBY;INDEX=2;LEVEL=high:sewing ]]></sourcecode> <sourcecode type="json"><![CDATA[ "personalInfo": { "PERSINFO-1" : { "kind": "hobby", "value": "reading", "level": "high", "listAs": 1 }, "PERSINFO-2" : { "kind": "hobby", "value": "sewing", "level": "high", "listAs": 2 } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-interest"> <name>INTEREST</name><t>An<t>The INTEREST propertyas defined in <xref target="RFC6715"/> is represented as(<xref target="RFC6715" derivedContent="RFC6715" section="2.3" sectionFormat="of"/>) converts to a<tt>PersonalInfo</tt>PersonalInfo object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.4" sectionFormat="of"/>) in the<tt>personalInfo</tt>Card object's personalInfo property (<xref target="interest_conversion"/>). The<tt>kind</tt>PersonalInfo object's kind property is set to "interest".</t> <t>The INDEXparameter convertsand LEVEL parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="interest_conversion"> <name>INTERESTconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ INTEREST;INDEX=1;LEVEL=medium:r&b music INTEREST;INDEX=2;LEVEL=high:rock&roll music ]]></sourcecode> <sourcecode type="json"><![CDATA[ "personalInfo": { "PERSINFO-1" : { "kind": "interest", "value": "r&b music", "level": "medium", "listAs": 1 }, "PERSINFO-2" : { "kind": "interest", "value": "rock&roll music", "level": "high", "listAs": 2 } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-org-directory"> <name>ORG-DIRECTORY</name> <t>The ORG-DIRECTORY property (<xref target="RFC6715" derivedContent="RFC6715" section="2.4" sectionFormat="of"/>) <xref target="RFC6715"/> converts to a Directory object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.2" sectionFormat="of"/>) in the<tt>directories</tt>Card object's directories property (<xref target="org_directory_conversion"/>). The<tt>kind</tt>Directory object's kind property is set to<tt>directory</tt>."directory". The<tt>uri</tt>uri property is set to the ORG-DIRECTORY property value.</t> <t>The INDEX,PREFPREF, and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="org_directory_conversion"> <name>ORG-DIRECTORYconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ ORG-DIRECTORY;INDEX=1:https://directory.mycompany.example.com ORG-DIRECTORY;PREF=1:ldap://ldap.tech.example/o=Tech,ou=Engineering ]]></sourcecode> <sourcecode type="json"><![CDATA[ "directories": { "DIRECTORY-1": { "kind": "directory", "uri": "https://directory.mycompany.example.com", "listAs": 1 }, "DIRECTORY-2": { "kind": "directory", "uri": "ldap://ldap.tech.example/o=Tech,ou=Engineering", "pref": 1 } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Explanatory Properties</name> <section anchor="vcard-prop-categories"> <name>CATEGORIES</name><t>A<t>The CATEGORIES property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.1" sectionFormat="of"/>) converts to a set of entries of the<tt>keywords</tt>Card object's keywords property (<xref target="categories_conversion"/>). The keys are the comma-separated text values of the CATEGORIES property.</t> <t>In this case, the PREF parameter does not have a JSContact counterpart; however, the implementors <bcp14>MAY</bcp14> insert themapentries by order of preference.</t> <figure anchor="categories_conversion"> <name>CATEGORIESconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ CATEGORIES:internet,IETF,Industry,Information Technology ]]></sourcecode> <sourcecode type="json"><![CDATA[ "keywords": { "internet": true, "IETF": true, "Industry": true, "Information Technology": true }]]></artwork>]]></sourcecode> </figure> </section> <sectionanchor="vcard-prop-pid"> <name>CLIENTPIDMAP and PID Parameter</name> <t>These convertanchor="vcard-prop-clientpidmap"> <name>CLIENTPIDMAP</name> <t>The CLIENTPIDMAP property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.7" sectionFormat="of"/>) converts to the <xreftarget="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref> and <xref target="jscontact-prop-vcardparams"><tt>vCardParams</tt></xref> properties.</t>target="jscontact-prop-vcardprops">vCardProps</xref> property.</t> </section> <section anchor="vcard-prop-created"> <name>CREATED</name> <t>The CREATED property (<xref target="RFC9554" derivedContent="RFC9554" section="3.1" sectionFormat="of"/>) converts to the<tt>created</tt>Card object's created property (<xref target="created_conversion"/>).</t> <figure anchor="created_conversion"> <name>CREATEDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ CREATED:19940930T143510Z ]]></sourcecode> <sourcecode type="json"><![CDATA[ "created": "1994-09-30T14:35:10Z"]]></artwork>]]></sourcecode> </figure><t>Note: This property is defined in <xref target="I-D.ietf-calext-vcard-jscontact-extensions"/>.</t></section> <section anchor="vcard-prop-note"> <name>NOTE</name><t>A<t>The NOTE property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.2" sectionFormat="of"/>) converts to a<tt>Note</tt>Note object (<xref target="RFC9553" derivedContent="RFC9553" section="2.8.3" sectionFormat="of"/>) in the<tt>notes</tt> mapCard object's notes property (<xref target="notes_conversion"/>).</t> <t>The ALTID and LANGUAGE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="notes_conversion"> <name>NOTEconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ NOTE;CREATED=20221123T150132Z;AUTHOR-NAME="John": Office hours are from 0800 to 1715 EST\, Mon-Fri. ]]></sourcecode> <sourcecode type="json"><![CDATA[ "notes": { "NOTE-1" : { "note": "Office hours are from 0800 to 1715 EST, Mon-Fri.", "created": "2022-11-23T15:01:32Z", "author": { "name": "John" } } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-prodid"> <name>PRODID</name> <t>The PRODID property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.3" sectionFormat="of"/>) converts to the<tt>prodId</tt>Card object's prodId property (<xref target="prodid_conversion"/>).</t> <figure anchor="prodid_conversion"> <name>PRODIDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ PRODID:ACME Contacts App version 1.23.5 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "prodId": "ACME Contacts App version 1.23.5"]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-rev"> <name>REV</name> <t>The REV property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.4" sectionFormat="of"/>) converts to the<tt>updated</tt>Card object's updated property (<xref target="rev_conversion"/>).</t> <figure anchor="rev_conversion"> <name>REVconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ REV:19951031T222710Z ]]></sourcecode> <sourcecode type="json"><![CDATA[ "updated": "1995-10-31T22:27:10Z"]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-sound"> <name>SOUND</name><t>A<t>The SOUND property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.5" sectionFormat="of"/>) converts toan entrya Media object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.4" sectionFormat="of"/>) in the<tt>media</tt>Card object's media property (<xref target="sound_conversion"/>). Theentry value is a <tt>Media</tt> object whose <tt>kind</tt>Media object's kind property is set to<tt>sound</tt>"sound" and<tt>uri</tt>the uri property is set to the SOUND value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="sound_conversion"> <name>SOUNDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ SOUND:CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "media": { ... "SOUND-1": { "kind": "sound", "uri": "CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-uid"> <name>UID</name> <t>The UID propertycorresponds(<xref target="RFC6350" derivedContent="RFC6350" section="6.7.6" sectionFormat="of"/>) converts to the<tt>uid</tt>Card object's uid property (<xref target="uid_conversion"/>).</t> <figure anchor="uid_conversion"> <name>UIDconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ UID:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6 ]]></sourcecode> <sourcecode type="json"><![CDATA[ "uid": "urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6"]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-url"> <name>URL</name><t>A<t>The URL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.8" sectionFormat="of"/>) converts toan entrya Link object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.3" sectionFormat="of"/>) in the<tt>links</tt>Card object's links property (<xref target="url_conversion"/>). Theentry value is a <tt>Link</tt> object whose <tt>uri</tt>Link object's uri property is set to the URL value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="url_conversion"> <name>URLconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ URL:https://example.org/restaurant.french/~chezchic.html ]]></sourcecode> <sourcecode type="json"><![CDATA[ "links": { "LINK-1": { "uri": "https://example.org/restaurant.french/~chezchic.html" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-version"> <name>VERSION</name><t>This<t>The VERSION property (<xref target="RFC6350" derivedContent="RFC6350" section="6.7.9" sectionFormat="of"/>) converts toan entry inthe <xreftarget="jscontact-prop-vcardprops"><tt>vCardProps</tt></xref>target="jscontact-prop-vcardprops">vCardProps</xref> property.</t> </section> <section anchor="vcard-prop-xablabel"> <name>X-ABLabel</name><t>This<t>The X-ABLabel property is experimental but widely in use in existing vCard data. It converts to the<tt>label</tt>label property of a JSContactobject type.object. The X-ABLabel property is preceded by a vCard property group name, and the label converts to the JSContactobjectobject, whichgotwas converted from a vCard propertyhavingof the same group.</t> <t>The group name is notpreserved,preserved; implementations are free to choose any unique group name when converting back to vCard. For an example on how to preserve the groupnamename, see <xref target="vcard-param-group"/>.</t> <figure anchor="xablabel_conversion"> <name>X-ABLabelconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ item1.TEL;VALUE=uri:tel:+1-555-555-5555 item1.X-ABLabel:foo ]]></sourcecode> <sourcecode type="json"><![CDATA[ "phones": { "p1": { "number": "tel:+1-555-555-5555", "label": "foo" } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Security Properties</name> <section anchor="vcard-prop-key"> <name>KEY</name><t>A<t>The KEY property (<xref target="RFC6350" derivedContent="RFC6350" section="6.8.1" sectionFormat="of"/>) converts toan entrya CryptoKey object (<xref target="RFC9553" derivedContent="RFC9553" section="2.6.1" sectionFormat="of"/>) in the<tt>cryptoKeys</tt>Card object's cryptoKeys property (<xref target="key_conversion"/>). Theentry value is a <tt>CryptoKey</tt> object whose <tt>uri</tt>CryptoKey object's uri property is set to the KEY property value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="key_conversion"> <name>KEYconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ KEY:https://www.example.com/keys/jdoe.cer ]]></sourcecode> <sourcecode type="json"><![CDATA[ "cryptoKeys": { "KEY-1": { "uri": "https://www.example.com/keys/jdoe.cer" } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section> <name>Calendar Properties</name> <section anchor="vcard-prop-caladruri"> <name>CALADRURI</name><t>A<t>The CALADRURI property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.2" sectionFormat="of"/>) converts toan entrya SchedulingAddress object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.2" sectionFormat="of"/>) in the<tt>schedulingAddresses</tt>Card object's schedulingAddresses property (<xref target="caladruri_conversion"/>). Theentry value is a <tt>SchedulingAddress</tt> object whose <tt>uri</tt>SchedulingAddress object's uri property is set to the CALADRURI value.</t> <t>The PREF parameter (<xref target="RFC6350" derivedContent="RFC6350" section="5.3" sectionFormat="of"/>) converts according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="caladruri_conversion"> <name>CALADRURIconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ CALADRURI;PREF=1:mailto:janedoe@example.com CALADRURI:https://example.com/calendar/jdoe ]]></sourcecode> <sourcecode type="json"><![CDATA[ "schedulingAddresses": { "SCHEDULING-1": { "uri": "mailto:janedoe@example.com", "pref": 1 }, "SCHEDULING-2": { "uri": "https://example.com/calendar/jdoe" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-caluri"> <name>CALURI</name><t>A<t>The CALURI property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.3" sectionFormat="of"/>) converts toan entrya Calendar object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.1" sectionFormat="of"/>) in the<tt>calendars</tt>Card object's calendars property (<xref target="caluri_conversion"/>). Theentry value is a <tt>Calendar</tt> object whose <tt>kind</tt>Calendar object's kind property is set to<tt>calendar</tt>"calendar" and<tt>uri</tt>the uri property is set to the CALURI value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="caluri_conversion"> <name>CALURIconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ CALURI;PREF=1:https://cal.example.com/calA CALURI;MEDIATYPE=text/calendar:https://ftp.example.com/calA.ics ]]></sourcecode> <sourcecode type="json"><![CDATA[ "calendars": { "CAL-1": { "kind": "calendar", "uri": "https://cal.example.com/calA", "pref": 1 }, "CAL-2": { "kind": "calendar", "uri": "https://ftp.example.com/calA.ics", "mediaType": "text/calendar" } }]]></artwork>]]></sourcecode> </figure> </section> <section anchor="vcard-prop-fburl"> <name>FBURL</name><t>An<t>The FBURL property (<xref target="RFC6350" derivedContent="RFC6350" section="6.9.1" sectionFormat="of"/>) converts toan entrya Calendar object (<xref target="RFC9553" derivedContent="RFC9553" section="2.4.1" sectionFormat="of"/>) in the<tt>calendars</tt>Card object's calendars property (<xref target="fburl_conversion"/>). Theentry value is a <tt>Calendar</tt> object whose <tt>kind</tt>Calendar object's kind property is set to<tt>freeBusy</tt>"freeBusy" and<tt>uri</tt>the uri property is set to the FBURL value.</t> <t>The PREF and TYPE parameters convert according to the rulesasdefined in <xref target="vcard-parameters"/>.</t> <figure anchor="fburl_conversion"> <name>FBURLconversion example</name> <artwork><![CDATA[Conversion Example</name> <sourcecode type="text/plain"><![CDATA[ FBURL;PREF=1:https://www.example.com/busy/janedoe FBURL;MEDIATYPE=text/calendar:https://example.com/busy/project-a.ifb ]]></sourcecode> <sourcecode type="json"><![CDATA[ "calendars": { "FBURL-1": { "kind": "freeBusy", "uri": "https://www.example.com/busy/janedoe", "pref": 1 }, "FBURL-2": { "kind": "freeBusy", "uri": "https://example.com/busy/project-a.ifb", "mediaType": "text/calendar" } }]]></artwork>]]></sourcecode> </figure> </section> </section> <section anchor="vcard-extended"> <name>Extended Properties and Parameters</name><t>These<t>Extended properties and parameters convert as specified in <xref target="new-jscontact"/>.</t> </section> <section anchor="new-jscontact"> <name>New JSContactproperties</name>Properties</name> <t>vCards may contain properties or parameters for which no IANA-registered JSContact property is defined. For example, a vCard may contain properties and parameters of which the semantics or purposes are unknown to the implementation; see <xref target="RFC6350" sectionFormat="of" section="6.10"/>.</t> <t>This section defines JSContact properties by which such vCard properties and parameters <bcp14>MAY</bcp14> be represented in JSContact. Implementations <bcp14>MAY</bcp14> choose to convert differently if they deem that more appropriate.</t> <section anchor="jscontact-prop-vcardprops"><name>Property <tt>vCardProps</tt></name><name>vCardProps</name> <dl><dt>Name:</dt> <dd> <tt>vCardProps</tt> </dd> <dt>Type:</dt> <dd><tt>JCardProp[]</tt>, where <tt>JCardProp</tt> denotes a jCard-encoded<dt>vCardProps: JCardProp[] (optional).</dt> <dd>Contains vCardproperty as defined in <xref target="RFC7095" section="3.3"/>. </dd> <dt>Definition:</dt> <dd>This property is set on a JSContact object that represents a vCard. It containsproperties that are set in the vCard represented by this JSContact object.Each entry in this list typically representsThe JCardProp type denotes a jCard-encoded vCard propertyfor which no conversion to an IANA-registered JSContact property is defined.</dd>as defined in <xref target="RFC7095" sectionFormat="of" section="3.3"/>.</dd> <dt>Example:</dt> <dd> <t>This illustrates how to convert a vCard extension property:</t> <figure anchor="props_conversion"> <name>JSContact<tt>vCardProps</tt> example</name> <artwork><![CDATA[vCardProps Example</name> <sourcecode type="text/plain"><![CDATA[ item1.X-FOO;X-BAR=Hello:World! ]]></sourcecode> <sourcecode type="json"><![CDATA[ "vCardProps": [ ["x-foo", { "x-bar": "Hello", "group": "item1" }, "unknown", "World!"] ]]]></artwork>]]></sourcecode> </figure> </dd> </dl> </section> <section anchor="jscontact-prop-vcardparams"><name>Property <tt>vCardParams</tt></name><name>vCardParams</name> <dl><dt>Name:</dt> <dd> <tt>vCardParams</tt> </dd> <dt>Type:</dt> <dd> <tt>String[String|String[]]</tt> </dd> <dt>Definition:</dt> <dd>This property is<dt>vCardParams: String[String|String[]] (optional).</dt> <dd>Contains vCard parameters that are set ona JSContact object that represents athe vCardproperty. Itsproperty represented by this JSContact object. The value <bcp14>MUST</bcp14> be a JSON object containing vCard propertyparameters, definedparameters asarray element 2defined in <xref target="RFC7095" sectionFormat="of" section="3.3"/>. Each entry represents a parameter of the vCard property that converts to the JSContact object.</dd> <dt>Example:</dt> <dd> <t>This illustrates how to convert a vCard extension parameter:</t> <figure anchor="params_conversion"> <name>JSContact<tt>vCardParams</tt> example</name> <artwork><![CDATA[vCardParams Example</name> <sourcecode type="text/plain"><![CDATA[ EMAIL;X-FOO=Bar:jane_doe@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "emails": { "email1": { "address": "jane_doe@example.com", "vCardParams": { "x-foo": "Bar" } } }]]></artwork>]]></sourcecode> </figure> </dd> </dl> </section> <section anchor="jscontact-prop-vcardname"><name>Property <tt>vCardName</tt></name><name>vCardName</name> <dl><dt>Name:</dt> <dd> <tt>vCardName</tt> </dd> <dt>Type:</dt> <dd> <tt>String</tt> </dd> <dt>Definition:</dt> <dd>This property is set on a JSContact object that represents a vCard property or parameter and its value contains<dt>vCardName: String (optional).</dt> <dd>Contains the name ofthatthe vCardelement. Thiselement that is represented by this JSContact object. For example, this allows to preserve the name of a vCardelementproperty when multipleelementsvCard properties convert the same JSContactobjecttype. The case-insensitive value <bcp14>MUST</bcp14> be valid according to the<tt>name</tt>"name" ABNF defined in <xref target="RFC6350" sectionFormat="of" section="3.3"/>.</dd> <dt>Example:</dt> <dd> <t>Both vCard IMPP and SOCIALPROFILE convert to an OnlineService object (<xref target="RFC9553" derivedContent="RFC9553" section="2.3.2" sectionFormat="of"/>) in JSContact. The<tt>vCardName</tt>vCardName property value indicates that the vCard source element wasIMPP:</t>IMPP as follows:</t> <figure anchor="example-vcardname"> <name>JSContact<tt>vCardName</tt> example</name> <artwork><![CDATA[vCardName Example</name> <sourcecode type="text/plain"><![CDATA[ IMPP:xmpp:alice@example.com ]]></sourcecode> <sourcecode type="json"><![CDATA[ "onlineServices": { "os1": { "uri": "xmpp:alice@example.com", "vCardName": "impp" }, }]]></artwork>]]></sourcecode> </figure> </dd> </dl> </section> </section> </section> <section anchor="convert-jscontact-to-vcard"> <name>Converting JSContact to vCard</name> <section> <name>Conversion Rules</name> <t>A<tt>Card</tt>Card object converts to vCard by applying the reverse rules of converting vCard to JSContact. In addition to those listed in <xref target="convert_jscontact_to_vcard-reverse-rules"/>, the following rules apply:</t> <ul> <li>Multivalued JSContact properties convert to separate instances of their equivalent vCard property, andforeach of the PROP-IDparameterparameters <bcp14>MUST</bcp14> be set to the<tt>Id</tt>Id-typed key of the converted value (see <xref target="vcard-param-propid"/>).</li> <li> <t>The<tt>full</tt>full property of the<tt>name</tt>name property in JSContact is optional, but the FN property is mandatory in vCard. The following rules apply:</t> <ul> <li>If the Name<tt>full</tt>object's full property is set, then implementations <bcp14>MUST</bcp14> use its value for the vCard FN property.</li> <li>If the Name<tt>full</tt>object's full property is not set, then implementations <bcp14>SHOULD</bcp14> derive the full name from the Name<tt>components</tt>object's components property values. If the<tt>isOrdered</tt>isOrdered property istrue,"true", then this can be done by concatenating the name component values. Otherwise, or alternatively, an implementation can choose any other heuristic to generate the full name from itscomponents,components such as <xref target="CLDRPersonName"/>. Implementations <bcp14>MUST</bcp14> set the DERIVED parameter on the FN property.</li> <li>Otherwise,they <bcp14>MUST</bcp14> setthe FN property <bcp14>MUST</bcp14> be set to the empty value.</li> </ul> </li> <li>Vendor-specific and unknown properties convert to vCard as outlined in <xref target="jscontact-convert-unknown"/>.</li> </ul> <section anchor="jscontact-convert-unknown"> <name>Convertingunknown properties</name>Unknown Properties</name> <t>JSContactobject typesobjects may contain properties for which no IANA-registered vCard property is defined. For example, a JSContact object may contain vendor-specific properties of which the semantics or purpose are unknown.</t> <t>This specification defines the new <xreftarget="vcard-prop-jsprop"><tt>JSPROP</tt></xref>target="vcard-prop-jsprop">JSPROP</xref> vCard property and <xreftarget="vcard-param-jsptr"><tt>JSPTR</tt></xref>target="vcard-param-jsptr">JSPTR</xref> vCard parameter by which such JSContact properties <bcp14>MAY</bcp14> be represented in vCard. Implementations <bcp14>MAY</bcp14> choose to convert differently if they deem that more appropriate.</t> </section> </section> <section anchor="new-vcard-props"> <name>New vCard Properties</name> <section anchor="vcard-prop-jsprop"> <name>JSPROP</name> <dl> <dt>Property name:</dt> <dd>JSPROP</dd> <dt>Purpose:</dt><dd>This property represents<dd>Represents a JSContact property in vCard.</dd> <dt>Value type:</dt><dd>TEXT,<dd>TEXT; also seeFormat Definition"Format definition" below for value restrictions.</dd> <dt>Conformance:</dt><dd>The property can<dd>Can be specified multiple times in a vCard.</dd> <dt>Property parameters:</dt> <dd> The JSPTR parameter <bcp14>MUST</bcp14> be set for this property. Other IANA-registered and experimental property parameters can be specified on this property. </dd> <dt>Description:</dt> <dd> <t>This property converts an arbitrary JSContact property from and to vCard. The vCard property value is the JSON-encoded value of the JSContact property, represented as a TEXT value. The format of the JSON value <bcp14>MUST</bcp14> be compact, e.g., without insignificantwhitespace.whitespace as defined in <xref target="RFC8259" format="default" sectionFormat="of" derivedContent="RFC8259" section="2"/>. The value of the JSPTR parameter points to the JSContact property within the Card.</t> <t>The root of the JSON pointer is always the Card object that this vCard converts to, irrespective if the JSON pointer starts with the SOLIDUS (U+002F) character. The pointer <bcp14>MUST NOT</bcp14> reference into an array.</t> <t>All JSPROP properties in a vCard together form a PatchObject as defined in <xreftarget="I-D.ietf-calext-jscontact"/>.target="RFC9553"/>. The value of its JSPTR parameter corresponds to a key in thePatchObject,PatchObject; the value of the JSPROP property corresponds to the value for that key. When converting from vCard to JSContact, the PatchObject <bcp14>MUST</bcp14> only be applied after all other vCard properties have already been converted. The PatchObject <bcp14>MUST</bcp14> be valid, including the restriction that an invalid PatchObject <bcp14>MUST NOT</bcp14> be applied.</t> </dd> <dt>Format definition:</dt> <dd> <t>This property is defined by the following notation:</t> <sourcecodename=""type="abnf"><![CDATA[ jsprop = "JSPROP" jsprop-param ":" TEXT jsprop-param = *( ; The following areMANDATORYREQUIRED and MUST NOT ; occur more than once ( ";" jsptr-param ) / ; see next section ( ";" "VALUE" "=" "TEXT") ; ; The following isOPTIONAL,OPTIONAL ; and MAY occur more than once. ; (";" other-param) ; ) ]]></sourcecode> </dd> <dt anchor="vcard-prop-jsprop-examples">Example(s):</dt> <dd> <t>This illustrates how to convert a property at thetop-leveltop level in a Card object that is unknown to the implementation.</t> <figure anchor="jscontact-prop-unknown"> <name>Unknownproperty example</name> <artwork><![CDATA[Property Example</name> <sourcecode type="json"><![CDATA[ "someUnknownProperty": true ]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ JSPROP;JSPTR="someUnknownProperty":true]]></artwork>]]></sourcecode> </figure> <t>This illustrates how to convert a vendor-specific property at thetop-leveltop level of a Card object. Note the required use of quoted string for the JSPTRvaluevalue, which allows the path to include the COLON (U+003A) character.</t> <figure anchor="jscontact-prop-vendor-specific"><name>Vendor-specific property conversion example</name> <artwork><![CDATA[<name>Vendor-Specific Property Conversion Example</name> <sourcecode type="json"><![CDATA[ "example.com:foo": { "bar": 1234 } ]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ JSPROP;JSPTR="example.com:foo":{"bar":1234}]]></artwork>]]></sourcecode> </figure> <t>This illustrates how to convert a vendor-specific property at a nested level in a Card object using a path relative to the Card object. Although not recommended, the property name includes the SOLIDUS (U+002F)charactercharacter, which requires escaping in the JSON pointer.</t> <figure anchor="jscontact-prop-nested"> <name>Nestedvendor-specific property exampleVendor-Specific Property Example withpath relativea Path Relative to Card</name><artwork><![CDATA[<sourcecode type="json"><![CDATA[ "phones": { "phone1": { "number":"tel:+33-01-23-45-67""tel:+33-01-23-45-67", "example.com:foo/bar": "tux hux" } } ]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ TEL:tel:+33-01-23-45-67 JSPROP;JSPTR="phones/phone1/example.com:foo~1bar": "tux hux"]]></artwork>]]></sourcecode> </figure> </dd> </dl> </section> </section> <section> <name>New vCardParameter</name>Parameters</name> <section anchor="vcard-param-jscomps"> <name>JSCOMPS</name> <dl> <dt>Parameter name:</dt> <dd>JSCOMPS</dd> <dt>Purpose:</dt><dd>This parameter defines<dd>Defines the order and separators for the elements of a structured property value.</dd> <dt>Description:</dt> <dd> <t>The JSCOMPS parameter value facilitates converting name and address components between JSContact and vCard. It preserves the order of the components of the JSContact property and contains the verbatim values of separator components.</t> <t>If this parameter is set and its value is valid (see later), then implementations <bcp14>MUST</bcp14> set the<tt>isOrdered</tt>isOrdered property of the Name or Address object to "true". Otherwise, they <bcp14>MUST</bcp14> set the<tt>isOrdered</tt>isOrdered property value to "false".</t> <t>The JSCOMPS parameter value is a structured type value. Its value <bcp14>MUST</bcp14> be quoted. The parameter value consists of a sequence of entries, separated by the SEMICOLON character (U+003B). The first entry defines the value of the<tt>defaultSeparator</tt>defaultSeparator property. If it is the emptystringstring, then no default separator is defined. Otherwise, the first entry <bcp14>MUST</bcp14> be a separator entry. All following entries processed in order result in an ordered list of JSContactcomponents,components and <bcp14>MUST</bcp14> be one oftwothe following two kinds:</t> <ol> <li> <t>A positional. This refers to a component value in the vCard structuredvaluevalue. A position consists of the numeric index of a component in the structured value, optionally followed by a COMMA (U+002C) character and the non-zero index of a value within that component. The zero index selects the first component or value, respectively. The second indexby defaultiszero,zero by default, in which case it <bcp14>MUST</bcp14> be omitted (as well as the leading COMMA).</t> <t>The resulting JSContact component is formed by determining its kind by the position in the vCard structured value. The component value is the verbatim value of the vCard component. Figures <xreftarget="vcard-param-jscomps-example-positional"/>target="vcard-param-jscomps-example-positional" format="counter"/> and <xreftarget="vcard-param-jscomps-example-n-secondary-index"/>target="vcard-param-jscomps-example-n-secondary-index" format="counter"/> illustrate this by example.</t> </li> <li> <t>A separator. This contains the verbatim value of a separator component. It starts with the LATIN SMALL LETTER S (U+0073) character, followed by the COMMA(U+002C),(U+002C) character, followed by zero or more "param-value" characters (see <xref target="RFC6350"section="3.3"><tt>param-value</tt></xref> characters,sectionFormat="of" section="3.3"/>), where the COMMA(U+002c)(U+002C) and SEMICOLON (U+003B)charactercharacters <bcp14>MUST</bcp14> be escaped according to the rules defined in <xref target="RFC6350" sectionFormat="of" section="3.4"/>. <xref target="vcard-param-jscomps-example-separator"/> illustrates this by example.</t> <t>The resulting JSContact component is formed by setting its kind to<tt>separator</tt>"separator" and its value to the verbatim value of the entry.</t> </li> </ol> <t>A JSCOMPS parameter value is valid if and only if:</t> <ul> <li>All indexes in the positional entries refer to an existing component value in the vCard property value.</li> <li> <t>The count of positional entries equals the count of deduplicated component values. Deduplication is required because some values may occur in both their designated and backwards-compatible components in the vCard property value:</t> <ul> <li>A value that occurs in both the N property secondary surname component and the family name component only counts once.</li> <li>A value that occurs in both the N property generation component and the honorific suffix component only counts once.</li> <li>A value in the ADR property street address component does not count if the ADR property value contains a value in one of the new components defined in <xreftarget="I-D.ietf-calext-vcard-jscontact-extensions"/>.</li>target="RFC9554"/>.</li> <li>All other values count once each.</li> </ul> </li> </ul> </dd> <dt>Format definition:</dt> <dd> <sourcecodename=""type="abnf"><![CDATA[ jscomps-param = "JSCOMPS" "=" DQUOTE( (jscomps-entry-sep / "")[jscomps-entry-sep ] ";" jscomps-entrylist)DQUOTE jscomps-entrylist = jscomps-entry *(";" jscomps-entry) jscomps-entry = jscomps-entry-pos / jscomps-entry-sep jscomps-entry-pos = 1*DIGIT [ "," 1*DIGIT ] jscomps-entry-sep = "s" "," jscomps-entry-verb jscomps-entry-verb = *QSAFE-CHAR ; encode according to RFC 6868 ]]></sourcecode> </dd> <dt anchor="vcard-param-jscomps-examples">Example(s):</dt> <dd> <t>The following example demonstrates the use of positional entries for the name "Jane Doe". The given name is ordered before the surname. No secondary index is required for either positional because both are zero.</t> <figure anchor="vcard-param-jscomps-example-positional"> <name>Examplefor positional entries</name>of a Secondary Positional Index</name> <sourcecodename=""><![CDATA[name="json"><![CDATA[ "name": { "components": [ { "kind": "given", "value": "Jane" }, { "kind": "surname", "value": "Doe" } ], "isOrdered": true } ]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ N;JSCOMPS=";1;0":Doe;Jane;;;;;; FN;DERIVED=TRUE:Jane Doe ]]></sourcecode> </figure> <t>The following example demonstrates a secondary positional index. The "Jr." generation marker only counts once because it occurs in both the designated generation component and the backwards-compatible honorific suffixes component.</t> <figure anchor="vcard-param-jscomps-example-n-secondary-index"> <name>Examplefor positional entries</name>of Positional Entries</name> <sourcecodename=""><![CDATA[name="json"><![CDATA[ "name": { "components": [ { "kind": "given", "value": "John" }, { "kind": "given2", "value": "Philip" }, { "kind": "given2", "value": "Paul" }, { "kind": "surname", "value": "Stevenson" }, { "kind": "generation", "value": "Jr." }, { "kind": "credential", "value": "M.D." } ], "isOrdered": true }N;JSCOMPS=";1;2;2,1;0;6;4,1":Stevenson;John;Philip,Paul;;Jr.,M.D.;;Jr.]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ N;JSCOMPS=";1;2;2,1;0;6;4,1": Stevenson;John;Philip,Paul;;Jr.,M.D.;;Jr. ]]></sourcecode> </figure> <t>The following example demonstrates the use of separator entries for the (shortened for brevity) address "54321 Oak St, Reston". The first entry defines the default separator to be ", ". The second and fourth positional entries are separated with the separator value " ". Forbackwards-compatibility,backwards compatibility, the street address component of the ADR property contains both the street number and name, but it is not referred to in the JSCOMPS parameter and does not contribute to the count of values.</t> <figure anchor="vcard-param-jscomps-example-separator"> <name>Examplefor separator entries</name>of Separator Entries</name> <sourcecodename=""><![CDATA[name="json"><![CDATA[ "addresses": { "a1": { "components": [ { "kind": "number", "value": "54321" }, { "kind": "separator", "value": " " }, { "kind": "name", "value": "Oak St" }, { "kind": "locality", "value": "Reston" } ], "defaultSeparator": ", ", "isOrdered": true } } ]]></sourcecode> <sourcecode type="text/plain"><![CDATA[ ADR;JSCOMPS="s,\, ;11;s,;10;3":;;54321;10;3": ;;54321 Oak St;Reston;;;;;;;Oak St;54321;;;;;; ]]></sourcecode> </figure> </dd> </dl> </section> <section anchor="vcard-param-jsptr"> <name>JSPTR</name> <dl> <dt>Parameter name:</dt> <dd>JSPTR</dd> <dt>Purpose:</dt><dd> This<dd>This parametercontainsis set on a <xref target="vcard-prop-jsprop">JSPROP</xref> property. Its value is a JSON pointer <xref target="RFC6901"/> thatrelates the vCard <xref target="vcard-prop-jsprop">JSPROP</xref> propertypoints toathe JSContact property that has the value of the JSPROP property. </dd> <dt>Description:</dt> <dd> <t>This parameter has a single value that <bcp14>MUST</bcp14> be a valid JSON pointer as defined in <xref target="RFC6901"/>. Note that the value <bcp14>MUST</bcp14> be quoted according to the<tt>param-value</tt>"param-value" ABNF in <xref target="RFC6350"/>.</t> </dd> <dt>Format definition:</dt> <dd> <sourcecodename=""type="abnf"><![CDATA[ jsptr-param = "JSPTR" "=" param-value ; also see param-value in RFC 6350,sectionSection 3.3 ]]></sourcecode> </dd> <dt>Example(s):</dt> <dd> <t>This illustrates a simple example. For furtherexamplesexamples, see <xref target="vcard-prop-jsprop-examples"/>.</t> <sourcecodename=""><![CDATA[name="" type="text/plain"><![CDATA[ JSPROP;JSPTR="example.com:foo":"bar" ]]></sourcecode> </dd> </dl> </section> </section> </section> <section anchor="security-considerations"> <name>Security Considerations</name> <t>This specification defines how to convert between the JSContact and vCard formats. The security considerations for parsing and formatting such data apply and are outlined in <xreftarget="I-D.ietf-calext-jscontact" section="5"/>target="RFC9553" sectionFormat="of" section="4"/> and <xref target="RFC6350" sectionFormat="of" section="9"/>.</t> </section><section> <name>Acknowledgements</name> <t>The definition and examples of the <xref target="vcard-param-phonetic">PHONETIC</xref> and <xref target="vcard-param-script">SCRIPT</xref> parameters are based on the initial version of <xref target="I-D.calconnect-vobject-i18n"/>.</t> </section><section anchor="IANA"><!-- All drafts are required to have an IANA considerations section. See RFC 8126 for a guide.--><name>IANA Considerations</name> <section> <name>New vCardProperties</name>Property</name> <t>IANAis requested to addhas added the followingentriesentry to the "vCard Properties" registry, as defined inSection 10.3.1. of<xreftarget="RFC6350"/>.</t>target="RFC6350" sectionFormat="of" section="10.3.1"/>.</t> <table anchor="new_properties"> <name>New vCardProperties</name>Property</name> <thead> <tr> <th align="left">Namespace</th> <th align="left">Property</th> <th align="left">Reference</th> </tr> </thead> <tbody> <tr> <td/> <td align="left">JSPROP</td> <tdalign="left">This document,align="left">RFC 9555, <xref target="vcard-prop-jsprop"/></td> </tr> </tbody> </table> </section> <section> <name>New vCardParameters</name>Parameter</name> <t>IANAis requested to addhas added the followingentriesentry to the "vCard Parameters" registry, as defined inSection 10.3.2. of<xreftarget="RFC6350"/>.</t>target="RFC6350" sectionFormat="of" section="10.3.2"/>.</t> <table anchor="new_parameters"> <name>New vCardParameters</name>Parameter</name> <thead> <tr> <th align="left">Namespace</th> <th align="left">Parameter</th> <th align="left">Reference</th> </tr> </thead> <tbody> <tr> <td/> <td align="left">JSPTR</td> <tdalign="left">This document,align="left">RFC 9555, <xref target="vcard-param-jsptr"/></td> </tr> </tbody> </table> </section> <section> <name>New JSContact Properties</name> <t>IANAis requested to addhas added the following entries to the "JSContact Properties" registry.TheNote that the Since Versionfor all propertiesis1.0. The1.0, the Until Versionfor all propertiesis notset. All RFC section references are for this document. The change controllerset, and the Change Controller is IETF for all of theseproperties is IETF.</t>properties.</t> <table anchor="tab-iana-property-registry" align="center"><name>Initial Contents of the "JSContact Properties"<name>JSContact Properties Registry</name> <thead> <tr> <th align="left">Property Name</th> <th align="left">Property Type</th> <th align="left">Property Context</th> <thalign="left">Reference or Description</th> <thalign="left">Intended Usage</th> <th align="left">Reference/Description</th> </tr> </thead><!-- Everything in here should be sorted alphabetically: table entries by property name, the references for each property alphabetically by the object type or property they refer to --><tbody> <tr> <td align="left">vCardName</td> <td align="left">String</td> <td align="left">Any JSContact object</td> <tdalign="left">align="left">common</td> <td align="left">RFC 9555, <xref target="jscontact-prop-vcardname"format="default"/> </td> <td align="left">common</td>format="default"/></td> </tr> <tr> <td align="left">vCardParams</td> <tdalign="left">String[String]</td>align="left">String[String|String[]]</td> <td align="left">Any JSContact object</td> <tdalign="left">align="left">common</td> <td align="left">RFC 9555, <xref target="jscontact-prop-vcardparams" format="default"/> </td><td align="left">common</td></tr> <tr> <td align="left">vCardProps</td> <td align="left">JCardProp[]</td> <td align="left">Card</td> <tdalign="left">align="left">common</td> <td align="left">RFC 9555, <xref target="jscontact-prop-vcardprops" format="default"/> </td><td align="left">common</td></tr> </tbody> </table> </section> <section> <name>New JSContactTypes</name>Type</name> <t>IANAis requested to addhas added the followingentriesentry to the "JSContact Types" registry.TheNote that the Since Versionfor all propertiesis1.0. The1.0, the Until Versionfor all propertiesis notset. All RFC section references areset, and the Change Controller is IETF for thisdocument. The change controller for all these properties is IETF.</t>type.</t> <table anchor="tab-iana-jscontact-type-registry" align="left"><name>Additional Contents of the "JSContact Types"<name>JSContact Types Registry</name> <thead> <tr> <th align="left">Type Name</th> <thalign="left">Reference or Description</th> <thalign="left">Intended Usage</th> <th align="left">Reference/Description</th> </tr> </thead> <tbody> <tr> <td align="left">JCardProp</td> <tdalign="left">align="left">common</td> <td align="left">RFC 9555, <xref target="jscontact-prop-vcardprops" format="default"/> </td><td align="left">common</td></tr> </tbody> </table> </section> </section><section anchor="impl-status"> <name>Implementation Status</name> <t>NOTE: Please remove this section and the reference to RFC 7942 prior to publication as an RFC.</t> <t>This section records the status of known implementations of the protocol as defined in this specification at the time of posting of this Internet-Draft, and is based on a proposal described in <xref target="RFC7942"/>. The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that other implementations may exist.</t> <t>According to RFC 7942, "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature. It is up to the individual working groups to use this information as they see fit".</t> <section anchor="it-cnr-iit"> <name>CNR</name> <ul spacing="compact"> <li>Responsible Organization: National Research Council (CNR) of Italy</li> <li>Location: https://github.com/consiglionazionaledellericerche/jscontact-tools</li> <li>Description: This implementation includes tools for JSContact creation, validation, serialization/deserialization, and conversion from vCard, xCard and jCard.</li> <li>Level of Maturity: This is an "alpha" test implementation.</li> <li>Coverage: This implementation includes all features described in this specification.</li> <li>Contact Information: Mario Loffredo, mario.loffredo@iit.cnr.it</li> </ul> </section> </section></middle> <back> <displayreference target="I-D.calconnect-vobject-i18n" to="vOBJECT"/> <references> <name>References</name> <references> <name>Normative References</name> <!-- [I-D.ietf-calext-jscontact] in AUTH48-DONE; companion document RFC 9553 --> <reference anchor="RFC9553" target="https://www.rfc-editor.org/info/rfc9553"> <front> <title>JSContact: A JSON Representation of Contact Data</title> <author initials='R' surname='Stepanek' fullname='Robert Stepanek'> <organization /> </author> <author initials='M' surname='Loffredo' fullname='Mario Loffredo'> <organization /> </author> <date month='May' year='2024' /> </front> <seriesInfo name="RFC" value="9553"/> <seriesInfo name="DOI" value="10.17487/RFC9553"/> </reference> <!-- [I-D.ietf-calext-vcard-jscontact-extensions] in AUTH48-DONE; companion document RFC 9554 --> <reference anchor="RFC9554" target="https://www.rfc-editor.org/info/rfc9554"> <front> <title>vCard Format Extensions for JSContact</title> <author initials="R." surname="Stepanek" fullname="Robert Stepanek"> <organization>Fastmail</organization> </author> <author initials="M." surname="Loffredo" fullname="Mario Loffredo"> <organization>IIT-CNR</organization> </author> <date month="May" year="2024"/> </front> <seriesInfo name="RFC" value="9554"/> <seriesInfo name="DOI" value="10.17487/RFC9554"/> </reference> <xi:includehref="https://datatracker.ietf.org/doc/bibxml3/draft-ietf-calext-jscontact.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/> <xi:includehref="https://datatracker.ietf.org/doc/bibxml3/draft-ietf-calext-vcard-jscontact-extensions.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3986.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5234.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5234.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5646.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6350.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6350.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6473.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6473.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6474.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6474.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6715.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6715.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6869.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6869.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6901.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6901.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7095.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7095.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7942.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/> <xi:includehref="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8259.xml"/> </references> <references> <name>Informative References</name> <!--[I-D.calconnect-vobject-i18n] IESG state Expired as of 5/1/24. Entered the long way to get the correct initials--> <reference anchor="I-D.calconnect-vobject-i18n" target="https://datatracker.ietf.org/doc/html/draft-calconnect-vobject-i18n-00"> <front> <title>vObject Internationalization</title> <author fullname="Ronald Henry Tse" initials="R." surname="Tse"> <organization>Ribose</organization> </author> <author fullname="Peter Tam" initials="P." surname="Tam"> <organization>Ribose</organization> </author> <author fullname="Michael Douglass" initials="M." surname="Douglass"> <organization>Spherical Cow Group</organization> </author> <date day="8" month="June" year="2018"/> </front> <seriesInfo name="Internet-Draft" value="draft-calconnect-vobject-i18n-00"/> </reference> <xi:includehref="https://datatracker.ietf.org/doc/bibxml3/draft-calconnect-vobject-i18n.xml"/> <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8605.xml"/>href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8605.xml"/> <reference anchor="CLDRPersonName" target="https://www.unicode.org/reports/tr35/tr35-personNames.html"> <front><title>Technical Standard #35: Unicode<title>Unicode Locale Data Markup Language (LDML) Part 8: PersonNames, Version 43.1</title>Names</title> <author fullname="M. Davis"> <organization/> </author> <author fullname="P. Edberg"> <organization/> </author> <author fullname="R. Gillam"> <organization/> </author> <author fullname="A. Kolisnychenko"> <organization/> </author> <author fullname="M. McKenna"> <organization/> </author><author fullname="others"> <organization/><author> <organization>other CLDR committee members</organization> </author> <date year="2023" month="July"/> </front> <seriesInfo name="Unicode Technical Standard" value="#35"/> <seriesInfo name="Version" value="44.1"/> </reference> </references> </references> <section anchor="convert_jscontact_to_vcard-reverse-rules"> <name>Reverse Rules of Converting a vCard to a JSContact Card</name> <t><xref target="table_convert_jscontact_to_vcard"/> lists the relevant document sections for each JSContactobjecttype and property.</t> <table anchor="table_convert_jscontact_to_vcard"> <name>Conversionrules byRules for JSContactproperty</name>Types and Properties</name> <thead> <tr> <th align="left">JSContact Type</th> <th align="left">Property Name</th> <th align="left">Relevant Section(s)</th> </tr> </thead> <tbody> <tr> <td>Address</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Address</td> <td>components</td><td><xref target="vcard-prop-adr"/>,<td>Sections <xreftarget="vcard-param-jscomps"/></td>target="vcard-prop-adr" format="counter"/> and <xref target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Address</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Address</td> <td>coordinates</td><td><xref target="vcard-param-geo"/>,<td>Sections <xreftarget="vcard-prop-geo"/></td>target="vcard-param-geo" format="counter"/> and <xref target="vcard-prop-geo" format="counter"/></td> </tr> <tr> <td>Address</td> <td>country</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>countryCode</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>defaultSeparator</td><td><xref target="vcard-prop-adr"/>,<td>Sections <xreftarget="vcard-param-jscomps"/></td>target="vcard-prop-adr" format="counter"/> and <xref target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Address</td> <td>full</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>isOrdered</td><td><xref target="vcard-prop-adr"/>,<td>Sections <xreftarget="vcard-param-jscomps"/></td>target="vcard-prop-adr" format="counter"/> and <xref target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Address</td> <td>locality</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>phoneticScript</td><td><td>Sections <xreftarget="vcard-param-phonetic"/>,target="vcard-param-phonetic" format="counter"/> and <xreftarget="vcard-param-script"/>target="vcard-param-script" format="counter"/> </td> </tr> <tr> <td>Address</td> <td>phoneticSystem</td> <td><xref target="vcard-param-phonetic"/></td> </tr> <tr> <td>Address</td> <td>postcode</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Address</td> <td>region</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Address</td> <td>timeZone</td><td><xref target="vcard-param-tz"/>,<td>Sections <xreftarget="vcard-prop-tz"/></td>target="vcard-param-tz" format="counter"/> and <xref target="vcard-prop-tz" format="counter"/></td> </tr> <tr> <td>AddressComponent</td> <td>phonetic</td> <td><xref target="vcard-param-phonetic"/></td> </tr> <tr> <td>Anniversary</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Anniversary</td> <td>date</td> <td> <xref target="vcard-prop-anniversary"/> </td> </tr> <tr> <td>Anniversary</td> <td>kind</td> <td> <xref target="vcard-prop-anniversary"/> </td> </tr> <tr> <td>Anniversary</td> <td>place</td> <td> <xref target="vcard-prop-anniversary"/> </td> </tr> <tr> <td>Author</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Author</td> <td>name</td> <td> <xref target="vcard-param-author-name"/> </td> </tr> <tr> <td>Author</td> <td>uri</td> <td> <xref target="vcard-param-author"/> </td> </tr> <tr> <td>Calendar</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Calendar</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Calendar</td> <td>kind</td><td><xref target="vcard-prop-caladruri"/>,<td>Sections <xreftarget="vcard-prop-fburl"/></td>target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl" format="counter"/></td> </tr> <tr> <td>Calendar</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>Calendar</td> <td>mediaType</td> <td> <xref target="vcard-param-mediatype"/> </td> </tr> <tr> <td>Calendar</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Calendar</td> <td>uri</td><td><xref target="vcard-prop-caladruri"/>,<td>Sections <xreftarget="vcard-prop-fburl"/></td>target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl" format="counter"/></td> </tr> <tr> <td>Card</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Card</td> <td>@version</td> <td>not applicable</td> </tr> <tr> <td>Card</td> <td>addresses</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Card</td> <td>anniversaries</td> <td> <xref target="vcard-prop-anniversary"/> </td> </tr> <tr> <td>Card</td> <td>calendars</td><td><xref target="vcard-prop-caladruri"/>,<td>Sections <xreftarget="vcard-prop-fburl"/></td>target="vcard-prop-caluri" format="counter"/> and <xref target="vcard-prop-fburl" format="counter"/></td> </tr> <tr> <td>Card</td> <td>created</td> <td> <xref target="vcard-prop-created"/> </td> </tr> <tr> <td>Card</td> <td>directories</td><td><xref target="vcard-prop-source"/>,<td>Sections <xreftarget="vcard-prop-org-directory"/></td>target="vcard-prop-source" format="counter"/> and <xref target="vcard-prop-org-directory" format="counter"/></td> </tr> <tr> <td>Card</td> <td>emails</td> <td> <xref target="vcard-prop-email"/> </td> </tr> <tr> <td>Card</td> <td>keywords</td> <td> <xref target="vcard-prop-categories"/> </td> </tr> <tr> <td>Card</td> <td>kind</td> <td> <xref target="vcard-prop-kind"/> </td> </tr> <tr> <td>Card</td> <td>language</td> <td> <xref target="vcard-prop-language"/> </td> </tr> <tr> <td>Card</td> <td>links</td><td><xref target="vcard-prop-contact-uri"/>,<td>Sections <xreftarget="vcard-prop-url"/></td>target="vcard-prop-contact-uri" format="counter"/> and <xref target="vcard-prop-url" format="counter"/></td> </tr> <tr> <td>Card</td> <td>localizations</td> <td> <xref target="vcard-param-language"/> </td> </tr> <tr> <td>Card</td> <td>media</td><td><xref target="vcard-prop-photo"/>,<td>Sections <xreftarget="vcard-prop-logo"/>,target="vcard-prop-photo" format="counter"/>, <xreftarget="vcard-prop-sound"/></td>target="vcard-prop-logo" format="counter"/>, and <xref target="vcard-prop-sound" format="counter"/></td> </tr> <tr> <td>Card</td> <td>members</td> <td> <xref target="vcard-prop-member"/> </td> </tr> <tr> <td>Card</td> <td>name</td> <td> <xref target="vcard-prop-n"/> </td> </tr> <tr> <td>Card</td> <td>nicknames</td> <td> <xreftarget="vcard-prop-n"/>target="vcard-prop-nickname"/> </td> </tr> <tr> <td>Card</td> <td>notes</td> <td> <xref target="vcard-prop-note"/> </td> </tr> <tr> <td>Card</td> <td>onlineServices</td> <td> <xref target="vcard-prop-impp"/> </td> </tr> <tr> <td>Card</td> <td>organizations</td> <td> <xref target="vcard-prop-org"/> </td> </tr> <tr> <td>Card</td> <td>personalInfo</td><td><xref target="vcard-prop-expertise"/>,<td>Sections <xref target="vcard-prop-expertise" format="counter"/>, <xreftarget="vcard-prop-hobby"/>,target="vcard-prop-hobby" format="counter"/>, and <xreftarget="vcard-prop-interest"/></td>target="vcard-prop-interest" format="counter"/></td> </tr> <tr> <td>Card</td> <td>phones</td> <td> <xref target="vcard-prop-tel"/> </td> </tr> <tr> <td>Card</td> <td>preferredLanguages</td> <td> <xref target="vcard-prop-lang"/> </td> </tr> <tr> <td>Card</td> <td>prodId</td> <td> <xref target="vcard-prop-prodid"/> </td> </tr> <tr> <td>Card</td> <td>relatedTo</td> <td> <xref target="vcard-prop-related"/> </td> </tr> <tr> <td>Card</td> <td>schedulingAddresses</td> <td> <xref target="vcard-prop-caladruri"/> </td> </tr> <tr> <td>Card</td> <td>speakToAs</td> <td> <xref target="vcard-prop-gramgender"/> </td> </tr> <tr> <td>Card</td> <td>titles</td> <td> <xref target="vcard-prop-title"/> </td> </tr> <tr> <td>Card</td> <td>uid</td> <td> <xref target="vcard-prop-uid"/> </td> </tr> <tr> <td>Card</td> <td>updated</td> <td> <xref target="vcard-prop-rev"/> </td> </tr> <tr> <td>CryptoKey</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>CryptoKey</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>CryptoKey</td> <td>kind</td> <td>not applicable</td> </tr> <tr> <td>CryptoKey</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>CryptoKey</td> <td>mediaType</td> <td> <xref target="vcard-param-mediatype"/> </td> </tr> <tr> <td>CryptoKey</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>CryptoKey</td> <td>uri</td> <td> <xref target="vcard-prop-key"/> </td> </tr> <tr> <td>Directory</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Directory</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Directory</td> <td>kind</td><td><xref target="vcard-prop-source"/>,<td>Sections <xreftarget="vcard-prop-org-directory"/></td>target="vcard-prop-source" format="counter"/> and <xref target="vcard-prop-org-directory" format="counter"/></td> </tr> <tr> <td>Directory</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>Directory</td> <td>listAs</td> <td> <xref target="vcard-param-index"/> </td> </tr> <tr> <td>Directory</td> <td>mediaType</td> <td> <xref target="vcard-param-mediatype"/> </td> </tr> <tr> <td>Directory</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Directory</td> <td>uri</td><td><xref target="vcard-prop-source"/>,<td>Sections <xref target="vcard-prop-source" format="counter"/> and <xreftarget="vcard-prop-org-directory"/></td>target="vcard-prop-org-directory" format="counter"/></td> </tr> <tr> <td>EmailAddress</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>EmailAddress</td> <td>address</td> <td> <xref target="vcard-prop-email"/> </td> </tr> <tr> <td>EmailAddress</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>EmailAddress</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>EmailAddress</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>LanguagePref</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>LanguagePref</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>LanguagePref</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Link</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Link</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Link</td> <td>kind</td> <td><xreftarget="vcard-prop-contact-uri"/>, <xref target="vcard-prop-url"/></td>target="vcard-prop-contact-uri"/></td> </tr> <tr> <td>Link</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>Link</td> <td>mediaType</td> <td> <xref target="vcard-param-mediatype"/> </td> </tr> <tr> <td>Link</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Link</td> <td>uri</td><td><xref target="vcard-prop-contact-uri"/>,<td>Sections <xreftarget="vcard-prop-url"/>></td>target="vcard-prop-contact-uri" format="counter"/> and <xref target="vcard-prop-url" format="counter"/></td> </tr> <tr> <td>Media</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Media</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Media</td> <td>kind</td><td><xref target="vcard-prop-photo"/>,<td>Sections <xreftarget="vcard-prop-logo"/>,target="vcard-prop-photo" format="counter"/>, <xref target="vcard-prop-logo" format="counter"/>, and <xreftarget="vcard-prop-sound"/></td>target="vcard-prop-sound" format="counter"/></td> </tr> <tr> <td>Media</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>Media</td> <td>mediaType</td> <td> <xref target="vcard-param-mediatype"/> </td> </tr> <tr> <td>Media</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Media</td> <td>uri</td><td><xref target="vcard-prop-photo"/>,<td>Sections <xref target="vcard-prop-photo" format="counter"/>, <xreftarget="vcard-prop-logo"/>,target="vcard-prop-logo" format="counter"/>, and <xreftarget="vcard-prop-sound"/></td>target="vcard-prop-sound" format="counter"/></td> </tr> <tr> <td>Name</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Name</td> <td>components</td><td><xref target="vcard-prop-n"/>,<td>Sections <xref target="vcard-prop-n" format="counter"/> and <xreftarget="vcard-param-jscomps"/></td>target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Name</td> <td>defaultSeparator</td><td><xref target="vcard-prop-n"/>,<td>Sections <xref target="vcard-prop-n" format="counter"/> and <xreftarget="vcard-param-jscomps"/></td>target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Name</td> <td>full</td> <td> <xref target="vcard-prop-fn"/> </td> </tr> <tr> <td>Name</td> <td>phoneticScript</td><td><td>Sections <xreftarget="vcard-param-phonetic"/>,target="vcard-param-phonetic" format="counter"/> and <xreftarget="vcard-param-script"/>target="vcard-param-script" format="counter"/> </td> </tr> <tr> <td>Name</td> <td>phoneticSystem</td> <td><xref target="vcard-param-phonetic"/></td> </tr> <tr> <td>Name</td> <td>isOrdered</td><td><xref target="vcard-prop-n"/>,<td>Sections <xref target="vcard-prop-n" format="counter"/> and <xreftarget="vcard-param-jscomps"/></td>target="vcard-param-jscomps" format="counter"/></td> </tr> <tr> <td>Name</td> <td>sortAs</td> <td> <xref target="vcard-param-sortas"/> </td> </tr> <tr> <td>NameComponent</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>NameComponent</td> <td>kind</td> <td> <xref target="vcard-prop-n"/> </td> </tr> <tr> <td>NameComponent</td> <td>phonetic</td> <td><xref target="vcard-param-phonetic"/></td> </tr> <tr> <td>NameComponent</td> <td>value</td> <td> <xref target="vcard-prop-n"/> </td> </tr> <tr> <td>Nickname</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Nickname</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Nickname</td> <td>name</td> <td> <xref target="vcard-prop-n"/> </td> </tr> <tr> <td>Nickname</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Note</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Note</td> <td>author</td><td><xref target="vcard-param-author"/>,<td>Sections <xref target="vcard-param-author" format="counter"/> and <xreftarget="vcard-param-author-name"/></td>target="vcard-param-author-name" format="counter"/></td> </tr> <tr> <td>Note</td> <td>created</td> <td> <xref target="vcard-param-created"/> </td> </tr> <tr> <td>Note</td> <td>note</td> <td> <xref target="vcard-prop-note"/> </td> </tr> <tr> <td>OnlineService</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>OnlineService</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>OnlineService</td><td>kind</td> <td><xref target="vcard-prop-impp"/>, <xref target="vcard-prop-socialprofile"/></td> </tr> <tr> <td>OnlineService</td><td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>OnlineService</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>OnlineService</td> <td>service</td> <td> <xref target="vcard-param-service-type"/> </td> </tr> <tr> <td>OnlineService</td> <td>uri</td><td><xref target="vcard-prop-impp"/>,<td>Sections <xref target="vcard-prop-impp" format="counter"/> and <xreftarget="vcard-prop-socialprofile"/></td>target="vcard-prop-socialprofile" format="counter"/></td> </tr> <tr> <td>OnlineService</td> <td>user</td> <td> <xref target="vcard-param-username"/> </td> </tr> <tr> <td>OrgUnit</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>OrgUnit</td> <td>name</td> <td> <xref target="vcard-prop-org"/> </td> </tr> <tr> <td>OrgUnit</td> <td>sortAs</td> <td> <xref target="vcard-param-sortas"/> </td> </tr> <tr> <td>Organization</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Organization</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Organization</td> <td>name</td> <td> <xref target="vcard-prop-org"/> </td> </tr> <tr> <td>Organization</td> <td>sortAs</td> <td> <xref target="vcard-param-sortas"/> </td> </tr> <tr> <td>Organization</td> <td>units</td> <td> <xref target="vcard-prop-org"/> </td> </tr> <tr> <td>PartialDate</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>PartialDate</td> <td>calendarScale</td> <td> <xref target="vcard-param-calscale"/> </td> </tr> <tr> <td>PartialDate</td> <td>day</td> <td> <xref target="vcard-type-datetime"/> </td> </tr> <tr> <td>PartialDate</td> <td>month</td> <td> <xref target="vcard-type-datetime"/> </td> </tr> <tr> <td>PartialDate</td> <td>year</td> <td> <xref target="vcard-type-datetime"/> </td> </tr> <tr> <td>PatchObject</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>PersonalInfo</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>PersonalInfo</td> <td>kind</td><td><xref target="vcard-prop-expertise"/>,<td>Sections <xref target="vcard-prop-expertise" format="counter"/>, <xreftarget="vcard-prop-hobby"/>,target="vcard-prop-hobby" format="counter"/>, and <xreftarget="vcard-prop-interest"/></td>target="vcard-prop-interest" format="counter"/></td> </tr> <tr> <td>PersonalInfo</td> <td>listAs</td> <td> <xref target="vcard-param-index"/> </td> </tr> <tr> <td>PersonalInfo</td> <td>level</td> <td> <xref target="vcard-param-level"/> </td> </tr> <tr> <td>PersonalInfo</td> <td>value</td><td><xref target="vcard-prop-expertise"/>,<td>Sections <xref target="vcard-prop-expertise" format="counter"/>, <xreftarget="vcard-prop-hobby"/>,target="vcard-prop-hobby" format="counter"/>, and <xreftarget="vcard-prop-interest"/></td>target="vcard-prop-interest" format="counter"/></td> </tr> <tr> <td>Phone</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Phone</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Phone</td> <td>features</td> <td> <xref target="vcard-prop-tel"/> </td> </tr> <tr> <td>Phone</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>Phone</td> <td>number</td> <td> <xref target="vcard-prop-tel"/> </td> </tr> <tr> <td>Phone</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Pronouns</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Pronouns</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>Pronouns</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>Pronouns</td> <td>pronouns</td> <td> <xref target="vcard-prop-gramgender"/> </td> </tr> <tr> <td>Relation</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Relation</td> <td>relation</td> <td> <xref target="vcard-prop-related"/> </td> </tr> <tr> <td>Resource</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>SchedulingAddress</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>SchedulingAddress</td> <td>contexts</td> <td> <xref target="vcard-param-type"/> </td> </tr> <tr> <td>SchedulingAddress</td> <td>label</td> <td> <xref target="vcard-prop-xablabel"/> </td> </tr> <tr> <td>SchedulingAddress</td> <td>pref</td> <td> <xref target="vcard-param-pref"/> </td> </tr> <tr> <td>SchedulingAddress</td> <td>uri</td> <td> <xref target="vcard-prop-caladruri"/> </td> </tr> <tr> <td>SpeakToAs</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>SpeakToAs</td> <td>grammaticalGender</td> <td> <xref target="vcard-prop-gramgender"/> </td> </tr> <tr> <td>SpeakToAs</td> <td>pronouns</td> <td> <xref target="vcard-prop-gramgender"/> </td> </tr> <tr> <td>AddressComponent</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>AddressComponent</td> <td>kind</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>AddressComponent</td> <td>value</td> <td> <xref target="vcard-prop-adr"/> </td> </tr> <tr> <td>Timestamp</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Timestamp</td> <td>utc</td> <td> <xref target="vcard-type-datetime"/> </td> </tr> <tr> <td>Title</td> <td>@type</td> <td>not applicable</td> </tr> <tr> <td>Title</td> <td>kind</td> <td> <xref target="vcard-prop-title"/> </td> </tr> <tr> <td>Title</td> <td>name</td> <td> <xref target="vcard-prop-title"/> </td> </tr> <tr> <td>Title</td><td>organization</td><td>organizationId</td> <td> <xref target="vcard-prop-title"/> </td> </tr> </tbody> </table> </section> <section anchor="Acknowledgments" numbered="false"> <name>Acknowledgements</name> <t>The definition and examples of the <xref target="vcard-param-phonetic">PHONETIC</xref> and <xref target="vcard-param-script">SCRIPT</xref> parameters are based on the initial draft version of <xref target="I-D.calconnect-vobject-i18n"/>.</t> </section> </back> </rfc>