41
SAP Business Client for Desktop 6.0 Setup October 2015

SAP Business Client for Desktop 6.0 Setup

Embed Size (px)

Citation preview

SAP Business Client for Desktop 6.0 Setup

October 2015

© 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

1. Downloading SAP Business Client for

Desktop

© 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

2. Creating and distributing system connection

and client configuration

© 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”

3. Installing SAP Business Client and

SAP GUI for Windows 7.40

© 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

4. Creating and distributing Internet Explorer

security options

© 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. Configuring the AS ABAP back end

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. 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

6. Defining user roles for SAP Business

Client 6.0

© 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

Further information / links

© 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.