ODRL語彙および表現2.2

5.3 XML

この項は非規範的です。

ODRL方針表現は、XMLスキーマ[xmlschema11-1]とXMLデータ型式[xmlschema11-2]で定義されているとおり、XML[xml]シリアル化でエンコードできます。ODRL XMLのインスタンスで用いるすべてのODRL語彙IRIは、ODRL語彙で定義されているものに従わなければなりません(MUST)。

ODRL情報モデル[odrl-model]の各クラスは、同じ名前のXML要素で表されます。さらに、各クラスのプロパティーは、親要素のXML属性として表されるでしょう。ODRL情報モデルで定義される固定値は、列挙型として表されます。カーディナリティーもXMLスキーマの出現規則で表されます。属性は、必須(REQUIRED)であると明示的に注記されていない限り、オプションです。

RuleクラスはXMLエンコーディングでは表されず、子クラスのみで表されることに注意してください(許可、禁止、義務)。

方針の型がXML要素のカーディナリティーに関する追加の制約と要件を推論できる(MAY)ことに注意してください。詳細は方針のサブクラスの定義を参照してください。

XML要素と属性

方針要素には、次の属性が含まれます。

• uid - IRI(必須(REQUIRED))
• 型 - IRI(必須(REQUIRED))
• 衝突 - 固定の列挙型(XMLスキーマで定義)
• inheritFrom(～から継承) - IRI
• プロファイル - IRI(ODRLプロファイルを用いる場合は必須(REQUIRED))

注: ODRL方針サブクラスを表すためにtype属性が用いられます。

方針要素には、次の要素を含むことができます(MAY)。

• 許可、および/または
• 禁止、および/または
• 責務

方針要素には、すべての規則に適用される次の方針レベル要素を含むことができます(MAY)(ODRL規則の合成を参照)。

• 資産、
• 当事者、および/または
• 行為

方針要素には、方針メタデータをサポートするために、ダブリン・コア要素を含むこともできます(MAY)。

方針要素には、規則内の別の制約要素または論理制約により参照される制約である制約要素を含むこともできます(MAY)。これらの制約が、すべての規則の直接的な制約と解釈すべきではないことに注意してください。

資産クラスは、資産のuidとそれが規則にどのように関連付けられているかの両方を表すための1つの資産要素です。資産要素には、次の属性が含まれます。

• uid - IRI
• 関係 - IRI
• 型 - IRI
• partOf(～の部分) - IRI
• 情報源 - IRI
• id - この要素に対するローカル識別子
• idref - 資産要素への参照

資産要素の属性は、下記の属性の集合の1つとそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. uid(必須(REQUIRED))、関係(必須(REQUIRED))、型(オプション(OPTIONAL))、id(オプション(OPTIONAL))、または
2. idref(必須(REQUIRED))

資産要素には、資産コレクションに対する精緻化要素を含むこともできます。

当事者クラスは、当事者uidおよび規則に対する機能的役割の両方を表す1つの当事者要素です。当事者要素には、次の属性が含まれます。

• uid - IRI
• 機能 - IRI
• 型 - IRI
• partOf(～の部分) - IRI
• 情報源 - IRI
• id - この要素に対するローカル識別子
• idref - 当事者要素への参照

当事者要素の属性は、下記の属性の集合の1つとそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. uid(必須(REQUIRED))、機能(必須(REQUIRED))、型(オプション(OPTIONAL))、id(オプション(OPTIONAL))、または
2. idref(必須(REQUIRED))

当事者要素には、当事者コレクションに対する精緻化要素を含むこともできます。

許可要素には、次の要素が含まれます。

• 資産(必須(REQUIRED))
• 行為(必須(REQUIRED))
• 制約
• 当事者
• 義務

禁止要素には、次の要素が含まれます。

• 資産(必須(REQUIRED))
• 行為(必須(REQUIRED))
• 制約
• 当事者
• 救済

義務要素には、次の要素が含まれます。

• 行為(必須(REQUIRED))
• 制約
• 資産
• 当事者
• 結果

義務要素には、次の属性が含まれます。

• uid - IRI
• id - この要素に対するローカル識別子
• idref - 義務要素への参照

義務要素の属性は、下記の属性の集合の1つとそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. uid(オプション(OPTIONAL))、または
2. id(必須(REQUIRED))、または
3. idref(必須(REQUIRED))

行為要素には、次の属性が含まれます。

