Internet Engineering Task Force (IETF) M. Loffredo
Request for Comments: 9555 IIT-CNR/Registro.it
Updates: 6350 R. Stepanek
Category: Standards Track Fastmail
ISSN: 2070-1721 May 2024
This document defines how to convert contact information between the JSContact and vCard data formats. It defines conversion rules for every JSContact and vCard element registered at IANA at the time of publication. It also defines new JSContact properties as well as vCard properties and parameters, to support converting arbitrary or unknown JSContact and vCard elements.
このドキュメントでは、JSCONTACTとVCARDデータ形式間で連絡先情報を変換する方法を定義します。発行時にIANAに登録されているすべてのJSCONTACTおよびVCARD要素の変換ルールを定義します。また、新しいJScontactプロパティとVCARDプロパティとパラメーターを定義して、任意または不明なJSCONTACTおよびVCARD要素の変換をサポートします。
This is an Internet Standards Track document.
これは、インターネット標準トラックドキュメントです。
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.
このドキュメントは、インターネットエンジニアリングタスクフォース（IETF）の製品です。IETFコミュニティのコンセンサスを表しています。公開レビューを受けており、インターネットエンジニアリングステアリンググループ（IESG）からの出版が承認されています。インターネット標準の詳細については、RFC 7841のセクション2で入手できます。
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc9555.
このドキュメントの現在のステータス、任意のERRATA、およびそのフィードバックを提供する方法に関する情報は、https://www.rfc-editor.org/info/rfc9555で取得できます。
Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved.
著作権（c）2024 IETF Trustおよび文書著者として特定された人。無断転載を禁じます。
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.
このドキュメントは、BCP 78およびIETFドキュメント（https://trustee.ietf.org/license-info）に関連するIETF Trustの法的規定の対象となります。この文書に関するあなたの権利と制限を説明するので、これらの文書を注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、セクション4.Eで説明されている法的規定のセクション4.Eで説明されており、修正されたBSDライセンスで説明されている保証なしで提供されるように、改訂されたBSDライセンステキストを含める必要があります。
This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.
このドキュメントには、2008年11月10日までに公開または公開されたIETFドキュメントまたはIETFの貢献からの資料が含まれている場合があります。IETF標準プロセスの外。そのような資料の著作権を制御する人から適切なライセンスを取得しないと、このドキュメントはIETF標準プロセスの外側に変更されない場合があり、その派生作業は、ITF標準プロセスの外側で作成されない場合があります。RFCとしての出版または英語以外の言語に翻訳する。
1. Introduction
1.1. Motivation
1.2. Notational Conventions
1.3. ABNF Notations
2. Converting vCard to JSContact
2.1. General Rules
2.1.1. The Card uid Property
2.1.2. Choosing Identifiers
2.2. vCard Value Data Types
2.2.1. BOOLEAN
2.2.2. DATE, TIME, DATE-TIME, DATE-AND-OR-TIME, and TIMESTAMP
2.2.3. INTEGER
2.2.4. FLOAT
2.2.5. LANGUAGE-TAG
2.2.6. TEXT
2.2.7. URI
2.2.8. UTC-OFFSET
2.3. vCard Parameters
2.3.1. ALTID
2.3.2. AUTHOR
2.3.3. AUTHOR-NAME
2.3.4. CALSCALE
2.3.5. CC
2.3.6. CREATED
2.3.7. DERIVED
2.3.8. GEO
2.3.9. GROUP
2.3.10. INDEX
2.3.11. LANGUAGE
2.3.12. LABEL
2.3.13. LEVEL
2.3.14. MEDIATYPE
2.3.15. PHONETIC
2.3.16. PID
2.3.17. PREF
2.3.18. PROP-ID
2.3.19. SCRIPT
2.3.20. SERVICE-TYPE
2.3.21. SORT-AS
2.3.22. TYPE
2.3.23. TZ
2.3.24. USERNAME
2.3.25. VALUE
2.4. General Properties
2.4.1. BEGIN and END
2.4.2. KIND
2.4.3. SOURCE
2.4.4. XML
2.5. Identification Properties
2.5.1. ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE, and
DEATHPLACE
2.5.2. FN
2.5.3. GENDER
2.5.4. GRAMGENDER and PRONOUNS
2.5.5. N
2.5.6. NICKNAME
2.5.7. PHOTO
2.6. Delivery Addressing Properties
2.6.1. ADR
2.7. Communications Properties
2.7.1. EMAIL
2.7.2. IMPP
2.7.3. LANG
2.7.4. LANGUAGE
2.7.5. SOCIALPROFILE
2.7.6. TEL
2.8. Geographical Properties
2.8.1. GEO
2.8.2. TZ
2.8.3. Combining Geographical Properties
2.9. Organizational Properties
2.9.1. CONTACT-URI
2.9.2. LOGO
2.9.3. MEMBER
2.9.4. ORG
2.9.5. RELATED
2.9.6. TITLE and ROLE
2.10. Personal Information Properties
2.10.1. EXPERTISE
2.10.2. HOBBY
2.10.3. INTEREST
2.10.4. ORG-DIRECTORY
2.11. Explanatory Properties
2.11.1. CATEGORIES
2.11.2. CLIENTPIDMAP
2.11.3. CREATED
2.11.4. NOTE
2.11.5. PRODID
2.11.6. REV
2.11.7. SOUND
2.11.8. UID
2.11.9. URL
2.11.10. VERSION
2.11.11. X-ABLabel
2.12. Security Properties
2.12.1. KEY
2.13. Calendar Properties
2.13.1. CALADRURI
2.13.2. CALURI
2.13.3. FBURL
2.14. Extended Properties and Parameters
2.15. New JSContact Properties
2.15.1. vCardProps
2.15.2. vCardParams
2.15.3. vCardName
3. Converting JSContact to vCard
3.1. Conversion Rules
3.1.1. Converting Unknown Properties
3.2. New vCard Properties
3.2.1. JSPROP
3.3. New vCard Parameters
3.3.1. JSCOMPS
3.3.2. JSPTR
4. Security Considerations
5. IANA Considerations
5.1. New vCard Property
5.2. New vCard Parameter
5.3. New JSContact Properties
5.4. New JSContact Type
6. References
6.1. Normative References
6.2. Informative References
Appendix A. Reverse Rules of Converting a vCard to a JSContact
Card
Acknowledgements
Authors' Addresses
The JSContact data model and format [RFC9553] aims to be an alternative to the widely used vCard standard [RFC6350] and jCard format [RFC7095].
JScontactデータモデルと形式[RFC9553]は、広く使用されているVCARD標準[RFC6350]およびJCARD形式[RFC7095]の代替であることを目的としています。
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 data in JSContact.
アプリケーションはJSContactを好むかもしれませんが、連絡先カードデータを他のシステムと交換することは、VCARDまたはJCARDのみをサポートするサービスやクライアントと相互操作する可能性があります。同様に、すでにVCARDまたはJCARDを使用している既存の連絡先データプロバイダーと消費者は、JSCONTACTで連絡先データを表現したい場合もあります。
To achieve this, this document defines standard rules to convert contact data between JSContact and vCard (and consequently jCard).
これを達成するために、このドキュメントは、JSContactとVCard（およびその結果、JCard）の間で連絡先データを変換する標準ルールを定義します。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
キーワード「必須」、「必要」、「必須」、「shall」、「shall」、「shill "of"、 "nove"、 "becommended"、 "becommented"、 "may"、 "optional「このドキュメントでは、BCP 14 [RFC2119] [RFC8174]で説明されているように解釈されます。
The ABNF definitions in this document use the notations of [RFC5234]. ABNF rules not defined in this document are defined in either [RFC5234] (such as the ABNF for CRLF, WSP, DQUOTE, VCHAR, ALPHA, and DIGIT) or [RFC6350].
このドキュメントのABNF定義は、[RFC5234]の表記を使用します。このドキュメントで定義されていないABNFルールは、[RFC5234]（CRLF、WSP、Dquote、VCher、Alpha、およびDigitのABNFなど）または[RFC6350]のいずれかで定義されています。
This section contains the conversion rules from the vCard to the JSContact Card. It follows the same structure as vCard v4 [RFC6350]. Properties and parameters of vCard extension RFCs, including those described in "vCard Format Extension for JSContact" [RFC9554], have been added to the appropriate subsections.
このセクションには、VCardからJScontactカードへの変換ルールが含まれています。VCard V4 [RFC6350]と同じ構造に従います。「jScontactのVCard形式拡張」[RFC9554]に記載されているものを含むVCARD拡張RFCのプロパティとパラメーターが、適切なサブセクションに追加されました。
The UID property (Section 6.7.6 of [RFC6350]) in vCard is optional, but the Card object's uid property (Section 2.1.9 of [RFC9553]) is mandatory. Implementations that convert a vCard without a UID property MUST generate a unique identifier as value for the uid property. This value SHOULD be the same when converting the same vCard multiple times, but how to achieve this is implementation-specific.
VCardのUIDプロパティ（[RFC6350]のセクション6.7.6）はオプションですが、カードオブジェクトのUIDプロパティ（[RFC9553]のセクション2.1.9）は必須です。UIDプロパティなしでVCARDを変換する実装は、UIDプロパティの値として一意の識別子を生成する必要があります。この値は、同じVカードを複数回変換する場合に同じでなければなりませんが、これを達成する方法は実装固有です。
Multivalued properties in JSContact are typically represented as a JSON object where the object keys are of the Id type (Section 1.4.1 of [RFC9553]) and the object values are the converted vCard property. In the absence of the PROP-ID parameter (see Section 2.3.18), implementations are free to choose any identifier as key for such entries. Whatever identifier generation scheme implementations use, they MUST generate values that are valid according to the definition of the Id type in [RFC9553]. For example, this could be an incrementing number across all identifier keys in the Card object or only unique within one JSON object.
JSContactの多面的なプロパティは、通常、オブジェクトキーがIDタイプ（[RFC9553]のセクション1.4.1）であり、オブジェクト値が変換されたVCardプロパティであるJSONオブジェクトとして表されます。Prop-IDパラメーターがない場合（セクション2.3.18を参照）、実装はそのようなエントリのキーとして識別子を自由に選択できます。識別子生成スキームの実装がどのようなものであっても、[RFC9553]のIDタイプの定義に従って有効な値を生成する必要があります。たとえば、これは、カードオブジェクト内のすべての識別子キーにわたって増分数であるか、1つのJSONオブジェクト内でのみ一意である可能性があります。
The BOOLEAN type (Section 4.4 of [RFC6350]) converts to the JSContact Boolean type (Section 1.3.2 of [RFC9553]).
ブールタイプ（[RFC6350]のセクション4.4）は、JScontactブール型（[RFC9553]のセクション1.3.2）に変換されます。
The TIMESTAMP type (Section 4.3.5 of [RFC6350]) converts to the UTCDateTime type (Section 1.4.5 of [RFC9553]), except for anniversaries. For anniversaries, it converts to the Timestamp type (Section 2.8.1 of [RFC9553]).
記念日を除き、タイムスタンプタイプ（[RFC6350]のセクション4.3.5）は、UTCDateTimeタイプ（[RFC9553]のセクション1.4.5）に変換されます。記念日の場合、それはタイムスタンプタイプに変換されます（[RFC9553]のセクション2.8.1）。
The DATE type (Section 4.3.1 of [RFC6350]) converts to a PartialDate object (Section 2.8.1 of [RFC9553]) when used for an anniversary, unless the DATE value only contains a month or a day (but not both).
日付のタイプ（[RFC6350]のセクション4.3.1）は、記念日に使用される場合、日付が1か月または1日しか含まれていない限り（ただし、両方ではない）、記念日に使用する場合（[RFC9553]のセクション2.8.1）に変換されます。。
The following temporal types do not convert to a JSContact datetime type. Instead, vCard properties or parameters having such value types convert as defined in Section 2.15.
次の時間型は、JScontact DateTimeタイプに変換されません。代わりに、セクション2.15で定義されているように、そのような値タイプを変換するVCARDプロパティまたはパラメーター。
* TIME (Section 4.3.2 of [RFC6350])
* 時間（[RFC6350]のセクション4.3.2）
* DATE-TIME (Section 4.3.3 of [RFC6350])
* 日付時間（[RFC6350]のセクション4.3.3）
* DATE-AND-OR-TIME (Section 4.3.4 of [RFC6350])
* 日付と時間（[RFC6350]のセクション4.3.4）
* DATE type values that only define a month or day (but not both)
* 1か月または日のみを定義する日付タイプの値（両方ではありません）
The INTEGER type (Section 4.5 of [RFC6350]) converts to the JSContact Int and UnsignedInt types (Section 1.4.2 of [RFC9553]).
整数型（[RFC6350]のセクション4.5）は、JSContact INTおよびUnsignedInt型（[RFC9553]のセクション1.4.2）に変換されます。
The FLOAT type (Section 4.6 of [RFC6350]) converts to the JSContact Number type (Section 1.3.2 of [RFC9553]).
フロートタイプ（[RFC6350]のセクション4.6）は、jScontact番号タイプ（[RFC9553]のセクション1.3.2）に変換されます。
The LANGUAGE-TAG type (Section 4.8 of [RFC6350]) converts to the JSContact String type (Section 1.3.2 of [RFC9553]). The value MUST be a language tag as defined in [RFC5646].
言語タグタイプ（[RFC6350]のセクション4.8）は、jScontact文字列タイプ（[RFC9553]のセクション1.3.2）に変換されます。値は、[RFC5646]で定義されている言語タグでなければなりません。
The TEXT type (Section 4.1 of [RFC6350]) converts to the JSContact String type (Section 1.3.2 of [RFC9553]).
テキストタイプ（[RFC6350]のセクション4.1）は、jScontact文字列タイプ（[RFC9553]のセクション1.3.2）に変換されます。
The URI type (Section 4.2 of [RFC6350]) converts to the JSContact String type (Section 1.3.2 of [RFC9553]). The value MUST be a URI as defined in Section 3 of [RFC3986]
URIタイプ（[RFC6350]のセクション4.2）は、jScontact文字列型（[RFC9553]のセクション1.3.2）に変換されます。値は、[RFC3986]のセクション3で定義されているURIでなければなりません
The UTC-OFFSET type (Section 4.7 of [RFC6350]) either converts to a String value containing an IANA Time Zone Database entry name (see Section 2.8.2) or does not convert to any JSContact type. For the latter, vCard properties or parameters having such values convert as defined in Section 2.15.
UTCオフセットタイプ（[RFC6350]のセクション4.7）は、IANAタイムゾーンデータベースエントリ名（セクション2.8.2を参照）を含む文字列値に変換するか、JSContactタイプに変換されません。後者の場合、セクション2.15で定義されているような値を変換するVCARDプロパティまたはパラメーター。
This section contains the conversion rules for vCard parameters. A rule typically applies only for specific vCard properties. To convert a vCard parameter on an arbitrary vCard property, see Section 2.15.2.
このセクションには、VCARDパラメーターの変換ルールが含まれています。通常、ルールは特定のVCARDプロパティにのみ適用されます。任意のVCardプロパティでVCardパラメーターを変換するには、セクション2.15.2を参照してください。
The ALTID parameter (Section 5.4 of [RFC6350]) 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 of this, see Section 2.6.1. To preserve the verbatim value of the ALTID parameter, set the JSContact properties defined in Section 2.15.
AltIDパラメーター（[RFC6350]のセクション5.4）はJSContactのIANA登録プロパティに変換されませんが、複数のVCARDプロパティを単一のjScontactオブジェクトインスタンスに組み合わせて、このパラメーターをいくつかの変換ルールで使用します。この例については、セクション2.6.1を参照してください。AltIDパラメーターの逐語的な値を保持するには、セクション2.15で定義されているJSContactプロパティを設定します。
The AUTHOR parameter (Section 4.1 of [RFC9554]) on a NOTE property converts to the Author object's uri property (Section 2.8.3 of [RFC9553]). That Author object is set as the value of the Note object's author property (Section 2.8.3 of [RFC9553]).
メモプロパティの著者パラメーター（[RFC9554]のセクション4.1）は、著者オブジェクトのURIプロパティ（[RFC9553]のセクション2.8.3）に変換されます。その著者オブジェクトは、Noteオブジェクトの著者プロパティの値として設定されています（[RFC9553]のセクション2.8.3）。
The AUTHOR-NAME parameter (Section 4.2 of [RFC9554]) on a NOTE property converts to the Author object's name property (Section 2.8.3 of [RFC9553]). That Author object is set as the value of the Note object's author property.
メモの著者名パラメーター（[RFC9554]のセクション4.2）は、Authorオブジェクトの名前プロパティ（[RFC9553]のセクション2.8.3）に変換されます。その著者オブジェクトは、Note Objectの著者プロパティの値として設定されています。
The CALSCALE parameter (Section 5.8 of [RFC6350]) set on a BDAY, DEATHDATE, or ANNIVERSARY property converts to the PartialDate object's calendarScale property (Section 2.8.1 of [RFC9553]).
bday、deathdate、または記念日のプロパティに設定されたCalスケールパラメーター（[RFC6350]のセクション5.8）は、PartialDateオブジェクトのCalendarScaleプロパティに変換されます（[RFC9553]のセクション2.8.1）。
The CC parameter (Section 3.1 of [RFC8605]) on an ADR property converts to the Address object's countryCode property (Section 2.5.1.1 of [RFC9553]).
ADRプロパティのCCパラメーター（[RFC8605]のセクション3.1）は、アドレスオブジェクトのカントリーコードプロパティ（[RFC9553]のセクション2.5.1.1）に変換されます。
The CREATED parameter (Section 4.3 of [RFC9554]) on a NOTE property converts to the Note object's created property (Section 2.8.3 of [RFC9553]).
Noteプロパティの作成されたパラメーター（[RFC9554]のセクション4.3）は、Noteオブジェクトの作成されたプロパティ（[RFC9553]のセクション2.8.3）に変換されます。
The DERIVED parameter (Section 4.4 of [RFC9554]) does not convert to JSContact. If the DERIVED parameter is set to "true" on a vCard property, then implementations MAY choose not to convert that property.
導出されたパラメーター（[RFC9554]のセクション4.4）はJSContactに変換されません。派生パラメーターがVCardプロパティで「True」に設定されている場合、実装はそのプロパティを変換しないことを選択できます。
The GEO parameter (Section 5.10 of [RFC6350]) set on an ADR property converts to the Address object's coordinates property (Section 2.5.1.1 of [RFC9553]).
ADRプロパティに設定されたGEOパラメーター（[RFC6350]のセクション5.10）は、アドレスオブジェクトの座標プロパティ（[RFC9553]のセクション2.5.1.1）に変換されます。
The GROUP parameter (Section 7.1 of [RFC7095]) does not convert to JSContact. It exclusively is for use in jCard and MUST NOT be set in a vCard.
グループパラメーター（[RFC7095]のセクション7.1）はJScontactに変換されません。それはJCARDでのみ使用するためであり、VCardで設定してはなりません。
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 MAY set the jCard "group" parameter in the JSContact properties vCardProps or vCardParams as defined in Section 2.15.
VCardからJScontactに変換してVCardに戻るときに正確なグループ名を保存する必要はありません。結果のVCARDがプロパティを元のVCARDに等しくグループ化する限り、どのグループ識別子も行います。VCARDプロパティの正確なプロパティグループ名を保持したい実装は、セクション2.15で定義されているように、jScontactプロパティvcardpropsまたはvcardparamsのjcard "グループ"パラメーターを設定する場合があります。
item1.TEL;VALUE=uri:tel:+1-555-555-5555
"phones": {
"p1": {
"number": "tel:+1-555-555-5555",
"vCardParams" : {
"group" : "item1"
}
}
}
Figure 1: Example of How to Preserve the Group Name in vCardParams during Conversion
図1：変換中のvcardparamsのグループ名を保存する方法の例
item2.X-FOO:bar
"vCardProps": [
["x-foo", {
"group": "item2"
}, "unknown", "bar"]
]
Figure 2: Example of How to Preserve the Group Name in vCardProps during Conversion
図2：変換中にvcardPropsでグループ名を保存する方法の例
The INDEX parameter (Section 3.1 of [RFC6715]) set on the EXPERTISE, HOBBY, INTEREST, and ORG-DIRECTORY properties converts to the PersonalInfo (Section 2.8.4 of [RFC9553]) and Directory (Section 2.6.2 of [RFC9553]) objects' listAs property.
インデックスパラメーター（[RFC6715]のセクション3.1）は、専門知識、趣味、関心、および組織ディレクトリプロパティに設定されています。）オブジェクトのリストプロパティ。
The LANGUAGE parameter (Section 5.1 of [RFC6350]) converts to an entry in the Card object's localizations property (Section 2.7.1 of [RFC9553]) for that vCard property on which this parameter is set on. The value of the LANGUAGE parameter defines the language tag key in the localizations property.
言語パラメーター（[RFC6350]のセクション5.1）は、このパラメーターが設定されているVCARDプロパティのカードオブジェクトのローカライズプロパティ（[RFC9553]のセクション2.7.1）のエントリに変換されます。言語パラメーターの値は、ローカリゼーションプロパティの言語タグキーを定義します。
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.
この仕様では、プロパティ値を変換する方法に関する単一の標準変換ルールを定義しません。代わりに、ローカライズ値を構築することは実装固有です。
Two options to populate the localizations property are:
ローカリゼーションプロパティを設定する2つのオプションは次のとおりです。
* One Patch per 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.
* プロパティごとに1つのパッチ：言語パラメーターを備えた各VCardプロパティについて、VCARDプロパティが変換するJSCONTACTプロパティへのパッチオブジェクトの完全なパスを設定します。パッチの値は、変換されたプロパティ値です。これは簡単に処理でき、VCardに言語パラメーターにいくつかのプロパティのみが含まれている場合は適切です。
* 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.
* 親によるバンドルパッチ：PatchObjectに同じ親パスを持つ複数のパスが含まれている場合、これらのパッチを親プロパティにパッチする1つのパッチに結合することが可能かもしれません。これは、カード内のプロパティが完全にパッチされている場合に可能です。
Generally, localizations only localize properties that are present in the non-localized version of this Card. Figure 3 illustrates this.
一般に、ローカライズは、このカードの非局在バージョンに存在するプロパティのみをローカライズします。図3はこれを示しています。
FN;LANGUAGE=EN:John Doe
TITLE;ALTID=1;LANGUAGE=EN:Boss
TITLE;ALTID=1;LANGUAGE=fr:Patron
"language": "en",
"name": {
"full": "John Doe"
},
"titles": {
"t1": {
"name": "Boss"
}
},
"localizations": {
"fr": {
"titles/t1/name": "Patron"
}
}
Figure 3: LANGUAGE Conversion Example: One Dominant Language
図3：言語変換の例：1つの支配的な言語
As a special case, if one or more vCard properties of the same type do not have the LANGUAGE parameter set, add them to the non-localized Card. Convert any with LANGUAGE parameters to the localizations property. Figure 4 illustrates this.
特別なケースとして、同じタイプの1つ以上のVCardプロパティに言語パラメーターセットがない場合は、それらを非局在化カードに追加します。言語パラメーターで任意をローカライズプロパティに変換します。図4はこれを示しています。
FN:John Doe
TITLE;ALTID=1:Boss
TITLE;ALTID=1;LANGUAGE=fr:Patron
"name": {
"full": "John Doe"
},
"titles": {
"t1": {
"name": "Boss"
}
},
"localizations": {
"fr": {
"titles/t1/name": "Patron"
}
}
Figure 4: LANGUAGE Conversion Example: Property without Language
図4：言語変換の例：言語のないプロパティ
The LABEL parameter (Section 6.3.1 of [RFC6350]) on an ADR property converts to the Address object's full property (Section 2.5.1.1 of [RFC9553]).
ADRプロパティのラベルパラメーター（[RFC6350]のセクション6.3.1）は、アドレスオブジェクトの完全プロパティ（[RFC9553]のセクション2.5.1.1）に変換されます。
The LEVEL parameter (Section 3.2 of [RFC6715]) converts to the PersonalInfo object's level property (Section 2.8.4 of [RFC9553]). If this parameter is set on the EXPERTISE property, then its values convert as follows:
レベルパラメーター（[RFC6715]のセクション3.2）は、PersonalInfoオブジェクトのレベルプロパティ（[RFC9553]のセクション2.8.4）に変換されます。このパラメーターがExpertiseプロパティに設定されている場合、その値は次のように変換されます。
* "beginner" converts to "low";
* 「初心者」は「低」に変換されます。
* "average" converts to "medium"; and
* 「平均」は「中程度」に変換します。そして
* "expert" converts to "high".
* 「専門家」は「高」に変換します。
In all other cases, the values convert verbatim, but lowercase MUST be used for the JSContact value.
他のすべての場合、値はVerbatimを変換しますが、小文字はJScontact値に使用する必要があります。
The MEDIATYPE parameter (Section 5.7 of [RFC6350]) converts to the Resource object's mediaType property (Section 1.4.4 of [RFC9553]).
MediATypeパラメーター（[RFC6350]のセクション5.7）は、リソースオブジェクトのMediATypeプロパティ（[RFC9553]のセクション1.4.4）に変換されます。
The PHONETIC parameter (Section 4.6 of [RFC9554]) converts to the Name (Section 2.2.1 of [RFC9553]) and Address (Section 2.5.1 of [RFC9553]) objects' phoneticSystem property unless the parameter value is "script", in which case the phoneticSystem property is not set.
音声パラメーター（[RFC9554]のセクション4.6）は、パラメーター値が「スクリプト」でない限り、名前（[RFC9553]のセクション2.2.1）およびアドレス（[RFC9553]のセクション2.5.1の[RFC9553]のセクション2.5.1）に変換されます。その場合、声材系のプロパティは設定されていません。
The value of the SCRIPT parameter converts to the phoneticScript property (see Section 2.3.19).
スクリプトパラメーターの値は、PhoneticScriptプロパティに変換されます（セクション2.3.19を参照）。
The related N or ADR property is defined by the vCard ALTID parameter. The conversion rules for the N (Section 2.5.5) and ADR (Section 2.6.1) properties define how the vCard components convert to JSContact.
関連するNまたはADRプロパティは、VCard AltIDパラメーターによって定義されます。N（セクション2.5.5）およびADR（セクション2.6.1）プロパティの変換ルールは、VCARDコンポーネントがJSContactに変換する方法を定義します。
The component values of the property on which the PHONETIC parameter is set convert to the respective NameComponent or AddressComponent objects' phonetic properties.
音声パラメーターが設定されているプロパティのコンポーネント値は、それぞれのnameComponentまたはaddressComponentオブジェクトの音声特性に変換されます。
If more than one property has the PHONETIC parameter set and relates to the same property, then they convert to the Card object's localizations property according to their LANGUAGE parameter values as outlined in Section 2.3.11.
複数のプロパティに音声パラメーターセットがあり、同じプロパティに関連する場合、セクション2.3.11で概説した言語パラメーター値に従って、カードオブジェクトのローカライズプロパティに変換されます。
LANGUAGE=zh-Hant
N;ALTID=1;LANGUAGE=zh-Hant:孫;中山;文,逸仙;;
N;ALTID=1;PHONETIC=jyut;
SCRIPT=Latn;LANGUAGE=yue:syun1;zung1saan1;man4,jat6sin1;;
"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"
}
}
Figure 5: PHONETIC Conversion Example
図5：音声変換の例
The PID parameter (Section 5.5 of [RFC6350]) converts to the vCardParams property; see Section 2.15.2.
PIDパラメーター（[RFC6350]のセクション5.5）は、VCardParamsプロパティに変換されます。セクション2.15.2を参照してください。
The PREF parameter (Section 5.3 of [RFC6350]) converts to the pref property of the derived JSContact object.
[RFC6350]のセクション5.3）は、派生jScontactオブジェクトのprefプロパティに変換されます。
The PROP-ID parameter (Section 4.7 of [RFC9554]) converts to the Id-typed key of the derived JSContact object.
prop-idパラメーター（[rfc9554]のセクション4.7）は、派生したjScontactオブジェクトのID型キーに変換されます。
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
"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"
}
}
Figure 6: PROP-ID Conversion Example
図6：Prop-ID変換の例
The SCRIPT parameter (Section 4.8 of [RFC9554]) converts to the Name (Section 2.2.1 of [RFC9553]) or Address (Section 2.5.1 of [RFC9553]) objects' phoneticScript property.
スクリプトパラメーター（[RFC9554]のセクション4.8）は、名前（[RFC9553]のセクション2.2.1）またはアドレス（[RFC9553]のセクション2.5.1）オブジェクトのPhoneticScriptプロパティに変換されます。
Also see Section 2.3.15.
セクション2.3.15も参照してください。
The SERVICE-TYPE parameter (Section 4.9 of [RFC9554]) converts to the OnlineService object's service property (Section 2.3.2 of [RFC9553]).
[RFC9554]のセクション4.9）は、onlineserviceオブジェクトのサービスプロパティ（[RFC9553]のセクション2.3.2）に変換されます。
The SORT-AS parameter (Section 5.9 of [RFC6350]) converts to the Name, Organization, and OrgUnit objects' sortAs properties.
[RFC6350]のセクション5.9）は、名前、組織、およびOrgunitオブジェクトのSORTASプロパティに変換されます。
The TYPE parameter (Section 5.6 of [RFC6350]) converts to either the contexts property or the kind property, as defined in later sections. If not otherwise specified, the vCard "home" and "work" parameter values convert to the JSContact "private" and "work" contexts, respectively.
[RFC6350]のタイプパラメーター（セクション5.6）は、後のセクションで定義されているように、コンテキストプロパティまたはKindプロパティのいずれかに変換されます。特に指定されていない場合、VCardの「ホーム」と「ワーク」パラメーター値は、それぞれjScontact「プライベート」と「作業」コンテキストに変換されます。
The TZ parameter (Section 5.11 of [RFC6350]) on an ADR property converts to the Address object's timeZone property (Section 2.5.1.1 of [RFC9553]). Also see the conversion of the TZ property in Section 2.8.2.
ADRプロパティのTZパラメーター（[RFC6350]のセクション5.11）は、アドレスオブジェクトのタイムゾーンプロパティ（[RFC9553]のセクション2.5.1.1）に変換されます。セクション2.8.2のTZプロパティの変換も参照してください。
The USERNAME parameter (Section 4.10 of [RFC9554]) converts to the OnlineService object's user property (Section 2.3.2 of [RFC9553]).
ユーザー名パラメーター（[RFC9554]のセクション4.10）は、オンラインサービスオブジェクトのユーザープロパティ（[RFC9553]のセクション2.3.2）に変換されます。
The VALUE parameter (Section 5.2 of [RFC6350]) does not convert to an IANA-registered property in JSContact. To preserve properties with experimental values, see Sections 2.15.1 and 2.15.2.
値パラメーター（[RFC6350]のセクション5.2）は、JScontactのIANA登録プロパティに変換されません。実験値でプロパティを保持するには、セクション2.15.1および2.15.2を参照してください。
The BEGIN and END properties do not convert to IANA-registered properties in JSContact.
開始プロパティとエンドプロパティは、JSContactのIANA登録プロパティに変換されません。
The KIND property (Section 6.1.4 of [RFC6350]) converts to the kind property (Figure 7). Allowed values are those described in Section 6.1.4 of [RFC6350] and extended with the values declared in [RFC6473] and [RFC6869].
親切なプロパティ（[RFC6350]のセクション6.1.4）は、種類のプロパティに変換されます（図7）。許可された値は、[RFC6350]のセクション6.1.4で説明されており、[RFC6473]および[RFC6869]で宣言された値で拡張された値です。
KIND:individual
"kind": "individual"
Figure 7: KIND Conversion Example
図7：親切な変換の例
The SOURCE property (Section 6.1.3 of [RFC6350]) converts to a Directory object (Section 2.6.2 of [RFC9553]) in the Card object's directories property (Figure 8). The Directory object's kind property is set to "entry". The uri property is set to the SOURCE property value.
ソースプロパティ（[RFC6350]のセクション6.1.3）は、カードオブジェクトのディレクトリプロパティ（図8）のディレクトリオブジェクト（[RFC9553]のセクション2.6.2）に変換されます。ディレクトリオブジェクトの親切なプロパティは、「エントリ」に設定されています。URIプロパティは、ソースプロパティ値に設定されています。
The PREF and MEDIATYPE parameters convert according to the rules defined in Section 2.3.
PrefおよびMediatypeパラメーターは、セクション2.3で定義されているルールに従って変換されます。
SOURCE:https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf
"directories": {
"ENTRY-1": {
"kind": "entry",
"uri": "https://dir.example.com/addrbook/jdoe/Jean%20Dupont.vcf"
}
}
Figure 8: SOURCE Conversion Example
図8：ソース変換の例
The XML property (Section 6.1.5 of [RFC6350]) converts to the vCardProps property; see Section 2.15.1.
XMLプロパティ（[RFC6350]のセクション6.1.5）は、VCardPropsプロパティに変換されます。セクション2.15.1を参照してください。
The following properties all convert to Anniversary objects in the Card object's anniversaries property (Figure 9):
次のプロパティはすべて、カードオブジェクトの記念日プロパティの記念日オブジェクトに変換されます（図9）
* ANNIVERSARY (Section 6.2.6 of [RFC6350])
* 記念日（[RFC6350]のセクション6.2.6）
* BDAY (Section 6.2.5 of [RFC6350])
* bday（[RFC6350]のセクション6.2.5）
* BIRTHPLACE (Section 2.1 of [RFC6474])
* 生家（[RFC6474]のセクション2.1）
* DEATHDATE (Section 2.3 of [RFC6474])
* Deathdate（[RFC6474]のセクション2.3）
* DEATHPLACE (Section 2.2 of [RFC6474])
* Deathplace（[RFC6474]のセクション2.2）
BDAY and BIRTHPLACE convert to an Anniversary object (Section 2.8.1 of [RFC9553]) having the date and place properties set. The kind property is set to "birth".
誕生日と生まれた場所は、日付と場所のプロパティが設定されている記念日オブジェクト（[RFC9553]のセクション2.8.1）に変換されます。親切なプロパティは「誕生」に設定されています。
DEATHDATE and DEATHPLACE convert to an Anniversary object having the date and place properties set. The Anniversary object's kind property is set to "death".
死日と死の場所は、日付と場所のプロパティが設定された記念日オブジェクトに変換されます。アニバーサリーオブジェクトの親切なプロパティは、「死」に設定されています。
ANNIVERSARY converts to the Anniversary object's date property. The Anniversary object's kind property is set to "wedding".
記念日は、記念日オブジェクトの日付プロパティに変換されます。アニバーサリーオブジェクトの親切なプロパティは、「結婚式」に設定されています。
If the BIRTHPLACE or DEATHPLACE property value is of type URI using the "geo:" URI scheme, then it converts to the Address object's coordinates property. If the value type is TEXT, then it converts to the Address object's full property. Otherwise, it converts to the vCardProps property; see Section 2.15.1.
生まれた場所またはデスプレイスのプロパティ値が「GEO：」を使用してURIのタイプである場合、アドレスオブジェクトの座標プロパティに変換されます。値タイプがテキストの場合、アドレスオブジェクトの完全プロパティに変換されます。それ以外の場合は、VCardPropsプロパティに変換します。セクション2.15.1を参照してください。
The ALTID and LANGUAGE parameters of both the BIRTHPLACE and DEATHPLACE properties convert according to the rules defined in Section 2.3.
発祥の地とデスプレイスの両方のプロパティのAltIDおよび言語パラメーターは、セクション2.3で定義されているルールに従って変換されます。
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
"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
}
}
}
Figure 9: ANNIVERSARY, BDAY, BIRTHPLACE, DEATHDATE, and DEATHPLACE Conversion Example
図9：記念日、生年月日、生年月日、死亡日、死の場所の変換の例
The FN property (Section 6.2.1 of [RFC6350]) converts to the Name object's full property (Figure 10). If the LANGUAGE parameter is set, then the FN property converts as outlined in Section 2.3.11. In the unexpected case where the vCard contains more than one FN property without the LANGUAGE parameter, convert the FN property that has the least parameters. If multiple such FN properties are present, choose any of them. All other FN properties convert to the vCardProps (Section 2.15.1) property.
FNプロパティ（[RFC6350]のセクション6.2.1）は、名前オブジェクトの完全プロパティに変換されます（図10）。言語パラメーターが設定されている場合、FNプロパティはセクション2.3.11で概説されているように変換されます。VCARDに言語パラメーターのない複数のFNプロパティが含まれている予期しない場合、パラメーターが最も少ないFNプロパティを変換します。複数のそのようなFNプロパティが存在する場合は、それらのいずれかを選択してください。他のすべてのFNプロパティは、VCardProps（セクション2.15.1）プロパティに変換されます。
FN:John Q. Public, Esq.
"name": {
"full": "John Q. Public, Esq."
}
Figure 10: FN Conversion Example
図10：FN変換の例
The GENDER property (Section 6.2.7 of [RFC6350]) does not convert to an IANA-registered property in JSContact. To convert this property, see Section 2.15.1. Alternatively, the Card object's speakToAs property defines how to address and refer to an individual represented by the Card, as do the newly defined vCard GRAMGENDER and PRONOUNS properties of [RFC9554].
ジェンダープロパティ（[RFC6350]のセクション6.2.7）は、JScontactのIANA登録プロパティに変換されません。このプロパティを変換するには、セクション2.15.1を参照してください。あるいは、カードオブジェクトのSpeakToASプロパティは、[RFC9554]の新しく定義されたVCARDグラミンダーと代名詞プロパティと同様に、カードで表される個人に対処して参照する方法を定義します。
The GRAMGENDER property (Section 3.2 of [RFC9554]) converts to the SpeakToAs object's grammaticalGender property (Figure 11).
Gramgenderプロパティ（[RFC9554]のセクション3.2）は、SpeakToas ObjectのGrammaticalGenderプロパティに変換されます（図11）。
The PRONOUNS property (Section 3.4 of [RFC9554]) converts to the SpeakToAs object's pronouns property (Figure 11).
代名詞プロパティ（[RFC9554]のセクション3.4）は、SpeakToASオブジェクトの代名詞プロパティに変換されます（図11）。
GRAMGENDER:NEUTER
PRONOUNS;PREF=2:they/them
PRONOUNS;PREF=1:xe/xir
"speakToAs": {
"grammaticalGender": "neuter",
"pronouns": {
"PRONOUNS-1": {
"pronouns": "they/them",
"pref": 2
},
"PRONOUNS-2": {
"pronouns": "xe/xir",
"pref": 1
}
}
}
Figure 11: GRAMGENDER and PRONOUNS Conversion Example
図11：グラムジェンダーと代名詞変換の例
The N property (Section 6.2.2 of [RFC6350]) converts to a Name object (Section 2.2.1 of [RFC9553]) in the Card object's name property. Each component in the N property structured value converts to a NameComponent in the Name object's components property. The following table shows this relation:
Nプロパティ（[RFC6350]のセクション6.2.2）は、カードオブジェクトの名前プロパティの名前オブジェクト（[RFC9553]のセクション2.2.1）に変換されます。nプロパティの各コンポーネントは、名前オブジェクトのコンポーネントプロパティのnamecomponentに変換されます。次の表は、この関係を示しています。
+============+===============+==============================+
| N | NameComponent | Remarks |
| component | kind | |
+============+===============+==============================+
| Family | surname | To vCard: add any "surname2" |
| name | | NameComponent to the Family |
| | | name component, after all |
| | | "surname" values. |
| | | From vCard: ignore any value |
| | | that also occurs in the |
| | | Secondary surname component. |
+------------+---------------+------------------------------+
| Given name | given | |
+------------+---------------+------------------------------+
| Additional | given2 | |
| name | | |
+------------+---------------+------------------------------+
| Honorific | title | |
| prefix | | |
+------------+---------------+------------------------------+
| Honorific | credential | To vCard: add any |
| suffix | | "generation" NameComponent |
| | | to the Honorific suffix |
| | | component. |
| | | From vCard: ignore any value |
| | | that also occurs in the |
| | | Generation component. |
+------------+---------------+------------------------------+
| Secondary | surname2 | |
| surname | | |
+------------+---------------+------------------------------+
| Generation | generation | |
+------------+---------------+------------------------------+
Table 1: N Components Conversion
表1：Nコンポーネント変換
If the JSCOMPS (Section 3.3.1) parameter is set, then the Name object's isOrdered property value is "true", and the defaultSeparator property and any "separator" NameComponent objects are set according to the parameter value. The order in the components property MUST adhere to the order of the JSCOMPS parameter value.
jscomps（セクション3.3.1）パラメーターが設定されている場合、名前オブジェクトのisorderedプロパティ値は「true」であり、デフォルトセパレータープロパティと「セパレーター」のnamecomponentオブジェクトはパラメーター値に従って設定されます。コンポーネントプロパティの順序は、JSCOMPSパラメーター値の順序に準拠する必要があります。
If the JSCOMPS parameter is not set, then the Name object's isOrdered property value is "false", and the defaultSeparator property MUST NOT be set. The order in the components property MUST follow the order of values in the N structured value when read from left to right.
JSCOMPSパラメーターが設定されていない場合、Name ObjectのISORDEREDプロパティ値は「false」であり、DefaultSeparatorプロパティを設定してはなりません。コンポーネントプロパティの順序は、左から右に読み取られた場合、n構造された値の値の順序に従う必要があります。
If the SORT-AS parameter is set, then its structured value converts to the Name object's sortAs property according to Table 1. An empty or non-existent component value indicates that no sort is defined for this kind.
Sort-asパラメーターが設定されている場合、その構造化された値は、表1に従って名前オブジェクトのsortasプロパティに変換されます。
N;SORT-AS="Stevenson,John Philip":
Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.;;Jr.
"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"
}
}
Figure 12: N Conversion Example
図12：N変換の例
See Section 3.3.1 for examples of using the JSCOMPS parameter for vCard-structured property values.
VCARD構造のプロパティ値にJSCOMPSパラメーターを使用した例については、セクション3.3.1を参照してください。
The NICKNAME property (Section 6.2.3 of [RFC6350]) converts to a Nickname object (Section 2.2.2 of [RFC9553]) in the Card object's nicknames property (Figure 13). The name property is set to the NICKNAME property value.
ニックネームプロパティ（[RFC6350]のセクション6.2.3）は、カードオブジェクトのニックネームプロパティのニックネームオブジェクト（[RFC9553]のセクション2.2.2）に変換されます（図13）。名前プロパティは、ニックネームプロパティ値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
NICKNAME:Johnny
"nicknames": {
"NICK-1": {
"name": "Johnny"
}
}
Figure 13: NICKNAME Conversion Example
図13：ニックネーム変換の例
The PHOTO property (Section 6.2.4 of [RFC6350]) converts to a Media object (Section 2.6.4 of [RFC9553]) in the Card object's media property (Figure 14). The Media object's kind property is set to "photo" and the uri property is set to the PHOTO value.
写真プロパティ（[RFC6350]のセクション6.2.4）は、カードオブジェクトのメディアプロパティ（図14）のメディアオブジェクト（[RFC9553]のセクション2.6.4）に変換されます。メディアオブジェクトの親切なプロパティは「写真」に設定されており、URIプロパティは写真値に設定されています。
The PREF and MEDIATYPE parameters convert according to the rules defined in Section 2.3.
PrefおよびMediatypeパラメーターは、セクション2.3で定義されているルールに従って変換されます。
PHOTO:https://www.example.com/pub/photos/jqpublic.gif
"media": {
"PHOTO-1": {
"kind": "photo",
"uri": "https://www.example.com/pub/photos/jqpublic.gif"
}
}
Figure 14: PHOTO Conversion Example
図14：写真変換の例
The ADR property (Section 6.3.1 of [RFC6350]) converts to an Address object (Section 2.5.1.1 of [RFC9553]) in the Card object's addresses property. Each component in the ADR-structured property value converts to an AddressComponent in the Address object's components property.
カードオブジェクトのアドレスプロパティのADRプロパティ（[RFC6350]のセクション6.3.1）は、アドレスオブジェクト（[RFC9553]のセクション2.5.1.1）に変換されます。ADR構造化されたプロパティ値の各コンポーネントは、アドレスオブジェクトのコンポーネントプロパティのアドレスコンポーネントに変換されます。
[RFC9554] defines new components for the ADR property. Implementations SHOULD set these new components, even if all their values are the empty string.
[RFC9554] ADRプロパティの新しいコンポーネントを定義します。実装は、すべての値が空の文字列であっても、これらの新しいコンポーネントを設定する必要があります。
The following table shows how the ADR component and AddressComponent kind relate:
次の表は、ADRコンポーネントとアドレスコンポーネントの種類がどのように関連するかを示しています。
+=============+==================+===============================+
| ADR | AddressComponent | Remarks |
| component | kind | |
+=============+==================+===============================+
| post office | postOfficeBox | [RFC6350] recommends that |
| box | | this component not be set, |
| | | but this is now disputable |
| | | given the new components. |
| | | Instead, set this component |
| | | and use the new ADR value |
| | | format defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| extended | apartment | To vCard: set the values of |
| address | | the following components: |
| | | |
| | | * room |
| | | |
| | | * floor |
| | | |
| | | * apartment |
| | | |
| | | * building |
| | | |
| | | From vCard: ignore if the ADR |
| | | structured value is of the |
| | | format defined in [RFC9554]. |
| | | Otherwise, convert to |
| | | "apartment". |
+-------------+------------------+-------------------------------+
| street | name | To vCard: set the values of |
| address | | the following components: |
| | | |
| | | * number |
| | | |
| | | * name |
| | | |
| | | * block |
| | | |
| | | * direction |
| | | |
| | | * landmark |
| | | |
| | | * subdistrict |
| | | |
| | | * district |
| | | |
| | | From vCard: ignore if the ADR |
| | | structured value is of the |
| | | format defined in [RFC9554]. |
| | | Otherwise, convert to "name". |
+-------------+------------------+-------------------------------+
| locality | locality | |
+-------------+------------------+-------------------------------+
| region | region | |
+-------------+------------------+-------------------------------+
| postal code | postcode | |
+-------------+------------------+-------------------------------+
| apartment | apartment | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| block | block | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| building | building | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| direction | direction | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| district | district | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| floor | floor | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| landmark | landmark | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| room | room | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
| street | number | Defined in [RFC9554]. |
| number | | |
+-------------+------------------+-------------------------------+
| subdistrict | subdistrict | Defined in [RFC9554]. |
+-------------+------------------+-------------------------------+
Table 2: ADR Components Conversion
表2：ADRコンポーネント変換
If the JSCOMPS (Section 3.3.1) parameter is set, then the Address object's isOrdered property value is "true", and the defaultSeparator property and any separator name components are set according to the parameter value. The order in the components property MUST adhere to the order of the JSCOMPS parameter value.
jscomps（セクション3.3.1）パラメーターが設定されている場合、アドレスオブジェクトのisorderedプロパティ値は「true」であり、デフォルトセパレータープロパティとセパレーター名コンポーネントはパラメーター値に従って設定されます。コンポーネントプロパティの順序は、JSCOMPSパラメーター値の順序に準拠する必要があります。
If the JSCOMPS parameter is not set, then the Address object's isOrdered property value is "false", and the defaultSeparator property MUST NOT be set. The order in the components property MUST follow the order of values in the ADR structured value when read from left to right.
JSCOMPSパラメーターが設定されていない場合、アドレスオブジェクトのISORDEREDプロパティ値は「false」であり、DefaultSeparatorプロパティを設定してはなりません。コンポーネントプロパティの順序は、左から右に読み取ると、ADR構造値の値の順序に従う必要があります。
The LABEL parameter converts to the Address object's full property.
ラベルパラメーターは、アドレスオブジェクトの完全プロパティに変換されます。
The GEO parameter converts to the Address object's coordinates property.
GEOパラメーターは、アドレスオブジェクトの座標プロパティに変換されます。
The TZ parameter converts to the Address object's timeZone property.
TZパラメーターは、アドレスオブジェクトのTimeZoneプロパティに変換されます。
The CC parameter converts to the Address object's countryCode property.
CCパラメーターは、アドレスオブジェクトのカントリーコードプロパティに変換されます。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3. The ADR-specific values of the TYPE parameter defined in Sections 5.1 and 5.2 of [RFC9554] convert to the corresponding entries of the contexts property as defined in Section 2.5.1 of [RFC9553].
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。[RFC9554]のセクション5.1および5.2で定義されている型パラメーターのADR固有の値は、[RFC9553]のセクション2.5.1で定義されているように、コンテキストプロパティの対応するエントリに変換されます。
The ALTID and LANGUAGE parameters convert according to the rules defined in Section 2.3. Each possible language-dependent alternative converts to an entry of the PatchObject where the key references the full property.
AltIDおよび言語パラメーターは、セクション2.3で定義されているルールに従って変換されます。可能な各言語依存の代替代替は、キーが完全なプロパティを参照するPatchObjectのエントリに変換します。
ADR;TYPE=work;CC=US:
;;54321 Oak St;Reston;VA;20190;USA;;;;54321;Oak St;;;;;;
"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"
}
}
Figure 15: ADR Conversion Example
図15：ADR変換の例
See Section 3.3.1 for examples of using the JSCOMPS parameter for vCard-structured property values.
VCARD構造のプロパティ値にJSCOMPSパラメーターを使用した例については、セクション3.3.1を参照してください。
The EMAIL property (Section 6.4.2 of [RFC6350]) converts to an EmailAddress object (Section 2.3.1 of [RFC9553]) in the Card object's emails property (Figure 16). The EmailAddress object's address property is set to the EMAIL value.
電子メールプロパティ（[RFC6350]のセクション6.4.2）は、カードオブジェクトの電子メールプロパティ（図16）の電子メールアドレスオブジェクト（[RFC9553]のセクション2.3.1）に変換されます。emailAddressオブジェクトのアドレスプロパティは、電子メール値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
EMAIL;TYPE=work:jqpublic@xyz.example.com
EMAIL;PREF=1:jane_doe@example.com
"emails": {
"EMAIL-1": {
"contexts": { "work": true },
"address": "jqpublic@xyz.example.com"
},
"EMAIL-2": {
"address": "jane_doe@example.com",
"pref": 1
}
}
Figure 16: EMAIL Conversion Example
図16：電子メール変換の例
The IMPP property (Section 6.4.3 of [RFC6350]) converts to an OnlineService object (Section 2.3.2 of [RFC9553]) in the Card object's onlineServices property (Figure 17). The vCardName property is set to "impp", and the uri property is set to the IMPP value.
IMPPプロパティ（[RFC6350]のセクション6.4.3）は、カードオブジェクトのオンラインサービスプロパティのオンラインサービスオブジェクト（[RFC9553]のセクション2.3.2）に変換されます（図17）。VCardNameプロパティは「IMPP」に設定されており、URIプロパティはIMPP値に設定されています。
The SERVICE-TYPE, USERNAME, PREF, and TYPE parameters convert according to the rules defined in Section 2.3.
セクション2.3で定義されているルールに従って、サービスタイプ、ユーザー名、プリフ、およびタイプパラメーターは変換されます。
IMPP;PREF=1:xmpp:alice@example.com
"onlineServices": {
"OS-1": {
"uri": "xmpp:alice@example.com",
"pref": 1,
"vCardName": "impp"
}
}
Figure 17: IMPP Conversion Example
図17：IMPP変換の例
The LANG property (Section 6.4.4 of [RFC6350]) converts to a LanguagePref object (Section 2.3.4 of [RFC9553]) in the Card object's preferredLanguages property (Figure 18). The LANG property value converts to the LanguagePref object's language property value.
ラングプロパティ（[RFC6350]のセクション6.4.4）は、カードオブジェクトの優先言語プロパティのLanguagePrefオブジェクト（[RFC9553]のセクション2.3.4）に変換されます（図18）。Langプロパティ値は、LanguagePrefオブジェクトの言語プロパティ値に変換されます。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
LANG;TYPE=work;PREF=1:en
LANG;TYPE=work;PREF=2:fr
LANG;TYPE=home:fr
"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 }
}
}
Figure 18: LANG Conversion Example
図18：ラング変換の例
The LANGUAGE property (Section 3.3 of [RFC9554]) converts to the Card object's language property (Figure 19).
言語プロパティ（[RFC9554]のセクション3.3）は、カードオブジェクトの言語プロパティに変換されます（図19）。
LANGUAGE:de-AT
"language": "de-AT"
Figure 19: LANGUAGE Conversion Example
図19：言語変換の例
The SOCIALPROFILE property (Section 3.5 of [RFC9554]) converts to an OnlineService object (Section 2.3.2 of [RFC9553]) in the Card object's onlineServices property (Figure 20). The vCardName property is set to "socialprofile", or it can be omitted. If the SOCIALPROFILE property value is of type URI, then the OnlineService object's uri property is set; otherwise, the user property is set.
ソーシャルプロファイルプロパティ（[RFC9554]のセクション3.5）は、カードオブジェクトのオンラインサービスプロパティのオンラインサービスオブジェクト（[RFC9553]のセクション2.3.2）に変換されます（図20）。VCardNameプロパティは「SocialProfile」に設定されているか、省略できます。SocialProfileプロパティ値がタイプURIの場合、OnLineserviceオブジェクトのURIプロパティが設定されます。それ以外の場合、ユーザープロパティが設定されています。
The SERVICE-TYPE, USERNAME, PREF, and TYPE parameters convert according to the rules defined in Section 2.3.
セクション2.3で定義されているルールに従って、サービスタイプ、ユーザー名、プリフ、およびタイプパラメーターは変換されます。
SOCIALPROFILE;SERVICE-TYPE=Mastodon:https://example.com/@foo
"onlineServices": {
...
"OS-1": {
"service": "Mastodon",
"uri": "https://example.com/@foo"
}
}
Figure 20: SOCIALPROFILE Conversion Example
図20：ソーシャルプロファイル変換の例
The TEL property (Section 6.4.1 of [RFC6350]) converts to a Phone object (Section 2.3.3 of [RFC9553]) in the Card object's phones property (Figure 21).
TELプロパティ（[RFC6350]のセクション6.4.1）は、カードオブジェクトの電話プロパティ（図21）の電話オブジェクト（[RFC9553]のセクション2.3.3）に変換されます。
The TEL-specific values of the TYPE parameter convert to the features property keys as outlined in Table 3. Note that Section 6.4.1 of [RFC6350] defines the default type to be "voice", but the default Phone features property is absent by default. Accordingly, an implementation SHOULD only set the Phone object's features property if the TEL property actually has a TEL-specific TYPE parameter set.
TypeパラメーターのTEL固有の値は、表3に概説されている機能プロパティキーに変換します[RFC6350]のセクション6.4.1は、デフォルトのタイプを「音声」と定義していることに注意してください。デフォルト。したがって、Telプロパティに実際にTel固有のタイプパラメーターセットがある場合にのみ、実装は電話オブジェクトの機能プロパティを設定する必要があります。
+=============+===============+
| TYPE value | Phone feature |
+=============+===============+
| cell | mobile |
+-------------+---------------+
| fax | fax |
+-------------+---------------+
| main-number | main-number |
+-------------+---------------+
| pager | pager |
+-------------+---------------+
| text | text |
+-------------+---------------+
| textphone | textphone |
+-------------+---------------+
| video | video |
+-------------+---------------+
| voice | voice |
+-------------+---------------+
Table 3: TEL TYPE Conversion
表3：電話型変換
The value of the TEL property converts to the Phone object's number property.
Telプロパティの値は、電話オブジェクトの番号プロパティに変換されます。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
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
"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"
}
}
Figure 21: TEL Conversion Example
図21：電話変換の例
The GEO property (Section 6.5.2 of [RFC6350]) converts to the Address object's coordinates property (Section 2.5.1 of [RFC9553]). Also see Section 2.8.3 to determine which Address object instance to convert to.
[RFC6350]のGEOプロパティ（セクション6.5.2）は、アドレスオブジェクトの座標プロパティ（[RFC9553]のセクション2.5.1）に変換されます。また、セクション2.8.3を参照して、変換するアドレスオブジェクトインスタンスを決定します。
The TZ property (Section 6.5.1 of [RFC6350]) converts an Address object (Section 2.5.1 of [RFC9553]) in the Card object's addresses property.
TZプロパティ（[RFC6350]のセクション6.5.1）は、カードオブジェクトのアドレスプロパティのアドレスオブジェクト（[RFC9553]のセクション2.5.1）を変換します。
A value of type TEXT converts to the Address object's timeZone property.
タイプのテキストの値は、アドレスオブジェクトのTimeZoneプロパティに変換されます。
A value of type UTC-OFFSET converts to the Address object's timeZone property if the offset has zero minutes and the hour offset is between -12 and +14, both inclusively. Note that:
タイプのUTCオフセットの値は、オフセットにゼロ分があり、時間オフセットが両方とも包括的に-12〜 +14の場合、アドレスオブジェクトのタイムゾーンプロパティに変換されます。ご了承ください：
* If the hour offset is zero, use the time zone name "Etc/UTC".
* 時間オフセットがゼロの場合は、タイムゾーン名「など」を使用します。
* Otherwise, construct the time zone name with "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 "-0500" converts to "Etc/GMT+5".
* それ以外の場合は、「ETC/GMT」でタイムゾーン名を構築し、サインを含むが、主要なゼロと議事録を除く、反転したサインアワーオフセットの文字列表現で接尾辞を付けます。たとえば、UTCオフセット値「-0500」は「/GMT+5」に変換されます。
For such property values, also see Section 2.8.3 to determine which Address object instance to convert to.
このようなプロパティ値については、セクション2.8.3も参照して、変換するオブジェクトインスタンスを決定します。
Any other value of type UTC-OFFSET or URI does not convert to an IANA-registered property in JSContact. To convert such property, see Section 2.15.1.
タイプのUTCオフセットまたはURIのその他の値は、JSContactのIANA登録プロパティに変換されません。そのようなプロパティを変換するには、セクション2.15.1を参照してください。
In vCard, the properties ADR, GEO, and TZ occur independently of each other. In JSContact, they all convert to properties of an Address object. It is implementation-specific if these vCard properties convert to _separate_ address instances in JSContact or if some or all of them convert to the _same_ address. That being said, implementations MUST convert the properties to the _same_ address for the following cases:
VCardでは、プロパティADR、GEO、およびTZが互いに独立して発生します。JScontactでは、すべてアドレスオブジェクトのプロパティに変換されます。これらのVCardプロパティがJScontactの_Separate_アドレスインスタンスに変換される場合、またはそれらの一部またはすべてが_Same_アドレスに変換された場合、実装固有です。そうは言っても、実装は次の場合のプロパティを_Same_アドレスに変換する必要があります。
* The GROUP parameter values of the properties match.
* プロパティのグループパラメーター値は一致します。
* The GROUP parameters are not set, but they are set on any other ADR, GEO, and TZ properties.
* グループパラメーターは設定されていませんが、他のADR、GEO、およびTZプロパティに設定されています。
The CONTACT-URI property (Section 2.1 of [RFC8605]) converts to a Link object (Section 2.6.3 of [RFC9553]) in the Card object's links property (Figure 22). The Link object's kind property is set to "contact" and the uri property is set to the CONTACT-URI property value.
CARDオブジェクトのリンクプロパティ（図22）のContact-URIプロパティ（[RFC8605]のセクション2.1）は、リンクオブジェクト（[RFC9553]のセクション2.6.3）に変換されます。Link ObjectのKindプロパティは「連絡先」に設定されており、URIプロパティはContact-URIプロパティ値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
CONTACT-URI;PREF=1:mailto:contact@example.com
"links": {
"CONTACT-1": {
"kind": "contact",
"uri": "mailto:contact@example.com",
"pref": 1
}
}
Figure 22: CONTACT-URI Conversion Example
図22：Contact-URI変換の例
The LOGO property (Section 6.6.3 of [RFC6350]) converts to a Media object (Section 2.6.4 of [RFC9553]) in the Card object's media property (Figure 23). The Media object's kind property is set to "logo" and the uri property is set to the LOGO property value.
カードオブジェクトのメディアプロパティ（図23）のロゴプロパティ（[RFC6350]のセクション6.6.3）は、メディアオブジェクト（[RFC9553]のセクション2.6.4）に変換されます。メディアオブジェクトの親切なプロパティは「ロゴ」に設定されており、URIプロパティはロゴプロパティ値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
LOGO:https://www.example.com/pub/logos/abccorp.jpg
"media": {
"LOGO-1": {
"kind": "logo",
"uri": "https://www.example.com/pub/logos/abccorp.jpg"
}
}
Figure 23: LOGO Conversion Example
図23：ロゴ変換の例
The MEMBER property (Section 6.6.5 of [RFC6350]) converts to the Card object's members property (Figure 24). Each MEMBER property value is a key in the members property. The PREF parameter (Section 5.3 of [RFC6350]) does not convert to JSContact.
メンバープロパティ（[RFC6350]のセクション6.6.5）は、カードオブジェクトのメンバープロパティに変換されます（図24）。各メンバープロパティ値は、メンバープロパティのキーです。prefパラメーター（[RFC6350]のセクション5.3）はJSContactに変換されません。
KIND:group
FN:The Doe family
MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
MEMBER:urn:uuid:b8767877-b4a1-4c70-9acc-505d3819e519
"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
}
Figure 24: Group Example
図24：グループの例
The ORG property (Section 6.6.4 of [RFC6350]) converts to an Organization object (Section 2.2.3 of [RFC9553]) in the Card object's organizations property (Figure 25). The Organization object's name property is set to the ORG property organizational name component. The Organization object's units property is an array of OrgUnit objects that each contain an organizational unit name component value of the ORG property value.
[RFC6350]のORGプロパティ（セクション6.6.4）は、カードオブジェクトの組織プロパティ（図25）の組織オブジェクト（[RFC9553]のセクション2.2.3）に変換されます。組織オブジェクトの名前プロパティは、ORGプロパティ組織名コンポーネントに設定されています。組織オブジェクトのユニットプロパティは、それぞれに組織ユニット名コンポーネント値がORGプロパティ値の値を含むORGUNITオブジェクトの配列です。
Implementations MAY allow representation of organizational units without the organizational name. In this case, the first component of the ORG value MUST be an empty string (e.g., ORG:;DepartmentA).
実装により、組織名なしで組織ユニットの表現が可能になる場合があります。この場合、ORG値の最初のコンポーネントは空の文字列（例：org：; departmenta）でなければなりません。
The ALTID and LANGUAGE parameters convert according to the rules defined in Section 2.3.
AltIDおよび言語パラメーターは、セクション2.3で定義されているルールに従って変換されます。
The first item of the comma-separated SORT-AS parameter value converts to the sortAs property of the Organization object. The subsequent items convert to the sortAs property of the corresponding OrgUnit object.
Comma分離されたSort-asパラメーター値の最初の項目は、組織オブジェクトのSORTASプロパティに変換されます。後続のアイテムは、対応する組織オブジェクトのSORTASプロパティに変換されます。
The TYPE parameter converts according to the rules defined in Section 2.3.
タイプパラメーターは、セクション2.3で定義されているルールに従って変換します。
ORG;SORT-AS="ABC":ABC\, Inc.;North American Division;Marketing
"organizations": {
"ORG-1": {
"name": "ABC, Inc.",
"units":[
{ "name": "North American Division" },
{ "name": "Marketing" }
],
"sortAs": "ABC"
}
}
Figure 25: ORG Conversion Example
図25：ORG変換の例
The RELATED property (Section 6.6.6 of [RFC6350]) converts to the Card object's relatedTo property (Figure 26). The property value converts to the key in the relatedTo property. The TYPE parameters convert to the Relation object's relation property (Section 2.1.8 of [RFC9553]). Any other parameters convert as defined in Section 2.15.2.
関連プロパティ（[RFC6350]のセクション6.6.6）は、カードオブジェクトの関連プロパティに変換されます（図26）。プロパティ値は、関連プロパティのキーに変換されます。型パラメーターは、[RFC9553]のセクション2.1.8）の関係オブジェクトの関係プロパティに変換されます。その他のパラメーターは、セクション2.15.2で定義されているように変換されます。
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.
"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" : { }
}
}
Figure 26: RELATED Conversion Example
図26：関連する変換の例
The TITLE (Section 6.6.1 of [RFC6350]) and ROLE (Section 6.6.2 of [RFC6350]) properties convert to a Title object (Section 2.2.5 of [RFC9553]) in the Card object's titles property (Figure 27). The Title object's kind property is set to "title" or "role" for the TITLE and ROLE vCard properties, respectively. The name property is set to the vCard property value.
カードオブジェクトのタイトルプロパティ（図27）のタイトル（[RFC6350]のセクション6.6.1）と役割（[RFC6350]のセクション6.6.2）プロパティ（[RFC9553]のセクション2.2.5）に変換されるプロパティ。タイトルオブジェクトの親切なプロパティは、それぞれタイトルと役割VCardプロパティの「タイトル」または「役割」に設定されています。名前プロパティは、VCardプロパティ値に設定されています。
The value of the 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 property is also a part of that group.
OrganizationIDプロパティの価値は、タイトルまたはロールプロパティがVCardプロパティグループのメンバーであり、そのグループの一部である場合に正確に1つのORGプロパティでもある場合に導出できます。
The ALTID and LANGUAGE parameters convert according to the rules defined in Section 2.3.
AltIDおよび言語パラメーターは、セクション2.3で定義されているルールに従って変換されます。
TITLE:Research Scientist
group1.ROLE:Project Leader
group1.ORG:ABC, Inc.
"titles": {
"TITLE-1": {
"kind": "title",
"name": "Research Scientist"
},
"TITLE-2": {
"kind": "role",
"name": "Project Leader",
"organizationId": "ORG-1"
}
},
"organizations": {
"ORG-1": {
"name": "ABC, Inc."
}
}
Figure 27: TITLE and ROLE Conversion Example
図27：タイトルと役割の変換の例
The EXPERTISE property (Section 2.1 of [RFC6715]) converts to a PersonalInfo object (Section 2.8.4 of [RFC9553]) in the Card object's personalInfo property (Figure 28). The PersonalInfo object's kind property is set to "expertise".
専門知識プロパティ（[RFC6715]のセクション2.1）は、カードオブジェクトのPersonalInfoプロパティのPersonalInfoオブジェクト（[RFC9553]のセクション2.8.4）に変換されます（図28）。PersonalInfoオブジェクトの親切なプロパティは、「専門知識」に設定されています。
The INDEX and LEVEL parameters convert according to the rules defined in Section 2.3.
インデックスとレベルのパラメーターは、セクション2.3で定義されているルールに従って変換されます。
EXPERTISE;LEVEL=beginner;INDEX=2:Chinese literature
EXPERTISE;INDEX=1;LEVEL=expert:chemistry
"personalInfo": {
"PERSINFO-1" : {
"kind": "expertise",
"value": "Chinese literature",
"level": "low",
"listAs": 2
},
"PERSINFO-2" : {
"kind": "expertise",
"value": "chemistry",
"level": "high",
"listAs": 1
}
}
Figure 28: EXPERTISE Conversion Example
図28：専門知識変換の例
The HOBBY property (Section 2.2 of [RFC6715]) converts to a PersonalInfo object (Section 2.8.4 of [RFC9553]) in the Card object's personalInfo property (Figure 29). The PersonalInfo object's kind property is set to "hobby".
趣味のプロパティ（[RFC6715]のセクション2.2）は、カードオブジェクトのPersonalInfoプロパティのPersonalInfoオブジェクト（[RFC9553]のセクション2.8.4）に変換されます（図29）。PersonalInfoオブジェクトの親切なプロパティは、「趣味」に設定されています。
The INDEX and LEVEL parameters convert according to the rules defined in Section 2.3.
インデックスとレベルのパラメーターは、セクション2.3で定義されているルールに従って変換されます。
HOBBY;INDEX=1;LEVEL=high:reading
HOBBY;INDEX=2;LEVEL=high:sewing
"personalInfo": {
"PERSINFO-1" : {
"kind": "hobby",
"value": "reading",
"level": "high",
"listAs": 1
},
"PERSINFO-2" : {
"kind": "hobby",
"value": "sewing",
"level": "high",
"listAs": 2
}
}
Figure 29: HOBBY Conversion Example
図29：趣味の変換の例
The INTEREST property (Section 2.3 of [RFC6715]) converts to a PersonalInfo object (Section 2.8.4 of [RFC9553]) in the Card object's personalInfo property (Figure 30). The PersonalInfo object's kind property is set to "interest".
Card ObjectのPersonalInfoプロパティ（図30）のIntexプロパティ（[RFC6715]のセクション2.3）は、PersonalInfoオブジェクト（[RFC9553]のセクション2.8.4）に変換されます。PersonalInfoオブジェクトの親切なプロパティは、「関心」に設定されています。
The INDEX and LEVEL parameters convert according to the rules defined in Section 2.3.
インデックスとレベルのパラメーターは、セクション2.3で定義されているルールに従って変換されます。
INTEREST;INDEX=1;LEVEL=medium:r&b music
INTEREST;INDEX=2;LEVEL=high:rock&roll music
"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
}
}
Figure 30: INTEREST Conversion Example
図30：関心の変換の例
The ORG-DIRECTORY property (Section 2.4 of [RFC6715]) [RFC6715] converts to a Directory object (Section 2.6.2 of [RFC9553]) in the Card object's directories property (Figure 31). The Directory object's kind property is set to "directory". The uri property is set to the ORG-DIRECTORY property value.
org-directoryプロパティ（[RFC6715]のセクション2.4）[RFC6715]は、カードオブジェクトのディレクトリプロパティのディレクトリオブジェクト（[RFC9553]のセクション2.6.2）に変換されます（図31）。ディレクトリオブジェクトの親切なプロパティは、「ディレクトリ」に設定されています。URIプロパティは、組織ディレクトリプロパティ値に設定されています。
The INDEX, PREF, and TYPE parameters convert according to the rules defined in Section 2.3.
セクション2.3で定義されているルールに従って、インデックス、プリフ、およびタイプパラメーターは変換されます。
ORG-DIRECTORY;INDEX=1:https://directory.mycompany.example.com
ORG-DIRECTORY;PREF=1:ldap://ldap.tech.example/o=Tech,ou=Engineering
"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
}
}
Figure 31: ORG-DIRECTORY Conversion Example
図31：組織ディレクトリ変換の例
The CATEGORIES property (Section 6.7.1 of [RFC6350]) converts to a set of entries of the Card object's keywords property (Figure 32). The keys are the comma-separated text values of the CATEGORIES property.
カテゴリプロパティ（[RFC6350]のセクション6.7.1）は、カードオブジェクトのキーワードプロパティのエントリのセットに変換されます（図32）。キーは、カテゴリプロパティのコンマ分離されたテキスト値です。
In this case, the PREF parameter does not have a JSContact counterpart; however, the implementors MAY insert the entries by order of preference.
この場合、PrefパラメーターにはJScontactの対応物がありません。ただし、実装者は、優先順位でエントリを挿入する場合があります。
CATEGORIES:internet,IETF,Industry,Information Technology
"keywords": {
"internet": true,
"IETF": true,
"Industry": true,
"Information Technology": true
}
Figure 32: CATEGORIES Conversion Example
図32：カテゴリ変換の例
The CLIENTPIDMAP property (Section 6.7.7 of [RFC6350]) converts to the vCardProps (Section 2.15.1) property.
clientPidMapプロパティ（[RFC6350]のセクション6.7.7）は、VCardProps（セクション2.15.1）プロパティに変換されます。
The CREATED property (Section 3.1 of [RFC9554]) converts to the Card object's created property (Figure 33).
作成されたプロパティ（[RFC9554]のセクション3.1）は、カードオブジェクトの作成されたプロパティに変換されます（図33）。
CREATED:19940930T143510Z
"created": "1994-09-30T14:35:10Z"
Figure 33: CREATED Conversion Example
図33：作成された変換の例
The NOTE property (Section 6.7.2 of [RFC6350]) converts to a Note object (Section 2.8.3 of [RFC9553]) in the Card object's notes property (Figure 34).
Noteプロパティ（[RFC6350]のセクション6.7.2）は、カードオブジェクトのノートプロパティ（図34）のノートオブジェクト（[RFC9553]のセクション2.8.3）に変換されます。
The ALTID and LANGUAGE parameters convert according to the rules defined in Section 2.3.
AltIDおよび言語パラメーターは、セクション2.3で定義されているルールに従って変換されます。
NOTE;CREATED=20221123T150132Z;AUTHOR-NAME="John":
Office hours are from 0800 to 1715 EST\, Mon-Fri.
"notes": {
"NOTE-1" : {
"note": "Office hours are from 0800 to 1715 EST, Mon-Fri.",
"created": "2022-11-23T15:01:32Z",
"author": {
"name": "John"
}
}
}
Figure 34: NOTE Conversion Example
図34：変換の例に注意してください
The PRODID property (Section 6.7.3 of [RFC6350]) converts to the Card object's prodId property (Figure 35).
Prodidプロパティ（[RFC6350]のセクション6.7.3）は、カードオブジェクトのProdidプロパティに変換されます（図35）。
PRODID:ACME Contacts App version 1.23.5
"prodId": "ACME Contacts App version 1.23.5"
Figure 35: PRODID Conversion Example
図35：Prodid変換の例
The REV property (Section 6.7.4 of [RFC6350]) converts to the Card object's updated property (Figure 36).
Revプロパティ（[RFC6350]のセクション6.7.4）は、カードオブジェクトの更新プロパティに変換されます（図36）。
REV:19951031T222710Z
"updated": "1995-10-31T22:27:10Z"
Figure 36: REV Conversion Example
図36：回転変換の例
The SOUND property (Section 6.7.5 of [RFC6350]) converts to a Media object (Section 2.6.4 of [RFC9553]) in the Card object's media property (Figure 37). The Media object's kind property is set to "sound" and the uri property is set to the SOUND value.
カードオブジェクトのメディアプロパティ（図37）のサウンドプロパティ（[RFC6350]のセクション6.7.5）は、メディアオブジェクト（[RFC9553]のセクション2.6.4）に変換されます。メディアオブジェクトの親切なプロパティは「サウンド」に設定されており、URIプロパティはサウンド値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
SOUND:CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com
"media": {
...
"SOUND-1": {
"kind": "sound",
"uri": "CID:JOHNQPUBLIC.19960229T080000.xyzMail@example.com"
}
}
Figure 37: SOUND Conversion Example
図37：サウンド変換の例
The UID property (Section 6.7.6 of [RFC6350]) converts to the Card object's uid property (Figure 38).
UIDプロパティ（[RFC6350]のセクション6.7.6）は、カードオブジェクトのUIDプロパティに変換されます（図38）。
UID:urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
"uid": "urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6"
Figure 38: UID Conversion Example
図38：UID変換の例
The URL property (Section 6.7.8 of [RFC6350]) converts to a Link object (Section 2.6.3 of [RFC9553]) in the Card object's links property (Figure 39). The Link object's uri property is set to the URL value.
URLプロパティ（[RFC6350]のセクション6.7.8）は、カードオブジェクトのリンクプロパティ（図39）のリンクオブジェクト（[RFC9553]のセクション2.6.3）に変換されます。Link ObjectのURIプロパティは、URL値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
URL:https://example.org/restaurant.french/~chezchic.html
"links": {
"LINK-1": {
"uri": "https://example.org/restaurant.french/~chezchic.html"
}
}
Figure 39: URL Conversion Example
図39：URL変換の例
The VERSION property (Section 6.7.9 of [RFC6350]) converts to the vCardProps (Section 2.15.1) property.
バージョンプロパティ（[RFC6350]のセクション6.7.9）は、VCardProps（セクション2.15.1）プロパティに変換されます。
The X-ABLabel property is experimental but widely in use in existing vCard data. It converts to the label property of a JSContact object. The X-ABLabel property is preceded by a vCard property group name, and the label converts to the JSContact object, which was converted from a vCard property of the same group.
X-Ablabelプロパティは実験的ですが、既存のVCARDデータでは広く使用されています。JScontactオブジェクトのラベルプロパティに変換します。X-Ablabelプロパティの前にはVCardプロパティグループ名があり、ラベルは同じグループのVCardプロパティから変換されたJScontactオブジェクトに変換されます。
The group name is not preserved; implementations are free to choose any unique group name when converting back to vCard. For an example on how to preserve the group name, see Section 2.3.9.
グループ名は保存されていません。実装は、VCardに戻るときに一意のグループ名を無料で選択できます。グループ名を保持する方法の例については、セクション2.3.9を参照してください。
item1.TEL;VALUE=uri:tel:+1-555-555-5555
item1.X-ABLabel:foo
"phones": {
"p1": {
"number": "tel:+1-555-555-5555",
"label": "foo"
}
}
Figure 40: X-ABLabel Conversion Example
図40：Xアブラベル変換の例
The KEY property (Section 6.8.1 of [RFC6350]) converts to a CryptoKey object (Section 2.6.1 of [RFC9553]) in the Card object's cryptoKeys property (Figure 41). The CryptoKey object's uri property is set to the KEY property value.
キープロパティ（[RFC6350]のセクション6.8.1）は、カードオブジェクトのCryptokeysプロパティのCryptokeyオブジェクト（[RFC9553]のセクション2.6.1）に変換されます（図41）。CryptokeyオブジェクトのURIプロパティは、キープロパティ値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
KEY:https://www.example.com/keys/jdoe.cer
"cryptoKeys": {
"KEY-1": {
"uri": "https://www.example.com/keys/jdoe.cer"
}
}
Figure 41: KEY Conversion Example
図41：キー変換の例
The CALADRURI property (Section 6.9.2 of [RFC6350]) converts to a SchedulingAddress object (Section 2.4.2 of [RFC9553]) in the Card object's schedulingAddresses property (Figure 42). The SchedulingAddress object's uri property is set to the CALADRURI value.
Cardruriプロパティ（[RFC6350]のセクション6.9.2）は、カードオブジェクトのスケジューリングアドレスプロパティ内のスケジューリングアドレスオブジェクト（[RFC9553]のセクション2.4.2）に変換されます（図42）。SchedulingAddressオブジェクトのURIプロパティは、Caladruri値に設定されています。
The PREF parameter (Section 5.3 of [RFC6350]) converts according to the rules defined in Section 2.3.
[RFC6350]のセクション5.3）は、セクション2.3で定義されているルールに従って変換します。
CALADRURI;PREF=1:mailto:janedoe@example.com
CALADRURI:https://example.com/calendar/jdoe
"schedulingAddresses": {
"SCHEDULING-1": {
"uri": "mailto:janedoe@example.com",
"pref": 1
},
"SCHEDULING-2": {
"uri": "https://example.com/calendar/jdoe"
}
}
Figure 42: CALADRURI Conversion Example
図42：Caladruri変換の例
The CALURI property (Section 6.9.3 of [RFC6350]) converts to a Calendar object (Section 2.4.1 of [RFC9553]) in the Card object's calendars property (Figure 43). The Calendar object's kind property is set to "calendar" and the uri property is set to the CALURI value.
CARDオブジェクトのカレンダープロパティ（図43）のCaluriプロパティ（[RFC6350]のセクション6.9.3）は、カレンダーオブジェクト（[RFC9553]のセクション2.4.1）に変換されます。カレンダーオブジェクトの親切なプロパティは「カレンダー」に設定されており、URIプロパティはCaluri値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
CALURI;PREF=1:https://cal.example.com/calA
CALURI;MEDIATYPE=text/calendar:https://ftp.example.com/calA.ics
"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"
}
}
Figure 43: CALURI Conversion Example
図43：Caluri変換の例
The FBURL property (Section 6.9.1 of [RFC6350]) converts to a Calendar object (Section 2.4.1 of [RFC9553]) in the Card object's calendars property (Figure 44). The Calendar object's kind property is set to "freeBusy" and the uri property is set to the FBURL value.
fburlプロパティ（[RFC6350]のセクション6.9.1）は、カードオブジェクトのカレンダープロパティ（図44）のカレンダーオブジェクト（[RFC9553]のセクション2.4.1）に変換されます。カレンダーオブジェクトの親切なプロパティは「Freebusy」に設定されており、URIプロパティはFBURL値に設定されています。
The PREF and TYPE parameters convert according to the rules defined in Section 2.3.
Prefおよび型パラメーターは、セクション2.3で定義されているルールに従って変換されます。
FBURL;PREF=1:https://www.example.com/busy/janedoe
FBURL;MEDIATYPE=text/calendar:https://example.com/busy/project-a.ifb
"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"
}
}
Figure 44: FBURL Conversion Example
図44：Fburl変換の例
Extended properties and parameters convert as specified in Section 2.15.
セクション2.15で指定されているように、拡張プロパティとパラメーターが変換されます。
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 Section 6.10 of [RFC6350].
VCARDには、IANAが登録されているJSCONTACTプロパティが定義されていないプロパティまたはパラメーターが含まれている場合があります。たとえば、VCardには、セマンティクスまたは目的が実装に不明なプロパティとパラメーターを含める場合があります。[RFC6350]のセクション6.10を参照してください。
This section defines JSContact properties by which such vCard properties and parameters MAY be represented in JSContact. Implementations MAY choose to convert differently if they deem that more appropriate.
このセクションでは、このようなVCARDプロパティとパラメーターをJSCONTACTで表すことができるJSCONTACTプロパティを定義します。実装は、より適切だと思う場合、異なる変換を選択する場合があります。
vCardProps: JCardProp[] (optional).
vcardprops：jcardprop []（オプション）。
Contains vCard properties that are set in the vCard represented by this JSContact object. The JCardProp type denotes a jCard-encoded vCard property as defined in Section 3.3 of [RFC7095].
このjScontactオブジェクトで表されるVcardに設定されたVcardプロパティが含まれています。JCardPropタイプは、[RFC7095]のセクション3.3で定義されているように、JCARDエンコードVCARDプロパティを示します。
Example:
例：
This illustrates how to convert a vCard extension property:
これは、VCard拡張プロパティを変換する方法を示しています。
item1.X-FOO;X-BAR=Hello:World!
"vCardProps": [
["x-foo", {
"x-bar": "Hello",
"group": "item1"
}, "unknown", "World!"]
]
Figure 45: JSContact vCardProps Example
図45：jScontact vcardpropsの例
vCardParams: String[String|String[]] (optional).
vcardparams：string [string | string []]（オプション）。
Contains vCard parameters that are set on the vCard property represented by this JSContact object. The value MUST be a JSON object containing vCard property parameters as defined in Section 3.3 of [RFC7095]. Each entry represents a parameter of the vCard property that converts to the JSContact object.
このJScontactオブジェクトで表されるVCardプロパティに設定されたVCardパラメーターが含まれています。値は、[RFC7095]のセクション3.3で定義されているように、VCARDプロパティパラメーターを含むJSONオブジェクトでなければなりません。各エントリは、jScontactオブジェクトに変換するVCardプロパティのパラメーターを表します。
Example:
例：
This illustrates how to convert a vCard extension parameter:
これは、VCARD拡張パラメーターを変換する方法を示しています。
EMAIL;X-FOO=Bar:jane_doe@example.com
"emails": {
"email1": {
"address": "jane_doe@example.com",
"vCardParams": {
"x-foo": "Bar"
}
}
}
Figure 46: JSContact vCardParams Example
図46：jScontact vcardparamsの例
vCardName: String (optional).
vcardname：string（optional）。
Contains the name of the vCard element that is represented by this JSContact object. For example, this allows to preserve the name of a vCard property when multiple vCard properties convert the same JSContact type. The case-insensitive value MUST be valid according to the "name" ABNF defined in Section 3.3 of [RFC6350].
このjScontactオブジェクトで表されるVcard要素の名前が含まれています。たとえば、これにより、複数のVCardプロパティが同じjScontactタイプを変換する場合、VCardプロパティの名前を保存できます。症例と感受性の値は、[RFC6350]のセクション3.3で定義されている「名前」ABNFに従って有効でなければなりません。
Example:
例：
Both vCard IMPP and SOCIALPROFILE convert to an OnlineService object (Section 2.3.2 of [RFC9553]) in JSContact. The vCardName property value indicates that the vCard source element was IMPP as follows:
VCard IMPPとSocialProfileの両方が、JScontactのOnLineserviceオブジェクト（[RFC9553]のセクション2.3.2）に変換されます。VCardNameプロパティ値は、VCARDソース要素が次のようにIMPPであったことを示します。
IMPP:xmpp:alice@example.com
"onlineServices": {
"os1": {
"uri": "xmpp:alice@example.com",
"vCardName": "impp"
},
}
Figure 47: JSContact vCardName Example
図47：jScontact vcardnameの例
A Card object converts to vCard by applying the reverse rules of converting vCard to JSContact. In addition to those listed in Appendix A, the following rules apply:
カードオブジェクトは、VCARDをJSCONTACTに変換する逆ルールを適用することにより、VCARDに変換されます。付録Aにリストされているものに加えて、次のルールが適用されます。
* Multivalued JSContact properties convert to separate instances of their equivalent vCard property, and each of the PROP-ID parameters MUST be set to the Id-typed key of the converted value (see Section 2.3.18).
* 多面体のJSContactプロパティは、同等のVCARDプロパティの個別のインスタンスに変換され、各Prop-IDパラメーターは変換された値のIDタイプキーに設定する必要があります（セクション2.3.18を参照）。
* The full property of the name property in JSContact is optional, but the FN property is mandatory in vCard. The following rules apply:
* JScontactの名前プロパティの完全なプロパティはオプションですが、FNプロパティはVCARDでは必須です。次のルールが適用されます。
- If the Name object's full property is set, then implementations MUST use its value for the vCard FN property.
- 名前オブジェクトの完全なプロパティが設定されている場合、実装はVCARD FNプロパティにその値を使用する必要があります。
- If the Name object's full property is not set, then implementations SHOULD derive the full name from the Name object's components property values. If the isOrdered property is "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 its components such as [CLDRPersonName]. Implementations MUST set the DERIVED parameter on the FN property.
- 名前オブジェクトの完全なプロパティが設定されていない場合、実装は、名前オブジェクトのコンポーネントプロパティ値からフルネームを導出する必要があります。ISORDEREDプロパティが「TRUE」の場合、これは名前コンポーネント値を連結することで実行できます。それ以外の場合、または実装は、他のヒューリスティックを選択して、[cldrpersonName]などのコンポーネントからフルネームを生成することができます。実装は、FNプロパティに派生パラメーターを設定する必要があります。
- Otherwise, the FN property MUST be set to the empty value.
- それ以外の場合、FNプロパティは空の値に設定する必要があります。
* Vendor-specific and unknown properties convert to vCard as outlined in Section 3.1.1.
* セクション3.1.1で概説されているように、ベンダー固有の不明なプロパティ。
JSContact objects 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.
JScontactオブジェクトには、IANA登録VCARDプロパティが定義されていないプロパティが含まれている場合があります。たとえば、JScontactオブジェクトには、セマンティクスまたは目的が不明なベンダー固有のプロパティを含む場合があります。
This specification defines the new JSPROP (Section 3.2.1) vCard property and JSPTR (Section 3.3.2) vCard parameter by which such JSContact properties MAY be represented in vCard. Implementations MAY choose to convert differently if they deem that more appropriate.
この仕様では、新しいJSPROP（セクション3.2.1）VCARDプロパティとJSPTR（セクション3.3.2）VCARDパラメーターを定義します。実装は、より適切だと思う場合、異なる変換を選択する場合があります。
Property name:
プロパティ名：
JSPROP
jsprop
Purpose:
目的：
Represents a JSContact property in vCard.
VCardのJScontactプロパティを表します。
Value type:
値タイプ：
TEXT; also see "Format definition" below for value restrictions.
文章;また、価値制限については、以下の「フォーマット定義」も参照してください。
Conformance:
適合：
Can be specified multiple times in a vCard.
VCardで複数回指定できます。
Property parameters:
プロパティパラメーター：
The JSPTR parameter MUST be set for this property. Other IANA-registered and experimental property parameters can be specified on this property.
JSPTRパラメーターは、このプロパティに設定する必要があります。このプロパティでは、その他のIANA登録および実験的プロパティパラメーターを指定できます。
Description:
説明：
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 MUST be compact, e.g., without insignificant whitespace as defined in Section 2 of [RFC8259]. The value of the JSPTR parameter points to the JSContact property within the Card.
このプロパティは、VCARDからの任意のJScontactプロパティを変換します。VCARDプロパティ値は、JSCONTACTプロパティのJSONエンコード値であり、テキスト値として表されます。JSON値の形式は、たとえば、[RFC8259]のセクション2で定義されているとおりの重要でない白色のないコンパクトでなければなりません。JSPTRパラメーターの値は、カード内のjScontactプロパティを指します。
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 MUST NOT reference into an array.
JSONポインターのルートは、JSONポインターがSolidus（U+002F）文字で始まるかどうかに関係なく、常にこのVCardが変換するカードオブジェクトです。ポインターは配列に基準を記録してはなりません。
All JSPROP properties in a vCard together form a PatchObject as defined in [RFC9553]. The value of its JSPTR parameter corresponds to a key in the PatchObject; the value of the JSPROP property corresponds to the value for that key. When converting from vCard to JSContact, the PatchObject MUST only be applied after all other vCard properties have already been converted. The PatchObject MUST be valid, including the restriction that an invalid PatchObject MUST NOT be applied.
[RFC9553]で定義されているように、VCARD内のすべてのJSPROPプロパティが一緒になっています。JSPTRパラメーターの値は、PatchObjectのキーに対応しています。JSPROPプロパティの値は、そのキーの値に対応しています。VCARDからJSCONTACTに変換する場合、PatchObjectは、他のすべてのVCARDプロパティがすでに変換されている後にのみ適用する必要があります。PatchObjectは、無効なPatchObjectを適用してはならないという制限を含む有効でなければなりません。
Format definition:
フォーマット定義：
This property is defined by the following notation:
このプロパティは、次の表記法で定義されています。
jsprop = "JSPROP" jsprop-param ":" TEXT
jsprop-param = *(
; The following are REQUIRED and MUST NOT
; occur more than once
( ";" jsptr-param ) / ; see next section
( ";" "VALUE" "=" "TEXT")
;
; The following is OPTIONAL
; and MAY occur more than once.
;
(";" other-param)
;
)
Example(s):
例：
This illustrates how to convert a property at the top level in a Card object that is unknown to the implementation.
これは、実装に知られていないカードオブジェクトの上位レベルのプロパティを変換する方法を示しています。
"someUnknownProperty": true
JSPROP;JSPTR="someUnknownProperty":true
Figure 48: Unknown Property Example
図48：不明なプロパティの例
This illustrates how to convert a vendor-specific property at the top level of a Card object. Note the required use of quoted string for the JSPTR value, which allows the path to include the COLON (U+003A) character.
これは、カードオブジェクトの上位レベルでベンダー固有のプロパティを変換する方法を示しています。JSPTR値に引用された文字列の必要な使用に注意してください。これにより、パスがコロン（U+003a）文字を含めることができます。
"example.com:foo": {
"bar": 1234
}
JSPROP;JSPTR="example.com:foo":{"bar":1234}
Figure 49: Vendor-Specific Property Conversion Example
図49：ベンダー固有のプロパティ変換の例
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) character, which requires escaping in the JSON pointer.
これは、カードオブジェクトに対するパスを使用して、カードオブジェクトのネストされたレベルでベンダー固有のプロパティを変換する方法を示しています。推奨されていませんが、プロパティ名にはSolidus（U+002F）文字が含まれており、JSONポインターでの脱出が必要です。
"phones": {
"phone1": {
"number": "tel:+33-01-23-45-67",
"example.com:foo/bar": "tux hux"
}
}
TEL:tel:+33-01-23-45-67
JSPROP;JSPTR="phones/phone1/example.com:foo~1bar":
"tux hux"
Figure 50: Nested Vendor-Specific Property Example with a Path Relative to Card
図50：カードに対するパスを持つネストされたベンダー固有のプロパティの例
Parameter name:
パラメーター名：
JSCOMPS
jscomps
Purpose:
目的：
Defines the order and separators for the elements of a structured property value.
構造化されたプロパティ値の要素の順序とセパレーターを定義します。
Description:
説明：
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.
JSCOMPSパラメーター値は、JSContactとVCard間の名前とアドレスコンポーネントの変換を容易にします。jScontactプロパティのコンポーネントの順序を保持し、セパレーターコンポーネントの逐語的な値を含んでいます。
If this parameter is set and its value is valid (see later), then implementations MUST set the isOrdered property of the Name or Address object to "true". Otherwise, they MUST set the isOrdered property value to "false".
このパラメーターが設定され、その値が有効である場合（後で参照）、実装は名前またはアドレスオブジェクトのISORDEREDプロパティを「true」に設定する必要があります。それ以外の場合、ISORDEREDプロパティ値を「FALSE」に設定する必要があります。
The JSCOMPS parameter value is a structured type value. Its value MUST 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 defaultSeparator property. If it is the empty string, then no default separator is defined. Otherwise, the first entry MUST be a separator entry. All following entries processed in order result in an ordered list of JSContact components and MUST be one of the following two kinds:
JSCOMPSパラメーター値は、構造化されたタイプ値です。その価値は引用する必要があります。パラメーター値は、セミコロン文字（U+003B）で区切られた一連のエントリで構成されています。最初のエントリは、DefaultSeparatorプロパティの値を定義します。空の文字列の場合、デフォルトのセパレーターは定義されていません。それ以外の場合、最初のエントリはセパレーターエントリでなければなりません。順に処理されたすべての次のエントリは、jScontactコンポーネントの順序付けられたリストになり、次の2種類のいずれかでなければなりません。
1. A positional. This refers to a component value in the vCard structured value. 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 index is zero by default, in which case it MUST be omitted (as well as the leading COMMA).
1. 位置。これは、VCard構造値のコンポーネント値を指します。位置は、構造化された値のコンポーネントの数値インデックスで構成され、オプションでコンマ（U+002C）文字とそのコンポーネント内の値の非ゼロインデックスが続きます。ゼロインデックスは、それぞれ最初のコンポーネントまたは値を選択します。デフォルトでは、2番目のインデックスはゼロです。この場合は、省略する必要があります（および主要なコンマ）。
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 51 and 52 illustrate this by example.
結果のJScontactコンポーネントは、VCARD構造値の位置によってその種を決定することにより形成されます。コンポーネント値は、VCardコンポーネントの逐語的な値です。図51と52は、これを例で示しています。
2. 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) character, followed by zero or more "param-value" characters (see Section 3.3 of [RFC6350]), where the COMMA (U+002C) and SEMICOLON (U+003B) characters MUST be escaped according to the rules defined in Section 3.4 of [RFC6350]. Figure 53 illustrates this by example.
2. セパレーター。これには、セパレーターコンポーネントの逐語的な値が含まれます。ラテン語の小さな文字s（u+0073）文字から始まり、その後にコンマ（u+002c）文字が続き、その後にゼロ以上の「パラメータ」文字（[rfc6350]のセクション3.3を参照）が続きます。（U+002C）およびセミコロン（U+003B）文字は、[RFC6350]のセクション3.4で定義されているルールに従って逃げる必要があります。図53は、これを例ごとに示しています。
The resulting JSContact component is formed by setting its kind to "separator" and its value to the verbatim value of the entry.
結果のJScontactコンポーネントは、その種類を「セパレーター」に設定し、その値をエントリの逐語的な値に設定することにより形成されます。
A JSCOMPS parameter value is valid if and only if:
JSCOMPSパラメーター値は、以下の場合にのみ有効です。
* All indexes in the positional entries refer to an existing component value in the vCard property value.
* 位置エントリのすべてのインデックスは、VCardプロパティ値の既存のコンポーネント値を指します。
* 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:
* 位置エントリのカウントは、重複排除されたコンポーネント値のカウントに等しくなります。VCARDプロパティ値の指定されたコンポーネントと後方互換コンポーネントの両方でいくつかの値が発生する可能性があるため、重複排除が必要です。
- A value that occurs in both the N property secondary surname component and the family name component only counts once.
- Nプロパティセカンダリスナームコンポーネントと姓コンポーネントの両方で発生する値は、1回だけカウントされます。
- A value that occurs in both the N property generation component and the honorific suffix component only counts once.
- Nプロパティ生成コンポーネントとHonorificサフィックスコンポーネントの両方で発生する値は、1回だけカウントされます。
- 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 [RFC9554].
- ADRプロパティアドレスコンポーネントの値は、ADRプロパティ値に[RFC9554]で定義されている新しいコンポーネントの1つに値が含まれている場合、カウントされません。
- All other values count once each.
- 他のすべての値はそれぞれ1回カウントされます。
Format definition:
フォーマット定義：
jscomps-param = "JSCOMPS" "=" DQUOTE [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
Example(s):
例：
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.
次の例は、「Jane Doe」という名前の位置エントリの使用を示しています。指定された名前は、姓の前に注文されます。どちらの位置にもゼロであるため、どちらの位置にも二次インデックスは必要ありません。
"name": {
"components": [
{ "kind": "given", "value": "Jane" },
{ "kind": "surname", "value": "Doe" }
],
"isOrdered": true
}
N;JSCOMPS=";1;0":Doe;Jane;;;;;;
FN;DERIVED=TRUE:Jane Doe
Figure 51: Example of a Secondary Positional Index
図51：二次位置指数の例
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.
次の例は、二次位置指標を示しています。「Jr.」生成マーカーは、指定された生成コンポーネントと後方互換の敬意の接尾辞コンポーネントの両方で発生するため、1回のみカウントされます。
"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.
Figure 52: Example of Positional Entries
図52：位置エントリの例
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 " ". For 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.
次の例は、（簡潔に短縮）アドレス「54321 Oak St、Reston」のセパレーターエントリの使用を示しています。最初のエントリは、デフォルトのセパレーターを「」と定義します。2番目と4番目のポジションエントリは、セパレーター値「」で区切られています。後方互換性のために、ADRプロパティの通り住所コンポーネントには、ストリート番号と名前の両方が含まれていますが、JSCOMPSパラメーターでは言及されておらず、値のカウントには寄与しません。
"addresses": {
"a1": {
"components": [
{ "kind": "number", "value": "54321" },
{ "kind": "separator", "value": " " },
{ "kind": "name", "value": "Oak St" },
{ "kind": "locality", "value": "Reston" }
],
"defaultSeparator": ", ",
"isOrdered": true
}
}
ADR;JSCOMPS="s,\, ;11;s, ;10;3":
;;54321 Oak St;Reston;;;;;;;Oak St;54321;;;;;;
Figure 53: Example of Separator Entries
図53：セパレーターエントリの例
Parameter name:
パラメーター名：
JSPTR
JSPTR
Purpose:
目的：
This parameter is set on a JSPROP (Section 3.2.1) property. Its value is a JSON pointer [RFC6901] that points to the JSContact property that has the value of the JSPROP property.
このパラメーターは、JSPROP（セクション3.2.1）プロパティで設定されています。その値は、JSPROPプロパティの値を持つJSCONTACTプロパティを指すJSONポインター[RFC6901]です。
Description:
説明：
This parameter has a single value that MUST be a valid JSON pointer as defined in [RFC6901]. Note that the value MUST be quoted according to the "param-value" ABNF in [RFC6350].
このパラメーターには、[RFC6901]で定義されているように、有効なJSONポインターでなければならない単一の値があります。[RFC6350]の「パラマル値」ABNFに従って値を引用する必要があることに注意してください。
Format definition:
フォーマット定義：
jsptr-param = "JSPTR" "=" param-value
; also see param-value in RFC 6350, Section 3.3
Example(s):
例：
This illustrates a simple example. For further examples, see Section 3.2.1.
これは簡単な例を示しています。さらに例については、セクション3.2.1を参照してください。
JSPROP;JSPTR="example.com:foo":"bar"
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 Section 4 of [RFC9553] and Section 9 of [RFC6350].
この仕様では、JSCONTACT形式とVCARD形式間を変換する方法を定義します。このようなデータの解析とフォーマットに関するセキュリティ上の考慮事項が適用され、[RFC9553]のセクション4および[RFC6350]のセクション9で概説されています。
IANA has added the following entry to the "vCard Properties" registry, as defined in Section 10.3.1 of [RFC6350].
IANAは、[RFC6350]のセクション10.3.1で定義されているように、「VCardプロパティ」レジストリに次のエントリを追加しました。
+===========+==========+=========================+
| Namespace | Property | Reference |
+===========+==========+=========================+
| | JSPROP | RFC 9555, Section 3.2.1 |
+-----------+----------+-------------------------+
Table 4: New vCard Property
表4：新しいVCardプロパティ
IANA has added the following entry to the "vCard Parameters" registry, as defined in Section 10.3.2 of [RFC6350].
IANAは、[RFC6350]のセクション10.3.2で定義されているように、「VCardパラメーター」レジストリに次のエントリを追加しました。
+===========+===========+=========================+
| Namespace | Parameter | Reference |
+===========+===========+=========================+
| | JSPTR | RFC 9555, Section 3.3.2 |
+-----------+-----------+-------------------------+
Table 5: New vCard Parameter
表5：新しいVCardパラメーター
IANA has added the following entries to the "JSContact Properties" registry. Note that the Since Version is 1.0, the Until Version is not set, and the Change Controller is IETF for all of these properties.
IANAは、「JScontactプロパティ」レジストリに次のエントリを追加しました。以降のバージョンは1.0であり、までバージョンが設定されておらず、これらすべてのプロパティの変更コントローラーはIETFであることに注意してください。
+===========+=======================+=========+========+===========+
|Property |Property Type |Property |Intended|Reference/ |
|Name | |Context |Usage |Description|
+===========+=======================+=========+========+===========+
|vCardName |String |Any |common |RFC 9555, |
| | |JSContact| |Section |
| | |object | |2.15.3 |
+-----------+-----------------------+---------+--------+-----------+
|vCardParams|String[String|String[]]|Any |common |RFC 9555, |
| | |JSContact| |Section |
| | |object | |2.15.2 |
+-----------+-----------------------+---------+--------+-----------+
|vCardProps |JCardProp[] |Card |common |RFC 9555, |
| | | | |Section |
| | | | |2.15.1 |
+-----------+-----------------------+---------+--------+-----------+
Table 6: JSContact Properties Registry
表6：jScontactプロパティレジストリ
IANA has added the following entry to the "JSContact Types" registry. Note that the Since Version is 1.0, the Until Version is not set, and the Change Controller is IETF for this type.
IANAは、「JScontactタイプ」レジストリに次のエントリを追加しました。以降のバージョンは1.0であり、[バージョンは設定されておらず、このタイプのChange ControllerはIETFであることに注意してください。
+===========+================+==========================+
| Type Name | Intended Usage | Reference/Description |
+===========+================+==========================+
| JCardProp | common | RFC 9555, Section 2.15.1 |
+-----------+----------------+--------------------------+
Table 7: JSContact Types Registry
表7：jScontactタイプレジストリ
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
Resource Identifier (URI): Generic Syntax", STD 66,
RFC 3986, DOI 10.17487/RFC3986, January 2005,
<https://www.rfc-editor.org/info/rfc3986>.
[RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
Specifications: ABNF", STD 68, RFC 5234,
DOI 10.17487/RFC5234, January 2008,
<https://www.rfc-editor.org/info/rfc5234>.
[RFC5646] Phillips, A., Ed. and M. Davis, Ed., "Tags for Identifying
Languages", BCP 47, RFC 5646, DOI 10.17487/RFC5646,
September 2009, <https://www.rfc-editor.org/info/rfc5646>.
[RFC6350] Perreault, S., "vCard Format Specification", RFC 6350,
DOI 10.17487/RFC6350, August 2011,
<https://www.rfc-editor.org/info/rfc6350>.
[RFC6473] Saint-Andre, P., "vCard KIND:application", RFC 6473,
DOI 10.17487/RFC6473, December 2011,
<https://www.rfc-editor.org/info/rfc6473>.
[RFC6474] Li, K. and B. Leiba, "vCard Format Extensions: Place of
Birth, Place and Date of Death", RFC 6474,
DOI 10.17487/RFC6474, December 2011,
<https://www.rfc-editor.org/info/rfc6474>.
[RFC6715] Cauchie, D., Leiba, B., and K. Li, "vCard Format
Extensions: Representing vCard Extensions Defined by the
Open Mobile Alliance (OMA) Converged Address Book (CAB)
Group", RFC 6715, DOI 10.17487/RFC6715, August 2012,
<https://www.rfc-editor.org/info/rfc6715>.
[RFC6869] Salgueiro, G., Clarke, J., and P. Saint-Andre, "vCard
KIND:device", RFC 6869, DOI 10.17487/RFC6869, February
2013, <https://www.rfc-editor.org/info/rfc6869>.
[RFC6901] Bryan, P., Ed., Zyp, K., and M. Nottingham, Ed.,
"JavaScript Object Notation (JSON) Pointer", RFC 6901,
DOI 10.17487/RFC6901, April 2013,
<https://www.rfc-editor.org/info/rfc6901>.
[RFC7095] Kewisch, P., "jCard: The JSON Format for vCard", RFC 7095,
DOI 10.17487/RFC7095, January 2014,
<https://www.rfc-editor.org/info/rfc7095>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8259] Bray, T., Ed., "The JavaScript Object Notation (JSON) Data
Interchange Format", STD 90, RFC 8259,
DOI 10.17487/RFC8259, December 2017,
<https://www.rfc-editor.org/info/rfc8259>.
[RFC9553] Stepanek, R. and M. Loffredo, "JSContact: A JSON
Representation of Contact Data", RFC 9553,
DOI 10.17487/RFC9553, May 2024,
<https://www.rfc-editor.org/info/rfc9553>.
[RFC9554] Stepanek, R. and M. Loffredo, "vCard Format Extensions for
JSContact", RFC 9554, DOI 10.17487/RFC9554, May 2024,
<https://www.rfc-editor.org/info/rfc9554>.
[CLDRPersonName]
Davis, M., Edberg, P., Gillam, R., Kolisnychenko, A.,
McKenna, M., and other CLDR committee members, "Unicode
Locale Data Markup Language (LDML) Part 8: Person Names",
Unicode Technical Standard #35, Version 44.1, July 2023,
<https://www.unicode.org/reports/tr35/
tr35-personNames.html>.
[RFC8605] Hollenbeck, S. and R. Carney, "vCard Format Extensions:
ICANN Extensions for the Registration Data Access Protocol
(RDAP)", RFC 8605, DOI 10.17487/RFC8605, May 2019,
<https://www.rfc-editor.org/info/rfc8605>.
[vOBJECT] Tse, R., Tam, P., and M. Douglass, "vObject
Internationalization", Work in Progress, Internet-Draft,
draft-calconnect-vobject-i18n-00, 8 June 2018,
<https://datatracker.ietf.org/doc/html/draft-calconnect-
vobject-i18n-00>.
Table 8 lists the relevant document sections for each JSContact type and property.
表8に、各jScontactタイプとプロパティの関連するドキュメントセクションを示します。
+===================+=====================+=====================+
| JSContact Type | Property Name | Relevant Section(s) |
+===================+=====================+=====================+
| Address | @type | not applicable |
+-------------------+---------------------+---------------------+
| Address | components | Sections 2.6.1 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Address | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Address | coordinates | Sections 2.3.8 and |
| | | 2.8.1 |
+-------------------+---------------------+---------------------+
| Address | country | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | countryCode | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | defaultSeparator | Sections 2.6.1 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Address | full | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | isOrdered | Sections 2.6.1 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Address | locality | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | phoneticScript | Sections 2.3.15 and |
| | | 2.3.19 |
+-------------------+---------------------+---------------------+
| Address | phoneticSystem | Section 2.3.15 |
+-------------------+---------------------+---------------------+
| Address | postcode | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Address | region | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Address | timeZone | Sections 2.3.23 and |
| | | 2.8.2 |
+-------------------+---------------------+---------------------+
| AddressComponent | phonetic | Section 2.3.15 |
+-------------------+---------------------+---------------------+
| Anniversary | @type | not applicable |
+-------------------+---------------------+---------------------+
| Anniversary | date | Section 2.5.1 |
+-------------------+---------------------+---------------------+
| Anniversary | kind | Section 2.5.1 |
+-------------------+---------------------+---------------------+
| Anniversary | place | Section 2.5.1 |
+-------------------+---------------------+---------------------+
| Author | @type | not applicable |
+-------------------+---------------------+---------------------+
| Author | name | Section 2.3.3 |
+-------------------+---------------------+---------------------+
| Author | uri | Section 2.3.2 |
+-------------------+---------------------+---------------------+
| Calendar | @type | not applicable |
+-------------------+---------------------+---------------------+
| Calendar | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Calendar | kind | Sections 2.13.2 and |
| | | 2.13.3 |
+-------------------+---------------------+---------------------+
| Calendar | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| Calendar | mediaType | Section 2.3.14 |
+-------------------+---------------------+---------------------+
| Calendar | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Calendar | uri | Sections 2.13.2 and |
| | | 2.13.3 |
+-------------------+---------------------+---------------------+
| Card | @type | not applicable |
+-------------------+---------------------+---------------------+
| Card | @version | not applicable |
+-------------------+---------------------+---------------------+
| Card | addresses | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Card | anniversaries | Section 2.5.1 |
+-------------------+---------------------+---------------------+
| Card | calendars | Sections 2.13.2 and |
| | | 2.13.3 |
+-------------------+---------------------+---------------------+
| Card | created | Section 2.11.3 |
+-------------------+---------------------+---------------------+
| Card | directories | Sections 2.4.3 and |
| | | 2.10.4 |
+-------------------+---------------------+---------------------+
| Card | emails | Section 2.7.1 |
+-------------------+---------------------+---------------------+
| Card | keywords | Section 2.11.1 |
+-------------------+---------------------+---------------------+
| Card | kind | Section 2.4.2 |
+-------------------+---------------------+---------------------+
| Card | language | Section 2.7.4 |
+-------------------+---------------------+---------------------+
| Card | links | Sections 2.9.1 and |
| | | 2.11.9 |
+-------------------+---------------------+---------------------+
| Card | localizations | Section 2.3.11 |
+-------------------+---------------------+---------------------+
| Card | media | Sections 2.5.7, |
| | | 2.9.2, and 2.11.7 |
+-------------------+---------------------+---------------------+
| Card | members | Section 2.9.3 |
+-------------------+---------------------+---------------------+
| Card | name | Section 2.5.5 |
+-------------------+---------------------+---------------------+
| Card | nicknames | Section 2.5.6 |
+-------------------+---------------------+---------------------+
| Card | notes | Section 2.11.4 |
+-------------------+---------------------+---------------------+
| Card | onlineServices | Section 2.7.2 |
+-------------------+---------------------+---------------------+
| Card | organizations | Section 2.9.4 |
+-------------------+---------------------+---------------------+
| Card | personalInfo | Sections 2.10.1, |
| | | 2.10.2, and 2.10.3 |
+-------------------+---------------------+---------------------+
| Card | phones | Section 2.7.6 |
+-------------------+---------------------+---------------------+
| Card | preferredLanguages | Section 2.7.3 |
+-------------------+---------------------+---------------------+
| Card | prodId | Section 2.11.5 |
+-------------------+---------------------+---------------------+
| Card | relatedTo | Section 2.9.5 |
+-------------------+---------------------+---------------------+
| Card | schedulingAddresses | Section 2.13.1 |
+-------------------+---------------------+---------------------+
| Card | speakToAs | Section 2.5.4 |
+-------------------+---------------------+---------------------+
| Card | titles | Section 2.9.6 |
+-------------------+---------------------+---------------------+
| Card | uid | Section 2.11.8 |
+-------------------+---------------------+---------------------+
| Card | updated | Section 2.11.6 |
+-------------------+---------------------+---------------------+
| CryptoKey | @type | not applicable |
+-------------------+---------------------+---------------------+
| CryptoKey | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| CryptoKey | kind | not applicable |
+-------------------+---------------------+---------------------+
| CryptoKey | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| CryptoKey | mediaType | Section 2.3.14 |
+-------------------+---------------------+---------------------+
| CryptoKey | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| CryptoKey | uri | Section 2.12.1 |
+-------------------+---------------------+---------------------+
| Directory | @type | not applicable |
+-------------------+---------------------+---------------------+
| Directory | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Directory | kind | Sections 2.4.3 and |
| | | 2.10.4 |
+-------------------+---------------------+---------------------+
| Directory | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| Directory | listAs | Section 2.3.10 |
+-------------------+---------------------+---------------------+
| Directory | mediaType | Section 2.3.14 |
+-------------------+---------------------+---------------------+
| Directory | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Directory | uri | Sections 2.4.3 and |
| | | 2.10.4 |
+-------------------+---------------------+---------------------+
| EmailAddress | @type | not applicable |
+-------------------+---------------------+---------------------+
| EmailAddress | address | Section 2.7.1 |
+-------------------+---------------------+---------------------+
| EmailAddress | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| EmailAddress | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| EmailAddress | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| LanguagePref | @type | not applicable |
+-------------------+---------------------+---------------------+
| LanguagePref | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| LanguagePref | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Link | @type | not applicable |
+-------------------+---------------------+---------------------+
| Link | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Link | kind | Section 2.9.1 |
+-------------------+---------------------+---------------------+
| Link | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| Link | mediaType | Section 2.3.14 |
+-------------------+---------------------+---------------------+
| Link | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Link | uri | Sections 2.9.1 and |
| | | 2.11.9 |
+-------------------+---------------------+---------------------+
| Media | @type | not applicable |
+-------------------+---------------------+---------------------+
| Media | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Media | kind | Sections 2.5.7, |
| | | 2.9.2, and 2.11.7 |
+-------------------+---------------------+---------------------+
| Media | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| Media | mediaType | Section 2.3.14 |
+-------------------+---------------------+---------------------+
| Media | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Media | uri | Sections 2.5.7, |
| | | 2.9.2, and 2.11.7 |
+-------------------+---------------------+---------------------+
| Name | @type | not applicable |
+-------------------+---------------------+---------------------+
| Name | components | Sections 2.5.5 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Name | defaultSeparator | Sections 2.5.5 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Name | full | Section 2.5.2 |
+-------------------+---------------------+---------------------+
| Name | phoneticScript | Sections 2.3.15 and |
| | | 2.3.19 |
+-------------------+---------------------+---------------------+
| Name | phoneticSystem | Section 2.3.15 |
+-------------------+---------------------+---------------------+
| Name | isOrdered | Sections 2.5.5 and |
| | | 3.3.1 |
+-------------------+---------------------+---------------------+
| Name | sortAs | Section 2.3.21 |
+-------------------+---------------------+---------------------+
| NameComponent | @type | not applicable |
+-------------------+---------------------+---------------------+
| NameComponent | kind | Section 2.5.5 |
+-------------------+---------------------+---------------------+
| NameComponent | phonetic | Section 2.3.15 |
+-------------------+---------------------+---------------------+
| NameComponent | value | Section 2.5.5 |
+-------------------+---------------------+---------------------+
| Nickname | @type | not applicable |
+-------------------+---------------------+---------------------+
| Nickname | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Nickname | name | Section 2.5.5 |
+-------------------+---------------------+---------------------+
| Nickname | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Note | @type | not applicable |
+-------------------+---------------------+---------------------+
| Note | author | Sections 2.3.2 and |
| | | 2.3.3 |
+-------------------+---------------------+---------------------+
| Note | created | Section 2.3.6 |
+-------------------+---------------------+---------------------+
| Note | note | Section 2.11.4 |
+-------------------+---------------------+---------------------+
| OnlineService | @type | not applicable |
+-------------------+---------------------+---------------------+
| OnlineService | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| OnlineService | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| OnlineService | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| OnlineService | service | Section 2.3.20 |
+-------------------+---------------------+---------------------+
| OnlineService | uri | Sections 2.7.2 and |
| | | 2.7.5 |
+-------------------+---------------------+---------------------+
| OnlineService | user | Section 2.3.24 |
+-------------------+---------------------+---------------------+
| OrgUnit | @type | not applicable |
+-------------------+---------------------+---------------------+
| OrgUnit | name | Section 2.9.4 |
+-------------------+---------------------+---------------------+
| OrgUnit | sortAs | Section 2.3.21 |
+-------------------+---------------------+---------------------+
| Organization | @type | not applicable |
+-------------------+---------------------+---------------------+
| Organization | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Organization | name | Section 2.9.4 |
+-------------------+---------------------+---------------------+
| Organization | sortAs | Section 2.3.21 |
+-------------------+---------------------+---------------------+
| Organization | units | Section 2.9.4 |
+-------------------+---------------------+---------------------+
| PartialDate | @type | not applicable |
+-------------------+---------------------+---------------------+
| PartialDate | calendarScale | Section 2.3.4 |
+-------------------+---------------------+---------------------+
| PartialDate | day | Section 2.2.2 |
+-------------------+---------------------+---------------------+
| PartialDate | month | Section 2.2.2 |
+-------------------+---------------------+---------------------+
| PartialDate | year | Section 2.2.2 |
+-------------------+---------------------+---------------------+
| PatchObject | @type | not applicable |
+-------------------+---------------------+---------------------+
| PersonalInfo | @type | not applicable |
+-------------------+---------------------+---------------------+
| PersonalInfo | kind | Sections 2.10.1, |
| | | 2.10.2, and 2.10.3 |
+-------------------+---------------------+---------------------+
| PersonalInfo | listAs | Section 2.3.10 |
+-------------------+---------------------+---------------------+
| PersonalInfo | level | Section 2.3.13 |
+-------------------+---------------------+---------------------+
| PersonalInfo | value | Sections 2.10.1, |
| | | 2.10.2, and 2.10.3 |
+-------------------+---------------------+---------------------+
| Phone | @type | not applicable |
+-------------------+---------------------+---------------------+
| Phone | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Phone | features | Section 2.7.6 |
+-------------------+---------------------+---------------------+
| Phone | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| Phone | number | Section 2.7.6 |
+-------------------+---------------------+---------------------+
| Phone | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Pronouns | @type | not applicable |
+-------------------+---------------------+---------------------+
| Pronouns | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| Pronouns | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| Pronouns | pronouns | Section 2.5.4 |
+-------------------+---------------------+---------------------+
| Relation | @type | not applicable |
+-------------------+---------------------+---------------------+
| Relation | relation | Section 2.9.5 |
+-------------------+---------------------+---------------------+
| Resource | @type | not applicable |
+-------------------+---------------------+---------------------+
| SchedulingAddress | @type | not applicable |
+-------------------+---------------------+---------------------+
| SchedulingAddress | contexts | Section 2.3.22 |
+-------------------+---------------------+---------------------+
| SchedulingAddress | label | Section 2.11.11 |
+-------------------+---------------------+---------------------+
| SchedulingAddress | pref | Section 2.3.17 |
+-------------------+---------------------+---------------------+
| SchedulingAddress | uri | Section 2.13.1 |
+-------------------+---------------------+---------------------+
| SpeakToAs | @type | not applicable |
+-------------------+---------------------+---------------------+
| SpeakToAs | grammaticalGender | Section 2.5.4 |
+-------------------+---------------------+---------------------+
| SpeakToAs | pronouns | Section 2.5.4 |
+-------------------+---------------------+---------------------+
| AddressComponent | @type | not applicable |
+-------------------+---------------------+---------------------+
| AddressComponent | kind | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| AddressComponent | value | Section 2.6.1 |
+-------------------+---------------------+---------------------+
| Timestamp | @type | not applicable |
+-------------------+---------------------+---------------------+
| Timestamp | utc | Section 2.2.2 |
+-------------------+---------------------+---------------------+
| Title | @type | not applicable |
+-------------------+---------------------+---------------------+
| Title | kind | Section 2.9.6 |
+-------------------+---------------------+---------------------+
| Title | name | Section 2.9.6 |
+-------------------+---------------------+---------------------+
| Title | organizationId | Section 2.9.6 |
+-------------------+---------------------+---------------------+
Table 8: Conversion Rules for JSContact Types and Properties
表8：JSCONTACTタイプとプロパティの変換ルール
The definition and examples of the PHONETIC (Section 2.3.15) and SCRIPT (Section 2.3.19) parameters are based on the initial draft version of [vOBJECT].
音声（セクション2.3.15）およびスクリプト（セクション2.3.19）のパラメーターの定義と例は、[Vobject]の初期ドラフトバージョンに基づいています。
Mario Loffredo
IIT-CNR/Registro.it
Via Moruzzi, 1
56124 Pisa
Italy
Email: mario.loffredo@iit.cnr.it
URI: https://www.iit.cnr.it
Robert Stepanek
Fastmail
PO Box 234
Collins St. West
Melbourne VIC 8007
Australia
Email: rsto@fastmailteam.com
URI: https://www.fastmail.com