Installation Guide
Workforce Performance Builder
Document Version: 1.0 – 2015-04-
15
SAP Workforce Performance Builder 9.4
Navigator
CUSTOMER
Typographic Conventions
Type Style
Example
EXAMPLE
Example
Example
Example
<Example>
E X A M P L E
Description
Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.
Emphasized words or expressions.
Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE.
Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools.
Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.
Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system.
Keys on the keyboard, for example,
F 2
or
E N T E R
.
2
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Typographic Conventions
Table of Contents
3
4
1
2
Introduction ................................................................................................................................................... 4
System Requirements ................................................................................................................................... 5
Installation ...................................................................................................................................................... 6
Uninstalling the Navigator ............................................................................................................................ 7
5 Requirements for Playing Back Navigations .............................................................................................. 8
6 Adapting the DNT File .................................................................................................................................... 9
6.1
Using different Navigator Versions and Workareas ............................................................................................. 9
6.2
Using an IP Switch ................................................................................................................................................. 10
6.3
Using Both Scenarios ............................................................................................................................................ 10
7 Designating MIME Types While Using a Server ........................................................................................ 12
9
8 Specifying Navigations for the Autostart Function ................................................................................. 13
8.1
Defining the Autostart Function ........................................................................................................................... 13
Technical Support ........................................................................................................................................ 14
SAP Workforce Performance Builder 9.4
Table of Contents
Customer
© 2015 SAP SE. All rights reserved.
3
1
Introduction
The SAP Workforce Performance Builder Navigator is the tool for playing back navigations. It is required on every workstation on which navigations are to be played back. Before you can install the Navigator, and in order to ensure that it can be used to play back navigations without problems, certain requirements must be satisfied and certain procedures must be followed. These instructions will assist you with the administrative handling of the
Navigator.
4
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Introduction
2
System Requirements
The Navigator is mandatory for playing back navigations. Note the following minimum system requirements for installation:
Type
Operating system
Specifications
Memory
Microsoft Windows Vista, Windows 7 or Windows 8
(without tile mode)
32 & 64 bit version
A minimum of 1 GB
Hard drive
Browser
10 MB of free space
Internet Explorer 7.0 – 11.0
Scenario
SAP Business Suite
Windows Vista
Requirement
SAP GUI Scripting activated
Windows Automation API
SAP Workforce Performance Builder 9.4
System Requirements
Customer
© 2015 SAP SE. All rights reserved.
5
3
Installation
Installation is performed via the provided installation file
Navigator.msi
. To install the Navigator, carry out the following steps:
Note
In order to install the Navigator, you will need to have administrator rights for the computer on which the
Navigator is to be installed.
1. Start the installation program by double-clicking the installation file program icon.
2. The installation program will guide you through all the steps for installing the Navigator. Now follow the instructions in the displayed dialog.
3. Once the Navigator has been installed, you can close the installation program by clicking on the
Finish
button.
6
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Installation
4
Uninstalling the Navigator
The Navigator can be uninstalled via the software dialog of your operating system. This can be called up via the menu
Settings -> Control Panel -> Software
.
Alternatively, you can also uninstall the program via the installation file
Navigator.msi
of the corresponding version of your Navigator: Launch the installation file and click on
Next
. Select the option
Remove
and click on the
Remove
button to confirm. The Navigator software is then uninstalled.
SAP Workforce Performance Builder 9.4
Uninstalling the Navigator
Customer
© 2015 SAP SE. All rights reserved.
7
5
Requirements for Playing Back
Navigations
The Navigator, ensures the playback of navigations for the following applications:
Applications
SAP
Types and Versions
SAP GUI for Windows from 7.2
SAP GUI for HTML from Kernel version 7.2
NW Enterprise Portal from 7.3
NWBC for Windows 3.5 with embedded SAP GUI
NWBC for Windows 4.0 with embedded SAP GUI
MS Office
NWBC for Windows 4.0 with embedded WebDynpro
Business One 9.0
WebDynpro
Microsoft Office 2003, 2007, 2010 and 2013
(Word, Excel, Outlook and PowerPoint)
Detailed information is available in the Product Availability Matrix (PAM) of the SAP Workforce Performance
Builder.
Navigations under SAP
The following recommendations are necessary for the playback of navigations under SAP:
Consider for the playback the settings for the SAP Client.
The playback of the navigation requires the corresponding GUI Theme (e.g. SAP Tradeshow) used for the recording.
For information about the necessary settings in the SAP client, refer to the installation guide or manual of the
Producer.
Navigation on the Manager
For the playback of navigations from a Manager environment the following requirements are necessary:
SSO
An activated single sign on (SSO) is necessary for the playback of assigned content. Import the active directory of the user and activate SSO afterwards.
Anonymous
Without the login the Manager allows the playback of navigations for anonymous user. Activate the
Anonymous
user in your Manager and assign the navigations to the user.
8
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Requirements for Playing Back Navigations
6
Adapting the DNT File
You are able to adapt the DNT file of your navigation content to use several workareas by starting a navigation.
This can be done for the desktop assistant as the navigation type allows a centralized start and playback of the navigation content. There are the following scenarios:
Different Navigator and workarea versions
IP switch for localized content
Note
The created navigation content and the used Navigator are version dependent. Playback your content of a
SAP Workforce Performance Builder Producer version with the correspondent Navigator.
Adapting the DNT file
The DNT file is stored in the group folder of the desktop assistant in the workarea. The folder has the UID of the group as name, which can be read out in the Producer.
Open the file in a text editor and execute the changes. Save the DNT file afterwards.
Note
After generating and publishing a new desktop assistant, the changes are discarded. Save your adaptations in a different file to replace your needed adaptations easily.
Note
When adapting the DNT file do not change the structure. This is necessary to ensure an error free playback.
Use always quotation marks for the attributes and finish a line with a comma.
6.1 Using different Navigator Versions and Workareas
The created navigation content and the installed Navigator for the playback is version dependent. It is not possible to playback newer content with an older Navigator version.
As the content and the Navigator versions can be different you are able to add several workarea paths of the content versions in the DNT file of your desktop assistant. The installed Navigator calls the correct content of the defined workarea path.
SAP Workforce Performance Builder 9.4
Adapting the DNT File
Customer
© 2015 SAP SE. All rights reserved.
9
Example of a desktop assistant DNT file with different workarea paths (bold text):
{
"type":"desktop_assistant",
"entity_type":"group",
"cfg_contentlanguage":"en-US",
"disp_name":"Group 20140211111702",
"uid":"GR_8F6D32752FA92CB3",
"wa_base":"http://server-adress/workarea_standard/",
"wa_base_9.3":"http://server-adress/workarea_new/",
"wa_base_9.3.1":"http://server-adress/workarea_new_ServicePack/",
"wa_base_9.3.1.876":"http://server-adress/workarea_new_ServicePack_BuildNumber/"
}
'
wa
_base'
is the standard path for the workarea, e.g. for version 9.2, and should always be keeped.
'
wa
_base_NewVersion'
allows you to add the new workarea content for a newer Navigator version, e.g. 9.3.
In special cases you also can call the workarea regarding the Service Pack or the build number.
6.2 Using an IP Switch
In order to launch navigation content from within a decentralized network structure, the setup of an IP switch is necessary to call the workarea base URLs. Thus the distribution of workareas on several web servers is enabled and the end user is able to call local learning materials. This is especially meaningful when several international locations are given.
Example of a desktop assistant DNT file with an IP switch (bold text):
{
"type":"desktop_assistant",
"entity_type":"group",
"cfg_contentlanguage":"en-US",
"disp_name":"My Desktop Assistant",
"uid":"GR_8F6D32752FA92CB3",
"wa_base":{
"12.34.56.78": "http://server-adress_1/workarea_1/",
"12.34.56.90": "http://server-adress_2/workarea_2/"
}
You are able to use wildcards to support a wide range of IP addresses, e.g.:
"12.34.56
.*"
,
"12.*"
6.3 Using Both Scenarios
You can combine both scenarios in one DNT file - different versions of the workarea and Navigator as well as the
IP switch. The structure of the DNT file should be as follows:
10
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Adapting the DNT File
{
"type":"desktop_assistant",
"entity_type":"group",
"cfg_contentlanguage":"en-US",
"disp_name":"My Desktop Assistant",
"uid":"GR_8F6D32752FA92CB3",
"wa_base":{
"12.34.56.78": "http://server-adress/workarea_1/",
"12.34.56.90": "http://server-adress/workarea_2/"
},
"wa_base_9.3.0":{
"12.34.56.78": "http://server-adress/workarea_3/",
"12.34.56.90": "http://server-adress/workarea_4/"
}
}
SAP Workforce Performance Builder 9.4
Adapting the DNT File
Customer
© 2015 SAP SE. All rights reserved.
11
7
Designating MIME Types While Using a
Server
In order to play navigation files from a Microsoft Internet Information Server (IIS), it is necessary to clear several file types (MIME types) for the administrative area of operations as well as for navigation files playback. This is necessary as the server does not recognise the filename extensions by default and therefore is unable to run the files. Thus, the error message "File not found" will be displayed when accessing the file.
The respective files can be designated in the
MIME type/File type
dialogue of the server settings. Define the following extensions and types:
Extension
General
Type/Sub-type Description
Navigation project playback file .dnt application/x-wpb-navigation
Microsoft IIS (additional MIME types)
.index text/xml
.wa
.deploy text/xml text/xml
Contains the list of files in a folder to map the structure in the published area of operations.
Defines the folder for a specific area of operations. Contains the information regarding this area and, where applicable, a central work area.
Indicates a published area of operations. File has no further content.
12
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Designating MIME Types While Using a Server
8
Specifying Navigations for the Autostart
Function
Navigations can be specified for regular use in the Autostart function. This can be used for example to automatically open a navigation every time the computer is started up so that it is ready for work. Especially the desktop assistant is recommended for the use with the autostart.
Here, you can access navigations in a local workarea or navigations which are available via a web server or through file sharing.
8.1 Defining the Autostart Function
To specify a navigation for the Autostart, open the task planning via the menu
Control Panel (Category -> Small icons) -> Administrative Tools -> Task Scheduler
.
1. In the dialog, select the
Create Basic Task...
option to create a task.
2. Enter a name. Click on
Next
.
3. Specify when the navigation should start, e.g.
When the computer starts
. Click on
Next
.
4. Select
Start a program
as the action.
5. Program: In the corresponding field, define
Navigator.exe
as the program. If necessary you can use the
Browse...
option to locate it in your folder structure. Navigation: Specify the navigation in the field
Add arguments
. To do this, enter the path to the dnt file, e.g.: http://server/[...]/workarea/project/project/navigation.dnt
.
Click on
Next
.
6. Then click on
Finish
to transfer the task to your Autostart function.
SAP Workforce Performance Builder 9.4
Specifying Navigations for the Autostart Function
Customer
© 2015 SAP SE. All rights reserved.
13
9
Technical Support
Please use the SAP Incident Wizard on the SAP Service Marketplace to submit your incidents on the following components:
KM-WPB // Workforce Performance Builder
KM-WPB-PRO // Workforce Performance Builder – Producer
KM-WPB-IPR // Workforce Performance Builder – Instant Producer
KM-WPB-MGR // Workforce Performance Builder - Manager
KM-WPB-NAV // Workforce Performance Builder - Navigator
If you are not familiar with the SAP Service Marketplace, please read the following information:
To access the SAP Support Portal you need an S-user ID and password. You can request access data from your SAP Super Administrator or register online on the SAP Service Marketplace page under ‘Registration‘.
With this user, you have read-access to all the contents of the SAP Support Portal, you can use the SAP
Community Network and SAP Help Portal, and you can also book courses under SAP Education.
If you want to work with the support applications (Incident Wizard, license key request, system data maintenance, software download and so on), you need the corresponding authorizations, which your SAP
Super Administrator can give you.
You can find information for new users and about support applications on the Support Portal Homepage under ‘Learn More‘. There you can also register for a personal overview demonstration of the SAP Support
Portal.
14
Customer
© 2015 SAP SE. All rights reserved.
SAP Workforce Performance Builder 9.4
Technical Support
www.sap.com/contactsap
Material Number
© 2015 SAP SE. 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 AG.
The information contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System ads, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS,
S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise
Server, PowerVM, Power Architecture, POWER6+, POWER6,
POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes,
BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2
Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX,
Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Apple, App Store, FaceTime, iBooks, iPad, iPhone, iPhoto, iPod, iTunes, Multi-Touch, Objective-C, Retina, Safari, Siri, and Xcode are trademarks or registered trademarks of Apple Inc.
Oracle and Java are registered trademarks of Oracle and its affiliates.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the
Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame,
VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts
Institute of Technology.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge,
ByDesign, SAP Business ByDesign, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.
These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP
Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP
Group 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.
