RFC4153 日本語訳
4153 XML Voucher: Generic Voucher Language. K. Fujimura, M. Terada, D.Eastlake 3rd. September 2005. (Format: TXT=41941 bytes) (Status: INFORMATIONAL)
プログラムでの自動翻訳です。
英語原文
Network Working Group K. Fujimura
Request for Comments: 4153 NTT
Category: Informational M. Terada
NTT DoCoMo
D. Eastlake 3rd
Motorola Laboratories
September 2005
コメントを求めるワーキンググループK.藤村の要求をネットワークでつないでください: 4153年のNTTカテゴリ: 2005年の情報のM.Terada NTTドコモD.イーストレークモトローラ研究所9月3日
XML Voucher: Generic Voucher Language
XMLバウチャー: ジェネリックバウチャー言語
Status of This Memo
このメモの状態
This memo provides information for the Internet community. It does not specify an Internet standard of any kind. Distribution of this memo is unlimited.
このメモはインターネットコミュニティのための情報を提供します。 それはどんな種類のインターネット標準も指定しません。 このメモの分配は無制限です。
Copyright Notice
版権情報
Copyright (C) The Internet Society (2005).
Copyright(C)インターネット協会(2005)。
Abstract
要約
This document specifies rules for defining voucher properties in XML syntax. A voucher is a logical entity that represents a right to claim goods or services. A voucher can be used to transfer a wide range of electronic values, including coupons, tickets, loyalty points, and gift certificates, which often have to be processed in the course of payment and/or delivery transactions.
このドキュメントはXML構文でバウチャーの特性を定義するための規則を指定します。 バウチャーは商品かサービスを要求する右を表す論理的な実体です。 さまざまな電子値を移すのにバウチャーを使用できます、支払い、そして/または、配送トランザクションの間にしばしば処理されなければならないクーポン、チケット、ロイヤルティポイント、および商品券を含んでいて。
Table of Contents
目次
1. Introduction ................................................. 2
2. Processing Model ............................................. 2
3. Trust Model .................................................. 4
4. Component Structure .......................................... 4
5. Syntax Overview and Examples ................................. 6
6. Syntax and Semantics ......................................... 8
6.1. <Voucher> ............................................... 8
6.2. <Title> ................................................. 9
6.3. <Description> ........................................... 9
6.4. <Provider> .............................................. 9
6.5. <Issuer> ................................................ 10
6.6. <Holder> ................................................ 10
6.7. <Collector> ............................................. 11
6.8. <Value> ................................................. 11
6.8.1. <Ratio> .......................................... 13
6.8.2. <Fixed> .......................................... 13
1. 序論… 2 2. 処理モデル… 2 3. 信頼はモデル化されます… 4 4. コンポーネント構造… 4 5. 構文概要と例… 6 6. 構文と意味論… 8 6.1. <バウチャー>… 8 6.2. <タイトル>… 9 6.3. <記述>… 9 6.4. <プロバイダー>… 9 6.5. <発行人>… 10 6.6. <所有者>… 10 6.7. <コレクタ>… 11 6.8. <値の>… 11 6.8.1. <比の>… 13 6.8.2. <は>を修理しました… 13
Fujimura, et al. Informational [Page 1] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[1ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
6.9. <Merchandise> ........................................... 14
6.10. <ValidPeriod> .......................................... 14
6.11. <Conditions> ........................................... 15
7. IANA Considerations .......................................... 15
8. VTS Schema Example ........................................... 18
9. Security Considerations ...................................... 18
10. Acknowledgements ............................................. 19
11. Normative References ......................................... 19
12. Informative References ....................................... 20
6.9. <商品>… 14 6.10. <ValidPeriod>… 14 6.11. <は>を条件とさせます… 15 7. IANA問題… 15 8. VTS図式の例… 18 9. セキュリティ問題… 18 10. 承認… 19 11. 標準の参照… 19 12. 有益な参照… 20
1. Introduction
1. 序論
This document specifies rules for defining voucher properties in XML syntax. The motivation and background of the specification are described in [VTS].
このドキュメントはXML構文でバウチャーの特性を定義するための規則を指定します。 仕様の動機とバックグラウンドは[VTS]で説明されます。
A voucher is a logical entity that represents a certain right and that is logically managed by the Voucher Trading System (VTS). A voucher is generated by the issuer, traded among users, and finally collected by the collector using VTS.
バウチャーはある右を表して、Voucher Trading Systemによって論理的に管理される論理的な実体(VTS)です。 VTSを使用することで発行人によって生成されて、ユーザの中で取り引きされて、コレクタは、バウチャーを迎えるのに最終的に行きます。
This document defines the syntax and semantics of the Voucher Component, which defines voucher meaning and processing rules in XML syntax [XML]. A Voucher Component defines the properties that must be satisfied to allow the voucher to be processed by VTS or other trading systems; e.g., a wallet or merchant system. VTS definitions and models are also defined in [VTS].
このドキュメントはVoucher Componentの構文と意味論を定義します。(Voucher ComponentはXML構文[XML]でバウチャー意味と処理規則を定義します)。 Voucher ComponentはバウチャーがVTSか他の取引システムによって処理されるのを許容するので満たさなければならない特性を定義します。 例えば、財布か商人システム。 また、VTS定義とモデルは[VTS]で定義されます。
Note: This document uses "voucher" as an "instance of voucher", whose meaning is defined by the Voucher Component. In other words, a Voucher Component is NOT a voucher, and multiple vouchers can be issued and managed by the VTS using the same Voucher Component.
以下に注意してください。 このドキュメントは意味がVoucher Componentによって定義される「バウチャーのインスタンス」として「バウチャー」を使用します。 言い換えれば、Voucher Componentがバウチャーでなく、同じVoucher Componentを使用することで、VTSは複数のバウチャーを発行して、対処できます。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]
キーワード“MUST"、「必須NOT」が「必要です」、“SHALL"、「」、“SHOULD"、「「推薦され」て、「5月」の、そして、「任意」のNOTは中で説明されるように本書では解釈されることであるべきです。[RFC2119]
2. Processing Model
2. 処理モデル
There are several ways of implementing VTS and technologies are continually changing. For discount coupons or event tickets, for example, the smartcard-based offline VTS is often preferred, whereas for bonds or securities, the centralized online VTS is preferred. It is impractical to define standard protocols for issuing, transferring, or redeeming vouchers at this time.
VTSを実装するいくつかの方法があります、そして、技術は絶えず変化します。 割引券かイベントチケットに関しては、集結されたオンラインVTSは債券か証券で好まれますが、例えば、スマートカードベースのオフラインVTSはしばしば好まれます。 このときバウチャーを発行するか、移すか、または身請けするために標準プロトコルを定義するのは非実用的です。
Fujimura, et al. Informational [Page 2] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[2ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
To provide implementation flexibility, this document assumes a modular wallet architecture that allows multiple VTSes to be added as plug-ins. In this architecture, instead of specifying a standard voucher transfer protocol, two specifications, Voucher Component and VTS-API, are standardized (Figure 1).
実装の柔軟性を提供するために、このドキュメントは複数のVTSesがプラグインとして加えるモジュールの財布アーキテクチャを仮定します。 このアーキテクチャでは、標準のバウチャー転送プロトコルを指定することの代わりに、2つの仕様(Voucher ComponentとVTS-API)が、標準化されます(図1)。
After the sender and receiver agree on which vouchers are to be traded and which VTS is to be used, the issuing system or wallet system requests the corresponding VTS plug-in to permit the issue, transfer, or redeem transactions to be performed via the VTS API. The VTS then rewrites the ownership of the vouchers using the VTS- specific protocol. Finally, a completion event is sent to the wallet systems or issuing/collecting systems.
送付者と受信機が使用されるためにどのバウチャーが取り引きされることになっているか、そして、VTSがどれであるかに同意した後に、発行システムか財布システムが、問題を可能にするか、移すか、またはVTS APIを通して実行されるためにトランザクションを救うよう対応するVTSプラグインに要求します。 そして、VTSは、VTSの特定のプロトコルを使用することでバウチャーの所有権を書き直します。 最終的に、完成イベントは、システムを財布システムに送るか、支給するか、または集めることです。
This document describes the Voucher Component specification. The VTS-API specification is defined in [VTS-API].
このドキュメントはVoucher Component仕様を説明します。 VTS-API仕様は[VTS-API]で定義されます。
Sender wallet/Issuing system Receiver wallet/Collecting system +---------------------------+ +---------------------------+ | | | | | | Voucher Component | | | | (Specifies VTS Provider and Promise) | | | |-------------------------------------------------------->| | | | | | | | | | Intention to receive and payment (option) | | | |<- - - - - - - - - - - - - - - - - - - - - - - - - - - - | | | | | | | | | | | | | | | | Issue/transfer/ VTS | | VTS Register | | | | redeem request plug-in | plug-in Listener(*1)| | | |------------------>| | | |<------------------| | | | (VTS-API) |<- - - - - - - ->| (VTS-API) | | | | | VTS-specific | | | | | | protocol if VTS | | | | | | is distributed | | | | | Result |<- - - - - - - ->| Notify(*2) | | | |<------------------| | | |------------------>| | +---------------------------+ +---------------------------+
送付者財布/発行システムReceiver財布/収集システム+---------------------------+ +---------------------------+ | | | | | | バウチャーコンポーネント| | | | (VTSプロバイダーと約束を指定します) | | | |-------------------------------------------------------->| | | | | | | | | | 受信するという意志と支払い(オプション)| | | | <、- - - - - - - - - - - - - - - - - - - - - - - - - - - - | | | | | | | | | | | | | | | | 問題/転送/VTS| | VTSは登録します。| | | | 要求プラグインを救ってください。| プラグインListener(*1)| | | |、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、>|、|、| | <、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、|、|、|、| (VTS-アピ) | <、- - - - - - - ->| (VTS-アピ) | | | | | VTS特有です。| | | | | | VTSであるなら、議定書を作ってください。| | | | | | 分配にされる| | | | | 結果| <、- - - - - - - ->| (*2)に通知してください。| | | | <、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、|、|、| |、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、-、--、>|、| +---------------------------+ +---------------------------+
(*1) Registration is optional. Note also that the VTS plug-ins are
usually pre-registered when the wallet or collecting system
is started.
(*1) 登録は任意です。 また、財布か収集システムが始動されるとき、通常、VTSプラグインがあらかじめ登録されることに注意してください。
(*2) If a listener is registered.
(*2)はリスナーであるなら登録されています。
Figure 1. Wallet architecture with VTS plug-ins
図1。 VTSプラグインがある財布アーキテクチャ
Fujimura, et al. Informational [Page 3] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[3ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
3. Trust Model
3. 信頼モデル
A voucher is trusted if the Issuer and VTS Provider are trusted, as the Issuer is responsible for the contents of the voucher and the VTS Provider is responsible for preventing ownership from being assigned to multiple users.
IssuerとVTS Providerが信じられるなら、バウチャーは信じられます、Issuerがバウチャーのコンテンツに責任があって、所有権が複数のユーザに割り当てられるのを防ぐのにVTS Providerは責任があるとき。
The trust level required for the Issuer and VTS Provider depends on the type (or Promise) of the voucher. To provide the information needed for verification, the conditions of the Issuer and VTS Provider are specified in the Voucher Component and given as input to the verifier; e.g., wallet system or other software. The trust of a voucher is thus verified through the Voucher Component. This model enables trading partners to verify their trust in the voucher regardless of their trust in the partners.
信頼レベルがIssuerに必要であり、VTS Providerはバウチャーのタイプ(または、Promise)に頼っています。 検証に必要である情報を提供するために、検証に入力されるようにIssuerとVTS Providerの状態をVoucher Componentで指定して、与えます。 例えば、財布システムか他のソフトウェア。 バウチャーの信頼はVoucher Componentを通してこのようにして確かめられます。 このモデルは、貿易相手国がパートナーのそれらの信頼にかかわらずバウチャーでそれらの信頼について確かめるのを可能にします。
This document assumes that the Voucher Component is the root of trust. If a malicious user could alter the Voucher Component, a forged voucher could be verified as valid.
このドキュメントは、Voucher Componentが信頼の根であると仮定します。 悪意あるユーザーがVoucher Componentを変更できるなら、有効を偽造バウチャーについて確かめることができるでしょうに。
When a Voucher Component is delivered from the trusted VTS Provider, Issuer, or trusted third party, a secure communication channel (e.g., [TLS], [IPSEC], or object security, such as [XMLDSIG]) should be used to prevent alteration during the delivery.
Voucher Componentが信じられたVTS Provider、Issuer、または信頼できる第三者機関から提供されるとき、安全な通信チャネル([XMLDSIG]などの例えば、[TLS]、[IPSEC]、またはオブジェクトセキュリティ)は、配送の間、変更を防ぐのに使用されるべきです。
Note: The Voucher Component does not have to be sent from the sender of the voucher. Note also that a set of trusted Voucher Components can be downloaded before a transaction is conducted.
以下に注意してください。 バウチャーの送付者からVoucher Componentを送る必要はありません。 また、トランザクションが行われる前に信じられたVoucher Componentsの1セットをダウンロードできることに注意してください。
4. Component Structure
4. コンポーネント構造
The Voucher Component provides the information needed to identify the monetary value or merchandize rendered when the voucher is redeemed. It includes
バウチャーを身請けするとき、Voucher Componentは金銭価値を特定するか、またはレンダリングされていた状態でmerchandizeするのに必要である情報を提供します。 それは含んでいます。
o how much value/items can be claimed in exchange for the voucher,
and
o そしてバウチャーと引き換えにどのくらいの値/項目を要求できるか。
o restrictions applied to the voucher
o バウチャーに適用された制限
- participants (VTS Provider, Issuer, Holder, and Collector),
- 関係者(VTS Provider、Issuer、Holder、およびCollector)
- objects (merchandise) to be claimed,
- 要求されるオブジェクト(商品)
- time when valid (validity period), and
- そして有効であり時間(有効期間)。
- others.
- 他のもの。
Fujimura, et al. Informational [Page 4] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[4ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
The Voucher Component also provides common properties useful for displaying and manipulating the contents of wallet systems. It includes the title and description of each voucher.
また、Voucher Componentは財布システムのコンテンツを表示して、操ることの役に立つ通有性を提供します。それはそれぞれのバウチャーのタイトルと記述を含んでいます。
The Voucher Component contains the following components:
Voucher Componentは以下のコンポーネントを含んでいます:
Title Component
タイトルコンポーネント
Provides the title of the voucher. This is mainly for listing the
entities stored in a wallet system.
バウチャーのタイトルを提供します。 これは、主に財布システムに保存された実体を記載するものです。
Description Component
記述コンポーネント
Provides a short description of the voucher. This is mainly for
listing the entities stored in a wallet system.
バウチャーの短い記述を提供します。 これは、主に財布システムに保存された実体を記載するものです。
Provider Component
プロバイダーコンポーネント
Provides restrictions on which VTS Provider (or VTS plug-in) can
be used for trading the voucher.
バウチャーを取り引きするのに、VTS Provider(または、VTSプラグイン)を使用できる制限を提供します。
Issuer Component
発行人コンポーネント
Provides restrictions on the Issuer of the voucher.
バウチャーのIssuerで制限を提供します。
Holder Component
所有者の部品
Provides restrictions on the Holder of the voucher.
バウチャーのHolderで制限を提供します。
Collector Component
コレクタコンポーネント
Provides restrictions on the Collector of the voucher.
バウチャーのCollectorで制限を提供します。
Value Component
値のコンポーネント
Provides the value of each voucher. There are two types of
values: fixed and ratio values. For a fixed value, the currency
and the figure is specified. For a ratio value, the discount
ratio of the corresponding merchandize is specified.
それぞれのバウチャーの値を提供します。 2つのタイプの値があります: 修理されるのと比率値。 一定の価値として、通貨と図は指定されます。 比率値として、対応の比率がmerchandizeする割り引きは指定されます。
The Value Component also indicates the number of vouchers to be
redeemed for claiming the merchandise or monetary value specified
in the Merchandise Component or Value Component. If "n" (>0) is
specified, the merchandize or monetary value can be claimed in
exchange for "n sheets of" vouchers. If "0" is specified, it can
be used repeatedly.
また、Value Componentは、商品か金銭価値がMerchandise ComponentかValue Componentで指定したと主張するために償却するためにバウチャーの数を示します。 と引き換えに、「n」(>0)が指定されるならmerchandizeする、金銭価値を要求できる、「」 n枚のバウチャー。 「0インチを指定して、繰り返してそれを使用できます。」
Fujimura, et al. Informational [Page 5] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[5ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
Merchandise Component
商品の部品
Provides restrictions on the object to be claimed. The domain-
specific meaning of the voucher (e.g., reference number of the
merchandize or seat number for an event ticket) is specified to
identify the merchandize rendered when the voucher is redeemed.
要求されるオブジェクトの上に制限を提供します。 バウチャーのドメインの特定の意味、(例えば、数に参照をつける、イベントチケットの数をmerchandizeするか、または着席させてください、)、特定するために指定される、merchandizeする、バウチャーを身請けするとき、レンダリングします。
ValidPeriod Component
ValidPeriodの部品
Provides restrictions on the validity period of the voucher; i.e.,
start date and end date.
バウチャーの有効期間に制限を提供します。 すなわち、日付と終了日を始めてください。
Condition Component
状態コンポーネント
Provides any other applicable restrictions. This is intended to
cover contracts between the issuer and holder of the voucher in
natural language form.
いかなる他の適切な制限も提供します。 これが自然言語フォームでバウチャーの発行人と所有者との契約をカバーすることを意図します。
Using the above Components, semantics for diverse types of vouchers can be defined as shown in Table 1.
上のComponentsを使用して、Table1に示されるようにさまざまのタイプのバウチャーのための意味論を定義できます。
+----------------+--------------------------------+---------------+ | | Value | Restrictions | | +-----+---------------+----------+---------------+ | Examples |Ratio| Fixed |Number | Merchandise | | | +------+--------+needed for| | | | |Amount|Currency|redemption| | +----------------+-----+------+--------+----------+---------------+ |Gift certificate| | 25 | USD | 1 |(Not specified)| |Loyalty point | | 1 | AUD | 10 |(Not specified)| |Member card | 20%| | | 0 |(Not specified)| |Coupon | 30%| | | 1 |Beef 500g | |Event ticket | 100%| | | 1 |Hall A, S ,K23 | |Exchange ticket | 100%| | | 1 |ISBN:0071355014| +----------------+-----+------+--------+----------+---------------+
+----------------+--------------------------------+---------------+ | | 値| 制限| | +-----+---------------+----------+---------------+ | 例|比率| 修理されています。|数| 商品| | | +------+--------+、必要です。| | | | |量|通貨|償却| | +----------------+-----+------+--------+----------+---------------+ |商品券| | 25 | U.S.ドル| 1 |(指定されません)| |ロイヤルティポイント| | 1 | アウド| 10 |(指定されません)| |メンバーカード| 20%| | | 0 |(指定されません)| |クーポン| 30%| | | 1 |500g不平を言ってください。| |イベントチケット| 100%| | | 1 |ホールA、S、K23| |商品券| 100%| | | 1 |ISBN: 0071355014| +----------------+-----+------+--------+----------+---------------+
Table 1. Examples of vouchers and their properties
1を見送ってください。 バウチャーに関する例と彼らの特性
5. Syntax Overview and Examples
5. 構文概要と例
This section provides an overview and examples of Voucher Components. The formal syntax and semantics are found in Sections 6 and 7.
このセクションはVoucher Componentsに関する概要と例を提供します。 正式な構文と意味論はセクション6と7で見つけられます。
Voucher Components are represented by the <Voucher> element, which has the following structure (where "?" denotes zero or one occurrence):
バウチャーComponentsは<Voucher>要素によって表されます:(要素には、以下の構造(“?"がゼロか1回の発生を指示するところ)があります)。
Fujimura, et al. Informational [Page 6] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[6ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
<Voucher>
(Title)
(Description)?
(Provider)
(Issuer)?
(Holder)?
(Collector)?
(Value)
(Merchandise)?
(ValidPeriod)?
(Conditions)?
</Voucher>
<バウチャー>(タイトル)(記述)? (プロバイダー) (発行人)? (所有者)? (コレクタ)? (値) (商品)? (ValidPeriod)? (状態)? </バウチャー>。
An example of a Voucher Component is described below. This is an example of a five-dollar discount coupon for specific merchandize, a book with ISBN number 0071355014. The coupon is valid from April 1, 2001, to March 31, 2002. To claim this offer, one voucher must be spent.
Voucher Componentに関する例は以下で説明されます。 これによる詳細のための5ドルの割引券に関する例がmerchandizeされて、ISBNがある本がNo.0071355014であるということです。 クーポンは2001年4月1日から2002年3月31日まで有効です。 この申し出を要求するために、1つのバウチャーを費やさなければなりません。
<?xml version="1.0" encoding="UTF-8"?>
<Voucher xmlns="urn:ietf:params:xml:ns:vts-lang"
xmlns:vts="http://www.example.com/vts">
<Title>IOTP Book Coupon</Title>
<Description>$5 off IOTP Book</Description>
<Provider name="Voucher Exchanger 2002">
<vts:Version>VE2.31</vts:Version>
</Provider>
<Issuer name="Alice Book Center, Ltd.">
<vts:KeyInfo>
1DA8DFCF95521014BBB7171B95545E8D61AE803F
</vts:KeyInfo>
</Issuer>
<Collector name="Alice Book Center, Ltd."/>
<Value type="discount" spend="1">
<Fixed amount="5" currency="USD"/>
</Value>
<Merchandise>
<bk:Book xmlns:bk="http://www.example.com/bk"
bk:isbn="0071355014"/>
</Merchandise>
<ValidPeriod start="2002-04-01" end="2003-03-31"/>
<Conditions>
The value of this coupon is subject to tax.
</Conditions>
</Voucher>
<?xmlバージョン=、「=「UTF-8インチ?」をコード化する1インチ><バウチャーxmlns=「つぼ:ietf:params:xml:ナノ秒: vts-lang」xmlns: vtsが等しい、「 http://www.example.com/vts 、「><Title>IOTP Book Coupon</は」 バウチャー記述>5ドルの取り止めになっているIOTP Book</記述><Providerが命名する><=Exchanger2002を「><はvtsされます: バージョン>VE2」と題をつけます; 31 </vts: <Valueタイプ=が「割り引く」バージョン>プロバイダー><Issuer名前=</「アリスBookセンターLtd.「><vts: KeyInfo>1DA8DFCF95521014BBB7171B95545E8D61AE803F</vts: KeyInfo></発行人><Collector名=」アリスBookセンターLtd.」/>は「U.S.ドル」/></価値の><Merchandise><=「1インチの><Fixed量=」の5インチの通貨=Bkを費やします:; 本のxmlns: Bkは" http://www.example.com/bk "Bkと等しいです: 「0071355014」/></商品><isbn=ValidPeriodはこのクーポンの値が課税対象になる=「2002年4月1日」「2003年3月31日」/>エンド=<Conditions>を始動します。 </状態></バウチャー>。
Fujimura, et al. Informational [Page 7] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[7ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
6. Syntax and Semantics
6. 構文と意味論
The general structure of an XML Voucher Component is described in Section 4. This section details the Voucher Component features. Features described in this section MUST be implemented unless otherwise indicated. The syntax is defined via [XML-Schema-1] [XML-Schema-2]. For clarity, unqualified elements in schema definitions are in the XML schema namespace:
XML Voucher Componentの一般構造体はセクション4で説明されます。 このセクションはVoucher Componentの特徴を詳しく述べます。 別の方法で示されない場合、このセクションで説明された特徴を実装しなければなりません。 構文は[XML図式1]を通して定義されます[XML図式2]。 明快ために、XML図式名前空間には図式定義における資格のない要素があります:
xmlns="http://www.w3.org/2001/XMLSchema"
xmlnsは" http://www.w3.org/2001/XMLSchema "と等しいです。
References to XML Voucher schema defined herein use the prefix "gvl" and are in the namespace:
ここに定義されたXML Voucher図式の参照は、接頭語"gvl"を使用して、名前空間にはあります:
xmlns:gvl="urn:ietf:params:xml:ns:vts-lang"
xmlns: gvlは「つぼ:ietf:params:xml:ナノ秒: vts-lang」と等しいです。
This namespace URI for elements defined by this document is a URN [URN] that uses the namespace identifier 'ietf', defined by [URN-NS-IETF] and extended by [XML-Registry].
このドキュメントによって定義された要素のためのこの名前空間URIは[URN-NS-IETF]によって定義されて、[XML-登録]によって広げられた'ietf'という名前空間識別子を使用するURN[URN]です。
This namespace is also used for unqualified elements in voucher examples.
また、この名前空間はバウチャーの例の資格のない要素に使用されます。
6.1. <Voucher>
6.1. <バウチャー>。
The <Voucher> element contains <Title>, <Provider>, and <Value> elements and optionally contains <Description>, <Issuer>, <Holder>, <Collector>, <ValidPeriod>, and <Condition> elements. These sub- elements are defined in the following sections.
<Voucher>要素は、<Title>、<Provider>、および<Value>要素を含んでいて、任意に<記述>、<Issuer>、<Holder>、<Collector>、<ValidPeriod>、および<Condition>要素を含んでいます。 これらのサブ要素は以下のセクションで定義されます。
The <Voucher> element is defined by the following schema:
<Voucher>要素は以下の図式によって定義されます:
<element name="Voucher" type="gvl:VoucherType"/>
<complexType name="VoucherType">
<sequence>
<element ref="gvl:Title"/>
<element ref="gvl:Description" minOccurs="0"/>
<element ref="gvl:Provider"/>
<element ref="gvl:Issuer" minOccurs="0"/>
<element ref="gvl:Holder" minOccurs="0"/>
<element ref="gvl:Collector" minOccurs="0"/>
<element ref="gvl:Value"/>
<element ref="gvl:Merchandise" minOccurs="0"/>
<element ref="gvl:ValidPeriod" minOccurs="0"/>
<element ref="gvl:Conditions" minOccurs="0"/>
</sequence>
</complexType>
<要素名義の=「バウチャー」タイプが「gvl: VoucherType」/><complexType名=と等しい、「VoucherType、「><系列><要素審判=「gvl: タイトル」/><要素審判=「gvl: 記述」minOccurs=、「0インチ/>の<要素審判=「gvl: プロバイダー」/><要素審判=「gvl: 発行人」minOccursは「0インチ/>の<要素審判は「gvl: 所有者」と等しいこと」と等しいです; minOccursが等しい、「0インチ/>の<要素審判=「gvl: コレクタ」minOccursが等しい、「0インチ/>の<要素審判=「gvl: 値」/><要素審判=「gvl: 商品」minOccursが等しい、「0インチ/>の<要素審判=「gvl: ValidPeriod」minOccursが等しい、「0インチ/>の<要素審判=「gvl: 状態」minOccursは「0インチ/>の</系列></complexType>」と等しいです。
Fujimura, et al. Informational [Page 8] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[8ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
6.2. <Title>
6.2. <タイトル>。
The <Title> element contains a simpletext title of the voucher. This is mainly for listing the entities stored in a wallet system.
<Title>要素はバウチャーのsimpletextタイトルを含んでいます。 これは、主に財布システムに保存された実体を記載するものです。
The <Title> element has no attribute.
<Title>要素には、属性が全くありません。
The <Title> element is defined by the following schema:
<Title>要素は以下の図式によって定義されます:
<element name="Title" type="string"/>
<要素名前=「タイトル」タイプは「ストリング」/>と等しいです。
6.3. <Description>
6.3. <記述>。
The <Description> element contains a simpletext description of the voucher. This is mainly for listing the entities stored in a wallet system.
<記述>要素はバウチャーのsimpletext記述を含んでいます。 これは、主に財布システムに保存された実体を記載するものです。
The <Description> element has no attribute.
<記述>要素には、属性が全くありません。
The <Description> element is defined by the following schema:
<記述>要素は以下の図式によって定義されます:
<element name="Description" type="string"/>
<要素名前=「記述」タイプは「ストリング」/>と等しいです。
6.4. <Provider>
6.4. <プロバイダー>。
The <Provider> element may contain any element that is used to specify or restrict the VTS Provider of the voucher. The sub- elements contained in this element depend on the implementation of the VTS.
<Provider>要素はバウチャーのVTS Providerを指定するか、または制限するのに使用されるどんな要素も含むかもしれません。 この要素に含まれたサブ要素はVTSの実装に依存します。
An implementation of a wallet system may use this information to identify and/or authenticate the VTS Provider when the VTS plug-in is registered (see Section 7 of [VTS-API]). These implementation- specific elements of the VTS can be extended using [XML-ns]. An example of such a schema definition is described in Section 8.
財布システムの実装は、VTSプラグインが登録されているとき([VTS-API]のセクション7を見てください)、VTS Providerを特定する、そして/または、認証するのにこの情報を使用するかもしれません。 [XML-ナノ秒]を使用することでVTSのこれらの実装の特定の要素について敷衍できます。 そのような図式定義に関する例はセクション8で説明されます。
The <Provider> element has a string-type "name" attribute that is used to specify the name of the VTS Provider.
<Provider>要素には、VTS Providerという名前を指定するのに使用されるストリングタイプ「名前」属性があります。
The <Provider> element is defined by the following schema:
<Provider>要素は以下の図式によって定義されます:
<element name="Provider" type="gvl:RoleType"/>
<complexType name="RoleType" mixed="true">
<sequence>
<any namespace="##any" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="name" type="string"/>
</complexType>
「<要素名義の=「プロバイダー」タイプ=「gvl: RoleType」/><complexType名=の"RoleType"が=を混ぜた、「本当である、「><系列><、」 」 どんな名前空間も=##いずれもminOccursが「0インチのmaxOccurs=」と等しい、限りなさ、」 /></系列><属性名前=「名前」タイプは「ストリング」/></complexType>と等しいです。
Fujimura, et al. Informational [Page 9] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[9ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
6.5. <Issuer>
6.5. <発行人>。
The <Issuer> element may contain any element that is used to specify or restrict the Issuer of the voucher.
<Issuer>要素はバウチャーのIssuerを指定するか、または制限するのに使用されるどんな要素も含むかもしれません。
The Issuer of the voucher is generally managed by the VTS [VTS-API]. There is no need to specify the Issuer of the voucher using this element if there are no restrictions on the Issuer.
一般に、バウチャーのIssuerはVTS[VTS-API]によって管理されます。 制限が全くIssuerになければこの要素を使用することでバウチャーのIssuerを指定する必要は全くありません。
An implementation of a VTS may use this element to describe the authentication data and/or qualification information of the Issuer. This implementation-specific information can be extended through sub-elements using [XML-ns]. An example of such a schema definition is described in Section 8.
VTSの実装は、Issuerの認証データ、そして/または、資格情報について説明するのにこの要素を使用するかもしれません。 下位要素を通して[XML-ナノ秒]を使用することでこの実装特殊情報を広げることができます。 そのような図式定義に関する例はセクション8で説明されます。
The <Issuer> element has a string-type "name" attribute that is used to specify the name of the Issuer.
<Issuer>要素には、Issuerという名前を指定するのに使用されるストリングタイプ「名前」属性があります。
The <Issuer> element is defined by the following schema:
<Issuer>要素は以下の図式によって定義されます:
<element name="Issuer" type="gvl:RoleType"/>
<要素名前=「発行人」タイプは「gvl: RoleType」/>と等しいです。
The <RoleType> element type is defined in Section 6.4.
<RoleType>要素型はセクション6.4で定義されます。
If the <Issuer> element is omitted, it MUST be interpreted that there are no restrictions on the Issuer.
>要素は<Issuerであるなら省略されて、それを解釈しなければなりません。制限が全くIssuerにありません。
6.6. <Holder>
6.6. <所有者>。
The <Holder> element may contain any element that is used to specify or restrict the Holder of the voucher.
<Holder>要素はバウチャーのHolderを指定するか、または制限するのに使用されるどんな要素も含むかもしれません。
The Holder of the voucher is generally managed by the VTS [VTS-API]. There is no need to specify the Holder of the voucher using this element if there are no restrictions on the Holder.
一般に、バウチャーのHolderはVTS[VTS-API]によって管理されます。 制限が全くHolderになければこの要素を使用することでバウチャーのHolderを指定する必要は全くありません。
An implementation of a VTS may use this element to describe the authentication data and/or qualification information of the Holder. This implementation-specific information can be extended through sub-elements using [XML-ns].
VTSの実装は、Holderの認証データ、そして/または、資格情報について説明するのにこの要素を使用するかもしれません。 下位要素を通して[XML-ナノ秒]を使用することでこの実装特殊情報を広げることができます。
The <Holder> element has a string-type "name" attribute that is used to specify the name of the Holder.
<Holder>要素には、Holderという名前を指定するのに使用されるストリングタイプ「名前」属性があります。
Fujimura, et al. Informational [Page 10] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[10ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
The <Holder> element is defined by the following schema:
<Holder>要素は以下の図式によって定義されます:
<element name="Holder" type="gvl:RoleType"/>
<要素名前=「所有者」タイプは「gvl: RoleType」/>と等しいです。
The <RoleType> element type is defined in Section 6.4.
<RoleType>要素型はセクション6.4で定義されます。
If the <Holder> element is omitted, it MUST be interpreted that there are no restrictions on the Holder.
>要素は<Holderであるなら省略されて、それを解釈しなければなりません。制限が全くHolderにありません。
6.7. <Collector>
6.7. <コレクタ>。
The <Collector> element may contain any element that is used to specify or restrict the Collector of the voucher.
<Collector>要素はバウチャーのCollectorを指定するか、または制限するのに使用されるどんな要素も含むかもしれません。
There is no need to specify the Collector of the voucher using this element if there are no restrictions on the Collector.
制限が全くCollectorになければこの要素を使用することでバウチャーのCollectorを指定する必要は全くありません。
An implementation of a VTS may use this element to describe the authentication data and/or qualification information of the Collector. This implementation-specific information can be extended through sub-elements using [XML-ns].
VTSの実装は、Collectorの認証データ、そして/または、資格情報について説明するのにこの要素を使用するかもしれません。 下位要素を通して[XML-ナノ秒]を使用することでこの実装特殊情報を広げることができます。
The <Collector> element has a string-type "name" attribute that is used to specify the name of the Collector.
<Collector>要素には、Collectorという名前を指定するのに使用されるストリングタイプ「名前」属性があります。
The <Collector> element is defined by the following schema:
<Collector>要素は以下の図式によって定義されます:
<element name="Collector" type="gvl:RoleType"/>
<要素名前=「コレクタ」タイプは「gvl: RoleType」/>と等しいです。
The <RoleType> element type is defined in Section 6.4.
<RoleType>要素型はセクション6.4で定義されます。
If the <Collector> element is omitted, it MUST be interpreted that there are no restrictions on the Collector.
>要素は<Collectorであるなら省略されて、それを解釈しなければなりません。制限が全くCollectorにありません。
6.8. <Value>
6.8. <値の>。
The <Value> element optionally contains a <Fixed> or <Ratio> element but not both. These sub-elements are defined in the following sections.
<Value>要素は、任意に<Fixed>か<Ratio>要素を含んでいますが、ともに含むというわけではありません。 これらの下位要素は以下のセクションで定義されます。
The <Value> element has a "type" attribute that is used to specify the value process type. This attribute is provided to calculate the amount paid when the vouchers are redeemed at Merchant site, etc.
<Value>要素には、値のプロセスタイプを指定するのに使用される「タイプ」属性があります。 マーチャントサイトなどでバウチャーを身請けするとき、払込金額について計算するためにこの属性を提供します。
Fujimura, et al. Informational [Page 11] RFC 4153 XML Voucher: Generic Voucher Language September 2005
藤村、他 情報[11ページ]のRFC4153XMLバウチャー: ジェネリックバウチャー言語2005年9月
The following identifiers are defined for the "type" attribute.
以下の識別子は「タイプ」属性のために定義されます。
Exchange: Items specified in the <Merchandise> element can be claimed
in exchange for the voucher. If this type is selected, neither
the <Ratio> nor the <Fixed> element MUST be specified. Note that
this value process type has the same meaning as:
交換: バウチャーと引き換えに<Merchandise>要素で指定された項目は要求できます。 このタイプが選ばれるなら、<Ratio>も<Fixed>要素も指定してはいけません。 この値のプロセスタイプには以下と同じ意味があることに注意してください。
<Value type="discount"><Ratio percentage="100"/></Value>
<Value type="discount"><Ratio percentage="100"/></Value>
Discount: Items specified in the <Merchandise> element can be
purchased at the discount price calculated by the <Ratio> or
<Fixed> element.
Discount: Items specified in the <Merchandise> element can be purchased at the discount price calculated by the <Ratio> or <Fixed> element.
Monetary: Items specified in the <Merchandise> element can be
purchased using the value of the voucher. (Note: if the
<Merchandise> element is not specified, the voucher can be used
for any purchase.) If this type is selected, the <Fixed> element
MUST be specified.
Monetary: Items specified in the <Merchandise> element can be purchased using the value of the voucher. (Note: if the <Merchandise> element is not specified, the voucher can be used for any purchase.) If this type is selected, the <Fixed> element MUST be specified.
The <Value> element also has a "spend" attribute that is used to specify the number of vouchers to be redeemed for claiming the goods, services, or monetary value specified. For example, if "n" (>0) is specified, goods can be claimed in exchange for "n sheets of" vouchers. (Note: Multiple vouchers for the same Voucher Component must exist in this case.) If "0" is specified, it can be used repeatedly.
The <Value> element also has a "spend" attribute that is used to specify the number of vouchers to be redeemed for claiming the goods, services, or monetary value specified. For example, if "n" (>0) is specified, goods can be claimed in exchange for "n sheets of" vouchers. (Note: Multiple vouchers for the same Voucher Component must exist in this case.) If "0" is specified, it can be used repeatedly.
If the "spend" attribute or the whole element is omitted, it MUST be interpreted that "1" is specified for the "spend" attribute.
If the "spend" attribute or the whole element is omitted, it MUST be interpreted that "1" is specified for the "spend" attribute.
The <Value> element is defined by the following schema:
The <Value> element is defined by the following schema:
<element name="Value" type="gvl:ValueType"/>
<complexType name="ValueType">
<sequence minOccurs="0">
<choice>
<element name="Ratio" type="gvl:RatioValueType"/>
<element name="Fixed" type="gvl:FixedValueType"/>
</choice>
</sequence>
<attribute name="type" type="gvl:ValueProcessType"
use="required"/>
<attribute name="spend" type="nonNegativeInteger"
default="1"/>
</complexType>
<element name="Value" type="gvl:ValueType"/> <complexType name="ValueType"> <sequence minOccurs="0"> <choice> <element name="Ratio" type="gvl:RatioValueType"/> <element name="Fixed" type="gvl:FixedValueType"/> </choice> </sequence> <attribute name="type" type="gvl:ValueProcessType" use="required"/> <attribute name="spend" type="nonNegativeInteger" default="1"/> </complexType>
Fujimura, et al. Informational [Page 12] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 12] RFC 4153 XML Voucher: Generic Voucher Language September 2005
The <ValueProcessType> element type is defined by the following schema:
The <ValueProcessType> element type is defined by the following schema:
<simpleType name="ValueProcessType">
<restriction base="string">
<enumeration value="exchange"/>
<enumeration value="discount"/>
<enumeration value="monetary"/>
</restriction>
</simpleType>
<simpleType name="ValueProcessType"> <restriction base="string"> <enumeration value="exchange"/> <enumeration value="discount"/> <enumeration value="monetary"/> </restriction> </simpleType>
6.8.1. <Ratio>
6.8.1. <Ratio>
The <Ratio> element does not contain any contents.
The <Ratio> element does not contain any contents.
The <Ratio> element has a "percentage" attribute that is used to specify the discount ratio of the price of the corresponding merchandize in percentage.
The <Ratio> element has a "percentage" attribute that is used to specify the discount ratio of the price of the corresponding merchandize in percentage.
The <RatioValueType> element type is defined by the following schema:
The <RatioValueType> element type is defined by the following schema:
<complexType name="RatioValueType">
<attribute name="percentage" use="required">
<simpleType>
<restriction base="float">
<maxInclusive value="100"/>
</restriction>
</simpleType>
</attribute>
</complexType>
<complexType name="RatioValueType"> <attribute name="percentage" use="required"> <simpleType> <restriction base="float"> <maxInclusive value="100"/> </restriction> </simpleType> </attribute> </complexType>
6.8.2. <Fixed>
6.8.2. <Fixed>
The <Fixed> element does not contain any contents.
The <Fixed> element does not contain any contents.
The <Fixed> element has "currency" and "amount" attributes and optionally a "decimalPower" attribute as follows:
The <Fixed> element has "currency" and "amount" attributes and optionally a "decimalPower" attribute as follows:
Currency: Provides the unit of the monetary value in the three letter
ISO currency code [ISO4217]. For example, US dollars is "USD".
Currency: Provides the unit of the monetary value in the three letter ISO currency code [ISO4217]. For example, US dollars is "USD".
Amount: Provides the amount of the monetary value per voucher.
Amount: Provides the amount of the monetary value per voucher.
DecimalPower: Provides the number of decimal digits from the decimal
point applied to the base for the "amount" attribute above. If
the "decimalPower" attribute is omitted, it MUST be interpreted
that "0" is specified for the "decimalPower" attribute.
DecimalPower: Provides the number of decimal digits from the decimal point applied to the base for the "amount" attribute above. If the "decimalPower" attribute is omitted, it MUST be interpreted that "0" is specified for the "decimalPower" attribute.
Fujimura, et al. Informational [Page 13] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 13] RFC 4153 XML Voucher: Generic Voucher Language September 2005
For example, with a dollar currency denominated in cents, "1" is specified for the "amount" attribute, and "-2" is specified for the "decimalPower" attribute. Alternately, "0.01" is specified for the "amount" attribute, and the "decimalPower" attribute is omitted.
For example, with a dollar currency denominated in cents, "1" is specified for the "amount" attribute, and "-2" is specified for the "decimalPower" attribute. Alternately, "0.01" is specified for the "amount" attribute, and the "decimalPower" attribute is omitted.
The <FixedValueType> type is defined follows:
The <FixedValueType> type is defined follows:
<complexType name="FixedValueType">
<attribute name="currency" type="string" use="required"/>
<attribute name="amount" type="float" use="required"/>
<attribute name="decimalPower" type="short" default="0"/>
</complexType>
<complexType name="FixedValueType"> <attribute name="currency" type="string" use="required"/> <attribute name="amount" type="float" use="required"/> <attribute name="decimalPower" type="short" default="0"/> </complexType>
6.9. <Merchandise>
6.9. <Merchandise>
The <Merchandise> element may contain any element used to specify or restrict the goods or services rendered when the voucher is redeemed. The sub-elements contained in this element depend on the application of the voucher and are left to the other domain-specific specifications. Domain-specific elements can be extended as sub- elements using [XML-ns].
The <Merchandise> element may contain any element used to specify or restrict the goods or services rendered when the voucher is redeemed. The sub-elements contained in this element depend on the application of the voucher and are left to the other domain-specific specifications. Domain-specific elements can be extended as sub- elements using [XML-ns].
This element is intended to be interpreted by a collecting system. An implementation of a wallet system does not have to use this element. Any restrictions applied should also be described in the <Description> element or the <Conditions> elements in natural language form to enable users to check the restrictions.
This element is intended to be interpreted by a collecting system. An implementation of a wallet system does not have to use this element. Any restrictions applied should also be described in the <Description> element or the <Conditions> elements in natural language form to enable users to check the restrictions.
The <Merchandise> element does not have any attribute.
The <Merchandise> element does not have any attribute.
The <Merchandise> element is defined by the following schema:
The <Merchandise> element is defined by the following schema:
<element name="Merchandise" type="gvl:MerchandiseType"/>
<complexType name="MerchandiseType" mixed="true">
<sequence>
<any namespace="##any" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
<element name="Merchandise" type="gvl:MerchandiseType"/> <complexType name="MerchandiseType" mixed="true"> <sequence> <any namespace="##any" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType>
6.10. <ValidPeriod>
6.10. <ValidPeriod>
The <ValidPeriod> element does not contain any contents.
The <ValidPeriod> element does not contain any contents.
The <ValidPeriod> element has dateTime-type "start" and "end" attributes that are used to place limits on the validity of the voucher.
The <ValidPeriod> element has dateTime-type "start" and "end" attributes that are used to place limits on the validity of the voucher.
Fujimura, et al. Informational [Page 14] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 14] RFC 4153 XML Voucher: Generic Voucher Language September 2005
The <ValidPeriod> element is defined by the following schema:
The <ValidPeriod> element is defined by the following schema:
<element name="ValidPeriod" type="gvl:ValidPeriodType"/>
<complexType name="ValidPeriodType">
<attribute name="start" type="dateTime"/>
<attribute name="end" type="dateTime"/>
</complexType>
<element name="ValidPeriod" type="gvl:ValidPeriodType"/> <complexType name="ValidPeriodType"> <attribute name="start" type="dateTime"/> <attribute name="end" type="dateTime"/> </complexType>
If the "start" attribute is omitted, it MUST be interpreted that the voucher is valid on any date up to that specified by the end attribute (inclusive). If the "end" attribute is omitted, it MUST be interpreted that the voucher is valid from the start attribute with no expiry. If neither attribute is specified or the whole element is omitted, it MUST be interpreted that the voucher is valid at any time.
If the "start" attribute is omitted, it MUST be interpreted that the voucher is valid on any date up to that specified by the end attribute (inclusive). If the "end" attribute is omitted, it MUST be interpreted that the voucher is valid from the start attribute with no expiry. If neither attribute is specified or the whole element is omitted, it MUST be interpreted that the voucher is valid at any time.
6.11. <Conditions>
6.11. <Conditions>
The <Conditions> element contains any other restrictions or conditions applied. This is intended to cover contracts between the issuer and the holder of the voucher in natural language form.
The <Conditions> element contains any other restrictions or conditions applied. This is intended to cover contracts between the issuer and the holder of the voucher in natural language form.
An implementation of a wallet system SHOULD provide a means of displaying the text in this element.
An implementation of a wallet system SHOULD provide a means of displaying the text in this element.
The <Conditions> element has no attribute.
The <Conditions> element has no attribute.
The <Conditions> element is defined by the following schema:
The <Conditions> element is defined by the following schema:
<element name="Conditions" type="string"/>
<element name="Conditions" type="string"/>
7. IANA Considerations
7. IANA Considerations
This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [XML-Registry]. IANA has registered two URI assignments.
This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [XML-Registry]. IANA has registered two URI assignments.
Registration request for the vts-lang namespace:
Registration request for the vts-lang namespace:
URI: urn:ietf:params:xml:ns:vts-lang
URI: urn:ietf:params:xml:ns:vts-lang
Registrant Contact: See the "Authors' Addresses" section of this document.
Registrant Contact: See the "Authors' Addresses" section of this document.
XML: None. Namespace URIs do not represent an XML specification.
XML: None. Namespace URIs do not represent an XML specification.
Fujimura, et al. Informational [Page 15] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 15] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Registration request for the vts-lang XML schema:
Registration request for the vts-lang XML schema:
URI: urn:ietf:params:xml:schema:vts-lang
URI: urn:ietf:params:xml:schema:vts-lang
Registrant Contact: See the "Authors' Addresses" section of this document.
Registrant Contact: See the "Authors' Addresses" section of this document.
XML:
BEGIN
<?xml version="1.0" encoding="UTF-8"?>
XML: BEGIN <?xml version="1.0" encoding="UTF-8"?>
<schema
targetNamespace="urn:ietf:params:xml:ns:vts-lang"
xmlns:gvl="urn:ietf:params:xml:ns:vts-lang"
xmlns="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<schema targetNamespace="urn:ietf:params:xml:ns:vts-lang" xmlns:gvl="urn:ietf:params:xml:ns:vts-lang" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="Voucher" type="gvl:VoucherType"/>
<complexType name="VoucherType">
<sequence>
<element ref="gvl:Title"/>
<element ref="gvl:Description" minOccurs="0"/>
<element ref="gvl:Provider"/>
<element ref="gvl:Issuer" minOccurs="0"/>
<element ref="gvl:Holder" minOccurs="0"/>
<element ref="gvl:Collector" minOccurs="0"/>
<element ref="gvl:Value"/>
<element ref="gvl:Merchandise" minOccurs="0"/>
<element ref="gvl:ValidPeriod" minOccurs="0"/>
<element ref="gvl:Conditions" minOccurs="0"/>
</sequence>
</complexType>
<element name="Voucher" type="gvl:VoucherType"/> <complexType name="VoucherType"> <sequence> <element ref="gvl:Title"/> <element ref="gvl:Description" minOccurs="0"/> <element ref="gvl:Provider"/> <element ref="gvl:Issuer" minOccurs="0"/> <element ref="gvl:Holder" minOccurs="0"/> <element ref="gvl:Collector" minOccurs="0"/> <element ref="gvl:Value"/> <element ref="gvl:Merchandise" minOccurs="0"/> <element ref="gvl:ValidPeriod" minOccurs="0"/> <element ref="gvl:Conditions" minOccurs="0"/> </sequence> </complexType>
<element name="Title" type="string"/>
<element name="Title" type="string"/>
<element name="Description" type="string"/>
<element name="Description" type="string"/>
<element name="Provider" type="gvl:RoleType"/>
<element name="Issuer" type="gvl:RoleType"/>
<element name="Holder" type="gvl:RoleType"/>
<element name="Collector" type="gvl:RoleType"/>
<complexType name="RoleType" mixed="true">
<sequence>
<any namespace="##any" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="name" type="string"/>
</complexType>
<element name="Provider" type="gvl:RoleType"/> <element name="Issuer" type="gvl:RoleType"/> <element name="Holder" type="gvl:RoleType"/> <element name="Collector" type="gvl:RoleType"/> <complexType name="RoleType" mixed="true"> <sequence> <any namespace="##any" minOccurs="0" maxOccurs="unbounded"/> </sequence> <attribute name="name" type="string"/> </complexType>
Fujimura, et al. Informational [Page 16] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 16] RFC 4153 XML Voucher: Generic Voucher Language September 2005
<element name="Value" type="gvl:ValueType"/>
<complexType name="ValueType">
<sequence minOccurs="0">
<choice>
<element name="Ratio" type="gvl:RatioValueType"/>
<element name="Fixed" type="gvl:FixedValueType"/>
</choice>
</sequence>
<attribute name="type" type="gvl:ValueProcessType"
use="required"/>
<attribute name="spend" type="nonNegativeInteger"
default="1"/>
</complexType>
<element name="Value" type="gvl:ValueType"/> <complexType name="ValueType"> <sequence minOccurs="0"> <choice> <element name="Ratio" type="gvl:RatioValueType"/> <element name="Fixed" type="gvl:FixedValueType"/> </choice> </sequence> <attribute name="type" type="gvl:ValueProcessType" use="required"/> <attribute name="spend" type="nonNegativeInteger" default="1"/> </complexType>
<simpleType name="ValueProcessType">
<restriction base="string">
<enumeration value="exchange"/>
<enumeration value="discount"/>
<enumeration value="monetary"/>
</restriction>
</simpleType>
<simpleType name="ValueProcessType"> <restriction base="string"> <enumeration value="exchange"/> <enumeration value="discount"/> <enumeration value="monetary"/> </restriction> </simpleType>
<complexType name="RatioValueType">
<attribute name="percentage" use="required">
<simpleType>
<restriction base="float">
<maxInclusive value="100"/>
</restriction>
</simpleType>
</attribute>
</complexType>
<complexType name="RatioValueType"> <attribute name="percentage" use="required"> <simpleType> <restriction base="float"> <maxInclusive value="100"/> </restriction> </simpleType> </attribute> </complexType>
<complexType name="FixedValueType">
<attribute name="currency" type="string" use="required"/>
<attribute name="amount" type="float" use="required"/>
<attribute name="decimalPower" type="short" default="0"/>
</complexType>
<complexType name="FixedValueType"> <attribute name="currency" type="string" use="required"/> <attribute name="amount" type="float" use="required"/> <attribute name="decimalPower" type="short" default="0"/> </complexType>
<element name="Merchandise" type="gvl:MerchandiseType"/>
<complexType name="MerchandiseType" mixed="true">
<sequence>
<any namespace="##any" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
<element name="Merchandise" type="gvl:MerchandiseType"/> <complexType name="MerchandiseType" mixed="true"> <sequence> <any namespace="##any" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType>
<element name="ValidPeriod" type="gvl:ValidPeriodType"/>
<complexType name="ValidPeriodType">
<attribute name="start" type="dateTime"/>
<element name="ValidPeriod" type="gvl:ValidPeriodType"/> <complexType name="ValidPeriodType"> <attribute name="start" type="dateTime"/>
Fujimura, et al. Informational [Page 17] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 17] RFC 4153 XML Voucher: Generic Voucher Language September 2005
<attribute name="end" type="dateTime"/>
</complexType>
<attribute name="end" type="dateTime"/> </complexType>
<element name="Conditions" type="string"/>
</schema>
END
<element name="Conditions" type="string"/> </schema> END
8. VTS Schema Example
8. VTS Schema Example
An example of the schema definition for a VTS implementation is described below.
An example of the schema definition for a VTS implementation is described below.
<?xml version="1.0"?>
<?xml version="1.0"?>
<schema
targetNamespace="http://www.example.com/vts"
xmlns:vts="http://www.example.com/vts"
xmlns="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<schema targetNamespace="http://www.example.com/vts" xmlns:vts="http://www.example.com/vts" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<element name="Version" type="string"/>
<element name="KeyInfo" type="hexBinary"/>
</schema>
<element name="Version" type="string"/> <element name="KeyInfo" type="hexBinary"/> </schema>
Using this schema definition, the <vts:Version> can be used for specifying the VTS version number, and the <vts:KeyInfo> element can be used for specifying the Issuer in the Voucher Component, as shown in Section 5.
Using this schema definition, the <vts:Version> can be used for specifying the VTS version number, and the <vts:KeyInfo> element can be used for specifying the Issuer in the Voucher Component, as shown in Section 5.
9. Security Considerations
9. Security Considerations
The VTS must provide a means to prevent forgery, alteration, duplicate-redemption, reproduction of a voucher, and non-repudiation of transactions, as described in Section 3.2 of [VTS]. This will commonly require the presence of a unique serial number or the like in each Voucher instance, usually outside the Voucher Component. These security requirements, however, mainly follow the VTS plug-ins and their protocols. This document assumes that the VTS plug-ins are trusted and are installed by some means; e.g., manually checked as are other download applications.
The VTS must provide a means to prevent forgery, alteration, duplicate-redemption, reproduction of a voucher, and non-repudiation of transactions, as described in Section 3.2 of [VTS]. This will commonly require the presence of a unique serial number or the like in each Voucher instance, usually outside the Voucher Component. These security requirements, however, mainly follow the VTS plug-ins and their protocols. This document assumes that the VTS plug-ins are trusted and are installed by some means; e.g., manually checked as are other download applications.
The Voucher Component, however, defines restrictions on the VTS Provider (or VTS plug-in), and, if this information is altered, incorrect VTS plug-ins not accepted by the issuer could be used, allowing a forged voucher to be verified as if it were valid. To prevent this situation, the Voucher Component should be stored and
The Voucher Component, however, defines restrictions on the VTS Provider (or VTS plug-in), and, if this information is altered, incorrect VTS plug-ins not accepted by the issuer could be used, allowing a forged voucher to be verified as if it were valid. To prevent this situation, the Voucher Component should be stored and
Fujimura, et al. Informational [Page 18] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 18] RFC 4153 XML Voucher: Generic Voucher Language September 2005
acquired securely; e.g., downloaded from a trusted party using a secure communication channel, such as [TLS] or [IPSEC], or secured by the digital signature of a trusted party [XMLDSIG].
acquired securely; e.g., downloaded from a trusted party using a secure communication channel, such as [TLS] or [IPSEC], or secured by the digital signature of a trusted party [XMLDSIG].
10. Acknowledgements
10. Acknowledgements
The following persons, in alphabetic order, contributed substantially to the material herein:
The following persons, in alphabetic order, contributed substantially to the material herein:
Ian Grigg
Renato Iannella
Yoshiaki Nakajima
Ian Grigg Renato Iannella Yoshiaki Nakajima
11. Normative References
11. Normative References
[ISO4217] "Codes for the representation of currencies and
funds", ISO 4217, 1995.
[ISO4217] "Codes for the representation of currencies and funds", ISO 4217, 1995.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.
[URN] Moats, R., "URN Syntax", RFC 2141, May 1997.
[URN] Moats, R., "URN Syntax", RFC 2141, May 1997.
[URN-NS-IETF] Moats, R., "A URN Namespace for IETF Documents", RFC
2648, August 1999.
[URN-NS-IETF] Moats, R., "A URN Namespace for IETF Documents", RFC 2648, August 1999.
[XML] "Extensible Mark Up Language (XML) 1.0 (Second
Edition)", A W3C Recommendation,
<http://www.w3.org/TR/REC-xml>, October 2000.
[XML] "Extensible Mark Up Language (XML) 1.0 (Second Edition)", A W3C Recommendation, <http://www.w3.org/TR/REC-xml>, October 2000.
[XML-ns] "Namespaces in XML", A W3C Recommendation,
<http://www.w3.org/TR/REC-xml-names>, January 1999.
[XML-ns] "Namespaces in XML", A W3C Recommendation, <http://www.w3.org/TR/REC-xml-names>, January 1999.
[XML-Registry] Mealling, M., "The IETF XML Registry", BCP 81, RFC
3688, January 2004.
[XML-Registry] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004.
[XML-Schema-1] Thompson, H., Beech, D., Maloney, M., and N.
Mendelsohn, "XML Schema Part 1: Structures W3C
Recommendation.", <http://www.w3.org/TR/xmlschema-1/>,
May 2001.
[XML-Schema-1] Thompson, H., Beech, D., Maloney, M., and N. Mendelsohn, "XML Schema Part 1: Structures W3C Recommendation.", <http://www.w3.org/TR/xmlschema-1/>, May 2001.
[XML-Schema-2] Biron, P. and A. Malhotra, "XML Schema Part 2:
Datatypes W3C Recommendation.",
<http://www.w3.org/TR/xmlschema-2/>, May 2001.
[XML-Schema-2] Biron, P. and A. Malhotra, "XML Schema Part 2: Datatypes W3C Recommendation.", <http://www.w3.org/TR/xmlschema-2/>, May 2001.
Fujimura, et al. Informational [Page 19] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 19] RFC 4153 XML Voucher: Generic Voucher Language September 2005
12. Informative References
12. Informative References
[VTS] Fujimura, K. and D. Eastlake, "Requirements and Design
for Voucher Trading System (VTS)", RFC 3506, March
2003.
[VTS] Fujimura, K. and D. Eastlake, "Requirements and Design for Voucher Trading System (VTS)", RFC 3506, March 2003.
[IPSEC] Thayer, R., Doraswamy, N., and R. Glenn, "IP Security
Document Roadmap", RFC 2411, November 1998.
[IPSEC] Thayer, R., Doraswamy, N., and R. Glenn, "IP Security Document Roadmap", RFC 2411, November 1998.
[TLS] Dierks, T. and C. Allen, "The TLS Protocol Version
1.0", RFC 2246, January 1999.
[TLS] Dierks, T. and C. Allen, "The TLS Protocol Version 1.0", RFC 2246, January 1999.
[VTS-API] Terada, M. and K. Fujimura, "Voucher Trading System
Application Programming Interface (VTS-API)", RFC
4154, September 2005.
[VTS-API] Terada, M. and K. Fujimura, "Voucher Trading System Application Programming Interface (VTS-API)", RFC 4154, September 2005.
[XMLDSIG] Eastlake 3rd, D., Reagle, J., and D. Solo,
"(Extensible Markup Language) XML-Signature Syntax and
Processing", RFC 3275, March 2002.
[XMLDSIG] Eastlake 3rd, D., Reagle, J., and D. Solo, "(Extensible Markup Language) XML-Signature Syntax and Processing", RFC 3275, March 2002.
Authors' Addresses
Authors' Addresses
Ko Fujimura NTT Corporation 1-1 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-0847 JAPAN
Ko Fujimura NTT Corporation 1-1 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-0847 JAPAN
Phone: +81-(0)46-859-3053 Fax: +81-(0)46-855-1730 EMail: fujimura.ko@lab.ntt.co.jp
Phone: +81-(0)46-859-3053 Fax: +81-(0)46-855-1730 EMail: fujimura.ko@lab.ntt.co.jp
Masayuki Terada NTT DoCoMo, Inc. 3-5 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-8536 JAPAN
Masayuki Terada NTT DoCoMo, Inc. 3-5 Hikari-no-oka, Yokosuka-shi, Kanagawa, 239-8536 JAPAN
Phone: +81-(0)46-840-3809 Fax: +81-(0)46-840-3705 EMail: te@rex.yrp.nttdocomo.co.jp
Phone: +81-(0)46-840-3809 Fax: +81-(0)46-840-3705 EMail: te@rex.yrp.nttdocomo.co.jp
Donald E. Eastlake 3rd Motorola Laboratories 155 Beaver Street Milford, MA 01757 USA
Donald E. Eastlake 3rd Motorola Laboratories 155 Beaver Street Milford, MA 01757 USA
Phone: 1-508-786-7554 (work)
1-508-634-2066 (home)
EMail: Donald.Eastlake@motorola.com
Phone: 1-508-786-7554 (work) 1-508-634-2066 (home) EMail: Donald.Eastlake@motorola.com
Fujimura, et al. Informational [Page 20] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Fujimura, et al. Informational [Page 20] RFC 4153 XML Voucher: Generic Voucher Language September 2005
Full Copyright Statement
Full Copyright Statement
Copyright (C) The Internet Society (2005).
Copyright (C) The Internet Society (2005).
This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
Intellectual Property
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf- ipr@ietf.org.
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf- ipr@ietf.org.
Acknowledgement
Acknowledgement
Funding for the RFC Editor function is currently provided by the Internet Society.
Funding for the RFC Editor function is currently provided by the Internet Society.
Fujimura, et al. Informational [Page 21]
Fujimura, et al. Informational [Page 21]
一覧
スポンサーリンク
