MISTRA Managementinformationssystem Strasse und Strassenverkehr

Transkript

1 Eidgenössisches Departement für Umwelt, Verkehr, Energie und Kommunikation UVEK Bundesamt für Strassen ASTRA B. Gerhardt, Version 1.0 vom Doku Code: MISTRA Managementinformationssystem Strasse und Strassenverkehr Exportprozess <Adresse Firma> <LOGO Firma> C:\Users\u \AppData\Local\Fabasoft\DOCDIR\u \B Export BS - TDCost_d.docx

2 Impressum Impressum Erstelldatum: 10. Juni 2013 Letzte Änderung: 10. Juni 2013 Projektleiter: Assistenz: Verzeichnis/Datei: c:\users\u \appdata\local\fabasoft\docdir\u \b export bs - tdcost.docx Seitenanzahl gesamt inkl. Deckblatt und 15 Inhaltsverzeichnis: Dokumentenverwaltung Version Datum Autor Bemerkungen Geb Dokument erstellen Geb Korrekturen Bes einpflegen Geb Korrekturen Cas einpflegen Geb Korrekturen Filialen einfügen Geb Abstimmung Manueller Export mit Cas

3 Inhaltsverzeichnis Inhaltsverzeichnis Seite 1. Allgemeines Referenzierte Dokumente, Dateien Abkürzungsverzeichnis Rollenverzeichnis 1 2. Zweck des Dokuments Fachpersonen Hintergrundinformationen 2 3. Prozesse Prozess manueller Datenaustausch Prozess automatischer Datenaustausch 8 4. Anhang Beispiel DR-Ticket: Muster beim manuellen Export 12 Abbildungen Seite Abbildung 1 Prozess manueller Datenaustausch 4 Abbildung 2 Prozess automatischer Datenaustausch 8

4 Allgemeines 1. Allgemeines 1.1. Referenzierte Dokumente, Dateien Titel Autor(en) Version Nr. / Datum [1] Allgemeine Informationen zur Schnittstelle: eid= [2] Schnittstelle FME: E [3] XML: [4] "Bereinigung IO MISTRA BS - TDCost.doc (M ) S Caseri 1.2. Abkürzungsverzeichnis Abkürzung Begriff DR-Ticket Daten Request ( FME Feature Manipulation Engine IO Inventarobjekte NOK Nicht Okay VALID_FROM_DT Datum gültig von XML Extensible Markup Language: Sprache für den Austausch von Daten 1.3. Rollenverzeichnis Abkürzung Begriff D-PL Basissystem Datenprojektleitung Basissystem EP Filiale Erhaltungsplanung Filiale EP Zentrale Erhaltungsplanung Zentrale IC Filiale Investitionscontrolling Filiale IC Zentrale Investitionscontrolling Zentrale PL Basissystem Projektleitung Basissystem B Export BS - TDCost_d.docx Seite 1

5 Zweck des Dokuments 2. Zweck des Dokuments Dieses Dokument wurde erstellt um den Export vom Basissystem nach TDCost zu beschreiben. Der Export über die Schnittstelle wird nach Absprach innerhalb der Filiale in der Filiale ausgeführt. Das Dokument ist für den internen Gebrauch im gedacht Fachpersonen Zentrale: - Susanne Caseri (IC Zentrale) - Laurent Linder (EP Zentrale) - Florian Besançon (PL Basissystem) - Gerhardt Birgit (D-PL Basissystem) Filialen: - Jean-Marc Chassot (EP Filiale 1) - Urs Hayoz (EP Filiale 2) - Roman Zbinden (EP Filiale 3) - Marco Hochueli (EP Filiale 3) - Müller Marcel (EP Filiale 4) - Cédric Pagani (EP Filiale 5) 2.2. Hintergrundinformationen BS Wiki: - [1] Schnittstelle FME - [2] Beschreibung Schnittstelle und Attribute: [3] XML: [4] TDCost: Dokument "Bereinigung IO MISTRA BS - TDCost.doc (Autor Susanne Caseri) B Export BS - TDCost_d.docx Seite 2

