Step-by-step guide to integrate your Joule Web Client plugin in Fiori Launchpad of S/4HANA PCE

[sukai_tian]

This blog post aims to provide a detailed and comprehensive description of the steps involved in integrating your Joule Web Client plugin into the Fiori Launchpad of SAP S/4HANA Cloud Private Edition. Sometime the default sap_digital_assistant is already existing, you can follow below steps to create your own digital assistant, configure it in fiori lauchpad without changing the default digital assistant.

More useful information could be also found in SAP help - Integration with SAP S/4HANA Cloud Private Edition.

Firstly we will create a standalone joule web client, then integrate this joule web client into S/4HANA private fiori launchpad.

The detail steps are as below:

Step 1: Create a joule standalone application

You can create a standalone joule application below joule helloworld example tutorials:

https://github.tools.sap/DAS-Samples/joule-functions-example/blob/main/tutorials/helloworld/index.md .

After above tutorial, you should be able to launch a standalone joule web client. Please note down this standalone joule web client URL, it will be used later.

For example: https://<BTP_URL>.sapdas.cloud.sap/webclient/standalone/sk_helloworld 

(Digital assistant name is sk_helloworld)

Step 2: create a catalog and maintain target mapping In S/4HANA private cloud system

• Open Fiori launchpad designer via transaction ‘/UI2/FLPD_CUST’
• Click ‘＋’ to create a new catalog

• Create two target mappings with below new entries

First entry:

Semantic Object	Shell
Action	plugin
Application Type	SAPUI5 Fiori App
Title	TS Joule Sample
URL	<subscription_path>/resources/public/webclient/s4
ID	sap.das.webclientplugin.s4

Second Entry:

Semantic Object	DASBot
Action	sk_helloworld <your digital assistant name>
Application Type	SAPUI5 Fiori App
Title	TS Joule Sample
URL	<subscription_path>/resources/public/webclient/s4
ID	sap.das.webclientplugin.s4

• Save this fiori launchpad catalog.

Step 3: Create a role via transaction 'PFCG' in S/4HANA private cloud system

• Open transaction PFCG
• Enter role name and click ‘Single Role’  button

• In Menu tab, add catalog collection based on previous step

•  Navigation to user tab, and add your user id. And save this new role.

Step 4: Open S/4HANA Fiori launchpad UI and Check.
The joule icon is visible.

In the joule setting, you can change assistant to your created digital assitant.

Congratulations!!! Your Joule is integrated in SAP S/4HANA Cloud Private Edition!