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.

Datentransfer

Das viewMAX Interface bietet drei Verfahren zum Datentransfer über IP Netzwerke:

1. Import aus Textdatei (bevorzugt aus CSV-Dateien) über Netzwerkfreigaben oder FTP
2. Import aus XML Datei (nicht empfohlen)
3. SOAP via HTTP/HTTPS (erfordert individuelle Anpassungen)
4. 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

4. 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)