Instructions for SAPReader and its components


Contents

  1. Installing SAPReader
  2. Configuring SAPReader before use
    1. Setting which files should be processed
    2. Assembling an address translation table
    3. Assembling a product code translation table
  3. Running SAPReader manually
    1. From a shortcut
    2. From the command prompt
  4. Running SAPReader automatically at a fixed interval
    1. Using the Windows 98/Millennium Task Scheduler
    2. Using another scheduling program
  5. Uninstalling SAPReader
  6. Troubleshooting

Installing SAPReader

Items in quotes should be typed as they are seen, excluding the quotes.

  1. Click the Start button and choose Run from the Start menu.
  2. Type in "a:\install.bat"
  3. Click the OK button and wait for the window which appears to display the line "Installation complete."
  4. Click the X on the top right hand corner of this window to close it.
  5. SAPReader is now installed to c:\Program Files\SAPReader. The installer will also have created links to the program. If any errors are reported, please contact us about them.

Configuring SAPReader Before Use

Setting which files should be processed

The program filassoc.exe (named File Assocation Editor in the Start Menu) has the purpose of setting how the SAPRead program differentiates between order files and other files in the directory it processes.

Assembling an address translation table

The program addrestt.exe (named Address Translation Table Editor in the Start Menu) is used to assemble a translation table which translates a company's code (eg My Chemicals Company (LON)) into the address of that company.





Assembling a product code translation table

The program codestt.exe (named Product Codes Translation Table Editor in the Start Menu) is used to assemble a translation table which translates a customer's product code into the supplier's product code when SAPReader is run.


Running SAPReader Manually

From a Shortcut

  1. Right-click the desktop, click 'New' then click 'Shortcut.'
  2. Type "C:\SAPReader\sapread.exe" followed by a space, then the folder you want SAPReader to process in quotes. For example, the command line shown in the picture to the right will process the folder C:\Orders. (NOTE: The files that SAPReader will process within this folder depend on the File Association settings.)
  3. Click Next, type a name for the shortcut (such as 'SAPRead c:\orders') into the text box which will appear, then click finish.
  4. Double-click the shortcut which you have created to run SAPReader. You will find that the folder processed now contains two files for each processed file. Each file beginning with the symbol ¬ contains a backup of the original IDOC, whilst each file beginning with a $ sign contains the translated document.







From an MS-DOS prompt

  1. Click Start, then click Programs, then click MS-DOS Prompt.
  2. Type "cd\SAPReader" (without the quotes) and press return.
  3. Type "sapread" (without quotes) followed by a space, and then the name of the folder which you want to process. Press return to begin processing. Please note that when typing folder names like this, any folder whose name is either more than 8 letters long or contains spaces should be abbreviated to its first six letters (excluding spaces) followed by ~1
    For example, "C:\Program Files" becomes "C:\Progra~1" whilst "c:\Order 1" becomes "C:\Order1~1" Occasionally, there are two folders whose first six letters are identical, in which case the folder you are looking for may be called "c:\------~2" or "C:\------~3" instead. If you find SAPReader rejects a folder's name when using it this way, try this solution.
  4. Repeat for as many folders as you wish to process.
  5. Type "exit" and press return to close the MS-DOS window.



Running SAPReader automatically at a fixed interval

Using the Windows 98/Millennium Task Scheduler

  1. Double-click the "My Computer" icon on your desktop. Then double-click 'Scheduled Tasks' then 'Add Scheduled Task'
  2. Click next. When asked to choose an application for this scheduled task, click on "Browse..."
  3. In the filename box, type "C:\SAPReader\SAPRead.exe" and click OK.
  4. In the "Task name" box, type a name which you will remember.
  5. Choose how often you want to have SAPReader run from the selections in the bottom half of the dialog box, then click Next.
  6. Choose when you would like SAPReader to run each day/week/month, then click Next.
  7. Tick the box "Open advanced properties when I click Finish" then click "Finish".







  8. In the dialog that now appears, look for the line marked "Path". In this box, after "sapread.exe" put a space, followed by the name of the folder you want to be processed each time SAPReader runs. The example in the picture will process orders in the folder c:\orders.
  9. Click on schedule (at the top of the dialog box) then click "Advanced..." IF you want SAPReader to run more than once per day. If not, skip to step 11.
  10. Tick the box marked repeat task, and set how often each day SAPReader should be run, and how many times from the scheduled time onwards. Click OK.
  11. Close the Advanced Properties box by clicking OK.

SAPReader will now run automatically. If you want more than one folder to be regularly scanned, repeat the process from step 1.

Using Using another scheduling program

Due to the many different scheduling programs on the market, precise information cannot be provided. However, make sure that the following points are followed:

For more information, please consult the scheduling program's own documentation.


Uninstalling SAPReader

To uninstall SAPReader, double click on "My Computer" then "(C:)". Click SAPReader, press the delete key on your keyboard and click "Yes". SAPReader is now completely removed.


Troubleshooting

Troubleshooting issues reported so far: