draft-ietf-jmap-jscontact-06.txt   draft-ietf-jmap-jscontact-07.txt 
JMAP R. Stepanek JMAP R. Stepanek
Internet-Draft FastMail Internet-Draft FastMail
Intended status: Standards Track M. Loffredo Intended status: Standards Track M. Loffredo
Expires: 29 November 2021 IIT-CNR Expires: 13 January 2022 IIT-CNR
28 May 2021 12 July 2021
JSContact: A JSON representation of contact data JSContact: A JSON representation of contact data
draft-ietf-jmap-jscontact-06 draft-ietf-jmap-jscontact-07
Abstract Abstract
This specification defines a data model and JSON representation of This specification defines a data model and JSON representation of
contact card information that can be used for data storage and contact card information that can be used for data storage and
exchange in address book or directory applications. It aims to be an exchange in address book or directory applications. It aims to be an
alternative to the vCard data format and to be unambiguous, alternative to the vCard data format and to be unambiguous,
extendable and simple to process. In contrast to the JSON-based extendable and simple to process. In contrast to the JSON-based
jCard format, it is not a direct mapping from the vCard data model jCard format, it is not a direct mapping from the vCard data model
and expands semantics where appropriate. and expands semantics where appropriate.
skipping to change at page 1, line 37 skipping to change at page 1, line 37
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on 29 November 2021. This Internet-Draft will expire on 13 January 2022.
Copyright Notice Copyright Notice
Copyright (c) 2021 IETF Trust and the persons identified as the Copyright (c) 2021 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents (https://trustee.ietf.org/ Provisions Relating to IETF Documents (https://trustee.ietf.org/
license-info) in effect on the date of publication of this document. license-info) in effect on the date of publication of this document.
Please review these documents carefully, as they describe your rights Please review these documents carefully, as they describe your rights
skipping to change at page 15, line 19 skipping to change at page 15, line 19
relevant country's postal system. relevant country's postal system.
* countryCode: "String" (optional). The ISO-3166-1 country code. * countryCode: "String" (optional). The ISO-3166-1 country code.
* coordinates: "String" (optional) A [RFC5870] "geo:" URI for the * coordinates: "String" (optional) A [RFC5870] "geo:" URI for the
address. address.
* timeZone: "String" (optional) Identifies the time zone this * timeZone: "String" (optional) Identifies the time zone this
address is located in. This either MUST be a time zone name address is located in. This either MUST be a time zone name
registered in the IANA Time Zone Database (https://www.iana.org/ registered in the IANA Time Zone Database (https://www.iana.org/
time-zones), or it MUST be a valid TimeZoneId as defined in FIXME time-zones), or it MUST be a valid TimeZoneId as defined in
. For the latter, a corresponding time zone MUST be defined in the [jscalendar]. For the latter, a corresponding time zone MUST be
"timeZones" property. defined in the "timeZones" property.
* contexts: "Context[Boolean]" (optional). The contexts of the * contexts: "Context[Boolean]" (optional). The contexts of the
address information. In addition to the common contexts, allowed address information. In addition to the common contexts, allowed
values are: values are:
- "billing" An address to be used for billing. - "billing" An address to be used for billing.
- "postal" An address to be used for delivering physical items. - "postal" An address to be used for delivering physical items.
The value for each key in the object MUST be "true". The value for each key in the object MUST be "true".
skipping to change at page 17, line 48 skipping to change at page 17, line 48
Type: "String[Boolean]" (optional). The set of free-text or URI Type: "String[Boolean]" (optional). The set of free-text or URI
categories that relate to the card. The set is represented as an categories that relate to the card. The set is represented as an
object, with each key being a category. The value for each key in object, with each key being a category. The value for each key in
the object MUST be "true". the object MUST be "true".
2.5.5. timeZones 2.5.5. timeZones
Type: "String[TimeZone]" (optional). Maps identifiers of custom time Type: "String[TimeZone]" (optional). Maps identifiers of custom time
zones to their time zone definitions. For a description of this zones to their time zone definitions. For a description of this
property see the "timeZones" property definition in FIXME . property see the "timeZones" property definition in [jscalendar].
3. CardGroup 3. CardGroup
MIME type: "application/jscontact+json;type=cardgroup" MIME type: "application/jscontact+json;type=cardgroup"
A CardGroup object represents a group of cards. Its members may be A CardGroup object represents a group of cards. Its members may be
Cards or CardGroups. Cards or CardGroups.
3.1. Group properties 3.1. Group properties
skipping to change at page 19, line 47 skipping to change at page 19, line 47
TBD TBD
6. Security Considerations 6. Security Considerations
TBD TBD
7. References 7. References
7.1. Normative References 7.1. Normative References
[jscalendar]
"JSCalendar: A JSON Representation of Calendar Data",
<https://www.rfc-editor.org/authors/rfc8984.html>.
[RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
Extensions (MIME) Part Two: Media Types", RFC 2046, Extensions (MIME) Part Two: Media Types", RFC 2046,
DOI 10.17487/RFC2046, November 1996, DOI 10.17487/RFC2046, November 1996,
<https://www.rfc-editor.org/info/rfc2046>. <https://www.rfc-editor.org/info/rfc2046>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997, DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>. <https://www.rfc-editor.org/info/rfc2119>.
 End of changes. 6 change blocks. 
8 lines changed or deleted 12 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/