Verkehrsmonitoring - VMON (Sedex)

Transkript

1 Eidgenössisches Departement für Umwelt, Verkehr, Energie und Kommunikation UVEK Bundesamt für Strassen ASTRA IT - Dokumentation Ausgabe 2011 V1.00 Verkehrsmonitoring - VMON (Sedex) Anwendungshandbuch ASTRA ASTRA OFROU USTRA UVIAS

2

3 ASTRA Verkehrsmonitoring - VMON (Sedex) Impressum Impressum Autore(n)/Arbeitsgruppe Oliver Brack Lukas Studer (Zühlke Engineering AG) (Zühlke Engineering AG) Herausgeber Bundesamt für Strassen ASTRA Abteilung Strassennetze Verkehrsmanagement Verkehrsmonitoring 3003 Bern ASTRA Abdruck - ausser für kommerzielle Nutzung - unter Angabe der Quelle gestattet. Ausgabe 2011 V1.00 3

4

5 ASTRA Verkehrsmonitoring - VMON (Sedex) Inhaltsverzeichnis Inhaltsverzeichnis IMPRESSUM... 3 INHALTSVERZEICHNIS ALLGEMEINES INKRAFTTRETEN UND ÄNDERUNGEN REFERENZIERTE DOKUMENTE ZWECK ZIEL UND ZWECK DES DOKUMENTES ZIELPUBLIKUM UND VORAUSSETZUNGEN AN DIE LESER SYSTEMÜBERSICHT STRUKTUR DES SYSTEMS UND DIE EXTERNEN SCHNITTSTELLEN ZIELE UND HAUPTFUNKTIONEN DES SYSTEMS ALLGEMEINES ZU SICHERHEIT, DATENSCHUTZ, ANWENDERROLLEN GRUNDFUNKTIONEN ZUGRIFF AUF DIE ANWENDUNG BENUTZERDOKUMENTATION EINLEITUNG SEDEX-VERSAND TECHNISCHE DOKUMENTATION VERSANDVORBEREITUNG VON VMON-DATEIEN ÜBER SEDEX SEDEX-FORMAT ABBILDUNGSVERZEICHNIS TABELLENVERZEICHNIS Ausgabe 2011 V1.00 5

6 ASTRA Verkehrsmonitoring - VMON (Sedex) Allgemeines 0 Allgemeines 0.1 Inkrafttreten und Änderungen Ausgabe Version Datum Änderungen Ersterstellung Tabelle 1: Inkrafttreten und Änderungen 0.2 Referenzierte Dokumente [1] Anwendungshandbuch VMON; Version ; 65021_VMON_Anwendungshandbuch_R doc Tabelle 2: Referenzierte Dokumente 6 Ausgabe 2011 V1.00

7 ASTRA Verkehrsmonitoring - VMON (Sedex) Zweck 1 Zweck 1.1 Ziel und Zweck des Dokumentes Dieses Dokument beschreibt die Benutzung des Sedex-Tools, welches als Teil der Fachapplikation VMON ausgeliefert wird. 1.2 Zielpublikum und Voraussetzungen an die Leser Der Anwender muss einerseits die Umgebung der Fachapplikation VMON und andererseits die Windows-Kommandozeile und deren Verwendung kennen. Ausgabe 2011 V1.00 7

8 ASTRA Verkehrsmonitoring - VMON (Sedex) Systemübersicht 2 Systemübersicht 2.1 Struktur des Systems und die externen Schnittstellen MISTRA ist ein Managementinformationssystem des Bundesamtes für Strassen AST- RA. Es dient dem schnellen und einheitlichen Zugriff auf alle relevanten Informationen rund um das Schweizerische Stras-sennetz. Im MISTRA Basissystem werden generalisierte Daten aus allen Gebieten zusammengetragen und mitei-nander verknüpft. Die Erfassung und Aufbereitung der Daten erfolgt in Fachapplikationen, welche in das Basissystem eingebunden sind. Die Fachapplikation Verkehrsmonitoring (VMON) ist eine dieser Fachapplikationen. Sie dient der Erfassung und Aufbereitung von Verkehrszähldaten und der Verwaltung des Messstellennetzes. Zusätzlich verfügt die Fachapplikation über zahlreiche Import-, Export- und Reportingfunktionen. Die aufbereiteten Verkehrsdaten werden dem MISTRA Basissystem zur Verfügung gestellt. 2.2 Ziele und Hauptfunktionen des Systems Eine dieser Exportfunktionen stellt das Sedex-Tool dar. Dieses hilft, aus VMON exportierte Daten in ein einheitliches Format zu packen und zusammen mit beschreibenden Meta-Daten zum Austausch mit anderen Umsystemen zur Verfügung zu stellen. Der Austausch geschieht dabei über Transfer-Verzeichnisse, die dafür von MISTRA zur Vefügung gestellt werden. 8 Ausgabe 2011 V1.00

9 ASTRA Verkehrsmonitoring - VMON (Sedex) Systemübersicht Abbildung 1: Einbindung vom Sedex-Tool in die MISTRA-Systemlandschaft 2.3 Allgemeines zu Sicherheit, Datenschutz, Anwenderrollen VMON Sedex kennt keine unterschiedlichen Benutzerrollen. Der ausführende Benutzer muss lediglich Schreibrechte in den Transferverzeichnissen besitzen, was mit der Rolle [Applikation]_[Mandant]_DataMgr gegeben sein sollte. Ausgabe 2011 V1.00 9

10 ASTRA Verkehrsmonitoring - VMON (Sedex) Grundfunktionen 3 Grundfunktionen 3.1 Zugriff auf die Anwendung Um das Sedex-Tool starten zu können, muss man sich zuerst auf den Terminal Server verbinden, auf dem die Fachapplikation VMON installiert ist. Vorzugsweise geschieht dies über Remote Desktop. Anschliessend kann das Sedex-Tool über die Kommandozeile angesprochen werden. Details zur Verwen-dung und den möglichen Optionen finden sich im Kapitel 3. Es existiert keine grafische Benutzeroberfläche für dieses Tool. 10 Ausgabe 2011 V1.00

11 ASTRA Verkehrsmonitoring - VMON (Sedex) Benutzerdokumentation 4 Benutzerdokumentation 4.1 Einleitung Die Fachapplikation VMON besitzt die Konsolenapplikation SedexExporter.exe, mit welcher VMON-Dateien für den Sedex-Versand vorbereitet werden. Das Kapitel soll zeigen, wie die Funktionalität aufgerufen und verwendet werden kann. 4.2 Sedex-Versand Um exportierte VMON-Dateien für den Sedex-Versand vorzubereiten muss eine Konsole gestartet werden. Dort drin wird in das Verzeichnis gewechselt, welches das Programm SedexExporter.exe enthält. Der Aufruf erfolgt folgendermassen: SedexExporter.exe SourceDirectory TransferDirectory SenderId RecipientId MessageType Der SedexExporter packt die zu übertragenden Dateien aus dem Quellverzeichnis (SourceDirectory) in eine Zip-Datei und kopiert anschliessend die gezippte Datei mit einer XML-Datei (Envelope) in das Sedex-Versandverzeichnis (TransferDirectory). Von dort werden die vorbereiteten Dateien über das Sedex-Programm weiterverarbeitet Konsolenparameter Bezeichnung Erklärung Beispiel Erlaubte Werte Source Directory Verzeichnis der zu übertragenden Dateien. C:\SrcDir Absoluter lokaler, UNCund relative Verzeichnispfade Transfer Directory Sedex- Versandverzeichnis \\uvekv8120\mistrap\ Mistraapp\Ch\vmon\transfer\ sedex\outbox Absoluter lokaler, UNCund relative Verzeichnispfade SenderId[2] ID der sendenden Amtsstelle 2-GR-10 d-gg-dd oder d-dd-dd RecipientId[2] ID der empfangenden Amtsstelle 3-CH-38 d-gg-dd oder d-dd-dd MessageType[2] Typ der Übertragung 4200 dddd Tabelle 3: Konsolenparameter Bemerkungen: d: Dezimalzahl G: Grossbuchstabe Beispieleingabe: Ausgabe 2011 V

