Allgemeines Metadatenprofil für Bildungsressourcen (AMB)

## Zusammenfassung Ein bildungsbereichübergreifendes Metadatenprofil für die Beschreibung von Lehr- und Lernressourcen, das hauptsächlich auf [[?schema.org]] bzw. Learning Resource Metadata Initiative [[?LRMI]] basiert und zusätzlich Teile von Simple Knowledge Organization System [[?SKOS]] nutzt. Definiert wird eine [[JSON-LD11]]-konforme Datenstruktur in Form dieser HTML-Spezifikation inklusive eines JSON-Schemas, gegen das Daten automatisiert auf Konformität mit dem Profil geprüft werden können.

CC-BY Dieses Werk ist lizenziert unter Creative Commons Public Domain Dedication 1.0.

## Einleitung Metadaten sind beschreibende Daten, die das Auffinden von relevanten Wissensressourcen erleichtern sollen. Metadaten für Bildungsressourcen sollen das Finden und den Austausch von im Web verfügbaren Lehr- und Lernressourcen unterstützen. Es existieren bereits eine Menge unterschiedlicher Metadatenschemas für die Beschreibung von Webressourcen. Prominente Beispiele sind [[DC-Terms]] oder [[schema.org]]. Diese Schemas sind oft sehr allgemein gehalten, damit sie von einer Vielzahl von Angeboten sinnvoll nutzbar sind. Community- oder anwendungsspezifische Konkretisierungen, Erweiterungen oder auch Kombinationen von Metadatenschemas werden in sogenannten Metadatenprofilen (Englisch "metadata profiles", häufig auch "application profiles" genannt) festgehalten. Metadatenprofile beschreiben also die Art und Weise der Nachnutzung existierender Metadatenschemas, indem sie folgende Informationen angeben: - Welche Properties (Metadatenfelder) und Typen aus welchen Metadatenschemas werden benutzt? - Welche zusätzlichen Einschränkungen bei der Nutzung sind festgelegt, z.B. Pflichtfelder, Wiederholbarkeit eines Feldes, Formatvorgaben für Werte, genutzte kontrollierte Vokabulare? ### Bildungsbereiche Das Allgemeine Metadatenprofil für Bildungsressourcen (AMB) ist bewusst so allgemein gehalten, dass sie sowohl den Schul- als auch den Hochschulbereich abdeckt. Bei Unterschieden in beiden Bildungsbereichen (fachliche Zuordnung, Ressourcentyp) wird auf bereichsspezifische Best Practices verwiesen. ### Basis-Metadatenschemas Das AMB baut hauptsächlich auf [[schema.org]] auf und nutzt eine Untermenge von Typen und Properties des schema.org-Typs [`CreativeWork`](https://schema.org/CreativeWork). Viele der hier genutzten Elemente wurden durch die Learning Resource Metadata Intitiative ([[LRMI]]) in [[schema.org]] ergänzt. Zudem verlangt das AMB die Nutzung kontrollierter Vokabulare, die [[SKOS]]-konform veröffentlicht wurden, weshalb auch einige wenige SKOS-Properties enthalten sind. ### Beziehung zu HS-OER-LOM Mit dem Allgemeinen Metadatenprofil für Bildungsressourcen veröffentlicht das Kompetenzzentrum Interoperable Metadaten (KIM) eine zweite Spezifikation zur Auszeichnung von Lehr- und Lernressourcen mit Metadaten. Mit [[HS-OER-LOM]] wurde Anfang 2020 bereits ein LOM-basiertes Metadatenprofil veröffentlicht, das auf den Hochschulbereich zugeschnitten ist. Die Profile unterscheiden sich in folgenden Hinsichten: | | HS-OER-LOM | AMB | | --- | --- | --- | | Quell-Schema | LOM | schema.org | | Format | XML | JSON-LD | | Linked-Data | nein | ja | | Bildungsbereich | Hochschule | Schule & Hochschule | Mit Blick auf den Hochschulbereich nutzen beide Profile dieselben Werte für die Ausweisung des Ressourcentyps und die Zuweisung einer Ressource zu einem Fach. Die Werte kommen aus kontrollierten Vokabularen, die ebenfalls von KIM bereitgestellt werden: die [[Hochschulfächersystematik]] und das Ressourcentypen-Vokabular [[HCRT]]. Damit wird Interoperabilität der Metadatenprofile in Bezug auf den Hochschulbereich hergestellt.

