2.1. Vorbereitung

2.1.1. Systemvoraussetzungen

R2EdiViewer ist eine Java-Anwendung für Windows und läuft unter den Java Versionen 8 - 21.

Beim Setup von R2EdiViewer wird eine lokale JRE 64bit in das R2EdiViewer-Unterverzeichnis
private\jre mit installiert.

Falls die auf dem Rechner/unter Windows installierte JDK/JRE verwendet werden soll, kann der Inhalt
von private\jre einfach gelöscht werden (das Verzeichnis selber muss aber leer erhalten bleiben).
Dann wird zunächst nach einem JDK (Java Development Kit) und danach
nach einer JRE (Java Runtime Environment) gesucht.

Natürlich können Sie im Verzeichnis private\jre auch Ihre eigene, bevorzugte JRE-Version speichern.

Wenn R2EdiViewer über das Menü „Help->Check for new version“ aktualisiert wird, kann über eine
Checkbox entschieden werden, ob die mitgelieferte JRE64-Version die Version in private\jre ersetzen soll.

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:Setup...exe deinstalliert zuerst die alte R2EdiViewer-Version, falls die neue Version
in das gleiche Zielverzeichnis installiert wird.
Bei einem Upgrade in ein anderes/neues Zielverzeichnis ist die alte R2EdiViewer-Version
über R2EdiViewerUninstall.exe vorher zu deinstallieren (oder über Windows).
Danach installiert Setup...exe die neue R2EdiViewer-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
R2EdiViewer.jar	Eine Alternative im Batchmode: Hauptprogramm
R2EdiViewerSD.zip	Syntax-Directories	26.30
R2EdiViewerSH.cfg	Konfigurationsdatei für das Syntax-Highlighting	26.20
R2EdiViewerGT.cfg	Konfigurationsdatei für den GoTo-Navigationsbaum	9.10
R2EdiViewerIP.cfg	Konfigurationsdatei der Indexierungsprofile	26.20
R2EdiViewerSH\|dark.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	26.30
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	Setup: Deinstallationsprogramm
install.log	Setup: Installationsprotokoll
[jre64]	Lokale JRE (64-Bit); wird in das leere Verzeichnis „private/jre“ kopiert	26.30
[layouts]	Verzeichnis der standardmäßig ausgelieferten Layout-Vorlagen
[layoutsEdifileChecker]	Verzeichnis mit der Layout-Vorlage für den "EDI file checker"
[libs]	Verzeichnis externer JAR-Dateien
[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]	Vom User installierte JRE oder die JRE aus dem Verzeichnis jre64
ZBC_R2EdiViewer.abap	ABAP^®-Programm zur IDoc-Anzeige aus SAP^® via R2EdiViewer	26.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 oder das einzige IDoc wird auf den lokalen PC als Flatfile (ohne Statussätze)
oder als 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.

Wenn man keinen Programmsource installieren möchte, kann man über den ABAP^®
RCOD_DOWNLOAD_IDOC_AS_XML ein IDoc als XML-Datei auf den lokalen Rechner herunterladen.
Natürlich muss dann diese XML-Datei manuell mit R2EdiViewer geöffnet 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.
In der WLF_IDOC-Liste startet ein Doppelklick auf die Status-Nummer des IDocs
(SAP-Spalte "IDoc-Status") die Anzeige via ZBC_R2EDIVIEWER.

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