2.1. Vorbereitung
2.1.1. Systemvoraussetzungen
R2EdiViewer ist eine Java-Anwendung und benötigt Java Version 8 - 17,
installiert auf einem Windows Betriebssystem.
Es wird die aktuell auf dem Rechner installierte JRE (Java Runtime Environment) verwendet.
Findet R2EdiViewer jedoch ein JDK (Java Development Kit), so wird diese verwendet.
Unabhängig von dem auf dem Rechner installierten JRE/JDK, kann ein eigenes,
lokales JRE (z.B. Adoptium JRE) in das R2EdiViewer-Unterverzeichnis private/jre gespeichert werden.
Diese lokale JRE wird dann explizit verwendet.
2.1.2. Programmverzeichnis sichern
|
|---|
Falls Sie schon eine Version von R2EdiViewer installiert haben:
|
Sicher ist Sicher
2.2. Setup
Durch den Aufruf von Setup...exe wird R2EdiViewer in das Wunschverzeichnis installiert.
Folgende Dateien werden installiert:
| Dateiname | Beschreibung | SR | |
|---|---|---|---|
R2EdiViewer.exe | Hauptprogramm | ||
R2EdiViewerC.exe | Hauptprogramm mit zusätzlichem Konsolen-Bildschirm. | ||
R2EdiViewer.bat | Startet Hauptprogramm R2EdiViewer.jar mit der Standard-JRE | ||
R2EdiViewer.jar | Eine Alternative im Batchmode: Hauptprogramm | ||
R2EdiViewerSD.zip | Syntax-Directories | 23.30 |
|
R2EdiViewerSH.cfg | Konfigurationsdatei für das Syntax-Highlighting | 23.20 |
|
R2EdiViewerGT.cfg | Konfigurationsdatei für die Baumdarstellung des Goto-Befehls | 9.10 |
|
| R2EdiViewerSH.css | Cascading Style Sheets für die Syntax-Highlighting-Formatierung | 23.20 |
|
| R2EdiViewerSHdark.css | Cascading Style Sheets für die Syntax-Highlighting-Formatierung | 23.20 |
|
| R2EdiViewerXL.cfg | Konfigurationsdatei für die Layoutbestimmung bei XML-Dateien | 23.30 |
|
R2EdiViewer.ini | Programm-Settings | 23.10 |
|
R2EdiViewer.lic | Freeware-Lizenz-Zertifikat |
| |
| R2EdiViewerWL.css | Cascading Style Sheets für die Formatierung der Logdatei | 7.12 |
|
R2EdiViewerDoku_xx.pdf | Bedienungsanleitung in DE=Deutsch/EN=Englisch | ||
R2EdiViewerLicence.pdf | Endnutzer-Lizenzvertrag | ||
R2EdiViewerExample.edi | Beispiel einer EDI-Datei | ||
R2EdiViewerUninstall.exe | Excelsior-Installer: Deinstallationsprogramm | ||
install.log | Excelsior-Installer: Installationsprotokoll | ||
[libs] | Verzeichnis externer JAR-Dateien | ||
[layouts] | Verzeichnis der standardmäßig ausgelieferten Layout-Vorlagen | ||
| [layoutsEdifileChecker] | Verzeichnis mit der Layout-Vorlage für den "EDI file checker" | ||
| [private] | Verzeichnis für Kundenanpassungen (wird niemals gelöscht) | ||
| R2EdiViewerSD.zip | Leere Syntax-Directories für Kundenerweiterungen | 7.12 | |
..ExtensionLibraryXX.jar | Fünf leere JAR-Dateien für Kundenerweiterungen | 8.10 | |
| [jre] | Leeres Verzeichnis für die Installation einer eigenen JRE | 10.20 | |
ZBC_R2EdiViewer.abap | ABAP®-Programm zur IDOC-Anzeige aus SAP® via R2EdiViewer | 23.20 |
Nach der Installation startet R2EdiViewer automatisch und die EDI-Beispieldatei wird angezeigt.
2.2.1. Kundenanpassungen
2.2.1.1. Kundenanpassungen können über das Customizing vorgenommen werden im:
- User-Verzeichnis
- "private"-Verzeichnis
Dabei werden die Verzeichnisse wie folgt durchsucht:
| SR | Suchreihenfolge |
|---|---|
| Die Datei wird gesucht in den Verzeichnissen: "private"- und Programm-Verzeichnis. Dabei werden alle gefundenen Dateien in der Verzeichnis-Reihenfolge verwendet. Spätere Suchstrategie eines Eintrages: Die erste Fundstelle beendet die Suche. |
| Die Datei wird gesucht in den Verzeichnissen: User- und "private"- und Programm-Verzeichnis. Dabei werden alle gefundenen Dateien in der Verzeichnis-Reihenfolge verwendet. Spätere Suchstrategie eines Eintrages: Die erste Fundstelle beendet die Suche. |
| Die Datei wird gesucht in den Verzeichnissen: User- oder "private"- oder Programm-Verzeichnis. |
| Die Datei wird gesucht in den Verzeichnissen: User- oder "private"-Verzeichnis. Dabei wird nur die zuerst gefundene Datei verwendet. |
2.2.1.2. Eigene Layout-Verzeichnisse werden:
- durch eine Installation / Upgrade nie gelöscht
- zuerst im User- und dann im Programm-Verzeichnis gesucht
2.3. SAP®-Integration
2.3.1. ZBC_R2EdiViewer.abap
Mit dem ABAP® ZBC_R2EDIVIEWER kann man im SAP®-System nach IDocs selektieren,
die dann vom lokal installierten R2EdiViewer.exe angezeigt werden.
Wird bei der Selektion mehr als ein IDoc gefunden, so wird eine ALV-Liste angezeigt.
Aus der ALV-Liste kann durch Doppelklick ein IDoc ausgewählt werden.
Das ausgewählte IDoc, oder wenn nur ein IDoc gefunden wurde, wird auf den lokalen PC
als Flatfile (ohne Statussätze) oder XML-File (mit Statussätze) heruntergeladen und
dann von R2EdiViewer angezeigt.
Der ABAP®-Programmsource befindet sich im Programmverzeichnis und muss manuell
im SAP®-System mit der Transaktion SE80 in einem Paket Ihrer Wahl angelegt/aktualisiert werden.
2.3.2. WLF_IDOC
Auch die SAP®-Standardtransaktion WLF_IDOC dient u.a. zum Anzeigen von IDocs.
Durch eine kleine SAP®-Modifikation ist es möglich den ABAP® ZBC_R2EDIVIEWER
zur Anzeige des IDocs zu verwenden, anstelle der SAP®-Standardsicht.
Dazu ist folgendes zu tun:
- Passen Sie das Unterprogramm "uc_idoc_display" im ABAP® "WLF_IDOC_NEW_F01" entsprechend an
- Erfassen Sie den Wert "ZBC_R2EDIVIEWER" in den SU3-Benutzerparameter "RWLFIDOC_NEW_EXPERT"
| form uc_idoc_display using i_docnum type edidc-docnum changing c_refresh type slis_selfield-refresh. check i_docnum is not initial. *{ REPLACE 1 *\ submit idoc_tree_control with docnum = i_docnum *\ and return. * For IDOC display use locally installed R2EdiViewer.exe * if SU3 parameter RWLFIDOC_NEW_EXPERT = ZBC_R2EDIVIEWER data: lv_su3parm(15) type c. get parameter id 'RWLFIDOC_NEW_EXPERT' field lv_su3parm. if lv_su3parm = 'ZBC_R2EDIVIEWER'. submit ZBC_R2EdiViewer with sidocnum = i_docnum and return. else. submit idoc_tree_control with docnum = i_docnum and return. endif. *} REPLACE perform refresh_single using i_docnum changing c_refresh. if c_refresh is not initial. message s023 with i_docnum. endif. endform. "uc_idoc_display |
