Documente Academic
Documente Profesional
Documente Cultură
After you have installed the SAP GUI one or more of the icons for SAP Logon Pad or/and SAP Logon will appear on your desktop.
SAP Logon
A new entry, SAP Configuration, is added to the Microsoft Windows Control Panel.
Before you log on to an SAP system for the first time, your system administrator will give you an initial password. During the logon process, you should create a new password,
known only to you. After that, you use your own password whenever you log on. (Different organizations may have different procedures. If you have any questions, contact
your system administrator.
2.1.1 Logging On
After you have started an SAP system, the first screen you see is the logon screen.
1. Enter the client number in the Client field. If a default client number appears in the field, keep it or change it if necessary.
2. Enter your user ID in the Userfield.
3. Enter the initial password provided by your system administrator in the Password field. As you type the initial password, the asterisks remain in the field, and only the
cursor moves. For security reasons the system does not display what you enter.
4. Proceed to the Language field. You can change the language used to display screens, menus, and fields if necessary.
Note
When you choose the TAB key after you have entered data in a field, the cursor moves to the beginning of the next field.
5. Choose Continue.
6. The system automatically displays the new password dialog box requesting that you change your initial password:
If you do not see the new password dialog box, check the status bar for a system message. You may have entered an incorrect client number, password, user ID, or
language key. If this is the case, repeat steps 1 through 5.
7. Enter a new password and repeat it in the respective field below.
8. Choose (or the Enter key). If you have successfully changed your password, the Copyright dialog box appears.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 2 of 68
9. In the Copyright dialog box, choose Continue. If there are system-wide messages, the System Messages dialog box appears. After you have read the messages,
choose Continue to close the dialog box.
You can log off from the SAP System from any screen:
If you are not certain that you have saved all of your data and you do not want to log off after all, choose No. You return to the screen on which you were previously working.
If you are sure you have saved all your data, choose Yes. All of your SAP system sessions will be closed. You have successfully logged off.
Note
If you want to use SAP Shortcut to logon to a system, refer to the section
If you have only installed SAP Logon Pad, for information about logging on to the SAP system, see:
• Call SAP Logon from the Microsoft Windows menu: Start All Programs SAP Front End SAP Logon .
After you start SAP Logon, the SAP Logon main window appears (see below). The SAP Logon icon appears in the toolbar (together with a title, such as SAP Logon 730) and
in the system tray (in bottom right area of the desktop).
Note
Administrative Configuration: You need to have access to the registry key HKEY_LOCAL_MACHINE. More information: SAP Note 38119
• Blue Crystal theme Checkbox Accept SAP Fiori visual theme is set: Checkbox Accept SAP Fiori visual theme is NOT set:
• Corbu theme
SAP Logon is displayed in SAP Fiori visual theme for classical SAP Logon is displayed in the the theme that you selected for
• SAP Signature theme
applications. your system too, that is Blue Crystal theme, Corbu theme, or
SAP Signature theme.
Depending on the setting in the system, SAP Logon is displayed in one of the following themes:
System-dependent theme
• Enjoy
• Streamline
• Tradeshow
You can find notes about the themes in section 6.2.1 Theme Preview/Settings.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 3 of 68
After you start SAP Logon, the main window of SAP Logon appears:
The main SAP Logon window is displayed using the Explorer View, which is selected by default:
• Favorites
• Shortcuts
• Connections
Within these three main folders, you can create your own folder structure adapted to your working priorities:
You can show a comment field for a group of system connections. One part of the main window is then used to create and display comments for the selected system. You can
create comments for all connections and favorites that you created yourself. Individual comments cannot be created for lists of connections provided by the administrator. In
this case, the texts created in the central file are displayed in the comment field.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 4 of 68
You can change the view of the SAP Logon main window by choosing List View in the dropdown menu:
More information on how to use the entry's context menu: 2.2.2.5 Connections : Context Menu of System Entries.
You can change the view of the SAP Logon main window by choosing Tree View in the dropdown menu:
More information on how to use the entry's context menu: 2.2.2.5 Connections : Context Menu of System Entries.
You can change the view of the SAP Logon main window by choosing Workspace View in the dropdown menu:
This workspace view is only available if you are using the SAP UI landscape. For more information, contact your system administrator.
Note
Unlike in other view types, in your workspace view not all functions of context menus of folders and systems are offered. Some folders do not offer context menus at all.
For more information on how to use the context menu of system entries, see 2.2.2.5 Connections : Context Menu of System Entries.
Try the different views to determine which view best fits your requirements.
When you open the Connections folder for the very first time, it may be empty. If your system administrator has already created entries, you can immediately logon using these.
Entries defined centrally on a server will be displayed as read-only. For more information about the server configuration file refer to SAP note 1426178 .
You can change content of the Connections folder in SAP Logon (but not in SAP Logon Pad) as follows:
• Adding new connections to the Connections folder or one of its subfolders. (For more information, refer to the section 2.2.2.1 Connections: Add Entry.)
• Changing connection entries in the Connections folder (only if they are not displayed deactivated; more information: 2.2.2.3 Connections : Change Entry).
• Deleting connection entries in the Connections folder (only if they are not displayed deactivated; more information: 2.2.2.4 Connections : Delete Entry).
You can also use the connection entry's context menu, which exists both in SAP Logon and in SAP Logon Pad, to
• specify how the entries are displayed. (For more information, see 2.2.2.5 Connections : Context Menu of System Entries.)
• Log on to an SAP system or to display the status of SAP systems (For more information, refer to the sections 2.2.2.5 Connections : Context Menu of System Entries.)
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 5 of 68
Click the button, or choose Add New Entry from the folder's context menu. The first item in the list, User Specified System is selected by default. All of the systems
listed below the User Specified System option have been configured by your system adminstrator and are available for selection.
Note
If you cannot find the system you are searching for in the list, you can continue with section 2.2.2.2 Connections : Creating a User Specified System provided the details of
this system is available.
Select one of the systems from the system list for your new system entry. You can do this by typing the system ID or selecting the system's name in the list. Scroll the system
list if necessary.
You can also filter the system list first and then select a system. Place the focus in the Search for field above the system list and enter a string for which you want to search.
The search mechanism immediately starts a browse process over all system IDs and all description entries.
• AND operator:
To concatenate search terms this way, place a '+' directly before the relevant search term.
Example
Basis +Development
• OR operator:
This is the default. This concatenation will be used if a blank or '|' is located directly in front of the relevant search term.
Example
4.6D 46D, 4.6D |46D
• NOT operator:
In order to exclude systems matching a certain condition, place a '-' directly before the relevant search term
Example
46D -Support
Example
"Support package"
Note
Note that operators in front of the first search term are ignored with the exception of " for exact term search. The search can contain system IDs. The search can contain
system IDs. The search starts automatically and all matching entries are listed:
Note
If the search fails, the following message appears:
To continue select one of the filtered entries in the list or you can start a new search by choosing Clear Filter and typing a new string. If you choose Clear Filter, all available
systems are displayed in the list again.)
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 6 of 68
The last entry field, SAProuter allows you to configure a particular SAProuter for the new system connection. This field is usually empty by default because many systems do
not require a particular SAProuter connection. Sometimes it contains a SAProuter configured as the default SAProuter for your local installation. If you need a certain
SAProuter or need to change the local default configuration, select the respective entry from the SAProuter dropdown list:
Choose Next. Continue with Selecting Load Distribution Group or Application Server.
It can take a moment to connect to the message server and to call the list with the load distribution groups and application servers (Group/Server)
Note
You can define the maximum value for the Timeout of message server in seconds. To do this, call the SAP logon options (for more information, see SAP Logon Options,
6.9.1 General).
If there are groups and servers available they are listed. Select the one you want to connect to:
If the search for a group or server is not successful, the following error message appears in the list:
A special port for the message server can be added if required. For more information, see SAP Note 1685221 . Change the entry if necessary, and choose Next.
Note
All subsequent settings are optional; you can can complete creation process at this stage by choosing Finish. The default settings are used for the network and language
setting areas.
Check all entries, change them if necessary and choose Next. Continue with Defining Network Settings.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 7 of 68
This checkbox is active if the SNC name is defined in the SAP system to which you are going to connect. You can then choose this checkbox to turn on SNC mode and select
the required SNC level by selecting one of the radio buttons below the input field SNC Name. The table below contains a list of the SNC security levels:
Authentication When using authentication only, the system verifies the identity of the communication partners. This is the minimum security level offered by SNC.
Integrity When using integrity protection, the system also detects any changes or manipulation of the data which may have occurred between the two end points of a
communication.
Encryption When using encryption, the system encrypts the messages being transferred, which makes eavesdropping impossible. Privacy protection also includes integrity protection
of the data. This is the maximum level of protection provided by SNC.
Highest security The highest security level offered by the security product you use is selected automatically for your connection.
level
Note
If you chose the option Highest Available Security Setting, the security level is set by the security product used. The authentication is secure in any case. Encryption and
integrity protection of application data is used if the security product provides these functions.
In the presetting Single Sign-On is activated with the SNC mode. You have the option to deactivate Single Sign-On in SNC mode and use logon with user and password
instead.
You can find more information in the documentation for Secure Network Communication on the Service Marketplace under /security Security in Detail Infrastructure
Security SNC User's Guide .
Low Speed Connection (Reduced Network Traffic) You can select this checkbox to activate the low speed connection mode (WAN mode). For more information about
network settings, see 161053 .
Check all entries, change them if necessary and choose Next. Continue with section Maintaining Language Settings.
This screen offers the possibility of maintaining the language and encoding settings:
• Language Settings:
Choose the desired Language from the Language drop down list.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 8 of 68
• Up-/Download Encoding:
Choose the desired Language from the Encoding drop down list. For more information regarding upload/download encoding, refer to SAP Note 765763 .
Check all entries, change them if necessary and choose Finish.
The active wizard window closes and the new system entry is added to the Connections folder.
Note
You can skip steps 3, 4 and 5 by choosing Finish after selecting the Group/Server setting in step 2. In this case all further predefined settings are kept, the wizard is closed
immediately and the new connection is added to the Connections folder.
If the system you want is not entered in the list of available connections (see 2.2.2.1 Connections: Add Entry), you can create a user-specific system for your connection.
Note
To do this, you need some technical details of the connection.
1. In the dialog box Add New System Entry select the list entry at the top User Specified System.
2. If the system you want requires a SAProuter connection, select the correct connection from the dropdown list of available SAProuters.
3. Choose Next.
You can configure system connection parameters in the following dialog box.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 9 of 68
Description A short description of the system entry. Leave the Description field empty if you want to use a default description.
Application Server The name of the host to which you want to connect.
Instance Number
Specify the instance number (for example 00) of the SAP system ou want to connect to.
System ID Specify the system ID of the SAP system to which you want to connect.
It may be necessary to manually edit the group/server selection for a system connection.
The message server is not defined locally and is automtically Enter the correct port name after the message server, separating them with a colon.
displayed correctly.
The message server is not defined locally but the port is Enter the correct name of the message server. In this case the correct port is inserted automatically, and you can
continue with step 4.
Neither message server nor the port are defined locally Enter both the message server and the port, separating them with a colon.
4. Once the connection has been defined, you can select the group or server.
Note
You can find more information about configuring connections manually in SAP-Note 1685221 .
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 10 of 68
Note
Entries can be changed only if they are not displayed as deactivated. Deactivation means that they can be used to logon but their properties cannot be changed.
Deactivation can be configured
You can change an entry by selecting it from the system list and choosing the button in the toolbar. Alternatively, you can open the context menu of the
respective entry by right-clicking it in the list and choosing Properties.... A dialog box with the title System Entry Properties appears. There are three tabs on this dialog:
Connection, Network, and Code Page.
Tab Connections
You can find more information about editing the connection type in the following sections:
Tab Network
For information about network settings, see section
Note
Entries can be changed only if they are not displayed as deactivated. Deactivation means that they can be used to logon but their properties cannot be changed.
Deactivation can be configured
1. Select the relevant entry in the Connections folder, or in one of its subfolders.
Note
You can suppress this confirmation popup by deselecting the checkbox Confirm deletion of connection entries on the SAP Logon Options - General tab.
If you select an system entry, you can open its context menu by right-clicking, pressing the context menu key, or the keys Shift + F10 .
The system entry's context menu in SAP Logon contains the options
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 11 of 68
Choose
• for system entries without activated SNC mode: Log On to log on to the selected SAP system
• for system entries with activated SNC mode: SNC Logon with Single Sign-On to log on using single sign-on to the selected SAP system. SNC Logon Without Single
Sign-On to log on with user and password to the selected SAP system.
• Delete to delete the selected item
• System Status... to open a web page containing information about your SAP system status (if it exists)
• View and one of its menu options to view your system entries in a different presentation mode
• Properties... to change the definition of the selected item
Note
In SAP Logon Pad, the context menu of the system entry contains only the options Log On, System Status..., and View. 2.5 Using SAP Logon Pad).
Sometimes it may be necessary to structure the entries of the Connections folder due to their large number. Therefore it is possible to add new subfolders.
The new subfolder is now displayed on the SAP Logon start screen:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 12 of 68
You can
• Drag and drop entries from the Connections folder into its new subfolder
• Select the new subdirectory on the initial SAP Logon screen, and create new connection entries, as described in 2.2.2.1 Connections: Add Entry.
Shortcuts allow you to start SAP transactions, run reports or execute system commands directly after logging on to a specific system.
When you open the Shortcuts folder for the very first time, it may be empty. If your system administrator has already created entries, you can immediately logon using these.
Entries defined centrally on a server will be displayed as read-only. For more information about the server configuration file refer to SAP note 1426178 .
You can create and/or edit SAP shortcuts not only from your desktop (more information: 2.3.1.1. Creating an SAP Shortcut from your Desktop), or from a specific screen in the
SAP system (more information: 2.3.1.2 Creating a SAP Shortcut from a Specific Screen in the SAP System), but also from the Shortcuts folder in SAP Logon.
You can change content of the Shortcuts folder in SAP Logon (but not in SAP Logon Pad) as follows:
• You add new entries to the shortcut folder by choosing (see 2.2.3.1 Shortcuts : Add Entry)
• You change entries in the SAP shortcut list by choosing (see 2.2.3.2 Shortcuts : Changing or Deleting an Entry)
• You delete the selected SAP shortcut entry by choosing Sie (see 2.2.3.2 Shortcuts : Changing or Deleting an Entry)
You can also use the context menu of the SAP shortcut for these actions. A further option is available here:
• You can display your SAP shortcuts in different ways by choosing View from the context menu, and then one of the entries under View. (More information: 2.2.3.3
Shortcuts: Context Menu of System Entries).
Note
Before you can create a shortcut to a certain system, you need to have created the respective connection in the Connections folder (more information: 2.2.2.1 Connections:
Add Entry)
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 13 of 68
After entering the required data (refer to the description of the General tab in section 2.3.1.1. Creating an SAP Shortcut from your Desktop), the buttons Next and Finish
are active.
Choose the Finish button if you want to use the default options for Trace Level, Window Size, Working Directory. Otherwise, choose the Next button. This options dialog
box appears:
Alternatively, you can also drag and drop any entry in the shortcut list to the desktop.
Change Entry
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 14 of 68
3. Enter the necessary changes in the entry fields on both tabs. More information: 2.2.3.1 Shortcuts : Add Entry
4. If required, correct the settings on the Options tab:
Delete Entry
See 2.2.2.4 Connections : Delete Entry
If you select an SAP Shortcut entry, you can open its context menu by right-clicking, pressing the context menu key, or the keys Shift + F10 .
In SAP Logon the context menu of SAP shortcuts contains the following options:
• Log On
• Delete
• System Status (You can find the prerequisites to display the system status under Display SAP System Status.)
• View
• Sorted By
• Properties...
Choose
• Log On to log on to the SAP system defined by the selected SAP Shortcut entry
• Delete to delete the selected item
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 15 of 68
• System Status... to open a web page containing information about your SAP system status (if it exists)
• View and one of its menu options to view your SAP Shortcut entries in a different presentation mode
• Properties... to change the definition of the selected item
Note
In SAP Logon Pad, the SAP Shortcut entry's context menu contains only the options Log On, System Status..., and View. (For more information, see: 2.5 Using SAP Logon
Pad).
The Favorites folder allows you to easily bundle a group of systems that you currently use frequently:
To add a system connection to your Favorites folder, select the Connections folder and drag and drop the system to the Favorites folder icon on the left:
Note
The newly-created Favorites entry is not an additional system connection but only a link to the respective one listed in the Connections folder. Deleting the favorite does not
lead to the deletion of the connection.
You can rename the favorites entry either by choosing the button or by opening the context menu for this entry and choosing Properties...:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 16 of 68
3. Enter your user ID, your password and a language (optional, if you do not enter a language, the default language is selected), and choose Continue.
Choose the client you need for your current task from the system's User Selection list by clicking it. You can then access the system.
Use this function to logon to an SAP system without adding an item to the Connections folder.
On the SAP Logon start screen, choose Variable Logon in the toolbar:
• To logon to a user specified system keep the default entry selected. The following steps are similar to the respective steps described in 2.2.2.1 Connections: Add Entry
in section Choosing a System from the List (no description entry is necessary).
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 17 of 68
• You can also select an connection entry from the list, and then choose Next. The next steps are similar to those described in 2.2.2.2 Connections : Creating a User
Specified System.
The result of this dialog is just a single logon to the user specified system.
All systems accessed by variable logon during the current session are listed here. The system name is extended by a number that indicates the chronological order of the
system accesses.
Note
The Variable Logon folder and all its entries are deleted when you close the SAP Logon session.
1. Click the icon in the top left-hand corner of the SAP Logon window.
◦ From this screen you can access information about the SAP client environment:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 18 of 68
The Current Directory field in the Additional Information section is particularly important because this folder contains trace files and log files. To close this dialog box,
choose OK.
With this button you can call the SAP system status web page.
The system tray consists of a series of icons in the bottom right of the desktop. To display the relevant context menu, right-click the icon in the system tray.
You can use the SAP Logon icon in the system tray to do the following:
Note
The context menu to the SAP Logon icon on the system tray shows only the modes started by the SAP Logon process (saplogon.exe or saplgpad.exe). Modes started by
other processes like sapgui.exe or sapshcut.exe will not be shown in the modes list and they can not be minimized by choosing the context menu Minimize all session
windows either. For details and the workaround, refer to SAP Note 515156 and related SAP Notes.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 19 of 68
1. Choose the cross in the top right of the SAP Logon window.
2. Click the icon in the top left of the SAP Logon dialog box and choose Close.
3. Open the context menu for the SAP Logon icon in the system tray (see 2.2.8 Accessing the System Tray Menu) and choose Close SAP Logon.
• However, if you have some SAP GUI session(s) running, calling Close SAP Logon just minimizes the SAP Logon window. You can close SAP Logon if one or more SAP
GUI session is running by:
1. Logging off from all the system(s) and then closing SAP Logon (as above)
2. Opening the context menu for the SAP Logon icon in the system tray and choosing Shutdown SAP Logon.
SAP shortcuts allow the user to start SAP transactions, run reports, and execute system commands directly from the Microsoft Windows desktop. This means that you do not
have to navigate through menus. To use SAP shortcuts you must be using a 32-bit Microsoft Windows operating system.
SAP shortcuts can be created in several ways:
• In SAP logon
For more information, see 2.2.3.1 Shortcuts : Add Entry and 2.2.3.2 Shortcuts : Changing or Deleting an Entry.
• From the desktop
For more information, see section 2.3.1.1. Creating an SAP Shortcut from your Desktop.
For information about changing SAP shortcuts, see chapter 2.2.3.2 Shortcuts : Changing or Deleting an Entry.
1. Place the cursor anywhere on the desktop (not on an open Microsoft Windows application), and right-click.
2. Choose New SAP GUI Shortcut .
3. Enter a name for the shortcut (keep the .SAP file extension if it is not hidden). Choose Enter. The shortcut appears for example, as an icon on your desktop.
You have now created a file for your shortcut. Next, you must define this file.
4. Right-click the newly created icon to open the context menu, and choose Edit.
The following dialog appears with its two tabs General and Options:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 20 of 68
◦ Within the last area of this dialog box you have to enter a user and a client used for the system logon. Be aware, that your current Microsoft Windows user is set as
the default user value here. Change it if necessary. You can also change the logon language.
Note
For security reasons, we strongly recommend that you do not enter a password here. The password is stored in an encoded format, but with a stored password
the shortcut file always allows direct system access. Since shortcut files can, for example, be sent by e-mail or copied to other destinations, the stored password is
a significant security gap. Therefore, by default this option is not available. More information: 146173 .
◦ You can define a trace level for your shortcut (see 3 SAP Shortcut Trace.
◦ You can switch the size of the new window from normal size to maximum size.
◦ You can change the current working directory.
If you want to prevent too many sessions being opened, set the indicator for the checkbox Reuse Connections when Starting SAP Shortcuts (more information: 2.4
Logging on Using SAP Shortcuts.
2.3.1.2 Creating a SAP Shortcut from a Specific Screen in the SAP System
1. Go to the screen for the task you want to run, and choose Generate a Shortcut.
• If you do not have an SAP session running in the system the shortcut is targeting to:
1. Double-click the SAP Shortcut for the task you want to execute. A dialog box appears.
2. Enter your password. Press Logon, or press Enter. The SAP session starts.
3. To view or change your shortcut definition, display the context menu by right-clicking anywhere in the logon dialog box (except on the title bar, input fields, or
pushbuttons).
If you have not entered a password only the Edit option is activated. After you have entered a character in the Password field, both the Open and Edit options are
activated.
• If you already have an SAP session running in the system that the shortcut targets, double-click the SAP shortcut on the desktop for the application you want to run. If
an application is already running in the system, a new SAP session is opened. Otherwise, the current SAP session starts the task you want to run if the same logon
parameters defined in the shortcut properties are used in this session. If the SAP Shortcut was created for the system command /NTCD (/N + transaction code), the
task is run only in the current SAP session, irrespective of whether an application is already running or not.
To start a shortcut from within an open SAP session, drag and drop the shortcut onto the open session. The system starts the task you want to run. The following
functions are also available:
◦ To edit the shortcut, use SHIFT + Drag and Drop in the open session.
◦ To open a new session and start the task you want to execute use CTRL + Drag and Drop.
SAP Logon Pad looks very similar to SAP Logon (more information: 2.2 Using SAP Logon). The difference is that you cannot change the entries in the SAP Logon Pad. You
cannot, for instance, add, change or delete logon entries. The corresponding buttons in the toolbar are not active.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 21 of 68
In SAP Logon Pad, the context menu contains only the logon functions (with or without Single Sign-On) and some display variants.
Note
In many cases employees use SAP Logon Pad to access systems they work in. The required configurations are made available by a system administrator, so employees do
not have to define configurations themselves.
The bar shown in the screenshot below containing the menu options System, Edit, and so on, is called the Menu Bar.
The icon for the window menu is always on the far left of the menu bar: . This menu contains Microsoft Windows functions and the two functions added by SAP - Create
New Session and Cancel Transaction.
If an SAP screen personas flavor can be used for the current session, the SAP screen personas icon is located next to the windown menu icon: . By clicking on this icon,
you open the 3.1.1 SAP Screen Personas Selector and Flavor Gallery.
Menu Description
System This menu contains the functions that affect the whole system. For example: Create Session,
User Profile, and Log Off.
Functions Hold/Set/Delete Data for input fields are only availble if they were explictly
implemented in the application. With these functions data entered in a screen within the same
session can be held even if the user leaves the program or transaction and then returns to it
later.
Menu Description
<Object> Usually named after the object you are currently working with, For example: Material. It
contains functions that affect the whole system. For example: Display, Change, Print, or Exit.
Edit Allows you to edit components of the current object. Common functions include Select, Edit
and Copy. The Cancel option allows you to leave a task without saving the data you have
entered.
Goto Allows you to move directly to other screens of the current task. Also contains the Back option,
which takes you back one level in the session hierarchy. Before going back, the system checks
the data you have entered on the current screen, and displays a dialog box if it detects a
problem.
Menu Description
Extras Contains additional functions you can choose to complete the current object or an object component, but which you do not need regularly.
Environment Contains functions to display additional information about the current object.
View This menu enables you to display the current object in different views. Example: Switching between one line and two line display of a table.
Utilities Allows you to do object-independent processing, such as deleting, copying, and printing functions.
Sometimes not all of the available menus fit on one line in the menu bar. In this case, they wrap to the next line. The dropdown principle remains the same.
The SAP Screen Personas selector is a tool for selecting the flavor of SAP screen personas you want to use. The selector is available if:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 22 of 68
You can select one the available flavors as the default flavor by activating it with the yellow star in the flavor selection window.
Note
For more information, see SAP Screen Personas on SAP Help Portal.
The SAP Screen Personas flavor gallery contains further persona flavors, which you can choose to copy to the selector. To do this, you open the flavor gallery using the arrow
button on the bottom right of the SAP Screen Personas selector:
By clicking on icon , the selected flavor is moved from the flavor gallery to the personas selector, and here it is available for selection. By clicking on the button Move
to Flavor Gallery , you can remove selected flavors from the selector, and put them back in the flavor gallery:
3.2 Standard Toolbar, Title Bar, Application Bar, and Status Bar
Standard Toolbar
The system function bar is placed below the menu bar. It consists of a range of icons with general GUI functions and the command field. The command field is used to enter a
transaction code.
Create New Session Creates a new SAP session. Has the same
function as Create Session in the System
menu.
Help F1
Customizing of local layout ALT + F12 Enables you to set your own display options.
The layout menu, identified by the icon Customize Local Layout at the far right of the standard toolbar, allows you to customize certain SAP GUI for Windows settings (for
example: cursor position and the TAB function.
Title Bar
The title bar contains the name of the application currently being displayed:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 23 of 68
When an SAP GUI window is inactive (the window does not have the mouse/keyboard focus) the title appears at the top and the menu is hidden. When the SAP GUI title is
active the application menu is displayed.
Application Bar
The application bar is located below the title bar. The application bar contains icons relevant to the specific application.
Status Bar
The status bar provides general information on the SAP system and transaction or task you are working on. System messages are displayed on the left of the status bar.
There are three fields on the right hand side of the status bar: one with server information, the other two with status information.
YI (1) 000 (example) Shows the system and client you are logged on to. The number in brackets indicates the Session number assigned.
• System
• Client
• User Name
• Program
• Transaction
• Response Time
INS (example) Specifies your date entry mode. By clicking this field, you can toggle between the Insert (INS) and Overwrite (OVR) modes.
Is active if a recording is running with SAP scripting. (For more information about activating scripting on your local PC, see 6.4 Accessibility and Scripting).
Is active if a local Tab Order has been configured on the active screen.
The lock icon is closed if an SNC connection to the server is open. If no SNC connection is open, an open lock icon is displayed.
For information about keyboard access, see Status Bar (Table 18).
3.3.1 Fields
• Field name
• Field data
Field data is a single unit of information, such as a customer's name or account number.
Most of the tasks you perform in the SAP System involve data entry. Typically, you enter data in input fields.
Input fields vary in length. In some cases, the length of an input field determines how many characters you can enter in the field. In other cases, input fields are scrollable – that
is, you only see part of the entry in the field.
• For information about using the keyboard for navigating and editing data in fields, see 8 Keyboard Access in SAP GUI for Windows.
• Insert and overwrite mode
◦ Insert: Any data to the right of the cursor moves to the right as you type.
◦ Overwrite: You type over any data to the right of the cursor.
You use the Overwrite mode to overwrite data, and the Insert mode to insert data between existing data (for example, if you left out a letter in the middle of a word).
The default entry mode is Insert. However, you can to switch to Overwrite at any time.
The status bar displays the current mode. INS stands for insert mode, OVR for overwrite mode.
Choose the INS key to switch between modes.
This switches the current entry mode to the other entry mode.
The INS key is a toggle for both modes.
You can also toggle between modes by clicking the entry mode status field at the far right of the status bar.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 24 of 68
This function is provided by the icon. Whether input help is always visible or only visible if the cursor is positioned in the input field is defined for each application
separately.
Note
If the cursor is positioned in an input field, input help, if available, can also be called using the F4 key.
If advanced search is available, a magnifying glass icon appears in the F4 input help key.
Note
In this case too, the advanced search function depends on the implementation of the individual application. Typeahead input help is not automatically available for
every application.
Note
For more information, see the ABAP Dictionary area in SAP Help Portal:
Some input fields contain data that is for display only; you cannot change or delete the data in these input fields. Input fields whose background is the same color as the
background of the screen contain data that you cannot change.
To enter information in the SAP system, you must sometimes choose between several options. In some cases, you can select only one option; in others, you can select more
than one. If you can only select one option, radio buttons are displayed next to the options.
When you can select more than one, the options are identified by checkboxes.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 25 of 68
3.3.3 Pushbuttons
Pushbuttons are used to execute various functions. The elements Details, Select another flight, and Cancel flight in the screenshot below are pushbuttons:
Keyboard:
For information about keyboard access, see 8 Keyboard Access in SAP GUI for Windows in section 8.2.3 Pushbutton.
3.3.4 Tabs
The elements Assignment, Control, Period Closing, and General Data in the screenshot below are tabs:
Tabs are used to switch between different screen contents. In transactions containing multiple screens, they provide a clearer overview. In addition, tabs enable you to proceed
from one tab page to the next without having completed all the data. To access a tab page, select the corresponding tab header.
In some cases, you must complete all required input fields on a tab page before you can move to the next tab page. In the case of longer tab strips, not all of the tabs appear
on the screen. The left and right arrows at the top of the tab strip allow you to scroll to all the tabs. Tabs are arranged in order of importance or in the process order of the
transaction.
Keyboard:
For information about keyboard access, see 8 Keyboard Access in SAP GUI for Windows and 8.2.16 Tabstrips.
The Table Control function enables you to modify the standard SAP table format as necessary. This is especially useful when standard SAP tables contain columns you do not
use.
• Fixed and variable columns. Variable columns have a horizontal scrollbar at the bottom.
• You can resize columns:
When you move the cursor to the gridline between two columns, the cursor changes to a double-headed arrow. To change the column width, click the left mouse button,
and move the gridline to the desired width.
• You can rearrange columns using drag and drop:
Place the cursor in the header of the column you want to move, hold the left mouse button, and move the column to the required position.
• If you move the cursor along the horizontal scrollbar, quick infos appear indicating the column that would jump to the first display position (after the fixed columns) if you
click the scrollbar at that location.
• You can set the optimal column width (as defined in the SAP system) by pressing and holding the Shift key, and clicking the left mouse button within any column header.
• Icons at the bottom of a table are specific to that table. Some icons commonly used in tables are:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 26 of 68
Icon
Name of Icon Description
For information about keyboard access, see 8 Keyboard Access in SAP GUI for Windows and 8.2.15 Table Control.
Note
The table control must be selectable, that means it must contain the selecting buttons.
If a large amount of data is to be displayed, it can be grouped into lists, which are structures set up like tables made up of columns and rows:
You can find detailed information about the use of the ALV control on SAP Help Portal in the documentation for SAP NetWeaver 7.4 under SAP GUI First Steps Working
with Lists .
Keyboard control: For information about keyboard access, see 8 Keyboard Access in SAP GUI for Windows and 8.2.14 ALV Grid.
Note
A set of data can only be edited by one user and in one session at a time. Multiple write accesses for multiple sessions to the same set of data is denied.
Each session is independent of the others. An operation on one session (for example, closing it) does not cause the affect the other sessions.
Note
Too many open sessions can result in slower system performance. The system administrator specifies the maximum number of sessions you can have open at one time.
The system opens an additional window. The new session becomes the active session and remains the active session unless you click on a different (open or new) session.
Each session has a session number that is displayed in the status bar:
To display a list of all sessions for a system, enter /o in the command field and confirm.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 27 of 68
Closing Sessions
After you have finished using a session, close it. Each session uses system resources that can affect how fast the SAP system responds to your requests.
If you only have only one session open and you close it, you will log off from the system. However, before logging you off, the system prompts you to save your data.
Note
If you have multiple sessions open and only want to close one of them, the system will NOT prompt you to save your data. Therefore, if you want to keep your data, you have
to first save it in the session concerned.
• Enter /nend in the command field. /nend prompts you to confirm logging off from all sessions.
• Enter /nex in the command field. Whereas /nex closes all sessions without prompting you for confirmation.
• Choose System Log Off .
The difference between the two commands is that after entering /nend you are prompted to close all sessions. With /nex all sessions are closed with no prompting.
1. To select a field or the text you want to copy or move, click and drag the cursor over the desired text. The selected text is highlighted.
◦ To remove the information from an input field and place it onto the clipboard of your operating system, choose Cut ( CTRL + X ). The field is now blank.
◦ To copy the selected information onto the clipboard, choose Copy ( CTRL + C ). Data remains in the field.
2. To paste the text, position the cursor where you want the information and then choose Paste ( CTRL + V ). The text is pasted at the current cursor position. The
transferred data remains on the clipboard until you use Cut or Copy again to move or copy new texts on the clipboard. You can insert the texts into fields on another
SAP screen or an external application.
To copy data from several fields or different field types of a screen onto the clipboard, you must turn on the selection mode:
1. Choose Customize Local Layout Clipboard Mark ( CTRL + Y ). The pointer changes into a crosshair cursor.
2. Click in one corner of the area you want to copy, hold the mouse button down and drag the cursor to the diagonally opposite corner (for example, from top left to bottom
right). The system displays the characters selected.
3. Release the mouse button when the rectangle covers the entire text you want to copy.
4. Choose Copy ( CTRL + C ) or Cut ( CTRL + X ). The selected text is copied to the clipboard. When you choose Cut, the selected texts are deleted from the input fields.
The clipboard now contains all the information from the fields you have selected, including the field names and short descriptions. You can use this method to copy the
content of all selected input fields to a screen with the same layout. Because the field names are appended to the previous input field, they will be truncated.
Note
In this mode you can only copy the visible part of the fields. The invisible part of the input fields is truncated.
For an input field this operation only copies the displayed characters to the clipboard - no additional spaces are added.
If an input field already contains text, the clipboard copy function behaves differently depending on whether you use overwrite (OVR) or insert (INS) mode.
This function can also be used for copying SAP data and pasting it into an external program, such as Microsoft Word.
You can also execute the clipboard functions by choosing Customize Local Layout Clipboard Mark/Cut/Copy/Paste .
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 28 of 68
You have three basic possibilities for configuring the look and feel of your SAP Logon dialog and system access: You can open the Options... dialog using
• The Microsoft Windows start menu Control Panel SAP GUI Configuration
Note
The following documentation section describes the Options dialog primarily accessed using SAP Logon since this is the most important way. Several small differences to the
dialog accessed using the system or the Control Panel are described in separate sections:
Within the Options dialog you can use the function Search. All pages of the dialog are searched for the string you have entered. Pages with hits are marked in the tree on the
left.
Note
Most of the configuration attributes that you can manipulate are global: That means, that changes affect not only the system you are working in, and from which you probably
called the Options dialog, but also all other systems you access afterwards. Some changes even affect SAP Logon itself.
Some changes take effect immediately after closing the Options dialog, others only in the next session opened. Some changes even require a SAP Logon restart. You can
find details within the description of the respective attributes.
Note
The button Restore Defaults deletes all locally stored option settings and resets them to the default values delivered by SAP. You have the option to deal with your settings
and security rules separately:
You can:
• Reset all presettings but leave those defined by your security rules or
• Delete only those security settings created by your without resetting all other settings back to default or
• Reset both the settings made by you and the security rules created by you to the default values delivered by SAP.
Note
The settings of the options dialog can be set by the system administrator to a read-only mode. Depending on whether you want to freeze all setting options of a dialog or only
individual values, in the title bar you can choose [read-only] or [part read-only].
6.1 Themes
Several SAP GUI options depend on which theme you have chosen for SAP GUI. Therefore selecting the right theme for your application is the first step of the configuration
procedure.
Note
After having changed the SAP GUI theme, a restart of SAP Logon is required! The Theme selection affects all system accesses and SAP Logon itself.
After you have selected the right theme for your application, you are now able to adapt visual settings such as font settings or included applications:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 29 of 68
A preview of the selected theme is displayed on the right. If you change the Theme selection in the dropdown menu above, the displayed preview immediately adapts to your
latest selection. Be aware that, if you want to change your selection, you have to choose Apply and restart the SAP Logon before you proceed.
• Activate animated focus (Only available for SAP Signature theme and Corbu theme): Small red corners point to the field where the cursor is currently active. Press
CTRL to highlight the current cursor position.
• Show shadow border (Only available for SAP Signature theme): Deactivate this option if required to improve performance.
• Activate high contrast mode, see Theme with High Contrast
• Use Corbu style icons: Together with the Corbu theme a graphically updated set of system icons has been delivered. You have the option to use more modern icons
with the SAP Signature theme too.
• Accept SAP Fiori visual theme (only relevant for Blue Crystal, Corbu, and SAP Signature themes):
Note
This option is only relevant if SAP GUI is used with an S/4 HANA system with activated support of SAP Fiori theme. If other back-end systems are used, this
setting has no effect.
Selected: If an S/4 HANA system with activated support of SAP Fiori visual theme is used, when one of the three above-mentioned themes is selected, the SAP Fiori
visual theme is used for the display instead. The checkbox for this behavior is linked for the three affected SAP GUI themes. If the option for one of the themes was
confirmed, it is valid for the other two themes too. The checkbox is also shown as selected on the settings dialog of the other two themes.
This mode may be important for people with visual impairments. The displayed font colors are switched to white on a black background:
Note
Only the SAP Signature Theme and the Enjoy Theme offer the possibility of selecting a high contrast theme.
Note
Note that the display of SAP Logon can also change if you decide to use a different theme for your system (see 2.2 Using SAP Logon).
To be able to adapt the look and feel of existing applications as quickly as possible to the Fiori 2.0 Design and Usability paradigms -- without having to change over,
technically, to the Fiori framework, you have the SAP Fiori Themes at your disposal. Classic applications for SAP GUI for Windows can be adjusted to Fiori Design and
Usability paradigms by using the
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 30 of 68
The following list outlines some important changes to the display of various screen elements in the Belize theme, as opposed to their rendering in previously available themes
for SAP GUI for Windows:
• To obtain a better overview of the various functions on a screen, a complete new structure of functional display was created with the Fiori design. Commonly known
dynpro bars, such as menu bar, function key bar, title bar, application toolbar, and status bar have been removed and the functions within them redistributed. The Fiori
design only provides a header bar and a footer bar. Many less important functions are grouped in a menu item.
• Another important change is that icons are no longer used in the header and footer bars of the Belize theme. Instead, only texts are used.
• Inactive buttons in the header are not displayed.
• The Belize theme uses another metric that renders the various screen elements larger than current themes. This may cause some elements to appear too large for the
original screen layout, resulting in the user having to scroll horizontally or vertically to view the screen in full.
Display changes in the Belize theme greatly enhance screen readability and put a stronger focus on frequently used features.
Note
SAP Fiori visual themes are generally only available for S/4 HANA systems.
When setting a theme, if the option Accept SAP Fiori visual theme was selected, an additional option is available in this dialog box.
Here you can specify whether the font setting predefined by the SAP Fiori theme is used in the display.
6.2.3 Branding
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 31 of 68
You have the option to add a branding of your choice to the title bar of a SAP GUI session. This option must first be activated by the system administrator (for more information,
see 1669254 ). The graphic you selected is scaled to the available height of the title bar in keeping with the aspect ratio.
Note
For older themes (Classic theme, Enjoy theme, Streamline theme, Tradeshow theme), the option to integrate a branding is not available.
In the SAP Signature Theme you can define and save your own color for SAP GUI and SAP Logon. Saving alone does not mean that your defined color is automatically used.
It is first just added to the Color Settings, and you can select it from here.
Note
The user definition of SAP Signature colors is only available as of Windows 7.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 32 of 68
You can define a system and client-independent default color that you want to use for your future logons. This color setting is always used if no system-specific configurations
have been defined in the system you want to log on to. For the SAP Signature theme you use the dialog SAP Signature theme: Color Settings to define a list of colors.
However, these functions are not available for the Blue Crystal theme - here you can only select colors from a set of predefined colors.
Note
Setting the color using a system-specific configuration is also only available for the SAP Signature theme and Blue Crystal theme (see 6.12.1 SAP Signature Theme, Blue
Crystal Theme: Colors in the System).
With the checkbox Accept default color defined by SAP system you can give preference to a color setting defined in the backend system over your personal setting. For more
information about defining default color settings, see 1640960 and 1642105 .
You can only define color settings for the themes Enjoy, Streamline, Tradeshow, and System Dependent. Therefore this function is only active, if you have currently
selected one of these themes to display SAP GUI:
◦ To save your personal setting as a selectable variant choose Save as..., enter a name, and confirm the dialog. The new color setting variant is listed on the left side
of the dialog box and can now be selected.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 33 of 68
◦ To delete a color setting variant that you had previously saved, choose Delete and confirm.
◦ To reset the current configuration back to the default one, choose the Restore button. Your listed personal variants are not affected by this step.
3. Choose OK to close the dialog.
Time Settings
If you set the checkbox Activate Time Settings, the Color Settings dialog is extended. With the additional options you can configure a color gradient over a predefined period of
a maximum of one day. The background and foreground colors will then start with the selected start colors and change slowly to the selected end colors.
Only the Classic GUI theme offers additional options and the possibility to configure the colors in lists and forms:
These pages contain a number of settings related to interacting with the system, such as notification sounds and behavior of screen elements.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 34 of 68
6.3.2 Visualization
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 35 of 68
Block Cursor Selected: A block cursor is used. It is wide or narrow depending on the other settings for the
cursor width.
Table 2: Controls
Setting Function
Table 3: OK Code
Setting Function
Display field for OK code Selected: The field for the OK fieldis displayed in the toolbar. Using the assigned arrow icon, it
can be displayed either collapsed or expanded.
Selected: In batch input mode the display of an additional dialog box is permitted for the OK
Display dialog for OK code in batch input
code field.
Table 4: Lists
Setting Function
Use Cursor in Lists Selected: The cursor can be used within lists as usual
Allow use of Microsoft ClearType for text in lists Selected: The use of Microsoft ClearType for texts in the list will be allowed
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 36 of 68
Show additional information in the SAP GUI window title Selected: Additional information about the connected system will be displayed in the title bar of
the SAP GUI window - only as long as the window is not active. As soon as the window was
activated the information disappears and the title bar is used to display the main menu bar. As
soon as the window was activated the information disappears and the title bar is used to
display the main menu bar.
Display ellipses (...) if the whole text cannot be displayed Selected: Ellipses or three points (...), which indicate that the field content cannot be displayed
in its entirety, are also shown in I18n mode. The default setting in this mode does not show
them. (See also 1352364 ).
6.3.3 Notifications
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 37 of 68
If you activate the Customizable docking container position option, you can change the position of the docking container in the SAP GUI window. With key combination ALT +
F12 you can save the new position of the docking container, and delete it again.
Note
Option Adjustable Position of the Docking Container is not available inr SAP Fiori visual theme.
For more information about control services, see: Appendix A: Working with Control Services.
To make SAP GUI more accessible for people with visual impairment, the following themes provide an accessible mode:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 38 of 68
If you switch the accessibility mode, the following two options are available for selection:
• Including write-protected and deactivated elements in tab chains: Disabled and read-only elements are not skipped when focus tabbing through the screen.
• Displaying symbols as letters in lists: Unlike symbols, letters can be identified by a screen reader.
You can also specify that a document is displayed with a screen reader outside of the SAP GUI window for improved readability.
Note
If you are using Classic Design or SAP Signature Design, have selected accessibility mode, and have started SAP Logon/SAP Logon Pad again, the tree structure on the
left-hand side of the Options dialog box is now shown in a simplified way. Only this display is accessible by default for screen readers.
This display is then automatically selected when the options dialog is accessed using the screen reader JAWS. It is possible to activate accessibility mode in this way using
the JAWS screenreader for every available design. In this case, the search function of the options dialog is not available for technical reasons.
If the user selects accessibility mode, SAP Logon/SAP Logon Pad is also displayed in a simplified way that is accessible for screen readers (by activating the List View; see
2.2 Using SAP Logon Main Window - List View .)
Note
For more information, see Accessibility for SAP GUI for Windows on the Help Portal.
Scripting
SAP GUI Scripting is an automation interface that enhances the capabilities of SAP GUI for Windows and Java. Using this interface, end users may automate repetitive tasks
by recording and running macro-like scripts. Administrators and developers on the other hand may build tools for server-side application testing or client-side application
integration.
Since Microsoft Windows' native system dialogs (Save As, Open) cannot be recorded when a script is run, they are replaced automatically with a dynpro-based dialog. You
can disable this procedure by selecting option, Show Native MS Windows Dialog. The system-defined dialogs will be displayed, but cannot be recorded by the script.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 39 of 68
You can only configure the relevant settings if scripting is installed. For information about installation and documentation for SAP GUI scripting API, see SCN in area SAP GUI
. For information about recording and playing back scripts, see 6.14 Further Options of the Customizing Local Layout Menu Script Recording and Playback .
Multilanguage functionalities are activated by default. You can configure the SAP GUI settings in accordance with your system environment using the following configuration
pages:
• 6.5.1 IME
• 6.5.2 Encoding
• 6.5.3 Graphic
• 6.5.4 Others
6.5.1 IME
The attributes on this page affect the behavior of the Input Method Editor (IME) used to enter multilanguage characters.
6.5.2 Encoding
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 40 of 68
Auto-detect Latin1 characters Latin1 characters are displayed even with multi-byte character set.
Adjust font to the input language Adjust the font and character set to the keyboard layout.
Adjust font to SAP code-page at logon Adjust the font and character set to SAP code-page sent from the server. Default is ON.
6.5.3 Graphic
User Settings Select the fonts for SAP Graphics. Using this option overrides the internal settings of the
graphic.
Always use this language Display local texts of SAP Graphics in this language (example: EN for English) independently
of the logon language.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 41 of 68
Setting Function
Font file to load Specify the file name of PostScript font to print SAP Graphics.
Font name Specify the font name of PostScript to print SAP Graphics.
6.5.4 Others
Hide shortcut key for multibyte menu Don't display shortcut keys for multi-byte menus.
Do not send any function keys when IME is open Send no function key to the server when IME is open.
Use SAP Logon's language setting Display local menus and messages of SAP front end in SAP Logon's language independently
of the logon language.
Set layout according to the logon language Set RTL layout when the logon language is Arabic or Hebrew. Default is ON.
6.6.1 History
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 42 of 68
Setting Function
On Input history is available up to a maximum length of 59 characters. Your input will be stored in the database locally. When you input data or press the backspace
key, a list is shown for the input field with focus
Immediate The history list is shown immediately for the field with the focus before any entry is made.
Expiration Time Specifies when entries are considered obsolete and can be deleted.
Maximum Permitted File The maximum file size of the database stored locally for history items. This size must be greater than 0, because otherwise no history is available.
Size
Maximum Number of Specifies how many values are stored. Numbers between 1 and 999 are allowed values.
Entries
Enable History for Fields Specifies the length of input fields, up to which the system writes the history. The maximum possible field length is 255; the default is 59. Note that the change does
up to not take effect until you restart SAP GUI.
Delete History All history items are deleted. This is across all the systems.
You can enable the history for individual input fields if their field length exceeds the general maximum length. To do this, place the cursor on the affected input field, press Ctrl,
and then open the context menu of the input field with a single click of the right mouse button. The context menu will offer entries for the input history:
With the Enable History function you can enable all input histories, even if their field length exceeds the predefined length.
Conversely, with the Disable History function you can disable input histories whose field length lies within the predefined range. The input history function will be fully disabled
for this field.
Wit the Use Default Setting you can remove the field selection setting again.
If the Options dialog has been called from the SAP Logon window or from the control panel of your local computer you can redefine the path of the local directory where the
input history information is stored.
Note
If you called the Options dialog from the start menu of your computer, you can only change the path as long as you do not currently have a session open and SAP
Logon/Logon Pad is not running. If you called the Options dialog from the SAP Logon window, you can only change the path as long as you do not currently have a session
open.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 43 of 68
6.6.2 Cache
Within the local cache downloaded pictures will be stored as well as data contained in dropdown lists.
Setting Function
Maximum cache size Specifies the maximum total size of all cache files.
Maximum cache file size Specifies the maximum size of one cache file.
On this page you can find out for how long files stored in one of these two directories are to be saved. As long as you do not change the default setting, all documents that you
have downloaded and all trace files are not deleted but kept for an unlimited period of time. However, you can also specify for both directories that the files which are stored
there are deleted either:
Note
In the Documents folder, all subfolders as well as all files are deleted with each delete operation (including those that are marked as read-only). Whereas in the Trace
folder, only files are deleted (read-only files are deleted too).
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 44 of 68
A third directory where temporary files can be stored by the SAP System is always emptied when the SAP Logon is ended.
On this page you can specify the directory where you want to store configuration details of local tab orders. (For more information about local tab orders, see 8.1 Navigation in
User Interface Elements Configuration of Local Tab Order ).
• Clear Local Tab Order: Deletes all defined local tab orders.
6.7 Traces
Traces help to find errors in programs. While a traced process is running, a trace file is created with all relevant information. This trace file is stored within the Trace folder. You
can only configure the Trace folder on the Session Traces page, but you can also access it from the SAP GUI Traces page and the SAP Logon Traces page.
You can use session traces to get information about errors of different components of the application running in the current SAP GUI session. You may select one or more of
these listed components. Example: ABAP Editor or Calendar for tracing.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 45 of 68
When you enable the session trace mode, all errors and warnings will be displayed automatically. Sometimes, you are also asked to activate Timestamps for performance
tracing or to select Memory for tracing the memory usage of SAP GUI.
Select one or more components for which you want to carry out a trace. If you choose Select All, all available components are selected.
The following example shows how you should proceed to execute an automation trace:
Note
To get trace information about generic system functions check trace option General (formerly option Monitor) from the components list.
To turn off the trace settings, open the trace dialog box again and choose Disable.
If View on Disable is checked, the trace file is opened automatically by choosing Disable.
Otherwise you can open the trace file manually by choosing View Trace. Choose OK to close the dialog box.
The SAP GUI Trace checks the communication between the backend server and your locally installed SAP GUI. You can activate the SAP GUI trace by choosing an
appropriate trace level and confirming the dialog. An alternative way to activate traces is described in section 7 Error Analysis SAP-GUI-Trace .
SAP Logon Trace is used to analyze problems within the SAP Logon dialog itself. An alternative way to activate traces is described in section 7 Error Analysis SAP-Logon-
Trace .
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 46 of 68
6.8 Security
Security is a very important issue that always requires significant amount of attention. For example it is necessary to
Note
You can find more information in SCN: Security Guide SAP GUI for Windows .
SAP GUI provides a comprehensive tool for configuring a wide range of security settings:
You can make individual security settings in the follow-on configuration dialog:
You can filter existing rules by different criteria and search by individual rules. To sort the list by one of the columns, click on the respective column header. You can also hide
rules that were created by SAP or by your system administrator. This can be useful because you cannot change these rules. If however, the security module starts to behave
strangely, you can show any hidden rules again to ascertain whether two or more rules are in conflict with one another.
The security status defines the overall level of applied security rules.
Deactivated
No security checks are performed. The back end is able to execute any program the user has sufficient permissions for on the client PC. The listed security rules have no
effects at all; all actions with no exceptions can be performed. The default action is not changeable and is displayed as Allow.
Note
To avoid unexpected activities on the client PC we strongly recommend that you do not use the security level Disabled.
Customized
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 47 of 68
If you select the security status Customized, the security check is performed on every considered action. There are now two possibilities:
1. With Security Rule - A rule for the respective file has been created (more information: 6.8.2 Security Rules): SAP GUI now checks the predefined action (Allow, Ask or
Deny) configured within this rule and acts accordingly.
2. Without Rule - No rule has been created for this action: SAP GUI executes the Default Action (Allow, Ask or Deny) that you defined as the default action in the Security
Configuration dialog.
Note
If you select security level Customized, you have to think carefully about the Default action defined in the overall security status.
Choosing action Allow means abandoning the control over certain actions triggered by back end processes.
If you choose Ask, the user is at least informed that a potentially critical action is attempting to be executed. He or she can decide whether or not to execute the
action.
In case of the selection Deny, the user is able to execute only those actions that are explicitly allowed in accordance with the configuration of their rules. Execution of
unexpected actions, for which no rules exist, is denied by default.
The text within this dialog box varies, depending on the origin of the asking procedure (rule or overall status), and on the affected action.
The table below lists the possible options:
Allow Allows the action to be executed once. You will be asked again in the future if this action is to be executed. None
Allow & Remember If you select the checkbox Remember My Decision and select the Allow button, the action will be allowed for all future Security rule is created
My Decision occurrences in this context. (For more information about Context, see 6.8.2 Security Rules Number of Contexts ).
Reject Denies the execution of the action this one time without creating a security rule Denying an action may lead to the application None
failing in case the action in question was required by the application. You will be asked again in the future if this action is to be
executed.
Deny & Remember If you select the checkbox Remember My Decision and select the Deny button, the action will be denied for all future Security rule is created
My Decision occurrences in every context. (For more information about Context, see 6.8.2 Security Rules Number of Contexts ).
Your administrator should add rules to the existing default SAP GUI Security settings so that the standard applications you are using can be executed with no or very
limited effect on the user. If you are using an application that generates a lot of SAP GUI Security popups you should consider contacting your administrator so that
an appropriate set of security rules can be deployed.
If you have accidentally created a security rule you can delete this rule in the SAP GUI Options dialog (see chapter Rules defined by the User).
◦ Default Action Deny:
Whenever an action was denied due to the overall security status or an application-specific rule has Deny as its default action, the user will be informed with the
following dialog box:
To get more information about the denied request the user can click the Yes button. The following dialog box appears.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 48 of 68
Click the Details button to display all relevant details for a selected request. It is also possible to save the details to a local file without displaying them first.
The dialog Server Action:The Detail View will offer again the possibility to save the details information.
Contact your administrator if a certain request was denied unexpectedly due to a rule created by the administrator or due to a rule created by SAP. Check your own
rule settings if it was denied due to a rule created by yourself.
Strict Deny:
All incoming requests to execute a certain file or to open a certain document are denied without exception. Only rules specified by SAP are checked. User defined and
administrator defined rules are not checked and therefore have no impact. The Default action is set to Deny and is not changeable.
In the Security Rules table in the Security Settings dialog you can find all rules that currently exist for particular objects like executable programs, files, or registry values that
have to be checked before being run, opened, or changed. The table contains various information about each rule:
Column Content
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 49 of 68
Action Action that is predefined for this object within the rule (Allow, Ask, Deny or Context-Dependent)
Origin Origin of the rule (for example, delivered by SAP, created by the system administrator or created by the user)
Number of A rule can be defined explicitly affecting only a certain back end system or system-client combination. If you need to limit a rule in this way, you can declare one or more
contexts contexts for this rule. As long as the number is 0, a rule is not limited regarding a certain back end constellation.
The object types can also be recognized by a small icon put in front of the object entry:
File
File Extension
Directory
Environment Variable
ActiveX Control
Command Line
Note
The rule semantics within the security module follow a Windows-like inheritance model: for parent objects will apply to the child objects as well, e.g. rules for a directory will
apply to all the files contained in the folder and all its subfolders
A number of existing rules, defined by SAP, are delivered with every SAP GUI. These rules are not changeable at all. You cannot edit or disable them. Rules defined by SAP
cannot be restricted to certain systems so they have no contexts. Their number of contexts is always 0.
You can select a rule delivered by SAP and choose the View button but in this case the following screen Rule Properties does not show any more details than the Rules table
itself.
The system administrator is able to define rules that cannot be changed or enabled/disabled by a single user. The system administrator can add one or more contexts to a rule
so that it only affects certain back end systems or certain system/client combinations. Select one of the rules created by the system administrator, and choose View to display
the existing contexts.
1. Scroll down the Rules list and select the empty row.
2. Choose the Insert pushbutton.
3. On the following screen, define the object type, the object you want to be checked, and the action to be performed. The screenshot below shows an example:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 50 of 68
Applying this rule means that every time a back end process tries to execute the file notepad.exe, the user is asked if he or she will allow it in this case. Leaving the
Security Rule Context table empty means that this rule will be applied to all back end systems.
Note
Use "/" as the path separator in directory, file, registry key and registry value names.
Use "\" to validate characters "[' , ']" and "\" in the names.
4. Choose OK to save the rule and close the dialog, or if required, define one or more security rule contexts.
5. To define a context, select the upper row of the security rules context table, and choose Insert:
6. A new context is added with wildcard asterisks for the fields System, Client, Transaction, Dynpro Name, and Dynpro Number. In at least one of these five fields set a
valid value by opening a table field by double-clicking it and entering a value.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 51 of 68
Note
Input in field Network is necessary only if you need to use a SAProuter to connect to a certain system. If all the systems you require are part of your local network, you
can ignore this field.
If you want to connect to a remote system, you have to declare the relevant SAProuter string in the Network field.
For a group of context conditions that apply to local and remote back-end systems, different contexts have to be created.
◦ One context without a Network value for each local system (or one context with wildcard asterisk for all local systems) and
◦ One context with a declared SAProuter string for each non-local system
7. Check if the default action Ask is the one you want to be performed. Otherwise double-click it and switch the value to Deny or Allow.
8. Double-click the value Disabled in the Status column and switch the value to Enabled. If you only want the context to take effect later, keep the default value Disabled
for now.
9. Choose OK to close the dialog.
The new rule is now displayed in the Security Settings list in the dialog. The one context created in the example above is counted in the last column.
The properties of this and all other rules created by a local user can be changed by choosing the Edit button.
All rules are processed in the order they are displayed in the Security Rules list. That means that the system first works through all SAP-defined rules, then all administrator-
defined rules and finally all user-defined rules. The order of SAP-defined and administrator-defined rules cannot be changed by a user. Users can only define additional rules
that are processed after all other rules. For this reason, users can only change the order of rules that they defined themselves.
If you want to change the order within the set of all user-defined rules, proceed as follows:
Take into account the order in which rules are processed if you get unexpected behavior related to the security settings. Sometimes rules can be defined contradictorily, which
leads to processing conflicts. You may have to examine whether a certain rule was processed before or after a second one with potentially conflicting content. Then it may be
necessary to change the order of your rules within the Rules list and/or to change single rule properties.
• 6.9.1 General
• 6.9.3 Local Configuration Files
• 6.9.3 Server Configuration Files
6.9.1 General
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 52 of 68
• Language
You can display SAP Logon in your selected language. With the checkbox you can specify that the SAP logon language you selected when you logged on to the system
is predefined as the default language.
• Message Server Timeout in Seconds
This field specifies how long the SAP Logon waits for a response from the back end message server. The default value, 10 seconds, is normally sufficient, even with
slow WAN connections. If you experience repeated timeout connection errors, increase this value. If the error persists, there may be a network installation problem.
Note
The current timeout for a connection to the message server is determined by the lower value of this setting and the standard timeout specified by the operating system
for connections.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 53 of 68
On this screen you can check which locally stored configuration files are currently used for your local installation. This information may be important if functional problems
occur. Your system administrator is able to adapt the content or path of all relevant files if necessary. (For more information, see: 38119 and 1409494 .) Double-click the
type name of a loaded configuration file to display its content.
On this screen you can check which configuration files stored centrally on a server are currently used for your local installation. This information may be important if functional
problems occur. Double-click the type name of a loaded configuration file to display its content.
With the checkbox Enable Caching of Server Configuration Files, the configuration files can be buffered locally. This is also useful for working with the latest versions of
configuration files if the connection is lost to the server.
If SAP UI Landscape is used, for this option you can also set the frequency at which the buffer is refreshed. If SAP UI Landscape is not used, this refresh option is not
available. For more information about SAP UI Landscape, contact your system administrator.
You can open the configuration dialog for front-end printing here. The configuration dialog opens in a separate window and offers its own integrated help.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 54 of 68
If you need specific installation details, you can find them on this page.
The page tree on the left varies depending on where you called the options dialog. The title bar also displays the system from which you accessed the dialog.
• The folder Traces now contains only the Session Traces page. That means that you can now only configure the trace options for this particular system, not generally for
all systems used by you in the future. You can enter a file path here for storing the trace file. Use View Trace button to display the last trace.
• The folder SAP Logon Options is not displayed in this view. These two folders contain global settings that may only be configured in the Options dialog accessed
through SAP Logon or Microsoft Windows Control Panel.
6.12.1 SAP Signature Theme, Blue Crystal Theme: Colors in the System
The SAP Signature theme provides the option to vary the color display of different logons depending on the selected system and/or the selected client. Prerequisite for this is
(see also 1617682 ).
1. The back-end system supports the use of different colors for each client.
2. You are logged on to the system and have opened the options dialog from this session.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 55 of 68
If you have selected the Enjoy Theme, you can change the system colors using this dialog. The selection is system-dependent and therefore only accessible from the
respective system you are working in.
You can call the SAP Logon Options dialog from the control panel in Microsoft Windows: Start Control Panel SAP GUI Configuration .
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 56 of 68
Sometimes an SAP system call is performed by an external application, for example a Portal application. If you want this external application to start the system call using the
design configured in SAP Logon, you have to add the application to the list shown on this page. Otherwise the external application uses the default system design. The
Applications configuration is only available for the themes SAP Signature and Enjoy.
You cannot access the local configuration files through the SAP Logon Options folder when you open the Options dialog from the Control Panel.
• Clipboard
More information: 5 Working with the Clipboard, (this function is not available in SAP Fiori visual theme).
• Generate Graphic
To extract some texts in simple UI elements like lists or input fields from the screen into a separate window choose Customize Local Layout Generate
Graphic on the session screen.
• Create Shortcut
More information: 2.3.1.2 Creating a SAP Shortcut from a Specific Screen in the SAP System
• Activate GuiXT
GuiXT allows you to simplify transactions in an SAP system without having to modify them. You can hide screen elements that you do not need, or add elements such
as checkboxes, pushbuttons, graphics, and documentation if this is beneficial to your system. The adjustments for a specific screen are recorded in a GuiXT script using
simple keywords. The script is run each time the screen is called.
You can find more information on GuiXT on the Synactive homepage. You activate or deactivate GuiXT by choosing Customize Local Layout Activate GuiXT .
A checkmark against the menu option means that GuiXT has already been activated. Choosing the menu option changes the setting from Activated to Deactivated or
vice versa. For example, if it was activated then choosing the menu option deactivates GuiXT.
• Script Recording and Playback
SAP GUI Scripting is a tool to record and play back scripts to automate repetitive tasks. For more information about activating scripting, see 6.4 Accessibility and
Scripting and also SCN in area SAP GUI .
To record a task choose Customize Local Layout Script Recording and Playback... The following dialog box appears:
You can extend the dialog box to also see the save options. Click the More >> button.
Check the saving path set by default and change it if necessary. Choose the icon to start the recording. Perform the procedure you want to record. While the
recording is active, this is indicated by the icon in the status bar (more information: ).
After you have finished the recording, choose . The script is stored automatically. You can now replay the script by choosing .playback_script
• Script Development Tools
The Script Development Tools offer you two different additional options:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 57 of 68
◦ Select Do a hit test on the window and choose OK. When you now move the cursor over different areas of the SAP GUI window, the GUI elements you are touching
are identified by a red frame. Additionally the "assistant" displays the technical type and name of the respective GUI element and offers the possibility to copy this
information. You can close this mode by choosing Stop.
◦ Select Troubleshoot SAP GUI Scripting and choose OK. If any problems occur during the use of SAP Script, they are displayed here.
• Default Size
You can change the size of the SAP GUI window to its default size by choosing Adjust Local Layout anpassen Default Size . (This function is not available in
SAP Fiori visual theme).
• Hardcopy
Select this to create a hardcopy of the current SAP GUI window. The screenshot is sent to the locally defined default printer.
• Character set:
A submenu group lists all character sets that are currently supported. You have to select one of them that suits your logon language for the SAP system.
• Quick Cut and Paste
When this function is activated you can cut and paste as follows:
◦ Select the text to be cut and pasted using the left mouse button.
◦ Position the cursor where you want to paste the text.
◦ The text is inserted when you click the right mouse button.
Note
When this option is activated, you can open the context menu by pressing Shift + right mouse button .
• Spelling Check
When you choose this menu option, the input fields in a screen are checked, based on a hidden Microsoft Word document. The results are displayed as follows:
◦ A text in the status line indicating that there are no errors
◦ A list of incorrect words in the status line
◦ A dialog box if there is a large number of incorrect words
Note
This option is not available if a field provides F4 help or if the field content is converted into upper case.
7 Error Analysis
Note
Traces can easily be activated using the respective pages of the Options dialog. For more information, see 6.7 Traces.
Note
After the trace has been completed, do not forget to turn off the trace. Otherwise, this adversely affects the system performance.
1. Close all SAP GUI windows and the previously opened SAP Logon window. Use Microsoft Windows Task Manager to check that no processes like saplogon.exe,
saplgpad.exe, or sapgui.exe are running. If they are, terminate them.
2. Copy the desktop icon SAP Logon Pad to a new icon with a name like Trace SAP Logon Pad.
3. Right-click the icon of Trace SAP Logon Pad and choose the context menu Properties.
4. Choose the tab Shortcut on the popup of properties.
5. In the field Target add a space and then -TRACE=3 at the end of the old text (after the character "). Example:
Example
"C:\Program Files\SAP\Frontend\SAPGUI\saplgpad.exe" -TRACE=3
6. The directory in the field Start in: is the current directory for the trace files.
7. Choose the OK button.
8. Double-click the icon Trace SAP Logon Pad.
9. Start SAP Logon Pad and reproduce the problem.
The trace files saplogon_*.trc, saplgdll_*.trc, sapdpams_*.trc are written in the current folder. You can find the path of the current folder in field Execute in: on the properties
dialog box of the TraceSAPlogon-pad icon. Another way of seeing the path is as follows:
• Click on the icon to the left of the title SAP Logon Pad in the SAP Logon Pad window.
• Choose the menu About SAP Logon.
• Choose System Information.
You can switch on the trace for SAP Logon by following the instructions for SAP Logon Pad Trace above only using the icon SAP Logon. The procedure to prepare the icon is
exactly the same.
The trace files saplogon_*.trc, saplgdll_*.trc, sapdpams_*.trc are written in the current folder. You can see the path of the current folder in the field Start in on the properties
popup of the TraceSAPLogon icon. Another way of seeing the path is as follows:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 58 of 68
• Click the icon to the left of the title SAP Logon in the SAP Logon window
• Choose the menu About SAP Logon.
• Choose System Information.
• You create an SAP shortcut as an *.sap file, in the same way as an SAP shortcut on the desktop.
1. Open the context menu of the shortcut icon and choose Edit. In the edit dialog box change the trace level to level 3.
2. Set the working directory where the trace files are stored. You can use the default working directory set in the *.sap file.
3. Restart the SAP shortcut with the new settings in order to create the trace file(s) sapshlib.trc in the working directory. Meanwhile SAP GUI log and trace files (*.log
and *.trc) are also created in the same directory when the SAP shortcut attempts to start SAP GUI.
4. Get the trace file from the working directory and provide it to SAP by attaching it to a customer message in the SAP support system.
• You can create an SAP shortcut with the command line.
1. Please add two additional parameters -trc=3 for the trace level and -wd="C:\temp" for working directory at the end of the command line.
2. Run the command line and then close the SAP shortcut or SAP GUI window started by the command line. The SAP shortcut trace file sapshlib.trc is created in the
working directory. Meanwhile SAP GUI log and trace files (*.log and *.trc) are also created in the same directory when the SAP shortcut attempts to start SAP GUI.
3. Get the trace file from the working directory and provide it to SAP by attaching it to a customer message in the SAP support system.
You can generate SAP GUI trace files and log files.
1. Create the icon TraceSAPlogon-pad as described in the section SAP Logon Pad Trace.
2. Start SAP Logon Pad by double-clicking the icon.
3. Logon to your SAP system and reproduce the problem.
If you get an error message asking you: "Do you want to see detailed error information?"
◦ Choose Yes and then
◦ Choose OK in the next dialog box so that the trace file contains the error message.
4. After the error occurs, log off from your SAP system.
The trace files are written to the current folder.
To see the path of the current folder:
◦ Click on the icon to the left of the title SAP Logon Pad in the SAP Logon Pad window.
◦ Choose About SAP Logon.
◦ Choose System Information.
Method 1:
1. Create the icon TraceSAPlogon as described in the section SAP Logon Trace.
2. Start SAP Logon by double-clicking the icon.
3. Log on to your SAP system.
4. Reproduce the problem.
If you get an error message asking you: Do you want to see detailed error information? Choose Yes and then OK in the next dialog box, so that the trace file contains
the error message. After the error occurs, log off from your SAP system. In addition to the traces for the SAP Logon program, the trace files for the SAP GUI-program,
such as sapgui_????.log and sapgui*.trc, are written in the current directory.
Method 2:
Turn on the trace for the SAP GUI program separately as described in section 2 SAP GUI Traces.
If you are going to log on to your SAP system using an SAP Shortcut, turn on the trace as described in the section SAP Shortcut Trace and double-click the SAP Shortcut. In
addition to the traces for SAP Shortcut,the trace files for the SAP GUI program, like sapgui_????.log and sapgui*.trc, are written in the working directory defined in the SAP
Shortcut.
• Click the icon Customize Local Layout on the active SAP GUI window and select menu option Options....Customizing local layout
• On the option dialog, choose the Traces Session Traces page.
• On the page, you sometimes need to activate Timestamps for tracing performance or Memory for tracing memory usage by SAP GUI. Then, select in the list below one
or more of the required trace components. Under Display Options, deactivate the flag Show Window. This accelerates working because the trace output is written to a
file and not displayed in a window. For more information, see 6.7.1 Session Traces.
Note
You should only turn on the trace directly before the error occurs. After the trace have been made, turn off the trace as described in 6.7.2 SAP GUI Traces.
Interaction Levels
The level of interactivity of a user interface element depends on:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 59 of 68
Note
For more information, see Accessibility for SAP GUI for Windows on the Help Portal.
Interactive user interface elements, such as input fields, allow interaction in principle, but their current states may be modifiable, read-only, or disabled:
Non-interactive elements such as labels or decorations cannot be manipulated and can only be navigated to in the accessibility mode.
Sequential element navigation moves the focus from one element to the next element. The focus will move along a predefined route, the tab order. Sequential element
navigation using TAB and SHIFT + TAB to move the focus forwards or backwards can be very time consuming. When user interface elements are grouped in dialogs or
screens, you can use group navigation more effectively and move the focus in larger steps. Choose CTRL + TAB to move the focus forwards and SHIFT + CTRL + TAB to
move it backwards.
Jumps to the next (TAB) or previous (SHIFT+TAB) input-enabled elements. Elements are input-enabled fields, pushbuttons, radio button groups, checkboxes,
TAB
ActiveX controls, button bars, toolbars, but not menu bars.
Shift + TAB
1. Command field and button bar are included in the tab chain for tab navigation.
2. If an OCX control will not focus, a focus rectangle will be drawn on its container in order to visualize the current focus, for example the SAP image control.
Jumps to the next (right ALT key+TAB) or previous (SHIFT+ right ALT key+TAB) elements, no matter whether it is input-enabled or not.
Alt Gr + TAB
Alt
Alt Gr + Shift +
TAB
Jumps to the first element of the next group of elements (CTRL+TAB) or the first element of the previous group of elements (SHIFT+CTRL+TAB). Elements group
CTRL + TAB
= visible and invisible frames, ActiveX controls (e. g. tree control, toolbar control etc.) button bars, toolbars.
CTRL + Shift + TAB
1. Jumps to the previous group.
2. Subscreens can be handled like frames if their KeepTab property has been set to TRUE in the Screen Painter.
Navigation inside the element (depending on the element type) If the arrow keys are not reserved by the graphical elements, horizontal or vertical scrolling will be
Arrow keys
made if necessary. In this case, using the key HOME or END will result in scrolling vertically to the first or last page. Compare with Microsoft Internet Explorer.
right / left / up / down
HOME , END
Normally on a screen you can navigate to the next field using the tab button. SAP GUI for Windows enables users to define a sequence of fields for use with the tab button.
You can define any field in a sequence of fields as the entry point for the tab order. Position the cursor in the chosen field and open the context menu of the field while
pressing the CTRL key. From this now enhanced context menu choose Entry Point.
In you define a field in the course of the next field sequence as the Exit Point. To configure your local tab order, press the CTRL key and open the context menu of your
chosen field, and choose Configure Local Tab Order. If you have not already defined any configurations, the table in this dialog is empty. But if you have already defined
entry and exit points, they are listed in the table. In the example below the E-Mail field has been defined as the exit point for the tab order:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 60 of 68
Entry and exit points can be set independently of each other. Using the menu entry Visualize Local Tab Order you can display the tab order of a screen graphically.
Provided no configurations have been defined, the cursor automatically jumps to field at the top left. The example below shows the original tab order of the dialog with
no local configuration. (Since the tab order in the example dialog is embedded in a larger screen it does not start with ordinal number 1):
If local entry and exits point have been configured locally, the visualization of the tab order changes accordingly.
In this example the cursor jumps to the first field of this dialog - Postal Code/City. The tab order ends with the E-Mail field. In the entry and exit point definitions you can
shorten the tab order within a screen, but this will not change the order of the fields the cursor jumps to.
With these functions you can define any order of elements. Position the cursor in the element with which you want to start a element order. and open the enhanced
context menu while pressing the CTRL key. Choose the Exit Element entry. Position the cursor in the next field you want. From the enhanced context menu of this field
choose Local TAB Order: The visualization below shows the result applicable if the E-Mail field was defined as the From Element, and the House Number as the To
Element:
With pushbutton Delete Tab Chain Shortcut you can delete shortcuts that were created in the table.
Note
If you have already specified a From Element for your tab order, the enhanced context menu for the screen in question only provides the option to specify a To Element. The
tab order from From Element and To Element is visible in the configuration table only after you have added the To Element too. You can now specify a From Element again
for the next tab order. From and To elements are stored together as value pairs and are therefore can only be displayed together in the configuration table. For this reason
they can only be deleted together too.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 61 of 68
Note
The configuration option for the tab order is not available for all SAP GUI elements. The following elements are currently supported:
• Input fields
• Radio buttons
• Checkboxes
• Labels
You can find notes about the associated shortcut keys in chapter Keyboard Access in SAP GUI for Windows in section 8.2.19 Configuration of the Tab Order, and notes
about the directory to store local tab orders in section 6.6.4 Local Tab Order.
The TAB key commands are working generally for all UI elements with appropriate functionality. Some elements offer additional key commands to simplify their usage. This
document contains an overview of additional keys used for the following user interface elements of SAP GUI for Windows:
Note
Especially for left-handed users, the following equivalent key combinations are available:Especially for left-handed users, the following equivalent key combinations are
available:
Key Combination for Changing the View of the SAP Logon Main Window Keyboard Command
The work area view is only available if you are using the SAP UI landscape. CTRL + 0
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 62 of 68
Move the focus to the command field directly Arrow up or Arrow down
In the command field: Call up the history list with all your previous entries ALT + Arrow down
8.2.3 Pushbutton
Select and activate pushbutton (simultaneously) Alt + <underlined letter> (Keyboard Command)
8.2.7 Checkbox
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 63 of 68
Select entry in a dropdown list box and go to next interface element. TAB
Close the dropdown list without selecting the focused list option ESCAPE
Move the focus through a list with many entries in larger steps PAGE up or PAGE down
8.2.10 Menu
navigate between the items in the main menu Arrow left or Arrow right
Close a submenu and go to the main menu item ESC or Arrow left
Open the context menu for the focused input field Shift + F10
Call up a history list and choose one of your previous entries Backspace or Alt + Arrow down
Select entry from the list of possible entries First letter of the entry
Move the text cursor between characters Arrow right or Arrow left
Go to the next or previous word CTRL + Arrow right or CTRL + Arrow left
Position the cursor before the first or after the last word or character in the field END or HOME
Select characters in an input field Shift + Arrow right or Shift + Arrow left
Select the word before or after the text cursor CTRL + Shift + Arrow right or CTRL + Shift + Arrow left
Finish editing an input field and save your changes TAB or Enter
Open the enhanced context menu with Input History functions. CTRL + right mouse button
Move the text cursor between characters within the text editor CTRL + Arrow right or CTRL + Arrow left
Place the cursor in front of the first or behind the last word or character END or HOME
Page forwards and backwards through the document PAGE up or PAGE down
Select the word before or after the text cursor CTRL + Shift + Arrow left or CTRL + Shift + Arrow right
Select the entire text from the left/the right of the cursor position to the start of the line Shift + HOME or Shift + END
Select all text between the cursor and the start or end of the entire text CTRL + Shift + HOME or CTRL + Shift + END
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 64 of 68
Go directly to the first or last field in the table/list CTRL + HOME or CTRL + END
Open a node in a hierarchically structured tree and display its child items F2
Navigate from one hierarchy level up or down to the next level ALT + CTRL + Arrow right or left
Navigate between single items at the same hierarchy level. ALT + CTRL + Arrow up or down
Switch between the editable cells of an ALV Grid TAB , Shift + TAB
Move the focus to the first or last cell of a column or a row CTRL + Arrow keys
Scroll through individual pages of an ALV grid containing multiple pages PAGE down or PAGE up
The focus jumps from the first cell at the top left to the last cell at the bottom right. CTRL + PAGE up , PAGE down
Select the word to the right or left or the cursor Shift + CTRL + Arrow right , Arrow left
Call the first or last page of an ALV grid directly CTRL + HOME , CTRL + END
Define a selection range across a number of vertically and horizontally arranged cells Shift + Arrow keys
Stop editing ALV grid cell and confirm changes TAB or Enter
Scroll through individual pages of a table control containing multiple pages PAGE down or PAGE up
The cursor jumps to the first page in the table. CTRL + HOME
The cursor jumps to the last page in the table. CTRL + END
Stop editing the cell of a table control and confirm changes TAB or Enter
Stop editing the cell of a table control and discard changes ESCAPE
Scroll through the complete column content ALT + click the scroll arrow
8.2.16 Tabstrips
Move to the next or previous tab page CTRL + PAGE up or CTRL + PAGE down
Change the size of the selected pane Arrow left , right , up , down
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 65 of 68
Jumps to the next or previous elements to get to the system information in the status bar Alt + CTRL + Arrow right , Alt + CTRL + Arrow left
Jumps from one menu entry to the next Arrow up , Arrow down
Opens the dialog box Configure Local Tab Order Shift + CTRL + L
Sets the selection Entry Point to the current GUI element Shift + CTRL + N
Sets the selection Exit Point to the current GUI element Shift + CTRL + O
Sets the selection Start Point to the current GUI element Shift + CTRL + S
Sets the selection End Point to the current GUI element Shift + CTRL + T
Open context menu Shift + F10 ; you can also use the context menu button on Windows keyboards.
Open submenu of a selected context menu item of a toolbar button Alt + Arrow right
Switch between day, month, and year in the date picker Arrow right , Arrow left
Increase or decrease day, month, or year in the date picker Arrow up , Arrow down
Move the cursor to the node one level deeper Arrow down
Jump to the top or bottom element in a column CTRL + Arrow up , Arrow down
When you view information (for example, a list or online help), not all of the information may fit in your window. To see the additional information use the scrollbars.
To move Procedure
Up or down one line Choose the up or down scroll arrow on the vertical scrollbar
Left or right one character Choose the left or right scroll arrow on the horizontal scrollbar
Up or down one page Click above or below the slider box on the vertical scrollbar
Left or right the width of the page Click to the right or left of the slider box on the horizontal scrollbar
To a certain position in the information (up or down) Drag the slider box on the vertical scrollbar to the approximate location of the desired information, and release the mouse button.
To a certain position in the information (left or right) Drag the slider box on the horizontal scrollbar to the approximate location of the desired information, and release the mouse button
Additional Options:
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 66 of 68
9 Notes on Accessibility
SAP GUI for Windows supports accessible access to SAP systems with different options.
Note
Themes SAP Signature and Classic Theme are the most suitable for accessibility purposes (see also 6.1 Themes).
The following table shows you the recommended settings in SAP GUI for Windows according to the type of assistive technology used or the type of disability. The settings are
described in more detail further below.
Accessibility mode Switch on Switch on Switch on Switch on 6.4 Accessibility and Scripting
Notify when a script Switch off Not relevant Not relevant Not relevant 6.4 Accessibility and Scripting
attaches to a running
SAP GUI
Include disabled Switch on Switch on only if preferred Switch off Switch off 6.4 Accessibility and Scripting
elements in tab chain
Display list symbols Switch on Switch off Switch off Switch off 6.4 Accessibility and Scripting
as letters
Dialog box for Switch on Switch on Switch on only if Switch off 6.3.3 Notifications
messages preferred
Set F4 help to modal Switch on Switch on only if preferred Switch on only if Switch off see below
dialog preferred
Keyboard access instead of the use of the mouse plays an important role in accessible use of SAP GUI for Windows (see 8 Keyboard Access in SAP GUI for Windows).
Appendix
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 67 of 68
The Control Services offer additional features for tree printing, text editing, and ALV Grid handling. The following list shows an overview of these multilanguage-supported
features:
Service Description
Tree structure printing You can print the contents of a tree structure (such as the one in the SAP Easy Access menu).
Text editing
• You can spell check the text in the text editor with Microsoft Word.
• You can send the content as mail using Microsoft Outlook as mail client.
• You can select a specific word in the text editor and directly start searching the Web for it.
• You can select a specific word in the editor and directly start searching for it in the SAP Library (help.sap.com).
Note
Before you can use control services, they have to be activated. For more information, see 6.3.4 Control Services.
The prerequisite for this is that tree structures that you want to print support context menus.
1. Since the tree structure is printed as it appears on the screen, open the structure nodes that you want to print.
2. Then right-click anywhere on the tree structure to open the context menu and choose Services Print as shown in the following picture:
3. A browser window opens, in which you can choose Print Tree to print the structure.
With the text editing features of the control services you can
• Spelling Check
To spell check the whole text shown in the text editor, right-click on the text to display the context menu, and choose Services SpellCheck . If you just want to spell
check part of the text, select the corresponding part of the text, right-click and choose Services SpellCheck . This opens the Microsoft Word spell checker. After
saving, all the corrections are transferred to the text editor. If the spell checker does not find any mistakes, Microsoft Word is closed again.
• Appendix A2.2 Sending an E-Mail from the Text Editor
Prerequisite: You can send an e-mail with the text shown in the text editor as the message body. Prerequisites You use Microsoft Outlook as your e-mail client.
Procedure:
1. Right-click anywhere in the text editor and choose Services Mail in the context menu as shown in the following picture:
Alternatively, you can send only part of the text as an e-mail by selecting the text part and right-clicking on it before using this function.
2. A mail message containing the text from the text editor as the message body is opened and ready to be sent.
Note
You cannot use the main Microsoft Outlook window until this mail has been sent or this new window has been closed.
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18
SAP GUI Help Page 68 of 68
Prerequisite: By default, Google is set as the search engine. You can change this setting by choosing Customize Local Layout Options Interaction Design
Control Services . Just change the default search engine using the drop down list in the Search Provider frame.
Procedure:
1. Select a word in the text editor and right-click to open the context menu. In the context menu, select Service Search SAP Help Portal .
2. A browser window opens showing the result of the keyword search in the SAP Library (help.sap.com).
• Searching the SAP Library for a Keyword
You can select a specific word in the editor and directly start searching for it in the SAP Library (help.sap.com) using your default search engine.
Prerequisite: By default, Google is set as the search engine. You can change this setting by choosing Customize Local Layout Options Interaction Design
Control Services . Just change the default search engine using the drop down list in the Search Provider frame.
Procedure:
1. Select a word in the text editor and right-click to open the context menu. In the context menu, select Service Search SAP Help Portal .
2. A browser window opens showing the result of the keyword search in the SAP Library (help.sap.com).
Appendix A3: Using the ALV Grid Features of the Control Services
Note
This functionality is not available for tables.
Prerequisite: By default, Google is set as the search engine. You can change this setting by choosing Customize Local Layout Options Interaction Design
Control Services . Just change the default search engine using the drop down list in the Search Provider frame.
Procedure:
1. Right-click on a word in the ALV Grid to open the context menu. In the context menu, select Service Search SAP Help Portal .
2. A browser window opens showing the result of the keyword search in the SAP Library (help.sap.com).
• Searching the Web for a Keyword
You can select a specific word in the ALV Grid and directly start searching the Web for it using the selected internet search engine.
Prerequisite: By default, Google is set as the search engine. You can change this setting by choosing Customize Local Layout Options Interaction Design
Control Services . Just change the default search engine using the drop down list in the Search Provider frame.
Procedure:
1. Right-click on the word in the ALV Grid and choose Services Search in the context menu.
2. A browser window opens showing the result of the keyword search in your default search engine.
For more information about SAP GUI (including FAQs), see SCN area SAP GUI , and pages SAP GUI Family .
You can find information on the SAP GUI Scripting API from the standard toolbar by choosing Customize Local Layout SAP GUI Scripting Help .
file:///C:/Users/Kashif%20Naeem/AppData/Local/Temp/~hh2325.htm 17-Feb-18