Skip to Content
Technical Articles
Author's profile photo Dennis Padia

SAP Enable Now: Web Assistant Set up for SAP S/4HANA On Premise


It takes more than software to transform a business. Your enterprise software is a powerful tool, but to harness that power, your workforce must use the software accurately and intelligently. Whether you have a new implementation or solutions already in production, it’s essential that employees keep their skill levels high and their knowledge current to increase productivity. The SAP Enable Now solution helps companies manage all aspects of modern corporate learning such as roll out and performance support, change management, compliance, and soft skills training.

This blog serves as a guidelines on how to integrate SAP Enable Now web assistant with S/4HANA On Premise edition. Web Assistant is available for several SAP Fiori apps delivered with SAP S/4HANA On-Premise. To make it available, you must set it up for the SAP Fiori launchpad and for the back-end system.


The Web Assistant supports different scenarios for providing help content for your apps and needs. The scenarios are:

Source: SAP


Standard Content Scenario: SAP provides Web Assistant content for your SAP applications by default, which includes context help and guided tours as well as tutorials for the learning app. This content is available for free, the end user consumption does not require an SAP Enable Now instance

NOTE: The standard content scenario provides standard SAP help content. It is not possible to customize the content.

Source: SAP


Extended Content Scenario: In addition, SAP Enable Now provides the possibility to customize standard SAP content and to create user-defined content which can be played back in parallel to the SAP content. The extended content scenario is based on the standard content scenario.

For the extended content scenario, an SAP Enable Now instance is required to edit and store the custom content on the SAP Enable Now Manager

Source: SAP


Custom Content Scenario: SAP Enable Now provides the possibility to create user-defined content, which includes context help and guided tours as well as tutorials for the learning app.

For the custom content scenario, an SAP Enable Now instance is required to edit and store the content on the SAP Enable Now Manager

Source: SAP


The most common scenario adopted by customer is Extended Content Scenario where business can leverage the flexibility to create user-defined content for their customized fiori apps or processes.


Web Assistant is not pre-configured and must be configured for each SAP S/4HANA system. Standard content created by SAP can be consumed directly.

For SAP S/4HANA-based SAP Fiori apps, Web Assistant requires the following:

  • SAP S/4HANA application server
  • SAP Web Dispatcher
  • Web Assistant Server (hosted by SAP)
  • SAP Content Server (hosted by SAP)

IMPORTANT NOTE: SAP Web Dispatcher is mandatory. No Question asked.

Below high level overview shows all the steps required for setting up Web Assistant for SAP S/4HANA, on-premise. This helps you to plan your setup with all steps and roles.

Setup of SAP Web Dispatcher

  • Download and install SAP Web Dispatcher
  • Get and import SSL certificate for SAP components (for example, for SAP content server)
  • Create redirect file
  • Create SAP Web Dispatcher profile

Setup SAP Fiori Catalog

  • Create a catalog in SAP Fiori launchpad designer
  • Create a Web Assistant role
  • Assign role to all relevant users

Test Implementation

  • Playback for end users

Setting up Web Dispatcher

To make Web Assistant available for the SAP Fiori launchpad, configure SAP Web Dispatcher. SAP Web Dispatcher is used as reverse proxy and redirects the URLs of the SAP S/4HANA application server, the SAP content server, and the Web Assistant server.

I’m using integrated Web Dispatcher with message server but if you have separate web dispatcher then also steps remain the same.

Getting the Certificate

Get the root certificate of so that SAP Web Dispatcher recognizes the SSL certificates.

Open “Developer Tools” or Press F12 in Chrome browser and navigate to “Security” section. Click on “View Certificate” > Certification Path > Click on root certificate and press “View Certificate” > Press on “Details” on next popped up certificate.

Click on “Copy to File” and select “Base-64 encoded X.509 (.CER)” export it to your local desktop

Importing the Certificate

Import the exported certificate into your SAP Web Dispatcher. Open web dispatcher URL


Login with administrator account. Default web dispatcher administrator account is “webadm”

Navigate to “PSE Management” > Select “SAPSSLC.pse” and click on “Import Certificate”

