Generated from
folio-assistant-core/dsa/skills/dsa/dsa-odrl-source.md— do not edit here.
dsa-odrl-source — Make the ODRL Agreement cite the legal text distribution (P2.3)
Skill id:
dsa-odrl-source· Package:dsa· Process:folio-assistant-core/dsa/processes/dsa-document-lifecycle.bpmn(Task_OdrlCitesText, P2.3) · Checker:folio-assistant-core/scripts/check-dsa-hash.ts(bun run cat check:dsa-hash)
When a Data Sharing Agreement carries a computable W3C ODRL 2.2 Agreement
beside its signed legal text, the policy must cite the exact versioned legal
text distribution from which its permissions, prohibitions, constraints and
duties were derived.
Existing specifications only
No custom link property is invented. The citation uses DCMI Metadata Terms
dcterms:source (http://purl.org/dc/terms/source) on the ODRL 2.2
Agreement node:
@contextincludes"http://www.w3.org/ns/odrl.jsonld"and binds"dcterms": "http://purl.org/dc/terms/".dcterms:sourcenames the@id/dcat:downloadURLof the signed legal text’sdcat:Distributionin the version’s DCAT 3 record.
Invariant enforced by check:dsa-hash
The ODRL Agreement’s dcterms:source must name the same
dcat:Distribution whose spdx:checksum is checked against the legal text
bytes:
- If
dcterms:sourceis absent on theAgreement, verification fails. - If
dcterms:sourcenames a URL or IRI that does not match thedcat:Distribution(@idordcat:downloadURL) carrying the legal text’sspdx:checksum, verification fails. - The
Agreement’suidis the version’s fixed-version URL: thedcat:Resource@idof that version (for examplehttps://example.org/dsa/042/v1), never a ‘latest’ URL. It is the URL a Consent cites inConsent.policy.uri(consent rule 2 indsa-document-lifecycle.bpmn), and the DCAT record’sodrl:hasPolicynames it.check:dsa-hashfails when either differs. - When the agreement is amended (
v2), the new ODRLAgreementmust updateuidto the new fixed-version URL anddcterms:sourceto name the new version’s legal text distribution.
Example (agreement.jsonld)
{
"@context": [
"http://www.w3.org/ns/odrl.jsonld",
{
"odrl": "http://www.w3.org/ns/odrl/2/",
"dcterms": "http://purl.org/dc/terms/"
}
],
"@type": "Agreement",
"uid": "https://example.org/dsa/042/v1",
"assigner": "https://example.org/org/fnphi",
"assignee": "https://example.org/org/frec",
"dcterms:source": "https://example.org/dsa/042/v1/agreement.md",
"permission": [
{
"assignee": "https://example.org/org/frec",
"action": "odrl:use",
"target": "https://example.org/datasets/respiratory-surveillance-2026",
"constraint": [
{
"leftOperand": "odrl:purpose",
"operator": "odrl:isA",
"rightOperand": "PUBHLTH"
}
],
"duty": [
{
"action": "odrl:delete",
"target": "https://example.org/datasets/respiratory-surveillance-2026"
}
]
}
]
}
Processes that run this skill
| process | step(s) that name it |
|---|---|
| Data sharing agreement document life cycle | P2.3 · Make the ODRL cite the text |