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:
- Höchstens die ersten
countDatensätze der Antwort verarbeiten. - Bei
more="more"den nächsten Abruf mitstart + countausführen. - Ohne
moreden 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