Dokumentation
Referenz

Datensätze, Identifier und Metadaten auswerten

Identifier, record-Antworten, gebräuchliche Metadatenfelder und historische Textkodierung verstehen.

Auf dieser Seite

Der identifier bezeichnet ein Medium im ARIX-Datenbestand. Er ist nicht mit einer EAF-Mediennummer, einer ISBN oder der Nummer eines Suchtreffers gleichzusetzen. Übernehmen Sie ihn aus einer Antwort, statt ihn aus Titel oder Mediennummer zusammenzusetzen.

Einzelnen Datensatz abrufen

Voraussetzung ist die Freigabe record.

<record identifier="anbieter-12345"/>

Der Handler reicht den Abruf an die konfigurierte Datensatzauflösung weiter. Eine mögliche Antwort ist:

<record identifier="anbieter-12345">
  <f n="titel">Der Wasserkreislauf</f>
  <f n="text">Verdunstung und Niederschlag.</f>
  <f n="typ">55</f>
</record>

Das ist ein schematisches Beispiel, keine aufgezeichnete Serverantwort. Der äußere Aufbau und zusätzliche Felder können von der Datensatzauflösung abhängen. Insbesondere ist die alte Aussage „wie search, nur mit einem Treffer“ kein verlässlicher Vertrag. Prüfen Sie das Antwortformat Ihres Zugangs vor der Implementierung des Parsers.

Das template-Attribut gehört nicht zur hier beschriebenen Datensatzabfrage. Verwenden Sie es nicht als zugesicherte HTML-Datenblattfunktion. Die Datenquelle wird serverseitig bestimmt; table nicht ohne Vereinbarung setzen.

Identifier unverändert behandeln

Historische Suchantworten ersetzen Bindestriche nach dem Anbieterpräfix durch ~. Aus anbieter-teil1-teil2 kann deshalb anbieter-teil1~teil2 werden. record wandelt ~ wieder in - um. Diese Behandlung gilt nicht automatisch für jeden anderen Befehl. Für Medienlinks und Lizenzverwaltung die dort vereinbarte vollständige Kennung verwenden und die Umsetzung mit einem entsprechenden Testmedium prüfen.

Häufige Metadatenfelder

Metadatenwerte sind zunächst Text. Die folgende Liste beschreibt gebräuchliche Felder, keine Pflichtfelder jedes Datensatzes und keine vollständige Liste aller installationsabhängigen Felder.

Bereich Felder und Bedeutung
Kennungen nr: Mediennummer; paranr, paranr2: Parallelnummern; isbn: ISBN
Titel titel, utitel: Titel und Untertitel; sertitel, serutitel: Serientitel und -untertitel; orgtitel: Originaltitel; paratitel: Paralleltitel
Beschreibung text: Beschreibung; kurztext, langtext: Kurz- und Langtext; didanmerk: didaktische Anmerkungen
Inhaltliche Erschließung schlag: Schlagwörter; geb: Sachgebietsangaben; gebtext: Sachgebietstext; themen, lernziele, vork: Themen, Lernziele, Vorkenntnisse
Zielgruppe adressat: Adressaten; fsk: Altersfreigabe; eignung: Eignungsangaben
Medienform typ: Medienart; typtext: Medienart als Text; laenge: Umfang/Länge; sprache, sprachfassungen: Sprachangaben
Herstellung produ, prodjahr, prodland: Produzent, Produktionsjahr und -land; herausgeber, lieferant, urheber, autor
Mitwirkende regie, kamera, musik, litvorlage
Material begleit, beigaben, bildliste, kontextmedien, einzeltitel
Technik techtext, techdat, systemvor
Rechte und Zeiträume rechte, vorfrecht, vorfbis, verfanf, verfende, empfende
Weitere Angaben url, links, praedikate, bemerk, datum

Taxonomiecodes, Trennzeichen, Datumsdarstellungen und Einheiten hängen vom Datenbestand ab. laenge ist beispielsweise nicht pauschal eine Sekundenanzahl, typ nicht überall derselbe Klartext. Erfragen Sie für automatisch ausgewertete Felder Format und zulässige Werte. Ein Metadaten-Rechtefeld ersetzt keine aktuelle Prüfung der Abspielberechtigung.

Das zusätzliche Suchfeld licence ist eine Lizenzinformation des Suchhandlers, kein boolescher Wert und keine dauerhafte Freigabe. Links zum Abspielen werden über notch und link angefordert. Das Feld url kann eine Webseite beschreiben; es ist nicht generell die Video- oder Downloadadresse.

XML und historische Textkodierung

In Suchantworten kann eine historische Ersetzung aktiv sein: & wird als Backslash ausgegeben, < als ~; bereits vorhandene Tilden werden entfernt. Bei deaktivierter Ersetzung verwendet der Suchhandler XML-Entities. harvest besitzt ebenfalls eine historische Ersetzung. record verwendet dagegen die jeweilige Datensatzauflösung.

Diese Varianten nicht durch globale Zeichenersetzung im gesamten XML „reparieren“. Das würde auch Identifier und Attribute verändern. Vereinbaren Sie das Textformat pro Antworttyp und verarbeiten Sie Feldinhalte erst nach dem Parsen. Die historische Ersetzung ist nicht vollständig verlustfrei.

Metadaten können HTML-Fragmente enthalten. Als Text anzeigen oder vor einer HTML-Darstellung gezielt bereinigen; niemals ungeprüft als ausführbares HTML einfügen. XML-Parser ohne externe Entitäten und ohne Netzwerkzugriffe betreiben. Eine leere oder nicht parsebare Antwort als Fehler behandeln, nicht als gültigen leeren Datensatz.

EAF-Kompatibilität

Verwenden Sie die für Ihren Zugang vereinbarten ARIX-Feldnamen. eaf="eaf" ist keine zugesicherte Umschaltung auf EAF-Feldnamen. Wenn Sie eine spezielle EAF-Ausgabe benötigen, stimmen Sie deren Format mit uns ab. Feldlisten aus anderen Integrationen sind nicht automatisch auf Ihren Zugang übertragbar.

Zur Übersicht: Einstieg in die ARIX-Schnittstelle