Handbuch J-EDI Viewer 3.0

Transkript

1 regiocom GmbH Marienstraße Magdeburg Handbuch J-EDI Viewer 3.0 Java-basierter EDI-Energy Dokumenten-Viewer Stand vom:

2 Inhaltsverzeichnis 1 Einführung Installationsbeschreibung Systemvoraussetzung Lizenz Softwareinformation Funktionsbeschreibung Funktionen des Viewers Unterstützte Formate Darstellung der Anpassungen Vergleich Message Implementation Guide (MIG-Vergleich) Vergleich Anwendungshandbuch (AHB-Vergleich) MIG-AHB-Beziehung Suchfunktion Export-Funktion Fehlerbehebung Fehlerhafte Anzeige Unterstützung durch Programmlieferant /16 3.0

3 Abbildungsverzeichnis Abbildung 1: Lizenzverwaltung... 3 Abbildung 2: Fehlerhafte Lizenzdaten... 4 Abbildung 3: Lizenzdaten bearbeiten... 4 Abbildung 4: Information zum J-EDI Viewer... 4 Abbildung 5: Funktionen J-EDI Viewer... 5 Abbildung 6: Farbliche Darstellung der Anpassungen... 6 Abbildung 7: Auswahl Typ und Versionen MIG-Vergleich... 7 Abbildung 8: MIG-Vergleich Ansicht... 7 Abbildung 9: MIG-Vergleich Ansicht, in der nur Anpassungen eingeblendet sind... 8 Abbildung 10: Integrierter Filter MIG-Vergleich... 8 Abbildung 11: Pfeilsymbole MIG-Vergleich... 8 Abbildung 12: Position in der Baumstruktur... 8 Abbildung 13: Auswahl Typ und Versionen AHB-Vergleich... 9 Abbildung 14: AHB-Vergleich Geschäftsvorfall, in denen es Anpassung im AHB gibt Abbildung 15: Ansicht AHB-Vergleich unterer Bereich... 9 Abbildung 16: Integrierter Filter AHB-Vergleich... 9 Abbildung 17: Pfeilsymbole AHB-Vergleich...10 Abbildung 18: Auszug EDI@Energy UTILMD Anwendungshandbuch...10 Abbildung 19: AHB-Vergleich - Darstellung Qualifizierer/Operatoren...10 Abbildung 20: MIG-AHB-Beziehung öffnen...11 Abbildung 21: MIG-AHB-Beziehung Auswirkung Nachrichtformat UTILMD auf Geschäftsvorfall...11 Abbildung 22: MIG-AHB-Beziehung - Auswirkung Löschung Code auf Geschäftsvorfall...12 Abbildung 23: MIG-AHB-Beziehung - Funktion Doppelklick...12 Abbildung 24: Suche...13 Abbildung 25: Suche - Ergebnis positiv...13 Abbildung 26: Suche - Ergebnis negativ...13 Abbildung 27: Konfigurationen exportieren...14 Abbildung 28: Auswahl der zu exportierenden Formate und Versionen...14 Abbildung 29: Speicherort für Exportdateien festlegen...15 Abbildung 30: Bestätigung Export...15 Abbildung 31: Fehlermeldung Export /16 3.0

4 1 Einführung Unternehmen der Energiewirtschaft stehen zweimal im Jahr vor der Herausforderung, die Änderungen für die nächste Formatumstellung herauszufinden. Um diese Änderungen zu analysieren, müssen die Nachrichtenbeschreibungen (MIG) und Anwendungshandbücher (AHB) diverser Nachrichtenformate durchgesehen werden. Der Java-basierte J-EDI Viewer der regiocom GmbH unterstützt Sie, die Änderungen der neuen Formatversionen mithilfe farblicher Markierungen schnell zu erkennen, und liefert eine tabellarische Übersicht aller EDI-Energy-Geschäftsvorfälle, die von den Änderungen der Formatumstellung betroffen sind. 2 Installationsbeschreibung Der J-EDI Viewer steht auf der regiocom Website zum Download zur Verfügung. Zur Nutzung des Tools benötigen Sie einen aktuellen Lizenzschlüssel. Für jede weitere Formatumstellung wird eine neue Version des J-EDI Viewers zum Download bereitgestellt. Zu dieser müssen jeweils neue Lizenzdaten erworben werden. 2.1 Systemvoraussetzung Der J-EDI Viewer ist eine Java-basierte Standalone-Lösung, der die nachfolgenden Voraussetzungen benötigt, um reibungslos zu funktionieren: Betriebssystem Windows 7 mindestens Java-Version Lizenz Wird der J-EDI Viewer erstmalig geöffnet, erscheint die Lizenzverwaltung zur Eingabe der per übermittelten Lizenzdaten. Abbildung 1: Lizenzverwaltung /16 3.0

