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