12 ASTRA Verkehrsmonitoring - VMON (Sedex) Benutzerdokumentation Abbildung 2: Erfolgreiches Ausführen des Programms Nach der erfolgreichen Eingabe erfolgt die Meldung Export of the files completed successfully (Abbildung 2). Zudem befinden sich nun im Transfer Directory (\\uvekv8120\mistra-p\mistra-app\ch\vmon\transfer\sedex\outbox) zwei Dateien: eine zip- und eine xml-datei (Abbildung 3). Abbildung 3: Erzeugte Dateien im TransferDirectory Fehlerhafte Eingabe/Hilfe Durch unvollständige oder fehlerhafte Eingaben zeigt das Programm einen Hilfetext an, welcher darüber Auskunft gibt, weshalb das Programm nicht fortfahren kann. Darin werden die Parameter beschrieben so-wie ein Beispiel aufgeführt. Bei fehlerhafter Ausführung muss der Befehl nochmals ausgeführt werden. Abbildung 4: Ansicht nach fehlerhafter Eingabe 12 Ausgabe 2011 V1.00

13 ASTRA Verkehrsmonitoring - VMON (Sedex) Technische Dokumentation 5 Technische Dokumentation Dieses Kapitel beschreibt die Sedex-Export Funktionalität. Darunter wird das Vorbereiten der Dateien sowie das Kopieren jener in den Sedex-Versandordner verstanden. 5.1 Versandvorbereitung von VMon-Dateien über Sedex Mit dem Sedex Exporter können exportierte VMon-Dateien für den Sedex-Versand vorbereitet werden. Dazu packt das Programm die zu übertragenden Dateien aus einem Quellverzeichnis in eine Zip-Datei und kopiert die gezippte Datei anschliessend gemeinsam mit einer XML-Datei (Envelope) in das Sedex-Versandverzeichnis Aufruf Der Aufruf des Sedex Exporters muss wie folgt erfolgen: SedexExporter.exe SourceDirectory TransferDirectory SenderId RecipientId MessageType Für die Ausführung des Programms sind alle fünf Parameter erforderlich Konsolenparameter Bezeichnung Erklärung Beispiel Erlaubte Werte Source Directory Verzeichnis der zu übertragenden Dateien. C:\SrcDir Absoluter lokaler, UNCund relative Verzeichnispfade Transfer Directory Sedex- Versandverzeichnis \\uvekv8120\mistrap\ Mistraapp\Ch\vmon\transfer\ sedex\outbox Absoluter lokaler, UNCund relative Verzeichnispfade SenderId[2] ID der sendenden Amtsstelle 2-GR-10 d-gg-dd oder d-dd-dd RecipientId[2] ID der empfangenden Amtsstelle 3-CH-38 d-gg-dd oder d-dd-dd MessageType[2] Typ der Übertragung 4200 dddd Tabelle 4: Konsolenparameter Bemerkungen: d: Dezimalzahl G: Grossbuchstabe Beispielablauf des Sedex-Exporters Die von VMON exportierten Dateien werden in einem frei wählbaren Source Directory (hier: C:\SrcDir) abgelegt. Daraufhin wird der Sedex-Exporter mit folgender Kommandozeile gestartet: SedexExporter.exe C:\SrcDir \\uvekv8120\mistra-p\mistraapp\ch\vmon\transfer\sedex\outbox 2-GR-10 3-CH Ausgabe 2011 V

14 ASTRA Verkehrsmonitoring - VMON (Sedex) Technische Dokumentation Anschliessend befinden sich im Transfer Directory (hier: \\uvekv8120\mistra-p\mistraapp\ch\vmon\transfer\sedex\outbox) zwei neue Dateien: envl_ _ xml data_ _ zip In der zip-datei sind alle Dateien des Source Directories komprimiert abgelegt. In der xml-datei sind die Dateien für den Sedex-Versand beschrieben. Die Dateien werden nun durch das Sedex-Programm weiterverarbeitet. Bei lauffähigem Sedex erfolgt dies automatisch. 5.2 Sedex-Format Im Transferverzeichnis werden zwei Dateien abgelegt. Die Erste ist eine Zip-Datei, welche alle zu übertragenden Dateien beinhaltet. Die Zweite ist eine XML-Datei, die die nötigen Informationen für den Transport durch Sedex beinhaltet Zip-Archiv Das Zip-Archiv beinhaltet alle Dateien sowie deren Ordnerstruktur, welche im angegebenen Source Directory (erster Parameter) abgelegt sind. Diese repräsentieren die aus VMON exportierten Dateien. Der Dateiname muss folgendem Format entsprechen: data_yyyymmtt_hhmmss Y: Jahr M: Monat T: Tag H: Stunde m: Minute S: Sekunde XML-Envelope Die XML-Datei enthält alle Informationen für die Sedex-Übermittlung. Der Dateiname entspricht dabei folgendem Format: envl_yyyymmtt_hhmmss Y: Jahr M: Monat T: Tag H: Stunde m: Minute S: Sekunde Ein resultiertes XML sieht z.b. wie folgt aus: <?xml version="1.0" encoding="utf 8"?> <ech 0090:envelope version="1.0" xmlns:ech 0090="http://www.ech.ch/smlns/eCH 0090/1" xmlns:xsi="http://www.w3.org/2001/xmlschema instance" xsi:schemalocation=" 0090/1/eCH xsd"> <ech 0090:messageId> _111704</eCH 0090:messageId> <ech 0090:messageType>4200</eCH 0090:messageType> <ech 0090:messageClass>0</eCH 0090:messageClass> <ech 0090:senderId>2 DD 99</eCH 0090:senderId> <ech 0090:recipientId> </eCH 0090:recipientId> 14 Ausgabe 2011 V1.00

15 ASTRA Verkehrsmonitoring - VMON (Sedex) Technische Dokumentation <ech 0090:eventDate> T11:17:04</eCH 0090:eventDate> <ech 0090:messageDate> T11:17:04</eCH 0090:messageDate> </ech 0090:envelope> Mit Ausnahme der gelb hinterlegten Abschnitte ist der Envelopeaufbau statisch. Aus diesem Grund wird nachfolgend auf die veränderlichen Bereiche detaillierter eingegangen: XML-Tag Erklärung Aufbau messageid messagetype senderid[2] recipientid[2] eventdate[2] Ist eine ID zur eindeutigen Kennzeichnung der Nachricht und entspricht dem aktuellen Datum und der Zeit. Der Meldungstyp definiert die Funktion des Datenpakets. Wird über den Parameter MessageType durch den Benutzer definiert. Bezeichnet den Sender (eine Amtsstelle). Wird über den Parameter SenderId durch den Benutzer definiert. Bezeichnet den Empfänger (eine Amtsstelle). Wird über den Parameter RecipientId durch den Benutzer definiert. Entspricht dem Datum und der Zeit der Erstellung des Envelopes und wird generiert. YYYYMMTT_HHmmSS dddd d-gg-dd oder d-dd-dd d-gg-dd oder d-dd-dd YYYY-MM-DDTHH:mm:SS messagedate Entspricht dem Datum und der Zeit der Erstellung des Envelopes und wird generiert. Tabelle 5: Elemente der XML-Envelope YYYY-MM-DDTHH:mm:SS Bemerkungen: d: Dezimalzahl [0-9] G: Grossbuchstabe [A-Z]) Y: Jahr M: Monat T: Tag H: Stunde m: Minute S: Sekunde Ausgabe 2011 V

16 ASTRA Verkehrsmonitoring - VMON (Sedex) Technische Dokumentation Abbildungsverzeichnis Abbildung 1: Einbindung vom Sedex-Tool in die MISTRA-Systemlandschaft... 9 Abbildung 2: Erfolgreiches Ausführen des Programms Abbildung 3: Erzeugte Dateien im TransferDirectory Abbildung 4: Ansicht nach fehlerhafter Eingabe Ausgabe 2011 V1.00

17 ASTRA Verkehrsmonitoring - VMON (Sedex) Tabellenverzeichnis Tabellenverzeichnis Tabelle 1: Inkrafttreten und Änderungen... 6 Tabelle 2: Referenzierte Dokumente... 6 Tabelle 3: Konsolenparameter Tabelle 4: Konsolenparameter Tabelle 5: Elemente der XML-Envelope Ausgabe 2011 V