ODRL 語彙および表現 2.2

5.3 XML

このセクションは非規範的です。

ODRL ポリシー表現は、XML Schema [xmlschema11-1] および XML Datatypes [xmlschema11-2] によって定義される XML [xml] シリアライゼーションでエンコードできます。 ODRL XML インスタンスで使用されるすべての ODRL 語彙 IRI は、ODRL 語彙で定義されたものに従わなければなりません（MUST）。

ODRL 情報モデル [odrl-model] の各クラスは、同じ 名前の XML 要素で表されます。さらに、各クラス・プロパティは親要素の XML 属性として表されます。 ODRL 情報モデルで定義される固定値は列挙型として表されます。 カーディナリティも XML Schema の出現規則で表されます。属性は 明示的に REQUIRED と示されていない限り任意です。

Rule クラスは XML エンコーディングでは表されず、子クラスである Permission、 Prohibition、および Duty のみが表されることに注意してください。

Policy Type は、XML 要素のカーディナリティに対して追加の制約および 要件を推論してもよい（MAY）ことに注意してください。詳細については ポリシーのサブクラスの定義を参照してください。

XML 要素および属性

Policy 要素には次の属性が含まれます。

• uid - IRI（REQUIRED）
• type - IRI（REQUIRED）
• conflict - 固定列挙（XML Schema で定義）
• inheritFrom - IRI
• profile - IRI（ODRL プロファイルを使用する場合は REQUIRED）

注記: type 属性は、ODRL Policy サブクラスを表現するために使用されます。

Policy 要素は、次の要素を含んでもよいです（MAY）。

• permission、および/または
• prohibition、および/または
• obligation

Policy 要素は、すべての Rules に適用される次のポリシー・レベル要素を含んでもよいです（MAY） （ODRL Rule Composition を参照）。

• asset、
• party、および/または
• action

Policy 要素は、Policy メタデータをサポートするために Dublin Core 要素も含んでもよいです（MAY）。

Policy 要素は、Rule 内の別の constraint 要素または Logical Constraint によって参照される Constraints である constraint 要素も 含んでもよいです（MAY）。これらの Constraints は、すべての Rules の直接的な 制約として解釈されるものではないことに注意してください。

Asset クラスは、Asset uid とそれが Rule にどのように関連するかの両方を表す単一の asset 要素です。 Asset 要素には次の属性が含まれます。

• uid - IRI
• relation - IRI
• type - IRI
• partOf - IRI
• source - IRI
• id - この要素のローカル識別子
• idref - Asset 要素への参照

Asset 要素属性は、以下の属性セットおよびそのカーディナリティのいずれかで定義されるとおりに 使用されなければなりません（MUST）。

1. uid（REQUIRED）、relation（REQUIRED）、type（OPTIONAL）、id （OPTIONAL）、または
2. idref（REQUIRED）

asset 要素は、アセット・コレクションのための refinement 要素も含むことができます。

Party クラスは、Party uid と Rule に対する機能的役割の両方を表す単一の party 要素です。 Party 要素には次の属性が含まれます。

• uid - IRI
• function - IRI
• type - IRI
• partOf - IRI
• source - IRI
• id - この要素のローカル識別子
• idref - Party 要素への参照

Party 要素属性は、以下の属性セットおよびそのカーディナリティのいずれかで定義されるとおりに 使用されなければなりません（MUST）。

1. uid（REQUIRED）、function（REQUIRED）、type（OPTIONAL）、id （OPTIONAL）、または
2. idref（REQUIRED）

party 要素は、party コレクションのための refinement 要素も含むことができます。

Permission 要素には次の要素が含まれます。

• asset（REQUIRED）
• action（REQUIRED）
• constraint
• party
• duty

Prohibition 要素には次の要素が含まれます。

• asset（REQUIRED）
• action（REQUIRED）
• constraint
• party
• remedy

Duty 要素には次の要素が含まれます。

• action（REQUIRED）
• constraint
• asset
• party
• consequence

Duty 要素には次の属性が含まれます。

• uid - IRI
• id - この要素のローカル識別子
• idref - Duty 要素への参照

Duty 要素属性は、以下の属性セットおよびそのカーディナリティのいずれかで定義されるとおりに 使用されなければなりません（MUST）。

1. uid（OPTIONAL）、または
2. id（REQUIRED）、または
3. idref（REQUIRED）

