SDV - SAP Data viewer
=====================

This program is freeware. It may be freely distributed as long as you include this file and all files in the original distribution archive without changes or additions. It is delivered to the end user "as is". The author is not responsible to any damages to the user's hard- or software.

All mentioned marks are property of their respective owners.

Copyright(c) 2004-2014, Software Union Luxembourg


Purpose
-------
This utility is provided for debugging SAP (r) IDOC file contents. It reads IDOC files and displays the data in a readable format. It can be a great help when developing IDOC-Interfaces for SAP(r). 

It is based on our own class library for IDOC handling which is available as a linkable dcu on request. 

Parameters
----------
Wildcard: 
You can provide a filename or wildcard at startup. All matching files will be imported and their contents shown in SDV.

At startup, IDoc template definitions can be read from par files provided for more flexibility. 

Parser files can be generated using SAP transaction WE63.


Definitions from those files will then be used instead of those defined by SAP Data Viewer. The names of the par files to be used have to be defined in an ini file. This ini file must reside in the application directory of SAP Data Viewer and be named like the application, with an .ini extension (e.g. sdv.ini). 

It's structure is as follows:

[Config]
CodePage.Input=<Internal codepage, default 0>
CodePage.Output=<IDoc codepage, default 0>
Font.Name=<Treelist font name, default Ms Sans Serif>
Font.Size=<Treelist font size, default 8>
Font.Charset=<Treelist font charset, default 1>

[Files]
ParFile1=<1st file name>
ParFile2=<2nd file name>
...
ParFilen=<nth file name>

Codepages define internal (for display) and external (used in IDoc) codepages. If they are different, IDoc file buffers are automatically converted after reading and before writing. To handle e.g an IDoc coded with codepage Latin-2 (Windows 28592), values should be set as:

CodePage.Input=1250 (Central Europe)
CodePage.Output=28592 (ISO-8859-2, Latin-2)
Font.Charset=238 (EASTEUROPE_CHARSET)

The file names can be either defined with absolute paths or relative to the application's directory. Thus, if the Data Viewer application is installed in c:\Program files\Sdv\Sdv.exe and the par files are in c:\Program files\Sdv\Parfiles then

Parfile1=parfiles\MyParfile.par

would be perfectly valid.

An options dialog can be opened by Selecting "Options" from the system menu or by Pressing Ctrl+O.

User Interface
--------------

Edit box: 
The name of an IDoc file to be imported can be entered here.

Button [...]: 
Alternatively, the file can be selected from a shell dialog which is shown when the button is pressed. The shell dialog can be opened also by pressing F4.

Checkbox Process empty fields:
When checked, empty fields will be imported and shown. Otherwise, they will be ignored. If you want to edit empty fields, you should check this option.

Button Read: 
After entering or selecting the IDOC file name import will start. The state of the import is shown by a progress bar. When import is complete, the IDOC data will be written to a treeview. This can take longer than the import itself and progress is also shown with a progress bar.

Treeview:
Within the treeview, all imported data are shown. Normal navigation as known from Windows (tm) Explorer is possible. The treeview also supports drag and drop, so you can drag files from anywhere on your desktop into it and the file contents will be read and displayed.

Status Bar:
Shows Author and e-mail information. An e-mail can be sent by double-clicking on the e-mail address.

Furthermore, configuration information is shown in the middle pane. Either "Auto" if internal structure definition is used, or "x PAR" if structure definitions have been read from PAR definition files (x is the numer of files read). If hovering the mouse over that info panel, a hint with further information will be displayed.

Function keys within the treeview:

Crtl+F: Find. After confirming the search string, the data will be searched for it, beginning with the next line. Search is case sensitive. Optionally, if the checkbox "Search in field names" is checked, field names will also be searched.

F3: Repeat search Forward.
Ctrl+F3: Repeat Search Backward.
Ctrl+Del: Delete Current node.

Ctrl+S: Save IDoc to file. Original delimiter setting from input file will be preserved but can be changed.
Ctrl+O: Show options dialog

Version History
---------------
2014-02-20
- Search for field names
- Parsing of "TEXT" description 
- Display of descriptive text as hint when hovering over a field name 

2008-02-19
- Dropping attachments from Outlook is now possible
- Eliminated error message "Cannot focus..." when loading IDocs via command line

2007-12-19
- Options can be configured in a dialog
- Delimiter settings can be changed on saving
- Better handling of numeric fields
- Better error handling for date fields
- Corrected problem with reading of time fields, 5th digit was suppressed
- Corrected document numbering when writing multiple IDocs to one file
- Corrected reading of multiple IDocs from one file with no delimiters present
- Adressing fields by numbers when saving IDocs to avoid problems with duplicate field names within one segment
- New property CodePage for codepage conversions
- Codepage for IDocs configurable via ini file
- Charset for Treeview configurable via ini file
- Font name, size and charset configurable via ini file
- Fixed bug when reading IDoc using internal definitions
- UI enhancements
- Whole form accepts dragged and dropped files now
- Removed XP manifest

2007-09-06
- Display of header records EDI_DC40 in bold
- Display of the Idoctype together with EDI_DC40 to enhance orientation within large IDocs
- New time field type 
- Reading of segment templates from Parameter files 
- Internal data structures more efficient (saves memory)
- Much Faster processing (e.g. 5 MB IDoc file in 0.5 s)
- Checkbox to decide if empty fields should be included
- Datatype specific editing for date, time, float, integer and string
- Saving of IDoc files with original delimiter settings from inputfile
- Included Segment EDL35 in fixed definitions
- Auto-detect of Delimiter setting
- Delimiter setting is preserved in IDoc object
- Enhanced handling of negative values
- Eliminated some more memory leaks
- Inclusion of field names in floating point conversion exceptions

2007-05-02
- It is possible to save IDocs after editing
- Corrected initial display on smaller screens
- New property : Delimiter to be used in connection with AppendCrlf, defaults to CR/LF but can be set to anything.

2005-10-24
- Eliminated some memory leaks
- Files are correctly closed in case of an error
- Formatting routines made thread-safe

2004-11-22
- Corrected wildcard parameter handling at startup.
- Empty segment names aren't imported as EDI_DC40 anymore
- Segment EDI_DC40 in first record is now handled correctly even if length is > 526 byte, up to 652 byte. 

2004-11-15 
- Initial release