5 Nachdem der Name des Lizenzeigentümers sowie der Lizenzschlüssel hinterlegt wurden, ist die Eingabe mit OK zu bestätigen. Bei korrekter Eingabe wird der J-EDI Viewer geöffnet. Ist die Eingabe fehlerhaft, wird eine entsprechende Fehlermeldung angezeigt. Abbildung 2: Fehlerhafte Lizenzdaten Über die Hilfe können die Lizenzdaten jederzeit bearbeitet werden. Abbildung 3: Lizenzdaten bearbeiten 3 Softwareinformation Die Informationen über den Viewer erhält der Nutzer über die Hilfe. Dort ist beispielsweise die verwendetet Version hinterlegt. Abbildung 4: Information zum J-EDI Viewer /16 3.0

6 4 Funktionsbeschreibung 4.1 Funktionen des Viewers Der J-EDI Viewer setzt sich aus drei grundlegenden Funktionen zusammen. Zum einen wird der tabellarische Vergleich der Nachrichtenbeschreibungen (MIG) und der Anwendungshandbücher (AHB) dargestellt. Zum anderen verfügt das Tool über die Funktion MIG-AHB-Beziehung, die die Auswirkung der Änderungen der Nachrichtenbeschreibungen zu dem jeweiligen Prüfidentifikator im Anwendungshandbuch darstellt. Zusätzlich verfügt der Viewer noch über eine Suchfunktion und eine XML-Exportfunktion. Abbildung 5: Funktionen J-EDI Viewer Die einzelnen Funktionen werden ab dem Abschnitt 6.2 genauer beschrieben. Der Viewer kann über den Menüpunkt Datei Applikation beenden oder das Icon geschlossen werden /16 3.0

7 4.1.1 Unterstützte Formate Die Version 3.0 unterstützt die folgenden Nachrichtenformate. UTILMD MSCONS INVOIC REMADV ORDERS ORDRSP REQOTE QUOTES IFTSTA INSRPT Darstellung der Anpassungen Um die Anpassungen schnell zu erkennen, werden diese farblich hervorgehoben. Dabei wird unterschieden, ob sich etwas geändert hat, etwas neu hinzugekommen ist oder entfernt wurde. Die farbliche Darstellung hat bei allen drei Grundfunktionen dieselbe Bedeutung. Grün neu Gelb geändert (Im MIG-Vergleich in roter Schrift hervorgehoben.) Rot entfernt Die folgende Abbildung soll die Darstellung näher veranschaulichen: Abbildung 6: Farbliche Darstellung der Anpassungen /16 3.0

8 4.2 Vergleich Message Implementation Guide (MIG-Vergleich) Der MIG-Vergleich zeigt die Anpassungen der Nachrichtenbeschreibungen zwischen zwei Dokumentenversionen an. Der Abgleich kann für alle unterstützten Formate vorgenommen werden (siehe 4.1.1). Um den Vergleich anzustoßen, sind im Auswahlmenü der Typ (Nachrichtenformat) und die Versionen auszuwählen. Unter Versionen werden alle freigegeben EDI-Energy-Dokumente verstanden, die von der ersten Veröffentlichung über sämtliche konsolidierten Lesefassungen bis hin zum Gültigkeitsdatum von der EDI-Energy freigegeben werden. Das Datum der Veröffentlichung differenziert die einzelnen Dokumente einer Nachrichtenversion. Abbildung 7: Auswahl Typ und Versionen MIG-Vergleich Durch Anzeigen wird der Vergleich gestartet und alle Anpassungen werden, wie auf der folgenden Abbildung gezeigt, dargestellt. Abbildung 8: MIG-Vergleich Ansicht Welche Versionen verglichen wurden, wird über der Ansicht angezeigt. Zur besseren Übersichtlichkeit gibt es die Möglichkeit, durch die Ordnersymbole (Schließen) und (Öffnen) die Baumstruktur in beiden Fenstern ein- bzw. auszublenden. Durch das Symbol werden ausschließlich Anpassungen dargestellt /16 3.0