Action 要素には次の属性が含まれます。

• name - IRI
• id - この要素のローカル識別子
• idref - Action 要素への参照

Action 要素属性は、以下の属性セットおよびそのカーディナリティのいずれかで定義されるとおりに 使用されなければなりません（MUST）。

1. name（REQUIRED）、id（OPTIONAL）、または
2. idref（REQUIRED）

action 要素は refinement 要素も含むことができます。

Constraint 要素には次の属性が含まれます。

• name - leftOperand または logical operand（Logical Constraints の場合）の IRI
• operator - IRI
• rightOperand - 文字列または IRI、集合値の場合は空白区切りのリスト（Logical Constraint の場合は Constraint 識別子のリストでなければならない）
• rightOperandReference - IRI
• dataType - IRI
• unit - IRI
• status - 文字列
• id - この要素のローカル識別子
• idref - Constraint 要素への参照

注記: Constraint の name 属性は、ODRL 情報モデルでは leftOperand と呼ばれます。

Constraint 要素属性は、以下の属性セットおよびそのカーディナリティのいずれかで定義されるとおりに 使用されなければなりません（MUST）。

1. name（REQUIRED）、operator（REQUIRED）、rightOperand および/または rightOperandReference（REQUIRED）、dataType（OPTIONAL）、 unit（OPTIONAL）、status（OPTIONAL）、id（OPTIONAL）、または
2. idref（REQUIRED）

Logical Constraint 要素属性は、以下の属性セットおよびそのカーディナリティで定義されるとおりに 使用されなければなりません（MUST）。

1. name（REQUIRED）、rightOperand（REQUIRED）

Duties が（外部）Assets を参照する場合には、ODRL XML 表現をその（外部）Asset の表現とともにパッケージ化する必要があります。この XML エンコーディング仕様は、 特定のパッケージング機構を義務付けません。各コミュニティがデータ相互運用性のために 望ましい選択肢を利用するためです。

XML の例

以下の例は、Policy に関するいくつかのメタデータを含む ODRL Policy の XML シリアライゼーションを示します。 この例では、target asset と assigner および assignee parties はポリシー・レベルで定義されているため、 両方の permission rules に適用されます。最初の permission は、assignee が追跡されることを 受け入れる限り、target asset を再生することを許可します。2 つ目の permission は、assignee が 補償金 EUR5,000 の支払いにより、識別された国（イタリア）に target asset を 配布することを許可します。

<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 リンク

Permissions および Prohibitions 間で同じ要素内容を繰り返すことをサポートするために、Asset、Party、 Constraint、Action、および Duty 要素は xml id および idref 属性をサポートします。id 属性を使用して 識別されたこれらの要素はいずれも、同じ名前を持つ要素から idref 属性を使用して参照できます。この場合、参照する要素は他の内容を持ってはなりません。

以下の例に示すように、Prohibition は Permission で定義された要素を参照しますが、 Constraint 要素は例外です。この場合、assignee はイタリアでは音楽アセットを再生できますが、フランスでは再生できません。

<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 属性も持つ Duty 要素でこの機能を使用する場合には、重要な違いがあることに注意してください。 uid 属性は、複数の Permissions から同じ Duty を参照するために使用されます。 この場合、Duty はすべての Permissions へのアクセスを得るために一度だけ実行される必要があります。 id および idref 属性を使用する場合、意味論は変化し、この場合 Duty は参照されるたびに 実行されなければなりません（潜在的には何度も）。同じ Duty 要素に対して uid 属性と id 属性を 使用することは許可されないことに注意してください。

論理制約

Logical Constraints をサポートするために、Constraint オブジェクトは Policy レベルで表現し、 id 属性によってローカルに識別できます。Rule 内の Logical Constraint は、その後、 leftOperand の #id と、name 属性の論理関係を使用して、これらの Constraints を参照できます。

ODRL XML 処理システムは、Logical Constraints の rightOperand における #id の使用を 検出しなければなりません（MUST）。検出された場合、Logical Constraints の処理モデル（[odrl-model] で定義）は その後、従われなければなりません（MUST）。

以下の例は、C1 および C2 という id で定義された 2 つの Constraints を示します。 Permission 内の Logical Constraint は、rightOperand の #C1 および #C2 値と、 name 属性の論理関係（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"/>