Storing Images for Transaction Variants

The transaction variant image archive allows you to manage images centrally in the SAP System. These images can automatically be downloaded to a user's PC and displayed on an SAP screen whenever needed. GuiXT scripts (which are also stored on the frontend) are responsible for calling and displaying these images.

Transaction SHDI provides two ways of storing images:

SAP recommends that you store images using the Business Document Service. The Business Document Service does not only provide general document management functions but also a link to the Change and Transport Organizer.

The following file extensions are supported:

Business Document Service

To choose an image file from the Business Document Service and use it in a GuiXT script, proceed as follows.

  1. Call transaction SHDI, and choose Business Document Server on the Determine image source dialog box.
  2. To use an image for a GuiXT script, enter TA_VARIANTS_IMAGES in the field Class name.
  3. In the field Document ID, enter a name of your choice (for example, DEMO). In this case, the document ID is a description of the directory in which you store your image files.
  4. If this directory contains image files already, choose Refresh display to update the data. The image files stored in the directory specified are then displayed in the lower part of the screen.

  5. Choose Import to load images from your PC for the Business Document Service. The system displays a dialog box. Choose the desired file.
  6. The name of the image and other attributes are displayed in the lower part of the screen.

    The Lifetime is specified in days.

    Your firm has changed its logo as of a specific date and you want the new logo to be displayed on SAP screens instead of the old one. You have restricted the validity of the old logo image to a specific number of days. When the validity of the old logo runs out, the new logo will automatically be downloaded to all PCs affected, if required, provided that you give the new logo the same file name as the old logo image file.

  7. Double-click the desired file name. The system displays a dialog box with the description of the image file, for example:

SAPIM:TA_VARIANTS_IMAGES//DEMO//Frankfurt.jpg

You can use the file name specified here in a GuiXT script of a transaction variant or a screen variant, as follows:

IMAGE (10,40) "SAPIM:TA_VARIANTS//DEMO//Frankfurt.jpg"

To transport an image file, choose Navigator. The system takes you to the Business Document Navigator. Choose the desired image, and then choose Transport documents. Further information can be found in the section on BC - Business Document Service.

Database

Uploading Images from Your Local Computer to a Directory in the R/3 Database

In order to upload an image to the R/3 database, proceed as follows:

  1. Call transaction SHDI.
  2. Choose Database in the dialog box that appears and enter a directory name in the field Root. Possible entries help is available if you need it. If no directory name is available, choose Create and enter the name of a new directory.
  3. After entering your root name, choose the Change R/3 Database (QuickInfo: Data source R/3 database (change mode)) pushbutton in the dialog box. The following screen contains a list of image files contained in the database directory you have chosen . The image files are stored in subdirectories.
  4. Choose Import from Frontend. A dialog box appears where you can choose the path and name of the image file that you want to import. The image is displayed on the screen to the right of the hierarchy.
  5. Select the folder that you want to save the image to and choose Save.

You may use the fields Validity and Date, located above the list, to determine the life of the picture in the system. Choose Activate (the match head icon) to insert the current date. Then choose Change in front of the input field for Validity. A dialog box appears where you can enter the new validity of your image in days.

Your firm has changed its logo as of a specific date and you want the new logo to be displayed on SAP screens instead of the old one. You can restrict the validity of the old logo image to the day that you want it to be supplanted exactly. When the validity of the old logo runs out, the new logo will automatically be downloaded to all PCs affected if you give the new logo the same file name as the old logo image file.

Downloading Images to Your Local Computer

If you want to make changes to an image stored in the image archive in R/3, you can download the image to your local PC. Be aware of the fact that downloads take place automatically whenever the image is called from a GuiXT script.

Proceed as follows:

  1. Call transaction SHDI.
  2. Choose Database in the dialog box that appears and enter a directory name in the field Root. Possible entries help is available if you need it.
  3. Choose Select available image from R/3 database (the first pushbutton on the left with the green check mark).
  4. Double-click on the image you want to download from the list and choose Export to frontend. A dialog box appears where you can enter the name of the directory where you want to store the image on your PC.

The Image Archive transaction offers you additional features as well. These include Create folder, Delete image file etc. and can be called with the help of the context menu (right mouse button).