9 Die restliche Baumstruktur ist ausgeblendet und bietet dadurch mehr Übersicht. Abbildung 9: MIG-Vergleich Ansicht, in der nur Anpassungen eingeblendet sind. Eine weitere Möglichkeit zur Eingrenzung der Anzeige bieten die expliziten Filter. Durch das Setzen der Haken in den entsprechenden Checkboxen kann die Anzeige auf Neuerungen, gelöschte Anpassungen oder Änderungen eingegrenzt werden. Die Ansicht aktualisiert sich automatisch. Abbildung 10: Integrierter Filter MIG-Vergleich Die Pfeilsymbole bieten eine Möglichkeit, zwischen den einzelnen Anpassungen zu navigieren. Abbildung 11: Pfeilsymbole MIG-Vergleich Die aktuelle Position in der Baumstruktur wird in der Ansicht blau hervorgehoben und unter der Ansicht angezeigt. Abbildung 12: Position in der Baumstruktur Die aktuelle Ansicht kann über das Druckersymbol ausgedruckt werden /16 3.0

10 4.3 Vergleich Anwendungshandbuch (AHB-Vergleich) Der AHB-Vergleich zeigt alle Anpassungen zu den einzelnen Anwendungsfällen prozessscharf an. Der Vergleich wird nach Einstellung des Typs (Nachrichtenformat) und der Versionen im Auswahlmenü durch Anzeigen gestartet. Abbildung 13: Auswahl Typ und Versionen AHB-Vergleich Die Ansicht des AHB-Vergleichs unterteilt sich in zwei Bereiche. Im oberen Bereich werden die einzelnen Prüfidentifikatoren aufgelistet. Auch hier werden mit farblicher Unterlegung diejenigen Geschäftsprozesse gekennzeichnet, welche mindestens eine Änderung enthalten. In der nachfolgenden Abbildung gibt es beispielsweise im gelb markierten Geschäftsvorfall Anmeldung NN eine Anpassung im AHB (Anwendungshandbuch). Abbildung 14: AHB-Vergleich Geschäftsvorfall, in denen es Anpassung im AHB gibt. Der untere Bereich zeigt den ausgewählten Geschäftsvorfall sowie die jeweiligen Anpassungen in den Prozessen an. Abbildung 15: Ansicht AHB-Vergleich unterer Bereich Je nach Auswahl des Prüfidentifikators/Geschäftsvorfalls aktualisiert sich der untere Bereich automatisch. Eine Möglichkeit zur Eingrenzung der Anzeige bietet auch hier der integrierte Filter durch das Setzen der Haken in den entsprechenden Checkboxen. Abbildung 16: Integrierter Filter AHB-Vergleich /16 3.0

11 Durch die Pfeilsymbole besteht die Möglichkeit, zwischen den einzelnen Anpassungen zu navigieren. Abbildung 17: Pfeilsymbole AHB-Vergleich Die aktuelle Ansicht kann durch das Druckersymbol ausgedruckt werden. Im AHB-Vergleich werden für die Qualifizierer und Operatoren des Anwendungshandbuchs Ersetzungsregeln dargestellt. Die nachfolgenden Abbildungen stellt dies beispielhaft dar. Abbildung 18: Auszug UTILMD Anwendungshandbuch Abbildung 19: AHB-Vergleich - Darstellung Qualifizierer/Operatoren /16 3.0

12 In den folgenden Tabellen sind die Ersatzregeln und ihre eigentliche Beschreibung aufgelistet. Qualifizierer Muss must Kann can Soll shall Verteiler distributor Verantwortlich responsible Berechtigt authorized X, x required O optional U required none Operatoren U, u & O, o X, x ^ 4.4 MIG-AHB-Beziehung Die Funktion MIG-AHB-Beziehung zeigt an, welche Codeänderung im MIG-Handbuch Auswirkung auf den jeweiligen Geschäftsvorfall hat. Durch den Button Anzeigen im Auswahlmenü wird die Funktion aufgerufen. Abbildung 20: MIG-AHB-Beziehung öffnen Die Funktion kann sowohl aus dem MIG-Vergleich als auch aus dem AHB-Vergleich nach Auswahl eines Nachrichtentyps geöffnet werden. Diese Übersicht stellt alle relevanten Geschäftsvorfälle/Prüfidentifikatoren dar, welche durch die Anpassungen im MIG-Handbuch betroffen sind. In der folgenden Abbildung ist die MIG-AHB-Beziehung für das Nachrichtenformat UTILMD abgebildet. Diese stellt dar, dass durch das neue Nachrichtenformat Auswirkungen auf drei Geschäftsvorfälle bestehen. Abbildung 21: MIG-AHB-Beziehung Auswirkung Nachrichtformat UTILMD auf Geschäftsvorfall Durch den Button Ansicht umschalten kann die Anzeige geändert werden. Diese Ansicht zeigt zu einer einzelnen Codeanpassung im MIG-Handbuch alle betroffenen Geschäftsvorfälle/Prüfidentifikatoren an /16 3.0

