ODRL 词汇表与表达 2.2

5.3 XML

本节为非规范性内容。

ODRL 策略表达式可以用 XML [xml] 序列化进行编码，具体由 XML Schema [xmlschema11-1] 和 XML Datatypes [xmlschema11-2] 定义。ODRL XML 实例中使用的所有 ODRL 词汇表 IRI MUST 遵循 ODRL 词汇表中定义的那些 IRI。

ODRL 信息模型 [odrl-model] 中的每个类都将由同名 XML 元素表示。此外，每个类属性都将表示为父元素的 XML 属性。 ODRL 信息模型中定义的固定值表示为枚举类型。 基数也通过 XML Schema 出现规则表示。除非明确标记为 REQUIRED，否则属性都是可选的。

注意，Rule 类不会在 XML 编码中表示，只表示其子类：Permission、 Prohibition 和 Duty。

注意，Policy Type MAY 会对 XML 元素的基数推断额外约束和 要求。更多详情请参见 策略子类的定义。

XML 元素和属性

Policy 元素包含以下属性：

• uid - 一个 IRI（REQUIRED）
• type - 一个 IRI（REQUIRED）
• conflict - 固定枚举（在 XML Schema 中定义）
• inheritFrom - 一个 IRI
• profile - 一个 IRI（使用 ODRL Profile 时为 REQUIRED）

注：type 属性用于表达 ODRL Policy 子类。

Policy 元素 MAY 包含以下元素：

• permission，和/或
• prohibition，和/或
• obligation

Policy 元素 MAY 包含以下应用于所有 Rules 的策略级元素 （参见 ODRL Rule 组合）。

• asset，
• party，和/或
• action

Policy 元素 MAY 还可包含 Dublin Core 元素以支持 Policy 元数据。

Policy 元素 MAY 还可包含 constraint 元素，这些元素是 Rule 内由另一个 constraint 元素或 Logical Constraint 引用的 Constraints。注意，这些 Constraints 不应被解释为所有 Rules 的直接 constraint。

Asset 类是单个 asset 元素，用于同时表示 Asset uid 及其与 Rule 的关系。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 元素还可以包含用于 asset collections 的 refinement 元素。

Party 类是单个 party 元素，用于同时表示 Party uid 及其对 Rule 的职能角色。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 collections 的 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 示例

下面的示例展示了 ODRL Policy 的 XML 序列化，其中包含关于该 Policy 的一些元数据。 在此示例中，目标 asset 以及 assigner 和 assignee parties 在策略级定义，因此 会应用于两个 permission 规则。第一个 permission 允许 assignee 播放目标 asset，只要其接受自己会被跟踪。第二个 permission 允许 assignee 将目标 asset 分发到已标识的国家（意大利），并支付 EUR5,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 链接

为支持在 Permissions 和 Prohibitions 中重复相同的元素内容，Asset、Party、 Constraint、Action 和 Duty 元素支持 xml id 和 idref 属性。任何使用 id 属性标识的这些元素都可以随后由同名元素使用 idref 属性引用。在这种情况下，引用元素不得有任何其他内容。

如下例所示，Prohibition 引用 Permission 中定义的元素，但 Constraint 元素除外。在这种情况下，assignee 可以在意大利播放该音乐 asset，但不能在法国播放。

<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>

注意，将此特性用于 Duty 元素时存在一个重要区别，因为它还具有 uid 属性。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 处理系统 MUST 检测 Logical Constraints 中 rightOperand 对 #id 的使用。如果检测到，则 MUST 遵循 Logical Constraints 的处理模型（在 [odrl-model] 中定义）。

下面的示例展示了两个带有 id C1 和 C2 定义的 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"/>