## Format und Bereitstellung Die Metadaten einer Ressource werden durch ein JSON-Dokument repräsentiert. Dieses JSON-Dokument MUSS einige obligatorische und KANN zusätzlich optionale Schlüssel/Werte-Paare des Profils beinhalten. Das Metadatendokument einer Ressource MUSS im JSON-LD-Format ([[JSON-LD11]]) bereitgestellt werden, entweder eingebettet in die Bildungsressource selbst bzw. – bei Nicht-HTML-basierten Lernressourcen – in die HTML-Beschreibungsseite oder als eigenständige Webressource – d.h. unter einer dedizierten URL. Die [[JSON-LD11]]-konforme Bereitstellung wird erreicht durch die Verlinkung eines [JSON-LD-Kontext-Dokuments](https://www.w3.org/TR/json-ld/#the-context) mit dem @context Keyword. ### In eine HTML-Seite eingebettete Metadaten Wenn die Metadaten in die Lernressource oder ihre Beschreibungsseite eingebettet werden, MUSS das JSON-Dokument in einem `script`-Element im `head`-Bereich der Webseite eingefügt werden: ``` ``` ### Metadaten als eigenständige Webressource Werden die Metadaten als Webressource unter einer eigenständigen URL angeboten, MUSS der `Content-Type` Header auf `application/ld+json` gesetzt werden: ``` Content-Type: application/ld+json ``` Der Metadatensatz MUSS auf eine der folgenden Arten in die Bildungsressource bzw. ihre Beschreibungsseite eingebunden werden: 1. Ein `link`-Element , das das JSON-Dokument referenziert, MUSS in den `head`-Bereich der Webseite eingebettet werden: ``` ``` ODER 2. Ein `Link` Header, der das JSON-Dokument referenziert, MUSS gemeinsam mit der Webseite ausgeliefert werden: ``` HTTP/1.1 200 OK Link: <[...]>; rel="describedby" ```

## Profil Als Basis-Metadatenschema für die Beschreibung einer Educational Resource dient [[!schema.org]]. Ergänzt wird schema.org durch [[!SKOS]] (Simple Knowledge Organization System) für die Beschreibung referenzierter Werte eines kontrollierten Vokabulars. Im Folgenden wird die Struktur eines OER-Metadatensatzes beschrieben. Nebst einer Kurzbeschreibung wird angegeben, ob der Wert eine Pflichtangabe ist und um welchen Typ es sich handelt. Wenn erforderlich wird der Wertebereich festgelegt und es werden kurze Beispiele gegeben.

### @context Die `@context`-Property enthält einen Array mit einem URI-String zur Referenzierung des [JSON-LD-Kontext](https://www.w3.org/TR/json-ld/#the-context) des Profils: `https://w3id.org/kim/amb/draft/context.jsonld`. Außerdem mit einem JSON-Objekt zur Angabe der im JSON-Dokument genutzten Sprache mittels dem JSON-LD-Keyword `@language` und einem [[?BCP47]] Sprachcode als Wert. Für ein deutschsprachiges Metadatendokument sieht es z.B. wie folgt aus: ```json { "@context":[ "https://w3id.org/kim/amb/draft/context.jsonld", { "@language":"de" } ] } ```

Pflichtfeld: ja
Typ: `array[string/object]`
Werte: `https://w3id.org/kim/amb/draft/context.jsonld`; `object`
Validierung: JSON Schema

### id Die URL, durch den die Ressource identifiziert wird. Auf dieser URL MUSS die Ressource abrufbar sein. Es SOLL keine URL sein, von der aus nur auf die Ressource verwiesen wird.