6 Prozesse 3. Prozesse Für den Austausch von Daten zwischen Basissystem und TDCost stehen zwei Prozesse zur Verfügung: - manueller Datenaustausch - automatischer Datenaustausch Der manuelle Datenaustausch wird vor allem in der Testphase eingesetzt und bei Objekten die nicht im automatischen Datenaustausch inkludiert sind. Der Export und Import der Daten erfolgt manuell und eine Absprache vor jedem Datenaustausch zwischen IC Filiale und EP Filiale ist unerlässlich. Beim automatischen Datenaustausch erfolgt der Export aus Basissystem und der Import in TDCost automatisch. Jede Filiale kann definieren, in welchem Zeitabstand, welche Objekte, automatisch ausgetauscht werden sollen. Wichtig ist, dass EP Filiale und IC Filiale den Exportablauf abstimmen. Nach einer Testphase mit dem manuellen Datenaustausch wird die Automaisierung der Standard sein. B Export BS - TDCost_d.docx Seite 3

7 Prozesse 3.1. Prozess manueller Datenaustausch Abbildung 1 Prozess manueller Datenaustausch Der manuelle Datenaustausch wird vor allem während der Testphase eingesetzt. Sobald ein automatischer Export sich standardisiert hat, kann mit dem manuellen Vorgehen eine Ausnahme gemäss dem Prozess exportiert werden. 1. Bearbeitung der Inventarobjekte im BS ist abgeschlossen - Bearbeitung der IO wird in Absprache zwischen IC Filialen und EP Filialen durchgeführt - Verantwortlich: EP Filiale - Ausführungsort: Filiale 2. OK IC Filiale EP Filiale und IC Filiale klären miteinander ab, ob TDCost bereit ist die gewünschten IO zu importieren. Je nach Prozess in der Filiale können weitere betroffenen Personen in die Abklärung eingebunden werden, z.b. Projektmanagement - Verantwortlich: EP Filiale und IC Filiale - Ausführungsort: Filiale - Abgeklärt werden: Veränderung bei den Daten (z.b. Objektnamen, Objekttyp, Objektnummer, Exportumgebung (Abnahme / Produktion), Exportdatum. Siehe dazu auch Dokument [4]. B Export BS - TDCost_d.docx Seite 4

8 Prozesse 3. FME Server (Export) - Verantwortlich: EP Filiale - Ausführungsort: Filiale - Export: Die in Schritt 2 abgeklärten Objekte können mit dem FME Server exportiert werden. Es können auch mehrere Exportfiles erstellt werden (z.b. bei unterschiedlichem Exportdatum, ) Wenn noch keine Schulung der Schnittstelle mit einer Filiale durchgeführt wurde, kann der Export durch die Zentrale erstellt werden - Auftragserteilung: Filiale erstellt ein DR-Ticket mit folgenden Informationen (Beispiel siehe Anhang 4.1): - Welche Filiale - Abklärungen aus Schritt 2 wurden mit welchem IC der Filiale gemacht - Welche Umgebung (Abnahme oder Produktion) - Welches Datum - Welche Objekte, Objektnummer, sollen exportiert werden - Verantwortlich für den Export in der Zentrale: D-PL BS - Ausführungsort: Zentrale 4. Manueller Datenaustausch - Verantwortlich: EP Filiale - Ausführungsort: Filiale - Zeitpunkt: kann jederzeit ausgelöst werden Filialen ohne eine Schulung der Schnittstelle: - Verantwortlich: D-PL BS, basierend auf DR-Ticket - Ausführungsort: Zentrale 5. MISTRA Transfer Share - Ablageort Abnahme: \\uvekv8120\mistra-a\mistra-app\ch\tdcost\ Doc\ExportSD\In Produktion: \\uvekv8120\mistra-p\mistra-app\ch\tdcost\ Doc\ExportSD\In - Der Ordner \TDCost\ Doc\... kann von allen geöffnet werden. Files können kontrolliert, gelöscht, werden B Export BS - TDCost_d.docx Seite 5

9 Prozesse 6. Kontrolle - Kontrolle: wurden die korrekten Objektenummer, Objekttypen, Objektnamen, exportiert - Vorgehen: - öffnen des XML mit einem Doppelklick - Suche nach den gewünschten Informationen: 7. Mail EP Filiale an IC Zentrale - Information: IC Zentrale per Mail über den Export informieren (Kopie an IC Filiale). Import in TDCost erfolgt nicht automatisch. - Im Mail müssen zwingend folgende Punkte erwähnt werden (Muster siehe Anhang 4.2): - Ablageort der Datei - Filiale - Name der Datei - Stichtag - Welche Objekttypen - Exportumgebung - Mit welchem IC Filiale der Export besprochen wurde (Schritt 2) 8. Mail IC Zentrale an EP Filiale - Information: IC Zentrale informiert per Mail über den Zeitpunkt des Imports. - Das Mail muss zwingend an die betroffenen EP Filiale und IC Filiale verschickt werden. B Export BS - TDCost_d.docx Seite 6

10 Prozesse 9. Import TDCost - Importart: manuell - Zeitpunkt: in Absprache mit der Filiale OK: Export ist abgeschlossen Nicht OK: IC Zentrale meldet per Mail die Fehler. Mögliche Errors: - in TDCost ist im Katalog ein neuer Abschnitt noch nicht eingetragen. Lösung: in TDCost muss der Katalog aktualisiert werden. - Datum VALID_FROM_DT ist nicht korrekt (Daten vor werden als Fehler ausgegeben). Lösung: Objekt muss korrigiert werden. B Export BS - TDCost_d.docx Seite 7

11 Prozesse 3.2. Prozess automatischer Datenaustausch Abbildung 2 Prozess automatischer Datenaustausch Der automatische Datenaustausch wird nach der Testphase mit dem manuellen Datenaustausch der Standard sein. 1. Bearbeitung der Inventarobjekte im BS ist abgeschlossen - Bearbeitung der IO wird in Absprache zwischen IC Filialen und EP Filialen durchgeführt - Verantwortlich: EP Filiale - Ausführungsort: Filiale 2. OK IC Filiale EP Filiale und IC Filiale klären miteinander ab, ob TDCost bereit ist die gewünschten IO zu importieren - Verantwortlich: EP Filiale und IC Filiale - Ausführungsort: Filiale - Abgeklärt werden: Veränderung bei den Daten (z.b. Objektnamen, Objekttyp, Objektnummer, Exportumgebung (Abnahme / Produktion), Exportdatum. Siehe dazu auch Dokument [4]. 3. FME Server (Export) - Pro Filiale kann ein eigenständiger automatischer Datenaustausch erstellt werden. - Verantwortlich für Definition Exportparameter: EP Filiale B Export BS - TDCost_d.docx Seite 8

12 Prozesse - Auftrag: per CM-Ticket (Filiale, welche Objekte, Exportintervall, ) - Verantwortlich für die Ausführung des CM-Tickets: PL BS, D-PL BS. Die in Schritt 2 abgeklärten Objekte werden in einem eigenen Workbench definiert 4. Automatischer Datenaustausch Kann erst erfolgen wenn eine Aktualisierung der Objekte erfolgt ist. Pro Filiale kann ein eigenständiger Datenaustausch erstellt werden - System erstellt automatisch einen Export 5. MISTRA Transfer Share - Ablageort Abnahme: \\uvekv8120\mistra-a\mistra-app\ch\tdcost\transfer\exportsd\in Produktion: \\uvekv8120\mistra-p\mistra-app\ch\tdcost\transfer\exportsd\in - Der Ordner \TDCost\Transfer\... kann nur mit der Rolle TDCost_CH_DataMgr geöffnet werden. Wenn eine Filiale ein exportiertes File einsehen möchte, muss dies bei IC Zentrale angefordert werden. - Falls fälschlicherweise ein Export erstellt wurde, muss so schnell als möglich IC Zentrale informiert werden. Wenn File noch nicht in TDCost importiert ist, kann das XML-File gelöscht werden (Angabe von Filename, Datum, Uhrzeit von Export). TDCost hat keine Historisierung und ein Import kann nicht rückgängig gemacht werden. 6. Import TDCost - Importart: automatisch - Zeitpunkt: je nach gewählter Exportregelmässigkeit kann dies angepasst werden (täglich, wöchentlich) Wichtig für TDCost ist: - Export muss bis 5.00 Uhr morgens erfolgt sein - Export muss Inkrementell sein (Daten innerhalb eines Zeitraumes von zu) - Kataloge von TDCost müssen bereit sein OK: Export ist abgeschlossen Nicht OK: IC Zentrale meldet per Mail die Fehler. - Mögliche Errors: - in TDCost ist im Katalog ein neuer Abschnitt noch nicht eingetragen. Lösung: in TDCost muss der Katalog aktualisiert werden. - Datum VALID_FROM_DT ist nicht korrekt (Daten vor werden als Fehler ausgegeben). Lösung: Objekt muss korrigiert werden B Export BS - TDCost_d.docx Seite 9

13 Anhang 4. Anhang 4.1. Beispiel DR-Ticket: Eintragsdetails ansehen MISTRA DR - BS Datenexport ID Projekt Kategorie Sichtbarkeit Meldungsdatum Reporter Hayoz Urs Bearbeitung durch Hayoz Urs Katego- (Keine rie) BS Datenexport öffentlich :53 Priorität normal Auswirkung kleinerer Fehler Status In QS Lösung offen Letzte Aktualisierung :59 Reproduzierbar nicht getestet Rechnertyp Betriebssystem BS-Version Achse CH ASTRA Filiale F2 Thun Fachnetz CH Name Hayoz Vorname Urs Org./Firma Bundesamt für Strassen (ASTRA) Telefon Wunschtermin Gebiet/Bereich urs.hayoz@astra.admin.ch Zweck Verbesserung der Arbeitsbedingungen in TDcost für die MA des IC der Filiale Thun. Themenauswahl/Topics Inventarobjekte Eigentümer Zielapplikation Andere, siehe Beschreibung Lieferadresse gleich Antragsteller Lieferadresse - Firma TDcost-Produktion Lieferadresse - Person Susanne Caseri Lieferadresse - Telefon Lieferadresse - susanne.caseri@astra.admin.ch Lieferadresse - Adresse ASTRA, Mühlestrasse 2, 3063 Ittingen Format Daten XML Modus Voll Häufigkeit einmalig Periode Täglich Wochentag Montag Quartalsmonat 1 Monat Januar Monatstag 1 Kostenträger gleich Antragsteller Kostenträger Bundesamt für Strassen, Mühlestrasse 3, 3063 Ittingen Berechtigt Ja Einverständnis Datenherr Ja vorhanden B Export BS - TDCost_d.docx Seite 10

14 Anhang Aufwand PT Möglicher Ausführungstermin Ende Ausführbar Ja Begründung Ablehnung QS Massnahmen Qualitätsziel erreicht Ja Effektiver Ausführungstermin Ende Auftrag erfüllt Ja Titel (max. 128 Zeichen) : Exportieren aller Inventarobjekte F2 für den Import in TDcost Beschreibung Die Filiale Thun (F2) hat letzthin einen Teil der Inventarobjekte (alle 4er und 5er) aus MISTRA exportieren lassen und in die TDcost-Abnahmeumgebung importieren lassen. Die Feststellungen durch die Frauen Susanne Caseri und Brigit Gerhardt haben ergeben, dass die Übereinstimmung der IO sehr gut ist und der Import funktioniert hat. Shp vom IC der Filiale Thun konnte die gleichen Feststellungen machen. In Absprache mit Shp haben wir entschieden, dass nun alle Inventarobjekt-Typen der Filiale 2 aus MISTRA exportiert und in die TDcost-Produktion importiert werden sollen. Wir bitten darum, nach dem Export (Datenstand vom ) den Datentransfer in die Produktion-TDcost zu veranlassen. Herzlichen Dank für die Unterstützung und die Mitarbeit. Freundliche Grüsse Urs Hayoz Schritte zur Reproduktion Zusätzliche Informationen Schlüsselwörter Keine Schlüsselwörter zugeordnet. Datenanfrage- Beziehungen Angehängte Dateien B Export BS - TDCost_d.docx Seite 11

15 Anhang 4.2. Muster beim manuellen Export Von: Gerhardt Birgit ASTRA Gesendet: Donnerstag, 2. Mai :58 An: Caseri Susanne ASTRA Cc: Hayoz Urs ASTRA; Besançon Florian ASTRA Betreff: F2: Export BS > TDCost (Produktion) Hallo Susanne Im Ordner \\uvekv8120\mistra-p\mistra-app\ch\tdcost\doc\exportsd\in steht ein Export der Filiale 2 zur Verfügung. Der Name der Datei lautet: MISTRA_TD_ xml Informationen zum Export: - Stichtag: Filiale: F2 - Objekttypen: alle Objekttypen - Produktion - Der IC (Shp) in der Filiale ist über den Export informiert In diesem Export gab es noch einige Objekte mit mittelalterlichen IVT_VALID_FROM_DT (Valid From Datum), diese habe ich manuell im XML korrigiert (Korrekturskript ist erst in Vorbereitung). Folgende IDs wurden geändert: - 9b656e0b-34c b facf7a98 - a37b0937-f3b3-f64d-a40c-c06333e023ec - 24a5f15c-e1ac-be4b-84b4-82c61816a a4c98-4a2c-d547-89aa-f27dd24f6a44-15a b-8cdbf9cda4d4-75f968a5-d35e-aa40-a7d3-505f873baa84-415a0ec9-9ab1-534f-9e56-df088e bfbe4-e18c-3749-ac19-55defb55230c - 936a9eb-6a37-0e4f-942e-2c2710f108ee B Export BS - TDCost_d.docx Seite 12