Administrator Configuration Tips

As Administrator, you can change the behavior of SAP Business Client by making changes to parameters in the administrator configuration file, NwbcOptions.xml.

The table below describes some of the parameters, which, as Administrator, you are most likely to change.

Additionally, at the end of this section, a method for changing the client language on the system logon screen is described.

Table 1: Parameters of Administrator Configuration File (Incomplete List)
Action	Parameter	Notes	Default
Suppress the SAP GUI for HTML Warning	<WinguiCheck>	If no SAP GUI is installed on the local computer or the SAP GUI version is too old, the first time you navigate to an SAP GUI transaction in SAP Business Client, the SAP GUI Integrator dialog box is displayed, stating that with the current installation, all SAP GUI transactions are started with SAP GUI for HTML. Following this, SAP GUI for HTML is started. To display the SAP GUI for HTML warning, set this parameter to false; no warning dialog box is displayed and SAP GUI for HTML starts immediately.	True
Set the Behavior of SAP GUI Sessions	<OpenNewGuiSessionInNewWindow>	A new session can be opened in a new tab or a window. By default, new sessions are opened in a new tab. To ensure that new sessions are opened in a new shell window, set this parameter to true.	False
Set the Behavior of SAP Shortcuts	<ActivateDesktopAgent>	SAP Business Client uses the SAP Business Client desktop agent to communicate with its processes. Thus, triggered by an SAP shortcut or SAP Business Client start-up URL, SAP Business Client can open a tab within an existing SAP Business Client instance or shell window. For this, connection, client and user must match. The desktop agent is activated by default. It starts when the first SAP Business Client instance is opened and is terminated with the last SAP Business Client instance. To deactivate the SAP Business Client desktop agent, set this parameter to false; the shortcut always starts a new SAP Business Client instance and opens in a new shell window.	True
Keep the SAP GUI Theme	<KeepSapGuiTheme>	In SAP Business Client, the SAP GUI theme, SAP Corbu, is taken as default. To change this behavior, set this parameter to true; SAP Business Client uses the SAP GUI theme that is selected in the SAP GUI options.	False
Define the Entry Page	<EntryPage>	By default, the entry page for a user is set to the first pinned tab. You can change this to one of the following options: IndexPage, NewTabPage, FirstWorkcenterPage.	FirstPinnedTab
Open Side-Panel with New Tab	<OpenSidepanelWithNewTab>	If an application includes side panels, these can also be displayed when the application is opened by the user. To do this, change this parameter to true.	False
Show Connections as Read-Only	<ShowConnectionsAsReadOnly>	Use this parameter to prevent users from adding, deleting and changing system connections. This corresponds to the former definition <RuntimeConnections Final ="true"> and SAP Logon Pad mode.	False
Read-only Mode for Search Providers	<ShowSearchProviderConnectionsAsReadOnly>	Use this parameter to prevent users from adding, deleting and changing search providers. This corresponds to the former definition <<SearchProviderConnections Final ="true">. The user can still enable, disable and change the sort order of search providers.	True
Switch Off SAP Business Client Built-in Search Providers	<EnableNavigationItemsQuickLaunch> <ShowServerApplicationsQuickLaunch> <EnableDesktopSearchQuickLaunch>	Activate or deactivate the My Work Area section in the quick launch dropdown menu. Activate or deactivate the Transactions and Applications section in the quick launch dropdown menu Activate or deactivate the Desktop Search section in the quick launch dropdown menu. By specifying the attribute Final="true", the search provider does not occur in the Search Providers dialog box.	True True True
Launch SAP Easy Access from New Page Tab	<ShowEasyAccessLinkInNewTabPage>	Users can launch the SAP Easy Access menu directly from the New Tab page to browse the SAP Menu. To deactivate this, set this parameter to false.	True
Do Not Close Tabs	<DoNotCloseGuiTabs>	To ensure that SAP Business Client does not close tabs with SAP GUI transactions when the user or program navigates back to the SAP GUI entry screen, set this parameter to true.	False
Show Work Center Links on Index Page	<ShowWoCLinksOnIndexPage>	If true (default value), the work center links on the index page act as links to the first contained site.	True
Define URLs for NWBC Connections	<DefaultConnectionBaseUrls>	Define a set of base URLs to be used to generate a set of default URLs for NWBC connections by combining each base URL with all available protocols, application server hosts and ports of the specific system. The generated set of default URLs then appear in the URL dropdown listbox when creating or editing an NWBC connection. All URLs in the set will be pinged; the URL with the fastest response time is then suggested. Specify multiple base URLs by separating them with commas: `<DefaultConnectionBaseUrls>/sap/bc/nwbc,/sap/bc/ui2/nwbc</DefaultConnectionBaseUrls>` Generation of remote access URLs for targets in remote systems: Whenever SAP Business Client accesses the ABAP remote servers (for example, when accessing a server to gather side panel entries for a particular remote transaction), it does so via ICF node paths. SAP Business Client determines the ICF nodes paths as follows: The Administrator can predefine the ICF node paths (for example, /sap/bc/ui2/nwbc for using UI Services runtime or /sap/bc/nwbc for using NWBC runtime) by using the <DefaultConnectionBaseUrls> property (see above bullet point). If the Administrator has predefined the prefixes in this property, then SAP Business Client uses these prefixes. If the connection is a FIORI connection type, the system first tries with the UI2 prefixes (/ui2/nwbc and /sap/bc/ui2/nwbc). If this does not work, SAP Business Client tries then with non-UI2 prefixes (/nwbc, /sap/bc/nwbc). If the connection is an NWBC connection type, the system tries with active connection prefixes (for example /nwbc or external alias /mynwbc). If this does not work, SAP Business Client then tries with UI2 prefixes (/ui2/nwbc and /sap/bc/ui2/nwbc). If the UI2 prefixes do not work, then system then tries with non-UI2 prefixes (/nwbc, /sap/bc/nwbc).	False
Define URLs for Fiori Launchpad Connections	<DefaultFioriLaunchpadUrls>	Define a set of base URLs to be used to generate a set of default URLs for Fiori Launchpad connections by combining each base URL with all available protocols, application server hosts and ports of the specific system. The generated set of default URLs then appear in the URL dropdown listbox when creating or editing a Fiori Launchpad connection. All URLs in the set will be pinged; the URL with the fastest response time is then suggested. Specify multiple base URLs by separating them with commas: `<DefaultFioriLaunchpadUrls>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html,/sap/bc/ui2/flp/FioriLaunchpad.html</DefaultFioriLaunchpadUrls>`	False

Use Client Language on System Logon Screen

The language used by the SAP Business Client at startup is propagated to the system logon. This allows overruling a language predefined in a system connection, or logging on in a different language than is the default when authenticating with SSO (when there is no possibility to change the language in the system logon screen).

You can use the registry entry UseSAPLogonLanguageAsDefault in the following locations to change this:

HKEY_LOCAL_MACHINE\SOFTWARE\SAP\SAPLogon\Options (32 bits)
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP\SAPLogon\Options (64 bits)