Pflichtfeld: ja
Typ: `string` (URI)
Validierung: JSON Schema

### type Art der Ressource. MUSS den Wert `LearningResource` enthalten. KANN weitere Werte aus den Unterklassen von `https://schema.org/CreativeWork` enthalten.

Pflichtfeld: ja
Typ: `array[string]`
Werte: `LearningResource` und Unterklassen von CreativeWork
Validierung: JSON Schema

### name Titel der Ressource.

Pflichtfeld: ja
Typ: `string`
Validierung: JSON Schema

### creator Urheber:innen der Ressource. MUSS ein oder mehrere JSON-Objekte enthalten, die wiederum `type` und `name` Properties aufweisen MÜSSEN und `id` – mit einer URI-Referenz zu [[?ORCID]], [[?GND]], [[?Wikidata]] oder [[?ROR]] – aufweisen SOLLEN sowie – bei Personen – eine affiliation-Angabe enthalten KANN. Der Name (`name`) SOLL als vollständiger Name ohne akademischen Titeln angegeben werden, bei Namen aus dem deutschen Sprachraum z.B. in der Form "Vorname Nachname".

Pflichtfeld: nein
Typ: `array[object]`
Werte: JSON-Objekt mit Properties `type` und `name`
Validierung: JSON Schema

### contributor Sonstige Beitragende zu der Ressource. MUSS ein oder mehrere JSON-Objekte enthalten, die wiederum `type` und `name` Properties aufweisen MÜSSEN und `id` – mit einer URI-Referenz zu [[?ORCID]], [[?GND]], [[?Wikidata]] oder [[?ROR]] – aufweisen SOLLEN sowie – bei Personen – eine affiliation-Angabe enthalten KANN. Der Name (`name`) SOLL als vollständiger Name ohne akademischen Titeln angegeben werden, bei Namen aus dem deutschen Sprachraum z.B. in der Form "Vorname Nachname".

Pflichtfeld: nein
Typ: `array[object]`
Werte: JSON-Objekt mit Properties `type` und `name`
Validierung: JSON Schema

### affiliation Die Affiliierung einer beitragenden Person im Kontext der Erstellung der Lernressource. MUSS ein JSON-Objekt enthalten, das wiederum `type` und `name` Properties aufweisen MUSS und `id` – mit einer URI-Referenz zu [[?GND]], [[?Wikidata]] oder [[?ROR]] – aufweisen SOLL.

Pflichtfeld: nein
Typ: `object`
Validierung: JSON Schema

### description Beschreibung der Ressource.

Pflichtfeld: nein
Typ: `string`
Validierung: JSON Schema

### about Fach/Thema der Inhalte. MUSS ein oder mehrere JSON-Objekte enthalten, die eine Property `id` mit einem URI aus der [[Hochschulfächersystematik]] ODER aus der [[Schulfächerliste]] der DINI-AG-KIM enthalten MÜSSEN.

Pflichtfeld: nein
Typ: `array[object]`
Werte: Werte aus [[Hochschulfächersystematik]] oder [[Schulfächerliste]] der DINI-AG-KIM
Validierung: JSON Schema

### keywords Schlagworte zur Beschreibung des Inhalts der Ressource.

Pflichtfeld: nein
Typ: `array[string]`
Validierung: JSON Schema

### license Lizenz der Ressource. MUSS ein JSON-Objekt enthalten, das eine Property `id` mit einem URI als Wert enthält, der auf eine Creative Commons-Lizenz, GNU, Apache, MIT oder BSD verlinkt. Für die URI-Werteliste siehe [hier](https://w3id.org/kim/amb/draft/schemas/license.json).

Pflichtfeld: nein
Typ: `object`
Validierung: JSON Schema

### image Thumbnail der Ressource.

Pflichtfeld: nein
Typ: `string` (URI)
Werte
Validierung: JSON Schema

### dateCreated Erstellungsdatum der Ressource. MUSS einer Datumsangabe gemäß [[!ISO8601]] entsprechen.

