3.3.Graphical user interface

The graphical user interface has a main toolbar. It allows a quick access
to the most important functions of R2EdiViewer:

In addition to the standard display of an EDI file, which displays all EDI fields,
you can also create your own display layouts via customizing.
These usually display
selected EDI fields or check some EDI fields for correct values.

Some example layouts
(reports) for EDIFACT, IDOC, VDA, and ANSI messages
are delivered in the layout directories "layouts" and "layoutsEdifileChecker".

If a "layout directory" is specified in the main toolbar, the alternative display is performed
if suitable layout files exist for the EDI message.

Then the Report toolbar is also available:


Additional functions of R2EdiViewer can be accessed via the main menu.



3.3.1. Menu: File

  • Open
    Opens a dialog box for loading an EDI file.

    (info) Drag and Drop

    Alternatively, you can use "Drag and Drop" from Windows Explorer
    into one of the view tabs to open a file.


  • Search
    Opens a dialog box for searching for EDI files.

    - Search for EDI Content
      The search can be restricted by the EDI content (no XML/native files).
      The input syntax is identical to a layout data selection file.
      Only if a value has been found for all active rows, the search is considered successful.
      For performance reasons an "EDI file format" should also be given.
    - Search filter
      The wildcards * (any number of characters) and ? (one character) can be used for
      the fields "File name", "EDI file format" and "subdirectory name".
    - File name
      *.edi searches for files with the file ending "edi" and would find the file
      R2EdiViewerExample.edi in the R2EdiViewer program directory.
    - EDI file format
      An entry is expected as from the tab "File statistics"
      (examples: VDA_ALL_4905, EDIFACT_97A_DELFOR, *DELFOR, EDIFACT_97A*).
    - Subdirecorty name
      If the subdirectories are also searched, these can be restricted here.
      For *out*, the subdirectories must contain "out" in the name.
      The name of the "Start directory" is irrelevant.


  • Save as
    Opens a dialog box for saving processed EDI file.
    By default, the syntax-highlighted EDI file is saved as a text file.
    About the "Files of type" you can also generate a PDF file (in A1 until A4 size).

  • Exit
    Terminated R2EdiViewer.

  • Most recently used list
    For faster
    open/access, the last maximum of 15 files are displayed.

  • Clear most recently used list
    Delete MRU list.


3.3.2. Menu: Edit

  • Find
    Opens a dialog box for searching a text.
    The following search options are possible:
    - Case is ignored (default)
    - Go directly to the last place of finding

  • Find next
    Start the next search.


  • Goto
    Opens a dialog box with a tree hierarchy of the EDI file for quicker navigation.

    In square brackets will be displayed:
    - Record counter per message
    - Record counter per EDI file
    - Group number(segment number)
       G = start of the group
       g = continuation of the group

    Besides the mouse, the cursor keys can be used for navigation:

    Cursor rightopen tree
    Cursor leftcollapse tree
    Plus keyopen complete tree
    Minus keyclose complete tree

    The tree hierarchy can be configured via customizing.


  • Compare
    R2EdiViewer remembers the maximum last 10 displayed files in the syntax-highlighting view.
    In the settings an external file-comparison tool can be entered.
    With the compare the external tool is called with the actual displayed file and the previous file.

  • View comparison file list
    Display the last 10 files.
    A fixed file is indicated by a red background.

    For an alternate file comparison two other files can be selected.

    Using the toolbar the previous file can be fixed, i.e. a comparison is done always against
    this fixed file.
    : previous file is free (not fixed), i.e. the previous file changes every time
    view a new file .
    : previous file is fixed.


3.3.3. Menu: Settings

(warning) Warning

Startup parameters override always the setting values.

  • Standard

    - Scaling factor:
      One-time after program start the optimum scaling factor is calculate for the
      primary display. Here you can change the value (until Java 8).
      Values less than optimum scaling factor are automatically set to the optimum value.
      A too large value is automatically replaced with the maximum possible value.
    - Windows font folder:
      Directory that contains the TrueType fonts (.ttf files).
      TrueType fonts will be embedded in a PDF file, if PDF standard font can't display
      required characters.
      Customizing (file R2EdiViewerSH.css) determines which TrueType font is to be used
      for which character (Unicode block).

    Additional command line parameters :
      You can use optional v
    ariables %1 and %2.
      They will be later replaced with current (%1) and previous (%2) compare file. 


  • Encoding

  • Proxy Server
    If you have to use a proxy server to communicate with the Internet,
    you can
    make the necessary settings here for:
    - HTTP connections:
      R2EdiViewer is able to search for program updates
    - SOCKS5 connections:
      External SMTP mail server can be reached from the internal network.


  • Mail Server SMTP
    Before you can send an e-mail with the -MR-parameter, you have to setup
    the mail server settings. These are at least:
    - Mail host: IP address or DSN name of the SMTP mail server
    - Mail port: Port of SMTP mail server
    - Mail sender account: valid e-mail sender address on the mail server

    - If you need a mail provider identification, you have to enable "Server requires authentication"
      and you have to enter user name and password.
    - Well-maintained SOCKS5 proxy settings will be used when establishing a connection.

    (info) Send a test e-mail

    You can check the Mail Server SMTP settings, if you enter an e-mail address
    in the field "Send a test e-mail To:".
    After the OK button R2EdiViewer tries to send a test e-mail.


3.3.4. Menu: Help

  • Startup parameters
    Displays a quick reference with all startup parameters.

  • Info
    Displays system information, including program version, current Java version,
    Java memory situation and the active licence.

  • Show End User Licence Agreement
    Displays file R2EdiViewerLicence.pdf

  • Check for new version
    Check if a new version of R2EdiViewer is available for download.
    If you have to use a proxy server, you can make the corresponding settings
    in the menu
    "SettingsProxy Server".

  • Visit Homepage
    Starts the default Internet browser and displays the R2EdiViewer homepage.