1"use strict";(globalThis.webpackChunkschulconnex=globalThis.webpackChunkschulconnex||[]).push([[1090],{3686(e,n,i){i.r(n),i.d(n,{assets:()=>h,contentTitle:()=>c,default:()=>p,frontMatter:()=>u,metadata:()=>r,toc:()=>o});const r=JSON.parse('{"id":"lizenzerweiterung/praxisleitfaden/odrl-beispiele","title":"Typische Nutzungsrechte mit ODRL abbilden","description":"Die folgenden Beispiele veranschaulichen verschiedene Nutzungsrechte im ODRL-Format. Sie verdeutlichen, wie Nutzungsszenarien im schulischen Kontext mithilfe von ODRL modelliert werden k\xf6nnen, um die Bedeutung und Beschr\xe4nkungen der Nutzungsrechte pr\xe4zise und maschinenlesbar darzustellen.","source":"@site/docs/lizenzerweiterung/praxisleitfaden/odrl-beispiele.mdx","sourceDirName":"lizenzerweiterung/praxisleitfaden","slug":"/lizenzerweiterung/praxisleitfaden/odrl-beispiele","permalink":"/docs/lizenzerweiterung/praxisleitfaden/odrl-beispiele","draft":false,"unlisted":false,"tags":[{"inline":true,"label":"Informativ","permalink":"/docs/tags/informativ"}],"version":"current","frontMatter":{"tags":["Informativ"]},"sidebar":"spezPoliciesSidebar","previous":{"title":"HTTP-Statuscodes","permalink":"/docs/lizenzerweiterung/schnittstellendefinition/http-statuscodes"},"next":{"title":"Typischer Aufruf einer lizensierten Anwendung","permalink":"/docs/lizenzerweiterung/praxisleitfaden/medium-aufrufen"}}');var t=i(74848),s=i(28453),d=i(4865),l=i(19365),a=i(90446);const u={tags:["Informativ"]},c="Typische Nutzungsrechte mit ODRL abbilden",h={},o=[{value:"Grundstruktur einer Lizenzvereinbarung",id:"grundstruktur-einer-lizenzvereinbarung",level:2},{value:"JSON-LD",id:"json-ld",level:4},{value:"Schul-, Lehrer- und Gruppenlizenzen",id:"schul--lehrer--und-gruppenlizenzen",level:2},{value:"Schullizenz",id:"schullizenz",level:3},{value:"Lehrerlizenz",id:"lehrerlizenz",level:3},{value:"Gruppenlizenz",id:"gruppenlizenz",level:3},{value:"Medien",id:"medien",level:2},{value:"Videostream",id:"videostream",level:3},{value:"Arbeitsblatt",id:"arbeitsblatt",level:3},{value:"Zeitliche und r\xe4umliche Einschr\xe4nkung",id:"zeitliche-und-r\xe4umliche-einschr\xe4nkung",level:2},{value:"Schuljahreslizenz",id:"schuljahreslizenz",level:3},{value:"Kreisweite Lizenz",id:"kreisweite-lizenz",level:3},{value:"Dynamische Lizenz",id:"dynamische-lizenz",level:3},{value:"JSON-LD",id:"json-ld-1",level:4},{value:"Kombination von Lizenzbedingungen",id:"kombination-von-lizenzbedingungen",level:2}];function g(e){const n={code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",p:"p",...(0,s.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.header,{children:(0,t.jsx)(n.h1,{id:"typische-nutzungsrechte-mit-odrl-abbilden",children:"Typische Nutzungsrechte mit ODRL abbilden"})}),"\n",(0,t.jsx)(n.p,{children:"Die folgenden Beispiele veranschaulichen verschiedene Nutzungsrechte im ODRL-Format. Sie verdeutlichen, wie Nutzungsszenarien im schulischen Kontext mithilfe von ODRL modelliert werden k\xf6nnen, um die Bedeutung und Beschr\xe4nkungen der Nutzungsrechte pr\xe4zise und maschinenlesbar darzustellen."}),"\n",(0,t.jsx)(n.h2,{id:"grundstruktur-einer-lizenzvereinbarung",children:"Grundstruktur einer Lizenzvereinbarung"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein ausf\xfchrbares Programm",children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ]\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein ausf\xfchrbares Programm",children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ]\n }\n ]\n}'})})]}),"\n",(0,t.jsx)(n.p,{children:"Dieses Beispiel folgt dem ODRL 2.1-Standard und repr\xe4sentiert ein ODRL-Policy-Beispiel, das f\xfcr die Verwendung im deutschen Bildungssystem gedacht ist. Die Ziel-Medienobjekte k\xf6nnen dabei digitale internetbasierte Bildungsanwendungen, digitale Schulb\xfccher oder andere Bildungsmaterialien umfassen. Im Folgenden wird jede Top-Level-Eigenschaft dieses ODRL-Objekts detailliert erl\xe4utert."}),"\n",(0,t.jsxs)(n.p,{children:["Die Eigenschaft ",(0,t.jsx)(n.code,{children:"uid"})," (Unique Identifier) dient als eindeutige Kennzeichnung f\xfcr dieses spezifische ODRL-Objekt. Der Wert ",(0,t.jsx)(n.code,{children:"https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7"})," ist ein Internationalized Resource Identifier (IRI). Es ist wichtig zu betonen, dass, wenn ",(0,t.jsx)(n.code,{children:"uid"}),"-Attribute als URLs definiert sind, diese aufl\xf6sbare Endpunkte sein sollten, um die Nachverfolgbarkeit und Referenzierung des Nutzungsrechte-Objekts (Policy) zu gew\xe4hrleisten."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"target"}),"-Attribut spezifiziert das Medienobjekt oder die Medienobjekt, auf die sich die in dem Nutzungsrechte-Objekt definierten Regeln beziehen. In diesem Beispiel enth\xe4lt das ",(0,t.jsx)(n.code,{children:"target"}),"-Objekt zwei weitere Attribute: ",(0,t.jsx)(n.code,{children:"uid"})," mit dem Wert ",(0,t.jsx)(n.code,{children:"urn:issuer:medium:123456789"})," und ",(0,t.jsx)(n.code,{children:"partOf"})," mit dem Wert ",(0,t.jsx)(n.code,{children:"urn:issuer:catalogue"}),". Der ",(0,t.jsx)(n.code,{children:"uid"}),"-Wert identifiziert das spezifische Ziel-Medienobjekt mittels eines Uniform Resource Name (URN), w\xe4hrend ",(0,t.jsx)(n.code,{children:"partOf"})," angibt, dass dieses Medienobjekt Teil des durch ",(0,t.jsx)(n.code,{children:"urn:issuer:catalogue"})," identifizierten Medienkatalogs ist."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"permission"}),"-Array enth\xe4lt eine oder mehrere Berechtigungen, die dem oder den Zielobjekten gew\xe4hrt werden. In diesem Beispiel gibt es ein einzelnes Berechtigungsobjekt mit dem Attribut ",(0,t.jsx)(n.code,{children:"action"}),", dessen Wert ein Array mit dem Eintrag ",(0,t.jsx)(n.code,{children:"execute"})," ist. Die ODRL-Aktion ",(0,t.jsx)(n.code,{children:"execute"})," umfasst dabei nicht nur die Ausf\xfchrung von Software im herk\xf6mmlichen Sinne, sondern auch die Ausf\xfchrung von internetbasierten Anwendungen (Software as a Service). Diese Berechtigung erlaubt somit die Nutzung oder das Ausf\xfchren des durch das ",(0,t.jsx)(n.code,{children:"target"}),"-Attribut identifizierten Medienobjekts als Anwendung (Applikation)."]}),"\n",(0,t.jsx)(n.h4,{id:"json-ld",children:"JSON-LD"}),"\n",(0,t.jsxs)(n.p,{children:["Die Eigenschaft ",(0,t.jsx)(n.code,{children:"@context"})," definiert die JSON-LD-Kontexte, die f\xfcr die Interpretation des ODRL-Objekts relevant sind. Hier wird der offizielle ODRL-Kontext von der W3C-Namespace-Adresse ",(0,t.jsx)(n.code,{children:"http://www.w3.org/ns/odrl.jsonld"})," referenziert. Dieser Kontext stellt sicher, dass die Begriffe und Vokabeln im Objekt eindeutig der ODRL-Spezifikation zugeordnet werden k\xf6nnen und erm\xf6glicht so eine standardisierte maschinenlesbare Verarbeitung des Nutzungsrechte-Objekts."]}),"\n",(0,t.jsxs)(n.p,{children:["Die Eigenschaft ",(0,t.jsx)(n.code,{children:"@type"})," gibt den Typ des ODRL-Objekts an. In diesem Fall ist der Wert ",(0,t.jsx)(n.code,{children:"Agreement"}),", was bedeutet, dass es sich um eine Vereinbarung handelt, die Rechte und Pflichten zwischen verschiedenen Parteien festlegt. Andere m\xf6gliche Typen k\xf6nnten ",(0,t.jsx)(n.code,{children:"Policy"})," oder ",(0,t.jsx)(n.code,{children:"Offer"}
1)," sein, die jeweils unterschiedliche Arten von Regeln und Konditionen im Kontext des digitalen Nutzungsrechtemanagements repr\xe4sentieren."]}),"\n",(0,t.jsx)(n.h2,{id:"schul--lehrer--und-gruppenlizenzen",children:"Schul-, Lehrer- und Gruppenlizenzen"}),"\n",(0,t.jsx)(n.h3,{id:"schullizenz",children:"Schullizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Schullizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "assignee": {\n "partOf": {\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:organisation:kennung",\n "operator": "eq",\n "rightOperand": "NI_12345"\n }\n ]\n }\n }\n // highlight-end\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Schullizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "assignee": {\n "partOf": {\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:organisation:kennung",\n "operator": "eq",\n "rightOperand": "NI_12345"\n }\n ]\n }\n }\n // highlight-end\n }\n ]\n}\n'})})]}),"\n",(0,t.jsxs)(n.p,{children:["Dieses Beispiel erweitert die vorherige ODRL 2.1-Agreement-Policy f\xfcr den Einsatz im deutschen Bildungssystem. Es spezifiziert nun genauer, wem die Ausf\xfchrungsberechtigung f\xfcr das Ziel-Medienobjekt erteilt wird. Die Struktur bleibt erhalten, jedoch wird innerhalb der ",(0,t.jsx)(n.code,{children:"permission"})," ein ",(0,t.jsx)(n.code,{children:"assignee"})," hinzugef\xfcgt, um den Berechtigten zu definieren."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays befindet sich weiterhin ein Objekt, das die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," beschreibt, n\xe4mlich ",(0,t.jsx)(n.code,{children:"execute"}),". Zus\xe4tzlich zu dieser Aktion enth\xe4lt dieses Berechtigungsobjekt nun das Attribut ",(0,t.jsx)(n.code,{children:"assignee"}),". Das ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attribut dient dazu, die Partei oder die Parteien zu identifizieren, denen die in dieser ",(0,t.jsx)(n.code,{children:"permission"})," gew\xe4hrte Handlung erlaubt ist."]}),"\n",(0,t.jsxs)(n.p,{children:["Der Wert des ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attributs ist hier ein Objekt, das das Attribut ",(0,t.jsx)(n.code,{children:"partOf"})," enth\xe4lt. Das ",(0,t.jsx)(n.code,{children:"partOf"}),"-Attribut in diesem Kontext deutet darauf hin, dass der Berechtigte Teil einer bestimmten Gruppe oder Organisation ist. Die genaue Definition dieser Gruppe oder Organisation wird durch das nachfolgende ",(0,t.jsx)(n.code,{children:"refinement"})," pr\xe4zisiert."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"refinement"}),"-Array innerhalb von ",(0,t.jsx)(n.code,{children:"partOf"})," erm\xf6glicht eine detailliertere Filterung oder Auswahl der Berechtigten. In diesem Fall enth\xe4lt es ein einzelnes Refinement-Objekt. Dieses Objekt besteht aus drei Attributen: ",(0,t.jsx)(n.code,{children:"leftOperand"}),", ",(0,t.jsx)(n.code,{children:"operator"})," und ",(0,t.jsx)(n.code,{children:"rightOperand"}),". ",(0,t.jsx)(n.code,{children:"leftOperand"})," gibt die zu pr\xfcfende Eigenschaft an (",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:organisation:kennung"}),"), ",(0,t.jsx)(n.code,{children:"operator"})," definiert die Art des Vergleichs (",(0,t.jsx)(n.code,{children:"eq"})," f\xfcr \u201egleich\u201c), und ",(0,t.jsx)(n.code,{children:"rightOperand"})," enth\xe4lt den Wert, mit dem verglichen wird. (\u201eNI_12345\u201c steht f\xfcr die Kennung der Organisation, also die Schulnummer.)."]}),"\n",(0,t.jsxs)(n.p,{children:["Die Struktur innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Blocks bedeutet also, dass die Erlaubnis zur ",(0,t.jsx)(n.code,{children:"execute"}),"-Aktion nur denjenigen Organisationen (Schulen) gew\xe4hrt wird, deren Kennung (",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:organisation:kennung"}),") dem Wert ",(0,t.jsx)(n.code,{children:"NI_12345"})," entspricht. Dies erm\xf6glicht eine pr\xe4zise Darstellung der Zuweisung von Nutzungsrechten an eine spezifische Bildungseinrichtung, hier an die Schule mit der genannten Kennung."]}),"\n","\n",(0,t.jsx)(n.h3,{id:"lehrerlizenz",children:"Lehrerlizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Lehrerlizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "assignee": {\n // highlight-start\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:rolle",\n "operator": "eq",\n "rightOperand": "lehr"\n }\n ]\n // highlight-end\n }\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Lehrerlizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "assignee": {\n // highlight-start\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:rolle",\n "operator": "eq",\n "rightOperand": "lehr"\n }\n ]\n // highlight-end\n }\n }\n ]\n}\n'})})]}),"\n",(0,t.jsxs)(n.p,{children:["Dieses ODRL 2.1 Agreement-Beispiel setzt weiterhin auf die Struktur der vorherigen Beispiele. Der Fokus liegt hier abermals auf der pr\xe4zisen Definition des Berechtigten f\xfcr die Ausf\xfchrungsaktion, wobei nun eine andere Form der Verfeinerung innerhalb des ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attributs verwendet wird."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays finden wir wiederum ein Objekt, das die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," als ",(0,t.jsx)(n.code,{children:"execute"})," definiert. Analog zum vorherigen Beispiel enth\xe4lt dieses Berechtigungsobjekt das ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attribut, um den Kreis der berechtigten Personen oder Parteien einzugrenzen."]}),"\n",(0,t.jsxs)(n.p,{children:["Im Unterschied zum vorherigen Beispiel enth\xe4lt das ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attribut hier direkt ein ",(0,t.jsx)(n.code,{children:"refinement"}),"-Array. Dieses Array beinhaltet ein einzelnes Refinement-Objekt, das die Bedingungen f\xfcr die Zuweisung der Berechtigung festlegt."]}),"\n",(0,t.jsxs)(n.p,{children:["Das Refinement-Objekt besteht aus den bekannten Attributen: ",(0,t.jsx)(n.code,{children:"leftOperand"}),", ",(0,t.jsx)(n.code,{children:"operator"})," und ",(0,t.jsx)(n.code,{children:"rightOperand"}),". ",(0,t.jsx)(n.code,{children:"leftOperand"})," spezifiziert die zu pr\xfcfende Eigenschaft, hier die Organisationsrolle des Personenkontextes (",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:rolle"}),"). Der ",(0,t.jsx)(n.code,{children:"operator"})," ist auf ",(0,t.jsx)(n.code,{children:"eq"})," (gleich) gesetzt, und der ",(0,t.jsx)(n.code,{children:"rightOperand"})," hat den Codewert f\xfcr Lehrend (",(0,t.jsx)(n.code,{children:"lehr"}),")."]}),"\n",(0,t.jsxs)(n.p,{children:["Diese Konfiguration bedeutet also, dass die Erlaubnis zur Ausf\xfchrung des durch das ",(0,t.jsx)(n.code,{children:"target"}),"-Attribut identifizierten Medienobjekts ausschlie\xdflich denjenigen Personen gew\xe4hrt wird, deren Rolle dem Wert Lehrend entspricht. Dies erm\xf6glicht die Beschr\xe4nkung der Nutzungsrechte auf bestimmte Personengruppen innerhalb des Bildungssystems, in diesem Fall auf Lehrkr\xe4fte."]}),"\n","\n",(0,t.jsx)(n.h3,{id:"gruppenlizenz",children:"Gruppenlizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Gruppenlizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "assignee": {\n "partOf": {\n "refinement": [\n {\n // highlight-start\n "leftOperand": "urn:schulconnex:de:personenkontext:gruppe",\n "operator": "eq",\n "rightOperand": "ffceeb40-01e6-483f-a909-382ff576b429"\n // highlight-end\n }\n ]\n }\n }\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Gruppenlizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "assignee": {\n "partOf": {\n "refinement": [\n {\n // highlight-start\n "leftOperand": "urn:schulconnex:de:personenkontext:gruppe",\n "operator": "eq",\n "rightOperand": "ffceeb40-01e6-483f-a909-382ff576b429"\n // highlight-end\n }\n ]\n }\n }\n }\n ]\n}\n'})})]}),"\n",(0,t.jsxs)(n.p,{children:["Dieses ODRL 2.1-Agreement-Beispiel demonstriert erneut die detaillierte Zuweisung von Ausf\xfchrungsrechten. Die grundlegende Struktur des ODRL-Dokuments bleibt konsistent mit den vorherigen Beispielen. Der Fokus liegt wiederum auf der Spezifizierung des Berechtigten innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Blocks."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays ist die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," weiterhin als ",(0,t.jsx)(n.code,{children:"execute"})," definiert. Das Attribut ",(0,t.jsx)(n.code,{children:"assignee"})," dient dazu, die Person oder Partei zu bestimmen, der diese Ausf\xfchrungsberechtigung zusteht. Der Wert des ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attributs ist wiederum ein Objekt, das das Attribut ",(0,t.jsx)(n.code,{children:"partOf"})," enth\xe4lt."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"partOf"}),"-Attribut indiziert, dass der Berechtigte Teil einer bestimmten Gruppierung ist. Die genaue Definition dieser Gruppe erfolgt durch das nachfolgende ",(0,t.jsx)(n.code,{children:"refinement"}),"-Array. Dieses Array enth\xe4lt ein einzelnes Refinement-Objekt, das die Kriterien f\xfcr die Zugeh\xf6rigkeit zu der relevanten Gruppe festlegt."]}),"\n",(0,t.jsxs)(n.p,{children:["Das Refinement-Objekt besteht aus den Attributen ",(0,t.jsx)(n.code,{children:"leftOperand"}),", ",(0,t.jsx)(n.code,{children:"operator"})," und ",(0,t.jsx)(n.code,{children:"rightOperand"}),". Hier spezifiziert ",(0,t.jsx)(n.code,{children:"leftOperand"})," die zu pr\xfcfende Eigenschaft als ",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:gruppe"}),", was auf die Gruppenzugeh\xf6rigkeit einer Person im schulischen Kontext verweist. Der ",(0,t.jsx)(n.code,{children:"operator"})," ist auf ",(0,t.jsx)(n.code,{children:"eq"})," (gleich) gesetzt, und der ",(0,t.jsx)(n.code,{children:"rightOperand"})," enth\xe4lt die spezifische Kennung (ID) der Gruppe, hier ",(0,t.jsx)(n.code,{children:"ffceeb40-01e6-483f-a909-382ff576b429"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Diese Konfiguration gew\xe4hrt also die Erlaubnis zur Ausf\xfchrung des Ziel-Medienobjekts ausschlie\xdflich Mitgliedern derjenigen Gruppe, deren eindeutige Kennung deren Kennung, spezifiziert durch ",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:gruppe"}),", dem Wert ",(0,t.jsx)(n.code,{children:"ffceeb40-01e6-483f-a909-382ff576b429"})," entspricht."]}),"\n","\n","\n",(0,t.jsx)(n.h2,{id:"medien",children:"Medien"}),"\n",(0,t.jsx)(n.h3,{id:"videostream",children:"Videostream"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein gestreamtes Medium",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n // highlight-start\n "stream"\n // highlight-end\n ]\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein gestreamtes Medium",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n // highlight-start\n "stream"\n // highlight-end\n ]\n }\n ]\n}\n'})})]}),"\n",(0,t.jsxs)(n.p,{children:["Dieses ODRL 2.1-Agreement-Beispiel demonstriert eine einfache Erlaubnis f\xfcr eine spezifische Aktion. Die grundlegende Struktur des ODRL-Dokuments bleibt mit den vorherigen Beispielen identisch. Der Fokus lie
1gt hier auf der Definition der erlaubten Handlung innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Blocks."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays befindet sich ein Objekt, das die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," beschreibt. In diesem Fall ist der Wert des ",(0,t.jsx)(n.code,{children:"action"}),"-Arrays ",(0,t.jsx)(n.code,{children:"stream"}),". Die ODRL-Aktion ",(0,t.jsx)(n.code,{children:"stream"})," bezieht sich auf die fortlaufende \xdcbertragung von audiovisuellen oder anderen digitalen Inhalten, typischerweise in Echtzeit, zur direkten Wiedergabe, ohne dass eine vollst\xe4ndige dauerhafte Speicherung des Inhalts auf dem Endger\xe4t des Nutzers erfolgt."]}),"\n",(0,t.jsx)(n.p,{children:"Im Kontext digitaler Bildungsmedien k\xf6nnte diese Berechtigung beispielsweise das Recht einr\xe4umen, ein Lehrvideo oder eine interaktive Simulation direkt anzusehen, ohne die Datei herunterladen zu m\xfcssen. Diese Art der Berechtigung ist relevant f\xfcr den Schutz von Inhalten und die Kontrolle \xfcber deren Nutzung im Online-Bereich."}),"\n",(0,t.jsxs)(n.p,{children:["Es ist wichtig zu beachten, dass dieses Beispiel keine Einschr\xe4nkungen bez\xfcglich des Berechtigten (kein ",(0,t.jsx)(n.code,{children:"assignee"})," ist definiert) oder spezifische Bedingungen f\xfcr die Streaming-Aktion enth\xe4lt. Die Berechtigung gilt somit potenziell f\xfcr jeden, der auf das durch das ",(0,t.jsx)(n.code,{children:"target"}),"-Attribut identifizierte Objekt zugreifen kann."]}),"\n",(0,t.jsx)(n.h3,{id:"arbeitsblatt",children:"Arbeitsblatt"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein bearbeitbares Office-Dokument",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n // highlight-start\n "move",\n "view",\n "print",\n "distribute"\n // highlight-end\n ]\n },\n {\n // highlight-start\n "action": [\n "modify"\n ],\n "duty": [\n {\n "action": [\n "Attribution",\n "ShareAlike"\n ]\n }\n ]\n // highlight-end\n }\n ]\n}'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr ein bearbeitbares Office-Dokument",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n // highlight-start\n "move",\n "view",\n "print",\n "distribute"\n // highlight-end\n ]\n },\n {\n // highlight-start\n "action": [\n "modify"\n ],\n "duty": [\n {\n "action": [\n "Attribution",\n "ShareAlike"\n ]\n }\n ]\n // highlight-end\n }\n ]\n}'})})]}),"\n",(0,t.jsx)(n.p,{children:"Dieses ODRL 2.1-Agreement-Beispiel, das beispielsweise ein bearbeitbares Arbeitsblatt unter einer Creative Commons-Lizenz repr\xe4sentieren k\xf6nnte, demonstriert die Kombination mehrerer erlaubter Handlungen und die Definition einer Pflicht im Zusammenhang mit einer weiteren Handlung. Die grundlegende Struktur des ODRL-Objekts bleibt dabei erhalten."}),"\n",(0,t.jsxs)(n.p,{children:["Der ",(0,t.jsx)(n.code,{children:"permission"}),"-Array enth\xe4lt hier zwei separate Berechtigungsobjekte. Das erste Berechtigungsobjekt definiert ein Array von erlaubten ",(0,t.jsx)(n.code,{children:"action"}),"-Werten: ",(0,t.jsx)(n.code,{children:"move"}),", ",(0,t.jsx)(n.code,{children:"view"}),", ",(0,t.jsx)(n.code,{children:"print"})," und ",(0,t.jsx)(n.code,{children:"distribute"}),". Dies bedeutet, dass der Berechtigte die Erlaubnis hat, das Zielobjekt zu verschieben (z.B. in ein anderes Verzeichnis), anzusehen, auszudrucken und zu verbreiten. Diese Berechtigungen sind typisch f\xfcr die Nutzung und Weitergabe von Lehrmaterialien in Dateiform."]}),"\n",(0,t.jsxs)(n.p,{children:["Das zweite Berechtigungsobjekt spezifiziert die ",(0,t.jsx)(n.code,{children:"action"})," ",(0,t.jsx)(n.code,{children:"modify"}),", also die Erlaubnis zur Modifikation oder Bearbeitung des Ziel-Medienobjekts. Zus\xe4tzlich zu dieser Erlaubnis enth\xe4lt dieses Objekt ein ",(0,t.jsx)(n.code,{children:"duty"}),"-Array. Ein ",(0,t.jsx)(n.code,{children:"duty"})," beschreibt eine Verpflichtung, die erf\xfcllt werden muss, wenn die zugeh\xf6rige Handlung (hier ",(0,t.jsx)(n.code,{children:"modify"}),") ausge\xfcbt wird."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"duty"}),"-Arrays befindet sich ein Objekt, das ein ",(0,t.jsx)(n.code,{children:"action"}),"-Array mit den Werten ",(0,t.jsx)(n.code,{children:"Attribution"})," und ",(0,t.jsx)(n.code,{children:"ShareAlike"})," enth\xe4lt. ",(0,t.jsx)(n.code,{children:"Attribution"})," bedeutet, dass derjenige, der das Arbeitsblatt ver\xe4ndert und weitergibt, die urspr\xfcnglichen Urheber angemessen nennen muss. ",(0,t.jsx)(n.code,{children:"ShareAlike"})," bedeutet, dass alle Bearbeitungen und Weitergaben des Arbeitsblatts unter den gleichen oder \xe4hnlichen Lizenzbedingungen erfolgen m\xfcssen."]}),"\n",(0,t.jsx)(n.p,{children:"Dieses Beispiel erlaubt also die Nutzung, Vervielf\xe4ltigung und Weitergabe eines Arbeitsblattes in Dateiform, wobei im Falle einer Bearbeitung und Weitergabe die Pflicht zur Namensnennung der urspr\xfcnglichen Urheber und zur Weitergabe unter gleichen Bedingungen besteht, was typische Elemente einer Creative
1Commons-Lizenz widerspiegelt."}),"\n",(0,t.jsx)(n.h2,{id:"zeitliche-und-r\xe4umliche-einschr\xe4nkung",children:"Zeitliche und r\xe4umliche Einschr\xe4nkung"}),"\n",(0,t.jsx)(n.h3,{id:"schuljahreslizenz",children:"Schuljahreslizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Schuljahreslizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "constraint": [\n {\n "leftOperand": "dateTime",\n "operator": "gteq",\n "rightOperand": "2023-08-01T00:00+0200"\n },\n {\n "leftOperand": "dateTime",\n "operator": "lt",\n "rightOperand": "2024-08-01T00:00+0200"\n }\n ]\n // highlight-end\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Schuljahreslizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "constraint": [\n {\n "leftOperand": "dateTime",\n "operator": "gteq",\n "rightOperand": "2023-08-01T00:00+0200"\n },\n {\n "leftOperand": "dateTime",\n "operator": "lt",\n "rightOperand": "2024-08-01T00:00+0200"\n }\n ]\n // highlight-end\n }\n ]\n}\n'})})]}),"\n",(0,t.jsx)(n.p,{children:"Dieses ODRL 2.1-Agreement-Beispiel, das hier die Nutzung einer digitalen Bildungsanwendung w\xe4hrend des Schuljahres 2023/2024 regelt, erweitert die Ausf\xfchrungsberechtigung um zeitliche Einschr\xe4nkungen. Die grundlegende Struktur des ODRL-Dokuments bleibt dabei bestehen."}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays wird die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," als ",(0,t.jsx)(n.code,{children:"execute"})," definiert, was die Berechtigung zur Ausf\xfchrung der digitalen Anwendung umfasst. Zus\xe4tzlich zu dieser Aktion enth\xe4lt das Berechtigungsobjekt nun ein ",(0,t.jsx)(n.code,{children:"constraint"}),"-Array. Constraints definieren Bedingungen, die erf\xfcllt sein m\xfcssen, damit die gew\xe4hrte Berechtigung g\xfcltig ist."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"constraint"}),"-Array enth\xe4lt in diesem Beispiel zwei Constraint-Objekte, die beide eine zeitliche Einschr\xe4nkung definieren. Das erste Constraint-Objekt spezifiziert, dass der Wert des ",(0,t.jsx)(n.code,{children:"leftOperand"})," ",(0,t.jsx)(n.code,{children:"dateTime"})," (Datum und Uhrzeit) gr\xf6\xdfer oder gleich (",(0,t.jsx)(n.code,{children:"gteq"}),") dem ",(0,t.jsx)(n.code,{children:"rightOperand"})," ",(0,t.jsx)(n.code,{children:"2023-08-01T00:00+0200"})," sein muss. Dies legt den Beginn des G\xfcltigkeitszeitraums auf den 1. August 2023 um 00:00 Uhr mitteleurop\xe4ischer Sommerzeit (MESZ) fest (UTC+2)."]}),"\n",(0,t.jsxs)(n.p,{children:["Das zweite Constraint-Objekt legt fest, dass derselbe ",(0,t.jsx)(n.code,{children:"leftOperand"})," ",(0,t.jsx)(n.code,{children:"dateTime"})," kleiner als (",(0,t.jsx)(n.code,{children:"lt"}),") der ",(0,t.jsx)(n.code,{children:"rightOperand"})," ",(0,t.jsx)(n.code,{children:"2024-08-01T00:00+0200"})," sein muss. Dies definiert das Ende des G\xfcltigkeitszeitraums auf den 1. August 2024 um 00:00 Uhr MESZ, wobei dieser Zeitpunkt selbst nicht mehr in den G\xfcltigkeitsbereich f\xe4llt."]}
1),"\n",(0,t.jsx)(n.p,{children:"In der Zusammenschau bewirken diese beiden Constraints, dass die Erlaubnis zur Ausf\xfchrung der digitalen Bildungsanwendung auf den Zeitraum vom 1. August 2023, 00:00 Uhr MESZ, bis zum 1. August 2024, 00:00 Uhr MESZ (exklusive), beschr\xe4nkt ist. Dieser Zeitraum deckt das Schuljahr 2023/2024 ab."}),"\n",(0,t.jsx)(n.h3,{id:"kreisweite-lizenz",children:"Kreisweite Lizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine kreisweit g\xfcltige Lizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "constraint": [\n {\n // highlight-start\n "leftOperand": "spatial",\n "operator": "eq",\n "rightOperand": "https://www.wikidata.org/wiki/Q5956",\n "comment": "Landkreis Diepholz"\n // highlight-end\n }\n ]\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine kreisweit g\xfcltige Lizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "constraint": [\n {\n // highlight-start\n "leftOperand": "spatial",\n "operator": "eq",\n "rightOperand": "https://www.wikidata.org/wiki/Q5956",\n "comment": "Landkreis Diepholz"\n // highlight-end\n }\n ]\n }\n ]\n}\n'})})]}),"\n",(0,t.jsx)(n.p,{children:"Dieses ODRL 2.1-Agreement-Beispiel demonstriert eine r\xe4umliche Einschr\xe4nkung f\xfcr die Ausf\xfchrungsberechtigung. Die grundlegende Struktur des ODRL-Dokuments bleibt dabei unver\xe4ndert."}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays wird die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," als ",(0,t.jsx)(n.code,{children:"execute"})," definiert, was die Berechtigung zur Ausf\xfchrung der digitalen Anwendung beinhaltet. Zus\xe4tzlich zu dieser Aktion enth\xe4lt das Berechtigungsobjekt ein ",(0,t.jsx)(n.code,{children:"constraint"}),"-Array, das eine Bedingung f\xfcr die G\xfcltigkeit der Berechtigung festlegt."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"constraint"}),"-Array enth\xe4lt ein einzelnes Constraint-Objekt. Dieses spezifiziert, dass der Wert des ",(0,t.jsx)(n.code,{children:"leftOperand"})," ",(0,t.jsx)(n.code,{children:"spatial"})," (r\xe4umlich) gleich (",(0,t.jsx)(n.code,{children:"eq"}),") dem ",(0,t.jsx)(n.code,{children:"rightOperand"})," ",(0,t.jsx)(n.code,{children:"https://www.wikidata.org/wiki/Q5956"})," sein muss. Der beigef\xfcgte ",(0,t.jsx)(n.code,{children:"comment"})," erl\xe4utert, dass sich dieser Wikidata-Eintrag auf den Landkreis Diepholz in Deutschland bezieht."]}),"\n",(0,t.jsx)(n.p,{children:"In der Gesamtbetrachtung bedeutet dieses Constraint, dass die Erlaubnis zur Ausf\xfchrung der digitalen Bildungsanwendung auf Nutzer beschr\xe4nkt ist, die sich innerhalb des r\xe4umlichen Gebiets des Landkreises Diepholz aufhalten. Diese Art der r\xe4umlichen Einschr\xe4nkung kann beispielsweise relevant sein, um den Zugriff auf bestimmte Medienobjekt auf die Zugeh\xf6rigkeit zum Medie
1nzentrum eines Landkreises zu beschr\xe4nken."}),"\n",(0,t.jsx)(n.h3,{id:"dynamische-lizenz",children:"Dynamische Lizenz"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine dynamisch zugeteilte Lizenz",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "constraint": {\n "leftOperand": "concurrentUses",\n "operator": "lteq",\n "rightOperand": "100"\n }\n // highlight-end\n }\n ]\n}'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine dynamisch zugeteilte Lizenz",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld",\n {\n "ex": "http://example.com/odrl/"\n }\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n // highlight-start\n "constraint": {\n "leftOperand": "ex:concurrentUses",\n "operator": "lteq",\n "rightOperand": "100"\n }\n // highlight-end\n }\n ]\n}'})})]}),"\n",(0,t.jsx)(n.p,{children:"Dieses ODRL 2.1-Agreement-Beispiel, das f\xfcr den Einsatz im deutschen Bildungssystem relevant sein kann, demonstriert eine mengenm\xe4\xdfige Beschr\xe4nkung der Ausf\xfchrungsberechtigung. Die grundlegende Struktur des ODRL-Dokuments bleibt dabei erhalten, wird jedoch um einen zus\xe4tzlichen Kontext erweitert."}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays ist die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," weiterhin als ",(0,t.jsx)(n.code,{children:"execute"})," definiert. Zus\xe4tzlich enth\xe4lt dieses Berechtigungsobjekt ein ",(0,t.jsx)(n.code,{children:"constraint"}),"-Objekt, das eine Bedingung f\xfcr die Ausf\xfchrung festlegt."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"constraint"}),"-Objekt spezifiziert, dass der Wert des ",(0,t.jsx)(n.code,{children:"leftOperand"})," ",(0,t.jsx)(n.code,{children:"concurrentUses"})," kleiner oder gleich (",(0,t.jsx)(n.code,{children:"lteq"}),") dem ",(0,t.jsx)(n.code,{children:"rightOperand"})," ",(0,t.jsx)(n.code,{children:"100"})," sein muss. Dieser Begriff repr\xe4sentiert die Anzahl der gleichzeitig erlaubten Nutzungen des Zielobjekts."]}),"\n",(0,t.jsx)(n.h4,{id:"json-ld-1",children:"JSON-LD"}),"\n",(0,t.jsxs)(n.p,{children:["Die ",(0,t.jsx)(n.code,{children:"@context"}),"-Liste enth\xe4lt hier neben dem Standard-ODRL-Kontext einen weiteren Eintrag. Dieser definiert ein Pr\xe4fix ",(0,t.jsx)(n.code,{children:"ex"})," f\xfcr den Namespace ",(0,t.jsx)(n.code,{children:"http://example.com/odrl/"}),". Dies erm\xf6glicht die Verwendung von Begriffen aus diesem benutzerdefinierten Namespace innerhalb der ODRL-Richtlinie."]}),"\n",(0,t.jsxs)(n.p,{children:["Das ",(0,t.jsx)(n.code,{children:"constraint"}),"-Objekt spezifiziert, dass der Wert des ",(0,t.jsx)(n.code,{children:"leftOperand"})," ",(0,t.jsx)(n.code,{children:"ex:concurrentUses"})," kleiner oder gleich (",(0,t.jsx)(n.code,{children:"lteq"}),") dem ",(0,t.jsx)(n.code,{children:"rightOperand"})," ",(0,t.jsx)(n.code,{children:"100"})," sein muss. Hierbei bezieht sich ",(0,t.jsx)(n.code,{children:"ex:concurrentUses"})," auf einen Begriff aus dem zuvor definierten benutzerdefinierten Namespace ",(0,t.jsx)(n.code,{children:"http://example.com/odrl/"}),". Dort wird definiert, dass dieser Begriff die Anzahl der gleichzeitigen Nutzungen des Zielobjekts repr\xe4sentiert."]}),"\n",(0,t.jsx)(n.p,{children:"In der Gesamtbetrachtung bedeutet dieses Constraint, dass die Erlaubnis zur Ausf\xfchrung der digitalen Anwendung auf maximal 100 gleichzeitige Nutzungen beschr\xe4nkt ist. Diese Art der mengenm\xe4\xdfigen Beschr\xe4nkung kann beispielsweise verwendet werden, um die Lizenzbedingungen hinsichtlich der Anzahl paralleler Zugriffe auf eine digitale Ressource durchzusetzen."}),"\n",(0,t.jsx)(n.h2,{id:"kombination-von-lizenzbedingungen",children:"Komb
1ination von Lizenzbedingungen"}),"\n",(0,t.jsxs)(d.A,{groupId:"accept-type",queryString:!0,children:[(0,t.jsx)(l.default,{value:"json",label:"JSON",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Kombination von Lizenzbedingungen",showLineNumbers:!0,children:'{\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "constraint": [\n {\n "leftOperand": "dateTime",\n "operator": "gteq",\n "rightOperand": "2023-08-01T00:00+0200"\n },\n {\n "leftOperand": "dateTime",\n "operator": "lt",\n "rightOperand": "2024-08-01T00:00+0200"\n }\n ],\n "assignee": {\n "partOf": {\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:organisation:kennung",\n "operator": "eq",\n "rightOperand": "NI_12345"\n }\n ]\n },\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:rolle",\n "operator": "eq",\n "rightOperand": "lehr"\n }\n ]\n }\n }\n ]\n}\n'})}),(0,t.jsx)(l.default,{value:"json-ld",label:"JSON LD",children:(0,t.jsx)(a.default,{language:"js",title:"Beispiel f\xfcr eine Kombination von Lizenzbedingungen",showLineNumbers:!0,children:'{\n "@context": [\n "http://www.w3.org/ns/odrl.jsonld"\n ],\n "@type": "Agreement",\n "uid": "https://example.com/v1/policies-info/9230294b-68da-4f4f-aa63-ad9040122aa7",\n "target": {\n "uid": "urn:issuer:medium:123456789",\n "partOf": "urn:issuer:catalogue"\n },\n "permission": [\n {\n "action": [\n "execute"\n ],\n "constraint": [\n {\n "leftOperand": "dateTime",\n "operator": "gteq",\n "rightOperand": "2023-08-01T00:00+0200"\n },\n {\n "leftOperand": "dateTime",\n "operator": "lt",\n "rightOperand": "2024-08-01T00:00+0200"\n }\n ],\n "assignee": {\n "partOf": {\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:organisation:kennung",\n "operator": "eq",\n "rightOperand": "NI_12345"\n }\n ]\n },\n "refinement": [\n {\n "leftOperand": "urn:schulconnex:de:personenkontext:rolle",\n "operator": "eq",\n "rightOperand": "lehr"\n }\n ]\n }\n }\n ]\n}\n'})})]}),"\n",(0,t.jsxs)(n.p,{children:["Dieses umfassende ODRL 2.1-Agreement-Beispiel kombiniert mehrere Aspekte der Rechteverwaltung, indem es sowohl zeitliche Einschr\xe4nkungen als auch eine pr\xe4zise Definition des Berechtigten f\xfcr die Ausf\xfchrungsaktion festlegt. Die grundlegende Struktur des ODRL-Dokuments bleibt dabei erhalten, wobei nun sowohl das ",(0,t.jsx)(n.code,{children:"constraint"}),"- als auch das ",(0,t.jsx)(n.code,{children:"assignee"}),"-Attribut detaillierte Bedingungen enthalten."]}),"\n",(0,t.jsxs)(n.p,{children:["Innerhalb des ",(0,t.jsx)(n.code,{children:"permission"}),"-Arrays wird die erlaubte ",(0,t.jsx)(n.code,{children:"action"})," als ",(0,t.jsx)(n.code,{children:"execute"})," definiert, was die Berechtigung zur Ausf\xfchrung der digitalen Anwendung umfasst. Das Attribut ",(0,t.jsx)(n.code,{children:"constraint"})," enth\xe4lt ein Array mit zwei Constraint-Objekten, die, wie bereits im vorherigen Beispiel erl\xe4utert, den G\xfcltigkeitszeitraum der Berechtigung auf das Schuljahr 2023/2024 (vom 1. August 2023, 00:00 Uhr MESZ, bis zum 1. August 2024, 00:00 Uhr MESZ exklusive) beschr\xe4nken."]}),"\n",(0,t.jsxs)(n.p,{children:["Das Attribut ",(0,t.jsx)(n.code,{children:"assignee"})," definiert, wer zur Ausf\xfchrung der Anwendung berechtigt ist. Hier finden sich zwei Arten von Verfeinerungen. Zum einen gibt es ein ",(0,t.jsx)(n.code,{children:"partOf"}),"-Objekt mit einem ",(0,t.jsx)(n.code,{children:"refinement"}),"-Array, das besagt, dass der Berechtigte Teil einer Organisation sein muss, deren Kennung (",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:organisation:kennung"}),") dem Wert ",(0,t.jsx)(n.code,{children:"NI_12345"})," entspricht. Zum anderen gibt es ein direkt im ",(0,t.jsx)(n.code,{children:"assignee"}),"-Objekt enthaltenes ",(0,t.jsx)(n.code,{children:"refinement"}),"-Array, das festlegt, dass die Rolle der berechtigten Person (",(0,t.jsx)(n.code,{children:"urn:schulconnex:de:personenkontext:rolle"}),") den Wert ",(0,t.jsx)(n.code,{children:"lehr"})," haben muss."]}),"\n",(0,t.jsxs)(n.p,{children:["In der Kombination bedeuten diese Bedingungen, dass die Erlaubnis zur Ausf\xfchrung der digitalen Bildungsanwendung ausschlie\xdflich den Lehrkr\xe4ften (Rolle ",(0,t.jsx)(n.code,{children:"lehr"}),") der Organisation mit der Kennung ",(0,t.jsx)(n.code,{children:"NI_12345"})," gew\xe4hrt wird, und dies auch nur innerhalb des definierten Zeitraums des Schuljahres 2023/2024. Dieses Beispiel zeigt, wie ODRL genutzt werden kann, um sehr spezifische und kontextbezogene Zugriffsrechte auf digitale Ressourcen im Bildungsbereich zu definieren."]})]})}function p(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(g,{...e})}):g(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.