Pflichtfeld: nein
Typ: `Date`
Werte: [[!ISO8601]]
Validierung: JSON Schema

### datePublished Publikationssdatum der Ressource. MUSS einer Datumsangabe gemäß [[!ISO8601]] entsprechen.

Pflichtfeld: nein
Typ: `Date`
Werte: [[!ISO8601]]
Validierung: JSON Schema

### inLanguage Sprache(n) der Ressource. MUSS den Sprachcodes gemäß [[!BCP47]] entsprechen.

Pflichtfeld: nein
Typ: `array[string]`
Werte: [[!BCP47]]
Validierung: JSON Schema

### learningResourceType Art des Lernmittels. MUSS ein oder mehrere JSON-Objekte enthalten, die eine Property `id` mit einem URI aus [[HCRT]] ODER [[OEHRT]] als URI enthalten MÜSSEN.

Pflichtfeld: ja
Typ: `array[object]`
Werte: JSON-Object mit `id`-Wert aus [[HCRT]] oder [[OEHRT]]
Validierung: JSON Schema

### publisher Die Organisation, über die die OER veröffentlicht wurde. MUSS ein oder mehrere JSON-Objekte enthalten, die mindestens `type` mit value `Organization` und `name` Properties aufweisen.

Pflichtfeld: ja
Typ: `array[object]`
Werte: JSON-Objekt mit Properties `type` und `name`
Validierung: JSON Schema

### audience Zielgruppe(n) des Angebotes. MUSS einer *Educational Audience Role* von [[!LRMI]] entsprechen.

Pflichtfeld: nein
Typ: `array[string (URI)]`
Werte: LRMI Educational Audience Roles
Validierung: JSON Schema

### encoding Möglichkeiten zum Download der Ressource.

Pflichtfeld: nein
Typ: `array[object]`
Werte: JSON-Objekt, das `"type": "MediaObject"` sowie die Property `contentUrl` oder `embedUrl` enthalten MUSS und folgende weitere Properties enthalten KANN: `contentSize`, `embedUrl`, `sha256`, `bitrate` sowie `encodingFormat`, das bei Verwendung Werte aus [[IANA-MEDIA-TYPES]] enthalten MUSS.
Validierung: JSON Schema

### isBasedOn Verweis auf andere Ressource, von der die beschriebene Ressource ein Derivat ist.

Pflichtfeld: nein
Typ: `array[object]`
Validierung: JSON Schema

### isPartOf Verweis auf andere Ressource(n), von der/denen die beschriebene Ressource ein Teil ist. MUSS ein oder mehrere JSON-Objekte enthalten, die `id` Property aufweisen MÜSSEN und weitere Properties enthalten KÖNNEN.

Pflichtfeld: nein
Typ: `array[object]`
Werte: JSON-Objekt mit Property `id`
Validierung: JSON Schema

### hasPart Verweis auf andere Ressource(n), die von der die beschriebene Ressource ein Teil ist/sind. MUSS ein oder mehrere JSON-Objekte enthalten, die `id` Property aufweisen MÜSSEN und weitere Properties enthalten KÖNNEN.

Pflichtfeld: nein
Typ: `array[object]`
Werte: JSON-Objekt mit Property `id`
Validierung: JSON Schema

### mainEntityOfPage In diesem Feld können die Struktur-Metadaten ausgeführt werden, welche den eingebetten Strukturkontext der bereitgestellten Metadaten erfassen: - `id` zur Angabe der Landing-Page der Metadaten - `provider` zur Angabe des Metadaten-Providers mit einem dazugehörigen Objekt, das `id`,`type` und `name` des Providers angibt - `dateCreated` zur Angabe des Erstellungsdatums der Metadaten - `dateModified` zur Angabe des Änderungsdatum der Metadaten

Pflichtfeld: nein
Typ: `array[object]`
Validierung: JSON Schema

JSON Schema

Beispiele

Beispiele aus dem Bereich Hochschule

Beispiele aus dem Bereich Schule