RightsML Simple Examples
RightsML templates relating to the following Policy 'categories' are now available:
The goal of RightsML Templates is to support a quick and simple creation of the rights expression for a single specific case. To illustrate this, each page for the cases listed above is structured into four steps:
- A natural language expression of the case.
- A corresponding RightsML/ODRL Template. This template provides i/ fixed values typical for this case and ii/ variable values which vary based on the business context but don't modify the functionality of the case. All variables are delimited by { }-brackets in the template.
- A list of the Template Variables and their values assigned for the specific example case.
- A full RightsML/ODRL policy document with the assigned example values.
Our proposal for working with the RightsML Templates is
- Match your business case against the available templates; an initial set has been provided, and will be expanded over time.
- Go over the list of Template Variables: assign values corresponding to your business context.
- Copy the RightsML/ODRL Template to your editor and replace the placeholders in { }-brackets with the values you've assigned.
- The result should look similar to the example at the bottom of the specific RightsML Template page; only the variables should have different values.
- {value}: Indicates a value to be substituted into the sample, e.g. An {action} could be replaced by a specific instance of an Action such as 'http://w3.org/ns/odrl/vocab#sell'.
- [n]: Indicates the related Implementation Note, as detailed on this page.
- XML elements are represented as below:
<element-name attribute-name="attribute-value" />
The following notes apply to the samples discussed on the above pages:
[1] Recommendation: For @name, @operator and @function values:
- Use URLs, as opposed to any format for shortening URIs (QNames or QCodes)
- E.g.: 'http://w3.org/ns/odrl/vocab#target', as opposed to 'ov:target'
[2] Action Vocabularies:
- Some Action terms used with RightsML are specifically from the RightsML Action vocabulary, as opposed to the ODRL Action vocabulary, as these terms are specific to the new industry.
- E.g.: 'http://iptc.org/std/RightsML/2011-10-07/distribute' overrides 'http://w3.org/ns/odrl/vocab#distribute'.
[3] Recommendation: For a Policy relating to a Group of Assignees:
- Use a Policy with Type 'set', and define an Assignee Group to use as the Assignee Party.
- E.g.: the URI http://example.com/cv/policy/group/epapartners could be used to identify to a group of parties defined as 'any party which has a picture contract with the Example Photo Agency (EPA)'.
- E.g.: the URI http://example.com/cv/policy/group/epapartners could be used to identify to a group of parties defined as 'any party which has a picture contract with the Example Photo Agency (EPA)'.
Feedback and Questions
We welcome feedback on and questions about RightsML. You may post to the public RightsML Forum. If you are an IPTC member, then you are also entitled to join the private RightsML email discussion list.