Open the import root certificate in notepad and paste the certificate here. Click on “Import”

Creating the redirect URL

A redirect file is used to redirect to the URLs of the SAP content server and the Web Assistant server. Create a text file with the name redirect.txt by using a text editor and enter the following:

# User Assistance Content Platform - rewrite rule
if %{SID} = WA1
SetHeader HOST
RegRewriteRawUrl ^/sap/dfa/help/(.*) /dps/$1
# Script Server - rewrite rule
if %{SID} = WA2
SetHeader HOST
RegRewriteRawUrl ^/resources/sap/dfa/help/(.*) /xRayControls/resources/sap/dfa/help/$1

NOTE: WA1/WA2 SIDs which are used here are dummy SIDs, you can use any SID. It doesn’t matter. 

Transfer this file to your profile directory

Editing Web Dispatcher Instance Profile

# Additional Steps ----------------------------------------------------------
wdisp/system_conflict_resolution = FIRST_MATCH
icm/HTTP/mod_0=PREFIX=/, FILE=$(DIR_PROFILE)/redirect.txt

# Web Assistant Back-end system configuration -------------------------------
# Added for Web Assistant SID= WA1/WA2 dummy sids

wdisp/system_0 = SID=WA1, EXTSRV=, SRCURL=/sap/dfa/help/, STANDARD_COOKIE_FILTER=OFF

wdisp/system_1 = SID=WA2, EXTSRV=, SRCURL=/resources/sap/dfa/help/, STANDARD_COOKIE_FILTER=OFF

NOTE: Make sure you use the same SID in web dispatcher parameters as the one used in redirect.txt file. Again this are dummy SIDs, you can use any but just sure to used the same SIDs everywhere. 


If you are using Web Dispatcher to load balance your back end system, make sure the value of x in the parameter wdisp/system_x should be higher than web assistant back-end system configuration. Always use 0 and 1 for web assistant back-end system configuration and any number after that can be used for your back-end configuration.

Also wdisp/system_conflict_resolution should be set as FIRST_MATCH

Restart Web Dispatcher.

Testing the Redirection

Check whether the redirection is working properly

1 – Test the redirection of the SAP content server

You can check whether the SAP content server is working properly



If you get above message that means configuration is fine and your web dispatcher is redirecting to SAP Content Server

