- SAP Managed Tags:
You may preform these steps either on a Web Dispatcher or any application server using ICM as web dispatcher.
Download the required TLS certificate “Verizon Public SureServer CA G14-SHA2” from the internet.
In any Web Browser open the web dispatcher’s admin page
(
You’ll find the right address in the Web Dispatcher’s profile as parameter
Open PSE Management of “SSL and Trust Configuration”
Change “Manage PSE” to Client pse (normally
Click on “Import Certificate”:
Open the TLS certificate in any text editor, copy all lines
(including
and put it into the textfield:
Click on "import" to store the new certificate into
In the list of available certificates within the SSL Client, you shall now find the newly imported Verizon certificate:
Verify the imported certificate is valid (“Not after” – line).
Open the instance profile of your Web Dispatcher using any text editor and add the following two lines to it:
Add, if not exists, the following line to your profile:
Replace the “*” after
Save your new profile and close it.
If not exists, create a new filter_rules.txt file in your profile directory (or any directory specified within the
Add the following lines to the filter_rules.txt:
You’ll now need to restart your Web Dispatcher. For a standalone Web Dispatcher use sapcontrol, for any application server, use the tool supported (eq. SMICM).
If everything is setup correctly, you should be able to call the following URL using your web browser, where FQDN and Port are specified by your Web Dispatcher:
As a result, you should get a JSON string like:
Respectively calling the SAP Cloud XRay using:
The result will be a JSON string bit longer than the upper one, but starts with:
…
Open the following URL in your web browser:
Where <FQDN>, <Port> and <Client> reflect your SAP NetWeaver Gateway.
Login with a user, that has administrative rights on the SAP NetWeaver Gateway.
At the bottom of the customizing page, you’ll find a big “+”. Click on it to create a new catalog:
Use a name, that you may remember. You’ll need it later to create a role for the plugin:
Click on “Target Mapping” in the middle of the window and then on “Create Target Mapping”:
Use the parameters from the table so that the target mapping looks like the following screenshots:
Note, that the parameter “editor” should be switched to “false” in productive environments.
Start your SAP GUI and open transaction
Save your role.
Switch to “Menu” tab and switch “Transaction” to “SAP Fiori Tile Catalog”:
Assign your newly created catalog to the role, including applications:
Add your users to this role and have them check this new functionality.
Prerequisites
Download the required TLS certificate “Verizon Public SureServer CA G14-SHA2” from the internet.
Installation Steps
TLS/SSL Certificate
In any Web Browser open the web dispatcher’s admin page
(
http(s)://<FQDN>:<Port>/sap/wdisp/admin or http(s)://<FQDN>:<Port>/sap/admin)You’ll find the right address in the Web Dispatcher’s profile as parameter
icm/HTTP/admin_0.Open PSE Management of “SSL and Trust Configuration”
Change “Manage PSE” to Client pse (normally
SAPSSLC.pse respectivly "SSL client SSL Client (Standard) in case of an AS ABAP):Click on “Import Certificate”:
Open the TLS certificate in any text editor, copy all lines
(including
-----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----)and put it into the textfield:
Click on "import" to store the new certificate into
SAPSSLC.pse (or the according PSE of your SSL Client (Standard).In the list of available certificates within the SSL Client, you shall now find the newly imported Verizon certificate:
Verify the imported certificate is valid (“Not after” – line).
Profile Preparation
Open the instance profile of your Web Dispatcher using any text editor and add the following two lines to it:
wdisp/system_* = SID=HAC, EXTSRV=https://cp.hana.ondemand.com, SRCURL=/sap/dfa/help/,SRCSRV=*:*,STANDARD_COOKIE_FILTER=OFFwdisp/system_* = SID=HAX, EXTSRV=https://xray.hana.ondemand.com, SRCURL=/resources/sap/dfa/help/,SRCSRV=*:*,STANDARD_COOKIE_FILTER=OFFAdd, if not exists, the following line to your profile:
icm/HTTP/mod_* = PREFIX=/, FILE=$(DIR_DATA)$(DIR_SEP)filter_rules.txtReplace the “*” after
wdisp/system_ and icm/HTTP/mod_ by the next upper unused number.Save your new profile and close it.
Add Redirect Rules
If not exists, create a new filter_rules.txt file in your profile directory (or any directory specified within the
icm/HTTP/mod_* parameter).Add the following lines to the filter_rules.txt:
if %{SID} = CP1
begin
SetHeader HOST cp.hana.ondemand.com
RegRewriteRawUrl ^/sap/dfa/help/(.*) /dps/$1
endif %{SID} = CP2
begin
SetHeader HOST xray.hana.ondemand.com
RegRewriteRawUrl ^/resources/sap/dfa/help/(.*)/xRayControls/resources/sap/dfa/help/$1
endRestart
You’ll now need to restart your Web Dispatcher. For a standalone Web Dispatcher use sapcontrol, for any application server, use the tool supported (eq. SMICM).
Check Redirect
If everything is setup correctly, you should be able to call the following URL using your web browser, where FQDN and Port are specified by your Web Dispatcher:
http(s)://<FQDN>:<Port>/sap/dfa/help/odata.svc/?$format=jsonAs a result, you should get a JSON string like:
{"d":{"EntitySets":["DeliverableForReplication","TransportHistory","Product","Context","TourIssue","Hotspot","Project","Tile","Deliverable","Transport","ReplicationTourIssue"]}}Respectively calling the SAP Cloud XRay using:
http(s)://<FQDN>:<Port>/resources/sap/dfa/help/sap/cfg/XrayBootstrapHelpConfig.jsonThe result will be a JSON string bit longer than the upper one, but starts with:
{
"description":"This configuration registers the Xray bootstrap plug-in",
"modulePaths":{
"sap.dfa.help":"/resources/sap/dfa/help/~201601071332~"
},…
Configure Context-sensitive Help Plugin
Open the following URL in your web browser:
http(s)://<FQDN>:<Port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-client=<Client>Where <FQDN>, <Port> and <Client> reflect your SAP NetWeaver Gateway.
Login with a user, that has administrative rights on the SAP NetWeaver Gateway.
At the bottom of the customizing page, you’ll find a big “+”. Click on it to create a new catalog:
Use a name, that you may remember. You’ll need it later to create a role for the plugin:
Click on “Target Mapping” in the middle of the window and then on “Create Target Mapping”:
| Semantic Object | Shell |
| Action | plugin |
| Application Type | SAPUI5 Fiori App |
| Title (optional) | Help4 Plugin - End User View - Relevant for all Users |
| URL | /resources/sap/dfa/help/utils/adapters/fiori/ |
| ID | sap.dfa.help.utils.adapters.fiori |
| Information (optional) | Help4 Plugin - End User View - Relevant for all Users. |
| Device Types | Check all, maybe skip Phone |
| Parameters | product => SAP_S4HANA_ON-PREMISE version => 1511 001 editor => true (for testing & content assignment) false (in productive system) |
Use the parameters from the table so that the target mapping looks like the following screenshots:
Note, that the parameter “editor” should be switched to “false” in productive environments.
Create Role for context-sensitive help
Start your SAP GUI and open transaction
PFCG. Create a new single role and name it according your role concept:Save your role.
Switch to “Menu” tab and switch “Transaction” to “SAP Fiori Tile Catalog”:
Assign your newly created catalog to the role, including applications:
Add your users to this role and have them check this new functionality.
11 Comments