13 In der folgenden Abbildung hat beispielsweise das Löschen des Ablehnungsgrundcodes Z13 Auswirkungen auf den Geschäftsvorfall Ablehnung Anfrage Stornierung. Abbildung 22: MIG-AHB-Beziehung - Auswirkung Löschung Code auf Geschäftsvorfall Der Haken bei MIG Auswahl automatisch anpassen ist standardmäßig gesetzt. Diese Einstellung legt fest, ob durch Doppelklick auf den Code die passende Position in der MIG Ansicht angezeigt werden soll. Abbildung 23: MIG-AHB-Beziehung - Funktion Doppelklick Die Ordnersymbole (Schließen) und (Öffnen) ermöglichen das Aus- und Einblenden der Baumstruktur. Durch das Druckersymbol kann die aktuelle Ansicht ausgedruckt werden. Die MIG-AHB-Beziehung kann durch Schließen im Auswahlmenü oder durch das Icon wieder geschlossen werden /16 3.0

14 4.5 Suchfunktion Die Suche steht in allen drei Funktionen des J-EDI Viewers zur Verfügung. Der gesuchte Begriff wird in das Suchfeld eingetragen und durch Anklicken des Buttons Suche oder durch Betätigen der Enter-Taste wird die Suche gestartet. Bis zur Ausgabe des Ergebnisses, ist das Suchfeld blau hinterlegt. Abbildung 24: Suche Ist die Suche erfolgreich, wird der erste Treffer blau hervorgehoben und das Suchfeld ist grün hinterlegt. Damit die Suche möglichst erfolgreich ist, sollte auf die richtige Schreibweise des gesuchten Begriffes geachtet werden. Es wird jedoch nicht in Groß- und Kleinschreibung unterschieden. Durch Verwendung des Platzhalters * können beliebig viele Zeichen ersetzt werden. Abbildung 25: Suche - Ergebnis positiv Konnte kein passendes Ergebnis gefunden werden, wird das Suchfeld rot hinterlegt. Abbildung 26: Suche - Ergebnis negativ /16 3.0

15 4.6 Export-Funktion Der Export in ein XML-Format ist für alle unterstützten Nachrichtenformate verfügbar. Die Funktion wird über das Menü Datei Konfiguration exportieren aufgerufen. Abbildung 27: Konfigurationen exportieren Danach öffnet sich ein Auswahlfenster, in dem die gewünschten Nachrichtenformate und Versionen ausgewählt werden. Standardmäßig sind alle exportfähigen Formatversionen vorausgewählt. Um die Markierung für alle Versionen gleichzeitig aufzuheben, muss der Haken bei alle herausgenommen werden. Abbildung 28: Auswahl der zu exportierenden Formate und Versionen /16 3.0

16 Die Auswahl ist mit dem Button OK zu bestätigen. Anschließend öffnet sich ein weiteres Fenster, in dem der Speicherort festgelegt wird. Abbildung 29: Speicherort für Exportdateien festlegen Erläuterung der Symbole aus der Abbildung 29: In der Struktur eine Ebene höher springen. Zum Desktop wechseln. Einen neuen Ordner erstellen. In die Listenansicht wechseln. Übersicht der Namen. In die Detailansicht wechseln. Übersicht der Größe, des Typs und des Änderungsdatums. Durch Speichern wird der Export gestartet und die Dateien werden an dem entsprechenden Speicherort abgelegt. Nach erfolgreichem Export erscheint die folgende Meldung, die mit OK zu bestätigen ist: Abbildung 30: Bestätigung Export Konnte der Export nicht erfolgreich durchgeführt werden, beispielsweise aufgrund von zu wenig Speicherplatz, wird eine entsprechende Fehlermeldung ausgegeben. Abbildung 31: Fehlermeldung Export Über den Button Details anzeigen >> können weitere Informationen eingesehen werden /16 3.0

17 5 Fehlerbehebung 5.1 Fehlerhafte Anzeige In der Ansicht werden unnötige Leerzeilen angezeigt. Diese fehlerhafte Ansicht wird durch erneutes Laden der Daten, wiederholt Anzeigen anklicken, behoben. 5.2 Unterstützung durch Programmlieferant Darstellungsfehler können an die nachfolgende -Adresse gemeldet werden: /16 3.0