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 요소는 다음 요소를 포함할 MAY 수 있습니다:

• permission, 및/또는
• prohibition, 및/또는
• obligation

Policy 요소는 모든 규칙에 적용되는 다음 정책 수준 요소를 포함할 MAY 수 있습니다 (ODRL 규칙 구성 참조).

• asset,
• party, 및/또는
• action

Policy 요소는 정책 메타데이터를 지원하기 위해 Dublin Core 요소도 포함할 MAY 수 있습니다.

Policy 요소는 규칙 내에서 다른 constraint 요소 또는 논리 제약에 의해 참조되는 제약인 constraint 요소도 포함할 MAY 수 있습니다. 이러한 제약은 모든 규칙의 직접적인 제약으로 해석되지 않는다는 점에 유의하십시오.

Asset 클래스는 Asset uid와 그것이 규칙과 어떻게 관련되는지를 모두 나타내는 단일 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와 규칙에 대한 기능적 역할을 모두 나타내는 단일 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 요소는 당사자 컬렉션을 위한 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 또는 논리 피연산자(논리 제약의 경우)를 위한 IRI
• operator - IRI
• rightOperand - 문자열 또는 IRI, 집합 값의 경우 공백으로 구분된 목록(논리 제약의 경우 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)

Duty가 (외부) Asset을 참조하는 일부 경우에는 ODRL XML 표현을 해당 (외부) Asset의 표현과 함께 패키징해야 할 필요가 있습니다. 이 XML 인코딩 명세는 특정 패키징 메커니즘을 의무화하지 않습니다. 커뮤니티는 데이터 상호 운용성을 위해 선호하는 옵션을 활용할 것이기 때문입니다.

XML 예제

아래 예제는 정책에 관한 일부 메타데이터를 포함하는 ODRL 정책의 XML 직렬화를 보여줍니다. 이 예제에서 대상 자산과 양도인 및 양수인 당사자는 정책 수준에서 정의되며, 따라서 두 허가 규칙 모두에 적용됩니다. 첫 번째 허가는 양수인이 추적될 것임을 수락하는 한 대상 자산을 재생할 수 있게 합니다. 두 번째 허가는 양수인이 보상금 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 연결

Permission과 Prohibition 전체에서 동일한 요소 내용을 반복하는 것을 지원하기 위해, Asset, Party, Constraint, Action 및 Duty 요소는 xml id 및 idref 속성을 지원합니다. id 속성을 사용하여 식별된 이러한 요소는 같은 이름을 가진 요소에서 idref 속성을 사용하여 참조될 수 있습니다. 이 경우 참조하는 요소는 다른 내용을 가져서는 안 됩니다.

아래 예제에서 보듯이 Prohibition은 Constraint 요소를 제외하고 Permission에서 정의된 요소를 참조합니다. 이 경우 양수인은 이탈리아에서 음악 자산을 재생할 수 있지만 프랑스에서는 재생할 수 없습니다.

<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 속성은 여러 Permission에서 동일한 Duty를 참조하는 데 사용됩니다. 이 경우 모든 Permission에 접근하기 위해 Duty는 한 번만 수행되면 됩니다. id 및 idref 속성을 사용할 때는 의미론이 달라지며, 이 경우 Duty는 참조될 때마다(잠재적으로 여러 번) 수행되어야 합니다. 동일한 Duty 요소에 uid와 id 속성을 함께 사용하는 것은 허용되지 않는다는 점에 유의하십시오.

논리 제약

논리 제약을 지원하기 위해 Constraint 객체는 정책 수준에서 표현되고 id 속성으로 로컬 식별될 수 있습니다. 그런 다음 (규칙 내) Logical Constraint는 leftOperand에서 이러한 Constraint의 #id를 사용하고, name 속성에서 논리 관계를 사용하여 이를 참조할 수 있습니다.

ODRL XML 처리 시스템은 논리 제약의 rightOperand에서 #id 사용을 감지해야 MUST 합니다. 감지된 경우, 논리 제약을 위한 처리 모델([odrl-model]에서 정의됨)을 따라야 MUST 합니다.

아래 예제는 C1 및 C2 id로 정의된 두 Constraint를 보여줍니다. 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"/>