Mail Overview (from Outlook or Notes, for example)

Technical data

Type of application

MiniApp

Technical name

BW07

Supported as of Release

46D

Contained in the following role

Basic role for all employees

SAP_WPS_EMPLOYEE

Integration

The MiniApp displays data that is on an external mail server. You can go directly to the Web application or PC application of the external mail client from the MiniApp.

Prerequisites

You can use this MiniApp with all mail systems that support the iMAP standard (for example, Microsoft Outlook 98/2000 and Lotus Notes 5.0). However, iMAP settings have to first be made in the mail system.

The following components are required:

Component

Delivery type

Database table EMSSERVER

These components are delivered with the Workplace system.

Function module BWSO_EMS_PARAM_GET

Function module BWSO_EMS_PARAM_SET

ITS files for service BW07:

  • BW07.SRVC (service file)
  • BW07_01.HTML (HTML file)
  • BW07_01.HTML (flow file)
  • BW07_DE.HTRC (German resource file)
  • BW07_EN.HTRC (English resource file)
  • ENVELOPE.GIF (image file)

The latest version of these components is available in the SAP Download Area of the SAP Service Marketplace (alias ocs-download) under Download mySAP.com Workplace Packages.

ITS program files:

  • MPREMS.DLL
  • IMAP4.DLL
  • LIBCOMM.DLL

Program text for report ZEMSFILL:

ZEMSFILL.TXT

Activities

  1. Copy the following data into the following directories of the ITS server:

If the directories do not exist, create them.

File

Directory

BW07.SRVC

SERVICES

BW07_01.FLOW

BW07_01.HTML

BW07_DE.HTRC

BW07_EN.HTRC

TEMPLATES\BW07\99

ENVELOPE.GIF

MIMES\BW07\99

MPREMS.DLL

IMAP4.DLL

LIBCOMM.DLL

<ITS Instance>\Programs

  1. In the registry of the ITS server host, create a new entry with the name EMS in the directory HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\<ITS-VERSION>\<ITS-INSTANZ>\PROGRAMS\SAPMPR. Add the following STRING value to this entry:

Name

Value

(Default)

MprEMS

ModProvDLL

MprEMS

  1. The URLs used to call the Web clients in the mail system differ according to the mail system you are using. The EMS_NAME parameter in the BW07.SRVC service file determines the Web server for which the URL is to be generated.

The file is delivered with two entries for the EMS_NAME parameter. Deactivate the entry that is not to be used by annotating it. A comment line in the service file starts with #.

Example entry in file BW07.SRVC

If you are using Microsoft Exchange:

If you are using Lotus Notes:

If you are using a different mail system, add the Web server for which the URLs are to be created in the form ems_name <name of Web server>. You also have to change the HTML template BW07_01.HTML at the place where the URL is created for the Web client of the mail system.

Example of file BW07_01.HTML

Optional Settings

Users have to make some settings in this MiniApp before they can use the overview. You can make default settings for these specifications using report ZEMSFILL. The data is written to the EMSERVER personalization table.

  1. Read the report in the Workplace server system and use the text in the ZEMSFILL file as the program text.
  2. Execute the report.
  3. You can make the following settings:
    • Mail server
    • Mail Web server
    • Flag indicating whether the current Workplace user is to be preset in the Mailbox User field
    • Flag indicating whether the symbol for calling the PC mail client is to be shown
    • Flag indicating whether the symbol for calling the Web mail client is to be shown
    • Selection of whether the MiniApp in the PC client or the Web client in the mail system is to be used to start (the Web client is set by default)
  1. Specify the users for which the default settings are to apply. The possible entries are:
    • All users (*)
    • Individual users
    • Distribution lists
    • Several users whose names partially match (for example, AB01*)

Multiple users can be grouped together in distribution lists. They are maintained in transaction SO15 and stored in the shared folders in the Business Workplace. You can branch to distribution list maintenance by choosing Create Distribution List on the selection screen for the report.