azizi:export

Azizi Direktanbindungen

Azizi kann auch Datenbanken von Veranstaltern über eine direkte Anbindung automatisch Event-Daten beziehen und so weiterverteilen.

Der Datenlieferant stellt dazu einen Endpoint (URL) zur Verfügung, über welchen die Veranstaltungsdaten als XML-Datei gemäss dem Azizi-Schema heruntergeladen werden können.

  1. API-Funktion entwickeln, welche XML-Daten gemäss dieser Spezifikation generiert.
  2. XML-Download mit dem XSD-Schema überprüfen, z.B. mit diesem Validator.
  3. Zeigt der Validator keine Fehler mehr an, Download-Link an Saiten schicken zur Integration. Der Link sollte frei zugänglich sein, ohne Authentifizierung.
  4. Wenn unsere Tests ebenfalls erfolgreich sind, schalten wir den Import auf.

Im Azizi-Schema wird beschrieben, wie verschiedene Arten von Veranstaltungen (Einzelveranstaltungen, Ausstellungen, etc.) optimal abgebildet werden sollten. Das liefernde System sollte in der Lage sein, seine Daten gemäss diesen Empfehlungen zu strukturieren.

Generell lässt sich die Sache mit den Kategorien nicht logisch völlig korrekt lösen, denn jedes beteiligte System und jede Institution sieht das wieder anders:

  • Art der Kategorien sind unterschiedlich
  • Detaillierungsgrad unterscheidet sich
  • Einige System erlauben genau eine Rubrik, andere mehrere
  • Manche führen nebst Hauptkategorien noch Unterkategorien

Azizi bedient als Datensammelstelle verschieden Plattformen (Datenbezüger). Schlussendlich entscheidet jeder Datenbezüger selber, welche Kategorien ihn interessieren und wie er diese in seinem eigenen System abbildet. Bei Azizi arbeiten wir mit einer mittellangen Liste, um möglichst das ganze Spektrum an Veranstaltungen abzudecken:

  • Das Feld <mainCategory> muss vom Datenlieferanten zwingend mit einer der im Schema vorhandenen Kategorien befüllt werden.
  • <mainCategory> darf nur einmal vorkommen. Es ist also nicht möglich, einer Veranstaltung zwei Kategorien zuzuordnen.
  • Im Feld kann der Datenlieferant eine Unterkategorie oder auch eine zweite Kategorie liefern. Hier handelt es sich um ein freies Textfeld.
  • Es ist Sache des Datenlieferanten, wie seine eigenen Kategorien einer der Azizi-Kategorie zugeordnet werde soll.

Beim Import in Azizi werden die gelieferten Daten jeweils gemäss Schema validiert. Treten dabei Fehler auf, kann es passieren, dass ein Event oder auch der gesamte Datensatz nicht importiert werden kann. Diese Daten fehlen dann auch in den Systemen unserer Datenbezüger.

Bitte achtet also darauf, dass euer System so programmiert ist, dass nur gültige Daten erfasst werden können! Dies betrifft insbesondere alle Pflichtfelder.

  • azizi/export.txt
  • Zuletzt geändert: 14.02.2024 17:42
  • von manuel.maerklin