1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-22 01:02:17 -05:00
This commit is contained in:
stpeter 2011-06-27 15:22:44 -06:00
parent 6d6a9a3e33
commit 535cd0a682

View File

@ -31,6 +31,12 @@
<email>samizzi@cisco.com</email> <email>samizzi@cisco.com</email>
<jid>samizzi@cisco.com</jid> <jid>samizzi@cisco.com</jid>
</author> </author>
<revision>
<version>0.6</version>
<date>2011-06-27</date>
<initials>sm/psa</initials>
<remark><p>Clarified status of VERSION and TZ properties.</p></remark>
</revision>
<revision> <revision>
<version>0.5</version> <version>0.5</version>
<date>2011-06-24</date> <date>2011-06-24</date>
@ -227,7 +233,7 @@
]]></example> ]]></example>
</section2> </section2>
<section2 topic='Publication' anchor='iq-publication'> <section2 topic='Publication' anchor='iq-publication'>
<p>An XMPP entity publishes or updates its vCard by sending an IQ-set to itself, containing a &lt;vcard/&gt; child element qualified by the 'urn:ietf:params:xml:ns:vcard-4.0' namespace.</p> <p>An XMPP entity publishes or updates its vCard by sending an IQ-set to itself, containing a &lt;vcard/&gt; child element qualified by the 'urn:ietf:params:xml:ns:vcard-4.0' namespace. The publication request needs to include the entire vCard, not a "diff" against the prior data (if any).</p>
<example caption="vCard Publication Request"><![CDATA[ <example caption="vCard Publication Request"><![CDATA[
<iq from='stpeter@jabber.org/squire <iq from='stpeter@jabber.org/squire
id='h3vz319m' id='h3vz319m'
@ -275,12 +281,12 @@
</event> </event>
</message> </message>
]]></example> ]]></example>
<p>Note: There is no payload, because this is a pure notification (the receiver needs to retrieve the vCard using an IQ-get as described earlier..</p> <p>Note: There is no payload, because this is a pure notification (the receiver needs to retrieve the vCard using an IQ-get as described earlier.</p>
</section2> </section2>
</section1> </section1>
<section1 topic='vCards of Automated Entities' anchor='things'> <section1 topic='vCards of Automated Entities' anchor='things'>
<p>Traditionally, vCards have been used on the XMPP network for entities other than human users, e.g. by XMPP servers and chatrooms. When such automated entities use vCards, it is RECOMMENDED to specify a value of "thing" for the vCard4 KIND property &vcardthing;. An example follows.</p> <p>Traditionally, vCards have been used on the XMPP network for entities other than human users, e.g. by XMPP servers and chatrooms. When such automated entities use vCards, it is RECOMMENDED to specify a value of "thing" for the vCard4 KIND property &vcardthing;, as illustrated in the following example:</p>
<example caption="vCard for a Thing"><![CDATA[ <example caption="vCard for a Thing"><![CDATA[
<iq from='jabber.org' <iq from='jabber.org'
id='yhx51c35' id='yhx51c35'
@ -375,6 +381,9 @@ property-key = element key {
]]></code> ]]></code>
<p>The source of the spurious &lt;PHONETIC/&gt; element is unknown. However, it does not exist in vCard4 and therefore is simply discarded when mapping.</p> <p>The source of the spurious &lt;PHONETIC/&gt; element is unknown. However, it does not exist in vCard4 and therefore is simply discarded when mapping.</p>
</section3> </section3>
<section3 topic='VERSION' anchor='mapping-incorrect-version'>
<p>As explained in <cite>XEP-0054</cite>, the &lt;VERSION/&gt; element from the final Dawson draft was not used in vcard-temp; instead, the vcard-temp protocol used a 'version' attribute (in fact the Dawson drafts were inconsistent, since the DTD defined a &lt;VERSION/&gt; element and the body of the specification used a 'version' attribute).</p>
</section3>
</section2> </section2>
<section2 topic='Properties Defined Differently in vcard-temp, vCard3, and vCard4' anchor='mapping-different'> <section2 topic='Properties Defined Differently in vcard-temp, vCard3, and vCard4' anchor='mapping-different'>
<p>The following properties are defined differently in vcard-temp and vCard4. As a result, the mappings are workable but might not preserve all information that could have been contained in vcard-temp data.</p> <p>The following properties are defined differently in vcard-temp and vCard4. As a result, the mappings are workable but might not preserve all information that could have been contained in vcard-temp data.</p>
@ -425,6 +434,7 @@ property-key = element key {
<li>REV</li> <li>REV</li>
<li>ROLE</li> <li>ROLE</li>
<li>TITLE</li> <li>TITLE</li>
<li>TZ</li>
<li>UID</li> <li>UID</li>
<li>URL</li> <li>URL</li>
</ul> </ul>