Technical Articles
Integration: Launch native SAP GUI for Windows Applications in the Cloud with SAP Business Client
SAP Business Client has a great talent for integration. First, single apps have been integrated. Second, the Fiori Launchpad as a whole (FLP@ABAP). Now, the “cloud launchpad”, called SAP Build Work Zone, standard edition and SAP Build Work Zone advanced edition fka SAP Fiori Launchpad Service, running on Business Technology Platform (BTP, cloud foundry) are integrated.
So even in the cloud you can mix native SAP GUI transactions with state-of-the-art web applications. Therefore, a TCP ping to the remote system has to be performed at the time the application shall be started.
The following blog describes how to run a cloud launchpad within SAP Business Client in 3 steps.
But first,
What is SAP Build Work Zone, standard and advanced edition?
SAP Build Work Zone, standard edition¹ fka SAP Launchpad Service and SAP Build Work Zone advanced edition² fka SAP Work Zone enables organizations to establish a central point of access to SAP, custom-built, and third-party applications, and extensions, both on the cloud and on premise.
With SAP Build Work Zone you can only use Web GUI however. SAP GUI for Windows cannot be launched.
Using the SAP Build Work Zone with SAP Business Client native SAP GUI for Windows applications can be launched from your connected on-premise system.
¹integrated into SAP Business Client with version 7.70
²Integrated into SAP Business Client with version 8.00
Integration Prerequisites
SAP Business Client 7.70 to integrate SAP Build Work Zone, standard edition: SAP ONE Support Launchpad (SAP Software Download Center)
SAP Business Client 8.00 to integrate SAP Build Work Zone advanced edition: SAP Software Download Center
At least a trial account on BTP. See Get a Free Account on SAP BTP Trial | Tutorials for SAP Developers
For SAP Build Work Zone, advanced edition you need the full version. Check the following blog by Nagesh to get started:
Subscription to SAP Build Work Zone, standard edition including the Launchpad_Admin role (see the following tutorial Deliver Your First SAP Fiori Launchpad Site | Tutorials for SAP Developers)
SAP Build Work Zone, standard edition on BTP: Initial Setup
Direct Access and Tunneled Access
Direct access is only possible within the corporate network (or via VPN).
Tunneled Access is possible from the corporate network or from the Internet (for which you need the Cloud Connector). The Cloud Connector is http/https based. The DIAG protocol of SAP GUI for Windows cannot be used. We are therefore using direct access here.
Procedure
The following steps will show you how to launch SAP GUI for Windows applications (Dynpros) directly from the FLP@BTP. As an example, we ‘d like to create an app/tile in SAP Build Work Zone, standard edition (FLP@BTP) to open an SAP GUI for Windows transaction from a remote system (here U1Y*). To connect, you must create a http destination to this system (step 1 below).
Note: In general, there are two ways of integrating content into SAP Build Work Zone, standard edition: Manual Integration of Business Content, and integration of content from remote content providers. In this blog, we demonstrate the manual integration of apps. Administrators who need to integrate hundreds of roles will use the federation approach, described at the end of this blog.
Step 1: Create runtime destinations to access apps
To launch apps in SAP Build Work Zone, standard edition, the service must know where the content/apps are located. It is therefore necessary to create a destination to tell the BTP where your app is running.
Logon
- Logon to the BTP cockpit and open the Destination editor (subaccount=>Overview=> Connectivity=>Destinations)
- Choose New Destination and enter the name, type, description (optional), and URL as shown in the screenshot below. You can copy the URL from the landscape file or directly from Business Client (system selector, right click). It must start with https:// including the port, for example https://<server>.<domain>.<ext>:<port>.
Configure destination and add additional properties
Add the additional properties as shown in the screenshot below:
For example sap-login-group, message server and instance number, sap-snc-name, can be found in SAP Logon.
Configuring the destination to your back-end
Add additional parameters to your destination configuration
The editor is a little unpredictable, but I am optimistic that this will improve over time.
Link to documentation: Create Runtime Destinations to Access Apps
Step 2: Make your Apps visible in the Launchpad
In this step you will:
- Open the site manager
- Create and configure your app.
- Create a group and assign your app to it
- Create a catalog and assign your app to it
- Create a role and assign your app to it
- Assign your role to your app
Open the Site Manager
Open your Site Manager in your BTP cockpit or directly via the FLP Menu (upper right corner => your profile=> Manage Site)
Open Site Manager
Site Manager
Create and Configure your App
In the Site Manager, choose +New to create your app (in this example an SAP GUI for Windows transaction, SE80).
Add a new App
Select your system and fill in the properties as documented here Configure Apps for Your Subaccount.
System:
The system names in the list reflect the destinations defined in the SAP BTP cockpit. Choose your destination.
Choose your system
Choose your App UI Technology
You have to choose SAP GUI for HTML (as described in the documentation!) Configure Apps for Your Subaccount.
Switch to the tab Navigation tab and configure you intend based navigation.
Configuring intend based navigation
In this example, no additional parameters are needed.
Choose Save.
See: Configure Apps for you Subaccount (Help Portal Documentation)
Create a group and assign your app to it
Assign apps to a group
Choose Save.
Create a catalog and assign your app to it
Assign an app to a catalog
Choose Save.
Create a role and assign your app to it
Assign an app to a role
Choose Save.
Assign your role to your site
Go to your site manager and click Site Settings.
Site Manager in the BTP Cockpit
Choose Edit and assign your role to the site.
Choose Save.
Assign your role to the launchpad site
Note: In the BTP Cockpit, you have to assign this role to your BTP user.
To assign the role to your BTP user, you have to go back to the cockpit. Under Security, choose Users. Enter your e-mail address and assign the role to your user.
Assign the created role to your BTP user
Check if your site is working
Go back to the Site Manager and click on “Go to site”.
Site directory
Step 3: Configure your system connection within SAP Business Client
As an administrator, you can provide templates for your end users. See the following documentation for details: SAP Build Work Zone, standard edition Intregration – SAP Help Portal
For our example here, just copy the URL from your site into the Business Client system connection properties, as shown in the screenshot below.
Modify System Entry
Integration of content from remote content providers (Content Federation)
As you can imagine, manual integration of content is not the best approach for integrating large amounts of applications from your SAP Business Suite system to your SAP Build Work Zone, standard edition on BTP. Using the content federation administrators can expose the content and make business roles with their apps, catalogs, and groups available straight away.
Exposure of the content is done at role level. In an SAP Business Suite system or S/4HANA system, use transaction /UI2/CDM3_EXP_SCOPE to expose your SAP Fiori content.
For a detailed description of how to enhance your launchpad site with federated SAP S/4HANA content, see the following tutorials by Dr. Sibylle Brehm:
Enhance Your SAP Launchpad Site with Federated SAP S/4HANA Content | Tutorials for SAP Developers
You can find the official documentation here:
Federation of Remote Content Providers – SAP Help Portal
You can open your Launchpad Designer to check your catalogs, groups and tiles:
Running the Launchpad Designer – SAP Help Portal
Tip: Once connected to your on-premise back end, you can open the Launchpad Designer directly within SAP Business Client using transaction SPRO=>IMG (F5)
See also:
As a longtime fan of the Business Client, I think this is great news. It's always been an excellent option for combining web based and SAPGUI based applications without making compromises. And now the Launchpad service on BTP is supported as well. Even better!
Dear Sandra,
thank you for this detailed Blog and the follow up after the DSAG session. As Cloud Connector does also Support WebSockets and even TCP Connections wouldn't be there a future option to use this to enable SAP GUI for Windows to tunnel through the Backend? For RFC there is already WebSocket Support: WebSocket RFC – RFC For the Internet.
Best Regards
Gregor
Hi Sandra.
thanks for the blog.
I follow up on the steps but when I finally open the launchpad service in the NWBC any page is displayed.
I also try to create the tile as SAP GUI to input the tx code se80
then the tile tries to open the SAP GUI window, and a pop-up is displayed to input the user and password but then I get the following message
Logon Balancing error 85
to open se80 tx code with SAP GUI for windows what do I need to indicate in the tile? in the step "Create and Configure your App " you do not point to any TX code or specific URL.
then how does it work?
kind regards.
Hi David Martin Gutierrez Cruz,
To really solve your issue you should open a support ticket on the component BC-FES-BUS-DSK. Describe your system configuration and don't forget to attach the traces.
Regarding the app configuration:
There is a link in the blog above where you find all the information you need, but unfortunately without screenshots.
Adding a new App in the BTP Cockpit Website-Content-Manager you can enter your TX code, e.g. SE80, see the following screenshot:
What's also important for the system configuration within SAP Business Client you can see here in the help portal documentation SAP Launchpad Service Integration (with screenshots).
Please give the documentation a try. If it does not work, please open a ticket.
Kind Regards,
Sandra
Thank you very much for the blog.
Hi Sandra,
I attempted this and can say that this works perfectly well. This fits our use case of using the sap build workzone launchpad in SAP business client so that we can access the SAP gui for windows.
However, I wanted to mention about one issue and get your thoughts before I create a support ticket.
On my build workzone launchpad, I have a tile to launch an ECC system. I'm calling Transaction SMEN for that. And that works fine. However, I've noticed that when I do this, I am losing the ability of the command field where I enter a transaction code.
Here is a screenshot of ECC opened in business client from a build work zone launchpad.
And here is a screenshot of ECC opened directly in business client from the desktop.
You see the search field/ command field are different.
Any thoughts on how I could get the same command field (from 3rd screenshot) from business client when I open ECC, in business client from a build work zone launchpad.
Thank you
Julius
Hi Julius,
Great!
Once the connection to the backend is established* you can enter your transaction code as usual!
Even though the description text is different: Enter transaction code or command (System Connection type SAP Logon) vs. Enter search term or URL (Work Zone Connection).
*You have to be sure. Check this: menu settings=>appearance=>interaction design=>show system information in status bar
If it doesn't work for you we need the traces for further investigation.
support ticket component: BC-FES-BUS-DSK
Regards,
Sandra
Hi Sandra,
I appreciate your prompt response. I have checked the menu settings that you mentioned and it is set.
However, when I try to enter a transaction code, va01 in my example, its not opening the t. code but doing a desktop search.
And when I press the Enter key after entering va01, this is what opens. i.e. it is trying to search my computer with keyword va01.
I looked at the settings under Menu option connections --> Search providers and I see that its set there to do a desktop search
Where as in the case where I open an sap system from business client desktop directly, there are no search providers.
However, even if I deselect the desktop search as the provider in the case of launchpad withing business client, then it does not perform the desktop search for va01 but it doesn't open the t code va01 either.
Any other thoughts? I am opening a ticket anyway. What trace level should I choose?
Thank you
Julius
Hi Julius,
a not activated Web Service in the backend might cause the issue - I am just guessing. So we have to check.
Chosse trace level "verbose with http logs".
Send me the ticket number.
Regards,
Sandra
Thank you Sandra. My case id is 505253 / 2023.
Thanks.
Julius
Hi Julius, we are going to put the ticket on development today. I am sure they'll find a solution pretty soon. Regards, Sandra
Hi Sandra,
Thank you for the update. Yes development sent me some steps, but that hasn't resolved the issue. I have sent the ticket back to SAP dev.
On a side note, I have 2 more questions, not related to the issue.
Thank you
Julius
Dear Julius,
re 1: SSO via SNC (SAP Secure Login Service for SAP GUI) is SAPs recommanded solution
re 2: Your vote might help: Improvement Request Details - Customer Influence (sap.com)
Kind regards,
Sandra