Network Working Group S. Perreault
Internet-Draft Viagenie
Obsoletes: 2425, 2426, 4770 November 18, 2008
(if approved)
Updates: 2739 (if approved)
Intended status: Standards Track
Expires: May 22, 2009
vCard XML Schema
draft-perreault-vcarddav-vcardxml-00
Status of This Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on May 22, 2009.
Abstract
This document defines the XML schema of the vCard data format.
Perreault Expires May 22, 2009 [Page 1]
Internet-Draft vCard XML November 2008
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Schema . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Example: Author's XML vCard . . . . . . . . . . . . . . . . . . 4
4. Design Considerations . . . . . . . . . . . . . . . . . . . . . 4
4.1. Extensibility . . . . . . . . . . . . . . . . . . . . . . . 5
5. Security Considerations . . . . . . . . . . . . . . . . . . . . 5
6. Normative References . . . . . . . . . . . . . . . . . . . . . 5
Appendix A. Relax NG Schema . . . . . . . . . . . . . . . . . . . 5
Perreault Expires May 22, 2009 [Page 2]
Internet-Draft vCard XML November 2008
1. Introduction
vCard [draft-ietf-vcarddav-vcardrev] is a data format for
representing and exchanging information about individuals. It is a
text-based format (as opposed to a binary format). This document
defines an XML representation for vCard. The underlying data
structure is exactly the same. The XML formatting may be preferred
in some contexts where an XML engine is readily available and may be
reused instead of writing a stand-alone vCard parser.
2. The Schema
The schema is expressed in the Relax NG language (TODO: add
reference) and is found in Appendix A.
Perreault Expires May 22, 2009 [Page 3]
Internet-Draft vCard XML November 2008
3. Example: Author's XML vCard
4.0
Simon Perreault
Perreault
Simon
ing. jr.
M.Sc.
1983-02-03
M
Viagenie
Suite 625
2600 boul. Laurier
Quebec
QC
G1V 4W1
Canada
tel:+1-418-656-9254;ext=102
simon.perreault@viagenie.ca
46.772673
-71.282945
http://www.viagenie.ca/simon.perreault/simon.asc
public
4. Design Considerations
The general idea is to map vCard properties to XML element and vCard
parameters to XML attributes. For example, the "FN" property is
mapped to the "fn" element. That element's value (a text node)
corresponds to the vCard property's value.
vCard parameters are mapped to XML attributes. For example, the
"TYPE" parameter applied to the "TEL" property would look like the
following in XML:
tel:+1-555-555-555
Perreault Expires May 22, 2009 [Page 4]
Internet-Draft vCard XML November 2008
Properties having structured values (e.g. the N property) are
expressed by XML element trees. Element names in that tree (e.g.
"surname", "given", etc.) do not have a vCard equivalent since they
are identified by position in plain vCard.
Line folding is a non-issue in XML. Therefore, the mapping from
vCard to XML is done after the unfolding procedure is carried out.
Conversely, the mapping from XML to vCard is done before the folding
procedure is carried out.
4.1. Extensibility
The original vCard format is extensible. New properties, parameters,
data types and values (collectively known as vCard objects) can be
registered from IANA. It is expected that these vCard extensions
will also specify extensions to the XML format described in this
document. This is not a requirement: a separate document may be used
instead.
Unregistered extensions (i.e. those starting with "X-" and
"VND-...-") can be expressed in XML using the special
element. For example:
x-foo
abc
xyz
The content of the "name" element MUST start with "X-" or "VND-...-"
as specified in [draft-ietf-vcarddav-vcardrev]. The contents of the
"value" element is not specified and MAY be any well-formed XML
fragment.
5. Security Considerations
TBD
6. Normative References
[draft-ietf-vcarddav-vcardrev] Perreault, S. and P. Resnick, "vCard
Format Specification", 2008.
Appendix A. Relax NG Schema
Perreault Expires May 22, 2009 [Page 5]
Internet-Draft vCard XML November 2008
[Xx]-[A-Za-z0-9\-]+
vnd-[0-9]+-[A-Za-z0-9\-]+
[A-Za-z0-9!#$&.+\-^_]{1,127}
/[A-Za-z0-9!#$&.+\-^_]{1,127}
Perreault Expires May 22, 2009 [Page 6]
Internet-Draft vCard XML November 2008
[A-Za-z0-9+/]*
[+\-]([01][0-9]|2[0-3]):[0-5][0-9]
Perreault Expires May 22, 2009 [Page 7]
Internet-Draft vCard XML November 2008
individual
group
org
Perreault Expires May 22, 2009 [Page 8]
Internet-Draft vCard XML November 2008
uri
text
Perreault Expires May 22, 2009 [Page 9]
Internet-Draft vCard XML November 2008
text
M
F
Perreault Expires May 22, 2009 [Page 10]
Internet-Draft vCard XML November 2008
text
voice
fax
cell
video
pager
Perreault Expires May 22, 2009 [Page 11]
Internet-Draft vCard XML November 2008
text
Perreault Expires May 22, 2009 [Page 12]
Internet-Draft vCard XML November 2008
uri
Perreault Expires May 22, 2009 [Page 13]
Internet-Draft vCard XML November 2008
parent
child
sibling
manager
assistant
agent
Perreault Expires May 22, 2009 [Page 14]
Internet-Draft vCard XML November 2008
uri
4.0
Perreault Expires May 22, 2009 [Page 15]
Internet-Draft vCard XML November 2008
public
private
confidential
uri
Perreault Expires May 22, 2009 [Page 16]
Internet-Draft vCard XML November 2008
Perreault Expires May 22, 2009 [Page 17]
Internet-Draft vCard XML November 2008
Author's Address
Simon Perreault
Viagenie
2600 boul. Laurier, suite 625
Quebec, QC G1V 4W1
Canada
Phone: +1 418 656 9254
EMail: simon.perreault@viagenie.ca
URI: http://www.viagenie.ca
Perreault Expires May 22, 2009 [Page 18]
Internet-Draft vCard XML November 2008
Full Copyright Statement
Copyright (C) The IETF Trust (2008).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgement
This document was produced using xml2rfc v1.33 (of
http://xml.resource.org/) from a source in RFC-2629 XML format.
Perreault Expires May 22, 2009 [Page 19]