Allgemeinen Schnittstellenbeschreibung
Das viewMAX Interface ist eine Import-Schnittstelle. Datensätze können nur aus anderen Systemen übernommen werden, ein Rückkanal steht nicht zur Verfügung.
Inhaltsverzeichnis
Datentransfer
Das viewMAX Interface bietet drei Verfahren zum Datentransfer über IP Netzwerke:
- Import aus Textdatei (bevorzugt aus CSV-Dateien) über Netzwerkfreigaben oder FTP
- Import aus XML Datei (nicht empfohlen)
- SOAP via HTTP/HTTPS (erfordert individuelle Anpassungen)
- Direktes Auslesen der Daten aus fremden SQL Datenbanken (z.B. per Views; erfordert individuelle Anpassungen)
Vorausetzung für den Datenabgleich via Datei
- Für den aktuelle Tag müssen ständig alle Datensätze im Exportmedium vorhanden sein.
- Veranstaltungen die nicht weiter übermittelt werden, fehlerhafte oder nicht mehr aktuelle Datensätze, werden aus dem viewMAX System gelöscht.
- Eine Archivierung von alten Veranstaltungen erfolgt nicht.
Datensatzbeschreibung
Name | Anzahl | Beschreibung |
---|---|---|
Eindeutige ID | 1 | Wird vom Fremdsystem generiert |
Timestamp | 1 | Zeitstempel an dem der Datensatz erstellt oder zum letzten Mal verändert wurde. |
Name | 1 | Raumname |
Zeitraum | 2 | Anfangs- und Endzeit |
Text | 3 | Freie Textfelder wie z.B. Name der Veranstaltung, Beschreibung, Trainer usw. |
Je Veranstaltung nur ein Datensatz !
Datum und Zeit können bei Bedarf getrennt werden
Beispiele
Import aus CSV Textdatei
Das Fremdsystem generiert in bestimmten Abständen alle aktuelle Datensätze, die dann regelmässig vom viewMAX Interface ausgelesen, validiert und importiert werden. Der Interval zum Datenimport ist auf der viewMAX Seite frei wählbar.
Trennzeichen Tabulator ASCII 9 (Im Beispiel Semikolon zur besseren Lesbarkeit)
0815;200807280954;Raum 001;2008-07-28 10:30:00;2008-07-28 18:00:00;netMAX GmbH;Schulung;Herr Meier
Import aus XML Datei
Formate
Timestamp: beliebig numerisch fortlaufend Datum und Zeit: ISO „YYYY-MM-DD hh:mm:ss“ bevorzugt Codierung: UTF-8 (CSV Datei mit und ohne BOM Signature)