2.Installation

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

(warning) 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:

DateinameBeschreibung
SR

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

25.20

R2EdiViewerSH.cfg

Konfigurationsdatei für das Syntax-Highlighting

24.10

R2EdiViewerGT.cfg

Konfigurationsdatei für die Baumdarstellung des Goto-Befehls
9.10

R2EdiViewerIP.cfgKonfigurationsdatei der Indexierungsprofile24.10

R2EdiViewerSH.cssCascading Style Sheets für die Syntax-Highlighting-Formatierung 23.20

R2EdiViewerSHdark.cssCascading Style Sheets für die Syntax-Highlighting-Formatierung 23.20

R2EdiViewerXL.cfgKonfigurationsdatei für die Layoutbestimmung bei XML-Dateien23.30

R2EdiViewer.ini

Programm-Settings

24.10

R2EdiViewer.lic

Freeware-Lizenz-Zertifikat


R2EdiViewerWL.cssCascading 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.zipLeere Syntax-Directories für Kundenerweiterungen7.12

  ..ExtensionLibraryXX.jar

Fünf leere JAR-Dateien für Kundenerweiterungen8.10
  [jre]Lokale, unabhängige JRE für R2EdiViewer25.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:

SRSuchreihenfolge

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