Allgemeinen Schnittstellenbeschreibung: Unterschied zwischen den Versionen

Aus netMAX Wiki
Wechseln zu: Navigation, Suche
(Beispiele)
(Import aus XML Datei)
Zeile 61: Zeile 61:
 
=== Import aus XML Datei ===
 
=== Import aus XML Datei ===
  
Der Import aus einer XML Datei muss angepasst werden
+
Der Import aus einer XML Datei muss individuell angepasst werden
  
 
=== Formate ===
 
=== Formate ===

Version vom 11. September 2014, 16:41 Uhr

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

Das Fremdsystem generiert in bestimmten Abständen alle aktuelle Datensätze, die dann regelmäßig vom viewMAX Interface ausgelesen, validiert und importiert werden. Der Intervall zum Datenimport ist auf der viewMAX Seite frei wählbar.

Import aus CSV Textdatei

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

Der Import aus einer XML Datei muss individuell angepasst werden

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)