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

Sicher ist Sicher
Falls Sie schon eine Version von R2EdiViewer installiert haben: Sichern Sie alle Dateien und Verzeichnisse aus dem Programmverzeichnis. Verwenden Sie den Software upgrade manager für ein automatisches Upgrade. Falls Sie ein manuelles Upgrade bevorzugen, starten Sie R2EdiViewerUninstall.exe für die Deinstallation und starten dann Setup...exe für Installation der neuen Version.

2.2. Setup

Durch den Aufruf von Setup...exe werden folgende Dateien in installiert:

Dateiname	Beschreibung
R2EdiViewer.exe	Hauptprogramm
R2EdiViewerC.exe	Hauptprogramm mit zusätzlichem Konsolen-Bildschirm. Zu verwenden im Batchmode und bei der Fehlersuche.
R2EdiViewer.bat	Startet Hauptprogramm R2EdiViewer.jar mit der Standard-JRE
R2EdiViewer.jar	Eine Alternative im Batchmode: Hauptprogramm
R2EdiViewerSD.zip	Syntax-Directories	24.20
R2EdiViewerSH.cfg	Konfigurationsdatei für das Syntax-Highlighting	24.10
R2EdiViewerGT.cfg	Konfigurationsdatei für die Baumdarstellung des Goto-Befehls	9.10
R2EdiViewerIP.cfg	Konfigurationsdatei der Indexierungsprofile	24.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	24.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

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. Dabei wird nur die zuerst gefundene Datei verwendet.
	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

2.Installation