Dokumentation
Anleitung

Metadaten mit Harvest abrufen

Metadaten seitenweise abrufen und den zusätzlichen Prüfdatensatz sowie Exportgrenzen berücksichtigen.

Auf dieser Seite

harvest liest größere Metadatenmengen. Die Funktion benötigt eine eigene Freigabe. Stimmen Sie einen vollständigen Lauf vorab mit uns ab. Ein Metadatenexport ist keine dauerhafte Wiedergabe- oder Downloadberechtigung.

Request und Antwort

<harvest start="0" count="100" format="arix"/>
Attribut Bedeutung
start nullbasierter Offset; Standard 0
count Seitengröße; immer ausdrücklich positiv setzen
format für diese Anleitung arix
mime optionaler HTTP-Content-Type, keine Formatkonvertierung

Schematische Antwort:

<result more="more">
  <r identifier="anbieter-12345">
    <f n="titel">Beispieltitel</f>
  </r>
</result>

more="more" zeigt an, dass über die angeforderte Seitengröße hinaus noch ein Datensatz gefunden wurde. Fehlt das Attribut, hat der Abruf keinen solchen zusätzlichen Datensatz ergeben.

Besonderheit: ein zusätzlicher Datensatz

Die Antwort kann einen zusätzlichen Datensatz enthalten, der weitere Ergebnisse anzeigt. Bei count="100" können deshalb 101 Datensätze zurückkommen.

Verarbeiten Sie die Seiten wie folgt:

  1. Höchstens die ersten count Datensätze der Antwort verarbeiten.
  2. Bei more="more" den nächsten Abruf mit start + count ausführen.
  3. Ohne more den Durchlauf beenden.

Wer alle 101 Datensätze verarbeitet und trotzdem nur um 100 weiterblättert, erhält den Grenzdatensatz erneut. Der zusätzliche Datensatz ist kein Beleg für einen Fehler im XML-Parser. Andere, gesondert vereinbarte Exporthandler können ihn bereits abschneiden; verifizieren Sie das Verhalten Ihres Zugangs an einer Seitengrenze.

Grenzen des Exports

Der Handler sortiert nach Titel und liest keinen unveränderlichen Snapshot. Gleiche Titel oder Änderungen während des Laufs können die Seiten verschieben. Identifier deduplizieren; für eine Vollständigkeitsgarantie ist ein abgestimmtes Exportverfahren mit stabiler Reihenfolge erforderlich.

Der Harvest-Pfad verwendet eine eigene Datenabfrage und Lizenzprüfung mit Kaufoption. Sein Bestand muss nicht mit einer normalen Suche oder mit unmittelbar abspielbaren Medien identisch sein. Auch die Datenquelle ist nicht automatisch dieselbe wie die konfigurierte Such-View.

Feldinhalte unterliegen der historischen ARIX-Textersetzung. Das vorhandene csv-Verhalten sollte nicht als zuverlässiger CSV-Export verwendet werden. mime="text/csv" ändert allein den Header und löst dieses Problem nicht.

Betrieb

Eine begrenzte Seitengröße wählen, Requests nacheinander ausführen und nach Transportfehlern mit Wartezeit wiederholen. Einen vollständigen Lauf nicht bei jedem Seitenaufruf der eigenen Anwendung starten. Für Aktualisierung, Löschungen und Aufbewahrung ein eigenes Verfahren vereinbaren: Diese Anleitung beschreibt weder einen Deltafeed noch eine Löschbenachrichtigung.

Zur Übersicht: Einstieg in die ARIX-Schnittstelle