2 – Test the redirection of the Web Assistant server


    "description":"This configuration registers the Xray bootstrap plug-in",
            "config": {
                "serviceLayerVersion": "UACP v1.1",
                "product": "SAP_S4HANA_CLOUD",
                "version": "1503 000"

If you get above message that means your web dispatcher is redirecting properly to Web Assistant Server.

Setting up SAP Fiori Catalog

To make the Web Assistant available in the SAP Fiori launchpad, set up the Web Assistant plugin.

Create Catalog

Create a catalog in SAP Fiori launchpad designer. SAP Fiori launchpad designer can be launched with the following URL:


Click on “Create Catalog” on the bottom left + icon

Navigate to “Target Mapping” and click on “Create Target Mapping”. We will be created mapping for Web Assistant Plugin

Field Label Value
Semantic Object Shell
Action plugin
Application Type SAPUI5 Fiori App
Title (not critical) In-Application Help Plugin
URL /resources/sap/dfa/help/utils/adapters/fiori
Information (not critical) In-Application Help plugin, relevant for all app users
Device Type




Name: product. Value: SAP_S4HANA_ON-PREMISE

Name: version. Value: 1909.000

To display the tiles of the SAP Fiori launchpad with consistent IDs, which will allow to assign hotspots to them, further configurations are required. In the catalog, create a target mapping with the following values:

Field Value Label
Semantic Object Shell
Action bootConfig
Application Type SAPUI5 Fiori App
Title (not critical) Enter a title
URL Leave this field empty.
ID Enter an ID, for example, Z_FLP_CONFIG.
Parameters Name: renderers/fiori2/componentData/config/enableHelp Value: true

After you have made these settings, we now create Fiori Role for this catalog and assign it to user

Create a Role



Description: Help for Plugin

Open Fiori Launchpad and you will see that “?” icon is now visible and when you click on it, below information will be provided.


All SAP Enable Now documents are available in SAP Help Portal

SAP Help Portal:

It is advisable to refer latest available “Web Assistant Integration” document whenever you are trying to configure the same in your system.


Quick Fact: SAP Enable Now was earlier known as SAP Workforce Performance Builder. 


Dennis Padia

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Priya Bharath Yadlapalli
      Priya Bharath Yadlapalli

      Hi Dennis,


      Why are there two SID's pointing to two different EXTSRV?

      Can't I configure this for just one SID?


      Author's profile photo Dennis Padia
      Dennis Padia
      Blog Post Author

      Hello Priya,

      As mentioned in the overview section of the blog, the contents are provided to users from below servers.

      Web Assistant Server - It provides the in-app help framework. The server gets a request to load the framework.
      Content Server - It provides the standard help content which has been created by SAP. The server gets a request to load content for a specific app and context

      Content Server is hosted on EXTSRV - and Web Assistant Server is hosted on EXTSRV - Also we cannot provide the same SID, as in redirect.txt file redirect URL logic is mentioned based on SID.


      Dennis Padia.

      Author's profile photo Priya Bharath Yadlapalli
      Priya Bharath Yadlapalli

      Yes, Dennis.

      I have realzied that later. I have gone thru the standard document and configured as such. But, still the "?" doesn't show up.

      I am on 1809fps02. What would the product version for this would be? is it going to be

      1809.000 or 1809.002?


      Best Regards,


      Author's profile photo Dennis Padia
      Dennis Padia
      Blog Post Author

      Hello Priya,

      Kindly refer to section " Set Up the User Assistance Plugin" in below installation guide of S/4HANA 1809 FPS 02.

      For 1809 FPS 02, product version should be 1809.002


      Dennis Padia.

      Author's profile photo diwakar vaish
      diwakar vaish

      Hi Bharath,

      were you able to fix the issue? Could you please share how was it fixed ?

      Author's profile photo Sarbjeet Singh
      Sarbjeet Singh

      Hi Dennis,


      Thanks for the useful information.

      we tried configuring the web assistant in our on premise system. We do not have SAP Enable now license. We just want to use it for the standard applications.  However, I am not able to see it giving all the options as you are showing in the screenshot.

      I only see one option as learning. Could you please let me know if there is any other configuration we are missing. Or we need to have enable now instance to see the content with markers even for standard apps.



      Sarbjeet Singh


      Author's profile photo Dennis Padia
      Dennis Padia
      Blog Post Author

      Hello Sarbjeet,

      In order to use web assistant for standard content scenario, you don't require SAP Enable Now license. It is available free for all.

      Above steps should help you to view web assistant for standard content if all the steps are configured correctly. Also kindly check your configuration in UI Technology Guide > 4.3 User Assistance Settings based on S/4HANA version (1909 link). Try to debug in chrome using developer too2ls (F1) and check under network which services are not getting loaded. 

      Make sure you web assistant backend configuration is configured with the initial numbers in wdisp/system_<x>, wdisp/system_<x+1>.


      Whereas maintain the redirect path of your S/4HANA message server in wdisp/system_<x+2>, after web assistant backend configuration. The reason of this sequence is important because we have maintained below parameters.

      wdisp/system_conflict_resolution = FIRST_MATCH


      Dennis Padia.

      Author's profile photo Sarbjeet Singh
      Sarbjeet Singh

      Thanks Dennis.

      Thanks for pointing to 1909 link. Apparently catalog creation is not needed in 1909. Settings in /UI2/FLP_CUS_CONF are enough. After maintaining those. It is working fine now. Thanks a lot.


      One more question is related to custom applications. So for custom application, do we need enable now for sure or is there any workaround to create some help content for that locally and then point it there.



      Author's profile photo Dyflex Generic
      Dyflex Generic

      Hi Dennis,


      We are also curious to know if there is a workaround for custom Fiori apps without having to purchase EnableNow licence.



      Author's profile photo Ranjith Rajan
      Ranjith Rajan

      Hello Dennis,


      Thank you for the blog. is it possible to set up the configuration from web dispatcher to cloud connector instead of a proxy? We do not have an internet connection for the Development system so we would like to connect via cloud connector.




      Author's profile photo Jocelyn Hayes
      Jocelyn Hayes

      Thank you so much for the post!  Can a SQL DB be used with Web Assistant, or does the DB need to be HANA?

      Author's profile photo Jesse Bernal
      Jesse Bernal

      Jocelyn Hayes  you can not use SQL you have to use HANA DB for Web Assistant

      Author's profile photo Mark Schroeder
      Mark Schroeder

      We are debating on-prem vs cloud based Enable Now Manager. At this point the only planned usage of Enable Now will be for S4HANA with a Fiori Interface. In the future SAP Concur. IS there any significant differences to the web assistant experience I need to consider between Manager being onprem vs cloud? The S4HAna ERP install will be on-prem for critical operation reasons. We will be using both SAP authored content as well as customized content in our plan.


      Thank you.

      Author's profile photo Dyflex Generic
      Dyflex Generic

      For custom Fiori apps on premise is it mandatory to have EnableNow or there is a workaround?

      Author's profile photo Kristina Kunad
      Kristina Kunad


      SAP Enable Now is not mandatory, though of course recommended.

      Take care,


      Author's profile photo Jeroen Vanattenhoven
      Jeroen Vanattenhoven

      This is not what I understood from this blogpost.

      So, we can add such in-application help, to Fiori Apps we have created ourselves (via Fiori Elements or SAPUI5) without SAP Enable Now?

      Author's profile photo Kristina Kunad
      Kristina Kunad

      Hi Jeroen,

      you need SAP Enable Now to create and edit content. But I understood the question of Dyflex Generic as "do I need SAP Enable Now if I have a custom Fiori app", and to that the answer is no.

      I think it is misleading a bit, sorry.



      Author's profile photo Nikhil Kulkarni
      Nikhil Kulkarni

      Hi Dennis,

      Really nice blog for configuring SAP Enable now.

      Just wanted to check with you if we are planning to install SAP Enable now on-premise and wants to connect with SAP S/4HANA on-premise system, can we follow the similar steps ?

      Thanks you !!!

      Author's profile photo Kristina Kunad
      Kristina Kunad

      Hi Nikhil,

      as long as you use a HANA DB for SAP Enable Now on-premise you can follow the guide, yes.

      Take Care,


      Author's profile photo R. Vriens
      R. Vriens

      Hi there, great blog, very detailed!

      As long as you seem to know what you are talking about 🙂 Is a customer able to run the Web Assistant without any connection to the outside world? In other words, can we configure an on-site Web Assistant with on-site content, for example by means of export from SAP and import into our own Web Assistant. We are licensing SAP Enable Now at this moment, but we want to make sure we can use the advantages of all scenario's without having a connection to the outside world.

      No internet connection available!

      Regards, Rik

      Author's profile photo Dirk Manuel
      Dirk Manuel

      Yes, see Anton Mavrin's excellent post here:

      Author's profile photo R. Vriens
      R. Vriens

      Thanks for the answer, found the blog, thanks again.

      Author's profile photo Beatrix Biegler
      Beatrix Biegler

      dear all,


      we have a issue with sap companion on s4 hana on prem. Companion does not view help tiles to user in fiori shell. Is this discription up to date or is there a newer version available?




      Author's profile photo Bart Rhoten
      Bart Rhoten

      Hello, the latest information for SAP Enable Now and SAP Companion is always here:  . Click the Integrate tab, then click SAP Companion Integration Guide. The guide is no longer a PDF, but is a specific page within the website. See the Setup of SAP Companion for SAP S/4HANA On-Premise section.

      Hope this helps!

      Author's profile photo Wolfgang Mayer
      Wolfgang Mayer

      Dear Dennis,

      do these instructions apply to a "hub deployment" with a "Fiori Frontend Server 6.0" and a SAP ECC 6.0  EhP8 backend server as well?

      Thanks & regards