• 名前 - IRI
• id - この要素に対するローカル識別子
• idref - 行為要素への参照

行為要素の属性は、下記の属性の集合の1つとそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. 名前(必須(REQUIRED)、id(オプション(OPTIONAL))、または
2. idref(必須(REQUIRED))

行為要素には、精緻化要素を含むこともできます。

制約要素には、次の属性が含まれます。

• 名前 - leftOperand(左オペランド)または論理オペランド(論理制約の場合)に対するIRI
• 演算子 - IRI
• rightOperand(右オペランド) - 文字列またはIRI、集合値の場合は空白区切りのリスト(論理制約に対する制約識別子のリストでなければならない)
• rightOperandReference(右オペランド参照) - IRI
• dataType(データ型) - IRI
• 単位 - IRI
• ステータス - 文字列
• id - この要素に対するローカル識別子
• idref - 制約要素への参照

注: 制約の名前属性は、ODRL情報モデルではleftOperand(左オペランド)と呼ばれます。

制約要素の属性は、下記の属性の集合の1つとそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. 名前(必須(REQUIRED))、演算子(必須(REQUIRED))、rightOperand(右オペランド)および/またはrightOperandReference(右オペランド参照)(必須(REQUIRED))、dataType(データ型)(オプション(OPTIONAL))、単位(オプション(OPTIONAL))、ステータス(オプション(OPTIONAL))、id(オプション(OPTIONAL))、または
2. idref(必須(REQUIRED))

論理制約要素の属性は、下記の属性の集合とそのカーディナリティーで定義されているとおりに用いなければなりません(MUST)。

1. 名前(必須(REQUIRED))、rightOperand(右オペランド)(必須(REQUIRED))

義務が(外部)資産を参照する場合、ODRL XML表現とその(外部)資産の表現をパッケージ化する必要があります。このXMLエンコーディングの仕様では、コミュニティがデータ相互運用性のために優先オプションを利用するため、特定のパッケージ化メカニズムは必須ではありません。

XMLの例

下記の例は、方針に関する何らかのメタデータが含まれているODRL方針のXMLシリアル化を示しています。この例では、ターゲット資産と譲渡関と譲受人の当事者は、方針レベルで定義されており、したがって、両方の許可規則に適用されます。最初の許可により、譲受人は、追跡されることを認める限りターゲット資産を再生することが可能となります。2番目の許可により、譲受人は、5,000ユーロの補償金で、ターゲット資産を識別されている国(イタリア)に配信できるようになります。

<o:Policy xmlns:o="http://www.w3.org/ns/odrl/2/" xmlns:dc="http://purl.org/dc/terms/" 
          type="http://www.w3.org/ns/odrl/2/Agreement"
          uid="http://example.com/policy:9001" 
          profile="http://example.com/odrl:profile:10X">
    <dc:creator>Acme Enterprises</dc:creator>
    <dc:issued>2017-01-01T12:00</dc:issued> 
    <o:asset uid="http://example.com/music:4545" 
             relation="http://www.w3.org/ns/odrl/2/target"/>
    <o:party uid="http://example.com/sony"
             function="http://www.w3.org/ns/odrl/2/assigner"/>
    <o:party uid="http://example.com/billie"
             function="http://www.w3.org/ns/odrl/2/assignee"/>
    <o:permission>
        <o:action name="http://www.w3.org/ns/odrl/2/play"/>
        <o:duty>
            <o:action name="http://www.w3.org/ns/odrl/2/acceptTracking"/>
        </o:duty>
    </o:permission>
    <o:permission>
        <o:action name="http://www.w3.org/ns/odrl/2/distribute"/>
        <o:constraint name="http://www.w3.org/ns/odrl/2/spatial" 
                      operator="http://www.w3.org/ns/odrl/2/eq" 
                      rightOperand="http://vocab.getty.edu/tgn/1000080"/>
        <o:duty>
            <o:action name="http://www.w3.org/ns/odrl/2/compensate">
               <o:refinement name="http://www.w3.org/ns/odrl/2/payAmount"
                   operator="http://www.w3.org/ns/odrl/2/eq"
                   rightOperand="5000.00" 
                   unit="http://dbpedia.org/resource/Euro"/>
            </o:action>
        </o:duty>
    </o:permission>  
</o:Policy>

XMLリンク付け

許可と禁止で同じ要素の内容の繰り返しをサポートするために、資産、当事者、制約、行動、義務の要素は、xmlのidとidrefの属性をサポートしています。id属性を用いて識別されるこれらの要素は、同じ名前の要素をidref属性を用いて参照できます。このケースでは、参照元の要素は他の内容を持ってはなりません。

下記の例で示しているように、禁止は、制約要素を除いて、許可で定義されている要素を参照します。このケースでは、譲受人は、音楽資産をイタリアで再生できますが、フランスではできません。

<o:Policy xmlns:o="http://www.w3.org/ns/odrl/2/"
          type="http://www.w3.org/ns/odrl/2/Set"
          uid="http://example.com/policy:Z1XZ"
          profile="http://example.com/odrl:profile:10X">
  <o:permission>
     <o:asset id="as1" uid="http://example.com/music:1234908"
                 relation="http://www.w3.org/ns/odrl/2/target"/>
     <o:action id="ac1" name="http://www.w3.org/ns/odrl/2/play"/>
     <o:constraint id="c1" name="http://www.w3.org/ns/odrl/2/spatial"
                       operator="http://www.w3.org/ns/odrl/2/eq"
                       rightOperand="http://www.itu.int/tML/tML-ISO-3166:it"/>
     <o:party id="p1" uid="http://example.com/sony:10" 
                 function="http://www.w3.org/ns/odrl/2/assigner"/>
     <o:party id= "p2" uid="http://example.com/billie:888" 
                 function="http://www.w3.org/ns/odrl/2/assignee"/>
   </o:permission>
   <o:prohibition>
     <o:asset idref="as1"/>
     <o:action idref="ac1"/>
     <o:constraint name="http://www.w3.org/ns/odrl/2/spatial" 
                      operator="http://www.w3.org/ns/odrl/2/eq"
                      rightOperand="http://www.itu.int/tML/tML-ISO-3166:fr"/>
     <o:party idref="p1"/>
     <o:party idref="p2"/>
   </o:prohibition>
</o:Policy>

uid属性も含んでいる義務要素でこの機能を用いる場合には、大きな違いがあることに注意してください。uid属性は、複数の許可の同じ義務を参照するために用います。このケースでは、すべての許可にアクセスするためには、義務は1回しか履行する必要がありません。idとidrefの属性を用いると、このケースでは参照するたびに(潜在的に何度も)義務を履行しなければならないため、セマンティクスが変わります。同じ義務要素にuidとidの属性を用いることは認められていないことに注意してください。

論理制約

論理制約をサポートするために、制約オブジェクトは方針レベルで表され、id属性でローカルに識別できます。そして、(規則の)論理制約は、leftOperand(左オペランド)ではその#idを用い、名前属性では論理関係を用いてこれらの制約を参照できます。

ODRL XML処理システムは、論理制約のrightOperand(右オペランド)における#idの使用を検出しなければなりません(MUST)。そして、検出された場合、論理制約の処理モデル([odrl-model]で定義されている)に従わなくてはなりません(MUST)。

下記の例は、id C1とC2で定義されている2つの制約を示しています。許可における論理制約は、rightOperand(右オペランド)で#C1と#C2の値を用い、名前属性で論理関係(xone)を用いてこれらを参照しています。

<o:Policy xmlns:o="http://www.w3.org/ns/odrl/2/"
          type="http://www.w3.org/ns/odrl/2/Offer"
          uid="http://example.com/policy:9001"
          profile="http://example.com/odrl:profile:10X">
    <o:party uid="http://example.com/billie"
             function="http://www.w3.org/ns/odrl/2/assignee"/>
    <o:permission>
        <o:asset uid="http://example.com/music:4545" 
                 relation="http://www.w3.org/ns/odrl/2/target"/>
        <o:action name="http://www.w3.org/ns/odrl/2/distribute"/>
        <o:constraint name="http://www.w3.org/ns/odrl/2/xone"
                      rightOperand="#C1 #C2"/>
    </o:permission> 
</o:Policy>
...
<o:constraint id="C1" name="http://www.w3.org/ns/odrl/2/spatial" 
                  operator="http://www.w3.org/ns/odrl/2/eq" 
                  rightOperand="http://vocab.getty.edu/tgn/1000080"/>
				  
<o:constraint id="C2" name="http://www.w3.org/ns/odrl/2/spatial" 
                  operator="http://www.w3.org/ns/odrl/2/eq" 
                 rightOperand="http://vocab.getty.edu/tgn/1000090"/>