sap business client for desktop 6.0 setup
TRANSCRIPT
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 2Public
Contents
Client-side configuration and installation of SAP Business Client for Desktop 6.0 together with SAP
GUI for Windows 7.40
• System connections
• Client configuration
• Provisioning
• Security settings
Server-side configuration
• Enable NWBC core functionality
• Activate Side Panel
• User menus – role maintenance
Further information / links
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 3Public
4. Create and distribute
Internet Explorer
security options
Installing SAP Business Client for DesktopGeneral approach
Client-side
2. Create and distribute system
connections* and client
configuration
SAP UI Landscape
NwbcOptions.xml
Registry entries
5. Configure AS ABAP backend
Server-side
HTTP framework, required ICF services
authentication, SNC,
/UI2/NWBC_CFG_CUST
6. Define user roles
1. Download SAP
Business Client from
SAP Support Portal
3. Install SAP Business Client for
Desktop together with SAP GUI
for Windows 7.40
*Fiori Launchpad connection, NWBC connection, SAP logon connection, and SAP shortcut
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 5Public
Downloading SAP Business Client 6.0 1/2
The desktop version of the SAP
Business Client is available free of
charge!
Download it from the SAP Support Portal https://support.sap.com/home.html
1) Download
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 6Public
Downloading SAP Business Client 6.0 2/2
1) → Installations & Upgrades
3) Select „B“
2) Choose „A-Z“ option
1) Download
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 8Public
Creating system connections(1) SAP UI Landscape
For both SAP Business Client and SAP GUI for Windows 7.40, data
required for system logon is defined based on the new SAP UI Landscape
files. The administrator configuration file typically contains:
• Message server hosts and ports
• Routers
• Predefined SAP Fiori Launchpad connections (new)
• Predefined SAP Business Client connections
• Predefined SAP GUI connections
• Predefined search providers
For information on the migration of the previous connection configuration,
see:
• Help Portal: Migration of Configuration Data
• SAP Note 2075150
The SAP UI Landscape administrator configuration file replaces former NWBC configuration settings for
system connections and search providers in %ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml
2) System Connection
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 9Public
Creating system connections(2) New Connection Type: Fiori Launchpad
With the new fiori launchpad connection SAP Business client acts as a
Windows-based desktop browser for the SAP Fiori launchpad with the
ability to launch classic Dynpro applications (SAP GUI transactions):
• Protocol is either http:// or https://
• Syntax for the URL is as follows:
http(s)://<server>.<domain>.<ext>:<port>/<path>
• Default path:/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html
For information on the SAP Fiori Launchpad configuration, see:
• Help Portal: Setting Up the Launchpad
• Help Portal: Customize the Launchpad URL
2) System Connection
SAP Fiori launchpad
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 10Public
Distributing system connections Provision options for administrator configuration file
Pull
UI client retrieves administrator configuration file from a central storage
such as a remote share or a Web service platform
Push
Administrator distributes the administrator configuration file from his
central data storage repository to the clients
NWBC, SAP GUI for Windows,
SAP GUI for Java
%APPDATA%\SAP\Common\
SAPUILandscape.xml
Read and Write:
User configuration file
%ProgramData%/SAP/<filename>.xml
Retrieves data
from
administrator
configuration file
Remote Share: \\<Server>\<...>\UILandscape.xml
Client initiates pull request.
Web Service Access
NWBC, SAP GUI for Windows,
SAP GUI for Java
%APPDATA%\SAP\Common\
SAPUILandscape.xmlCache and Read:
Administrator
configuration file Read and Write:
User configuration file
2) Distributing Connection
More information:
• Help Portal: Provision of Administrator Configuration File
• SAP Front End Installation Guide, “Configuration with SAP NetWeaver Business Client”
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 11Public
Creating and distributing client configurationNwbcOptions.xml and registry entries
2) Client Configuration
Administrator configuration, such as user settings are located in the following folder:
%ALLUSERSPROFILE%\SAP\NWBC
• Predefine default values (changeable by end-users)
• Prevent end-users from changing values
• Prevent end-users from creating new entries
• Control runtime behavior
Provisioning options:
Push to clients (%ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml) or provide centrally,
once defining the location in %ALLUSERSPROFILE%\SAP\NWBC\NwbcRemoteOptions.xml
For more information, see
• Comments in the configuration file template
%ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml.template
• Help Portal: SAP Business Client Settings (NWBCOptions.xml)
• Help Portal: Administrator Configuration Tips
SAP UI landscape options
• Set registry entries – separately or together with installation via installation server
• For more information about the installation server, see
SAP Front End Installation Guide, “Configuring Packages and Scripting Events”
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 13Public
Installing SAP Business Client1/2
We recommend to install SAP Business Client together
with SAP GUI for Windows 7.40.
Please be aware that an automatic switch to the SAP UI
Landscape takes place.
A common installation package is planned for the next
7.40 Compilation DVD; in the meantime, you can add the
SAP Business Client 6.0 installation to 7.40 Compilation 2
(download via SAP Support Portal).
For more information, see:
• Front-End Installation Guide, which is stored in the
Docu directory both on the CD and the SAP
NetWeaver SAPSetup - SAPs Front-End Software
Deployment Tool guide ( Workstation Installation
Help.chm)
• Help Portal: Installing SAP Business Client with SAP
GUI
2) Install
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 15Public
Distributing Internet Explorer security options
Make sure server addresses corresponding to the system connections
are covered by the Local intranet or the Trusted sites zone.
For more information, see Help Portal: Security Zones in Internet Explorer
SAP Business Client renders HTML content using the Internet Explorer and thus uses the Internet Explorer zone model.
The Internet Explorer zone model is also used for navigation to SAP GUI transactions.
4) Security
5.1 Configuring the AS ABAP back end:
SAP Business Client core features
1. Configure HTTP(S) communication, authentication, SSL and SNC on the AS ABAP
2. Activate the NWBC server runtime
3. Make system-specific settings (NWBC customizing, whitelist)
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 18Public
5.1.1 General server configurationProposal
Step 1: Enable HTTP(S) communication – configure ICM
Help Portal: Administration of the Internet Communication Manager
Help Portal: HTTP(S) Settings in ICM
Test: Call BSP or WDA application in browser
Step 2: Configure the AS ABAP to support SSL and SNC
Help Portal: Installing the SAP Cryptographic Library on the AS ABAP
Help Portal: Secure Network Communications (SNC)
Step 3: Configure authentication
Help Portal: Authentication and Single Sign-On with SAP Business Client
https://<SERVER>:<PORT>/sap/bc/echo
https://<SERVER>:<PORT>/sap/bc/bsp/sap/it00
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 19Public
5.1.2 Activate the NWBC server runtime
Activate Business-Client specific ICF services
Help Portal: ICF Configuration
Help Portal: Active Services in ICF (UI Services)
Test: Launch NWBC for HTML (Test the NWBC ICF service in
transaction SICF)
The server runtime is required for transfer of system and user data. The following two server runtimes are available:
• Server runtime for SAP NetWeaver user interface services as of SAP User Interface Add-On 1.0 SPS 04 for SAP NetWeaver and SAP NetWeaver 7.4 SPS 03
• Server runtime for SAP Business Client
SAP recommends the use of the server runtime for SAP NetWeaver UI services
for the following reasons:
• New UI services features can be applied to SAP Business Client
• New UIs and latest developments based on SAPUI5 and SAP NetWeaver Gateway
can be used with NWBC
• SAP NetWeaver UI services can be supported by the provision of small-sized
support packages
• New UI features are shipped with support packages within a few months
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 20Public
5.1.3 Make system-specific settings
(customizing, and whitelist)5) Configure ABAP Back End
This is already fine-tuning…
In NWBC customizing, the administrator can for example
• Define a welcome message for the Index page
• Specify a theme
For more information, see
• Help Portal: Definition of Configuration Parameters in Customizing (server runtime for NW UI services)
• Help Portal: Definition of Configuration Parameters with Table NWBC_CFG (server runtime for NWBC)
A whitelist can be defined on top of the Internet Explorer security zone model.
For more information, see
• Help Portal: Whitelist
• Help Portal: Defining a Whitelist in HTTP_WHITELIST
• Help Portal: Security Zones in Internet Explorer
Recommended
5.2 Configuring the AS ABAP back end:
Activating the side panel
1. Activate the side panel business function
2. Assign side panel roles to users
3. Enable data transfer to side panels
4. Activate SAP GUI scripting
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 22Public
5.2.1 System settings:Activate side panel business function 1/2
Open the Easy Access Menu and navigate to:
> Tools
> ABAP Workbench
> Development
> Switch Framework
> Business Function
Alternatively, call transaction SFW2.
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 23Public
Enter business function ERP_CA_SIDEPANEL
and choose “Activate”
The business function documentation is available
in the SAP Help Portal:
Deutsch / English
5.2.1 System settings:Activate side panel business function 2/2
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 24Public
5.2.2 System settings:Assign side panel roles to users 1/3
As of ECC 6.0 SP07, a new generic side
panel role is available:
SAP_BSSP_SIDEPANEL_ALL
To enable the side panels for the users, you
must assign the side panel roles in User
Maintenance (SU01).
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 25Public
5.2.2 System settings:Assign side panel roles to users 2/3
Alternatively, assign the user to the role in
Role Maintenance (PFCG)
For more information, see the SAP Help Portal:
Deutsch / English
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 26Public
5.2.2 System settings:Assign side panel roles to users 3/3
If the SP status is ECC 6.0 SP06 or below,
specific roles need to be assigned
For more information, see the SAP Help Portal:
Deutsch → Sidepanel einrichten
English → Setting Up the Side Panel
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 27Public
5.2.3 System settings:Enable format conversion for data transfer from canvas to side panels
5) Configure ABAP Back End
Execute HTTP Service Hierarchy
Maintenance (Transaction SICF)
> Enter Hierarchy Type SERVICE
> Enter Service Path /sap/bc/ui2/nwbc/
(server runtime for NW UI services)
> Execute
Ensure that the SICF service nwbc_ext2int
responsible for data format conversion is
active
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 28Public
5.2.4 System settings:Enable global data transfer to side panels 1/2
1. In Object Navigator (transaction SE80),
select Web Dynpro Comp./Intf.
WD_GLOBAL_PARAMETERS.
2. Navigate to Web Dynpro application
WD_GLOBAL_SETTING. Set the focus to
the object and choose Test/Execute (F8).
A browser window opens.
1
2
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 29Public
5.2.4 System Settings:Enable global data transfer to side panels 2/2
3. Go to change mode and open section
“Side-Panel”.
4. Activate the 2 Web Dynpro parameters
WDSIDEPANELREMOTECONSUMER
and
WDSIDEPANELREMOTEPRODUCER.
5. Save changes.
5) Configure ABAP Back End
3
4
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 30Public
5.2.5 Activate SAP GUI scripting – approach 1
1. Start the Profile Parameter Maintenance
(transaction RZ11).
2. Enter parameter sapgui/nwbc_scripting, and
choose Display.
Attention: parameter name is case sensitive!
3. Choose Change Value.
4. Set the value to TRUE and save changes.
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 31Public
5.2.5 Activate SAP GUI scripting – alternative approach
1. Start the Profile Parameter Maintenance
(transaction RZ11).
2. Enter parameter sapgui/user_scripting and
choose Display.
Attention: parameter name is case sensitive!
3. Choose Change Value.
4. Set the value to TRUE and save changes.
5. Repeat for the parameter
sapgui/user_scripting_set_readonly and set
the value to TRUE.
5) Configure ABAP Back End
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 33Public
Role-based navigation
General
Roles are used to define authorization settings as well
as the navigation structure used by the UI client
Roles match the real life roles that people play within a
work environment
SAP Business Client
The Business Client runtime retrieves all roles assigned
to a specific user and makes the navigation structure
available to the shell
If the role doesn‘t provide a navigation structure,
Business Client uses the SAP Menu
For Web AS connections, maintain the navigation in
transaction PFCG, tab Menu
A set of attributes specifically dedicated to the navigation
frame presentation has been introduced to PFCG in the
last releases
Other Node Details and Menu Options
Help Portal: Role Maintenance in PFCG
6) Define Roles
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 34Public
Role-based navigation – merging of navigation trees
General
If a user has more than one role assigned, the entries in the navigation
tree appear merged as in one role
Two entries that are the same in two roles, appear only once
The role order depends on the sort index defined for the role
Help Portal: Merging of Navigation Trees
Rules
If roles contain identical folders in equal hierarchies, their folder contents
are merged and redundant folders are not visible
Identical folder means that the following attributes are identical:
– Name of the entry (object field)
– Level of the entry in the tree
– Type of the entry (standard entry, side panel or link collection)
– Referenced entry (for side panel and link collection)
The entries of the merged folder are sorted according to the sort index,
ie. entries from the role with the lower sort index come first
6) Define Roles
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 35Public
Role-based navigation: sort index
ZAP_NWBC_HOME
Sort index 0 (home role)ZAP_NWBC_USER_POWER
Sort index 100
ZAP_NWBC_USER_STANDARD
Sort index 10
NWBC 3.5
Newer Business
Client versions
6) Define Roles
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 37Public
Documentation
For detailed documentation of the Netweaver
Business Client please refer to the SAP Help Portal
Latest documentation regarding Business Client 6.0
see on SAP Community Network (SCN): Getting
Started
SAP Note 2201009 contains details about the patches
for SAP Business Client
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 38Public
SAP Business Client Administration Guide (Excerpt 1)
Installation and Client Configuration
SAP Business Client for Desktop Installation
o Installing SAP Business Client (Standalone)
o Installing SAP Business Client with SAP GUI
o Windows Terminal Server Installation
Administrator Configuration
Connection Configuration
o SAP UI Landscape
o Migration of Configuration Data
o Provision of Administrator Configuration File
SAP Business Client Settings
Administrator Configuration Tips
Configuring Support Information
Using SAP Business Client with a Load Balancer
Server Configuration
Server Runtime for SAP NetWeaver User Interface Services
o Migrating to the Server Runtime for UI Services
o Configuring the Server Runtime for UI Services for SAP
Business Client
o HTTP(S) Settings in ICM
o Active Services in ICF (UI Services)
o Settings for Fully Qualified Domain Names
o Configuring Authentication on the Server
o Cockpits
o Definition of Configuration Parameters in Customizing
Server Runtime for SAP Business Client
o HTTP(S) Settings in ICM
o Active Services in ICF
o Settings for Fully Qualified Domain Names
o Configuring Authentication on the Server
o Cockpits
o Definition of Configuration Parameters with Table NWBC_CFG
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 39Public
SAP Business Client Administration Guide (Excerpt 2)
Role Maintenance in PFCG
o PFCG Overview
o Navigation Tree
o Default Pages and Service Maps
o Menu
o Search Providers
o Side Panel
o Remote Systems
o Object-Based Navigation
o Merging of Navigation Trees
Programming Aspects
Generating an External Startup URL for NWBC
Integrating the Context-Sensitive Side Panel
Security Aspects
Authentication and Single Sign-On with SAP Business Client
o ICF Configuration
o Security Zones in Internet Explorer
White List
o Enabling Single Sign-On with Secure Login Client for SAP
Business Client
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 40Public
Further information about SAP Business Client
Join the SAP Community Network (SCN) for information
about the SAP Business Client:
http://scn.sap.com/community/netweaver-business-client
For more information on SAP Business Client and
its integration with SAP‘s UX strategy, see the UX
Explorer:
UX Explorer: SAP Business Client
© 2015 SAP SE or an SAP affiliate company. All rights reserved. 41Public
© 2015 SAP SE or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate
company) in Germany and other countries. Please see http://global12.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.
National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its
affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company products and
services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as
constituting an additional warranty.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop
or release any functionality mentioned therein. This document, or any related presentation, and SAP SE’s or its affiliated companies’ strategy and possible future
developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time
for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-
looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place
undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.