Class /PCH/CL_OBJ_URL_HANDLER

The handler allows a URL to be launched. The URL is delegated to the frontend for execution, which decides how to handle the URL. For http(s) URLs in the browser, single sign-on and SAP Fiori parameter enrichment are supported. This makes it possible to launch SAP Fiori apps using static application paths, but also external URL.

Parameter	Description

Parameter	Description
PROTOCOL	Scheme / Protocol if empty/undefined, https is used primarily
HOST	Host name if empty/undefined Host of the SAP Application Server
PORT	Port number if empty/undefined Port number of the SAP Application Server for HTTPS or HTTP
PATH	Address path (without protocol, host and port, starting with /). Supports the use of further standard parameters by using placeholders <ParameterName> (e.g. <OBJECT_KEY>). The path must be URL-encoded - except for the placeholders.
ADD_LP_PARAMETERS	Adds the Fiori Launchpad parameter for the client and language to the URL
USE_SSO	Starts the URL using single sing-on, so no re-authentication is required. SSO is only supported with Internet Explorer

The built URL must conform to the correct syntax for a URL, otherwise execution will be rejected by the system. In particular, the path must be specified correctly URL-encoded. The only exception are the parameters, which must not be URL-encoded, since these are replaced at runtime.

URL handling depends on the frontend (SAP GUI, operating system, device, and installed programs), so URLs may be handled differently on different frontends. In particular, the handling of file URLs is rejected on common browsers for security reasons.
Accordingly, it is the responsibility of system support to use only URLs that work on the frontends used (e.g. https on common devices).

Examples:

Navigating to an application in the Fiori Launchpad on the current system with SingleSignOn.

Parameter	Value

Parameter	Value
PROTOCOL	<empty> or https
PATH	/sap/bc/ui2/flp#Material-manage&//C_Product(Product='<OBJECT_KEY>',DraftUUID=guid'00000000-0000-0000-0000-000000000000',IsActiveEntity=true)
ADD_LP_PARAMETERS	X
USE_SSO	X

Navigation to a web page with the object key

Parameter	Value

Parameter	Value
PROTOCOL	<empty> or https
HOST	http://www.duckduckgo.com
PATH	/?q=<OBJECT_KEY>&ia=web

Navigation to a file in a shared directory

Parameter	Value

Parameter	Value
PROTOCOL	file
HOST	fileserver (unc-server-name ohne)
PATH	/daten/Produkte/Product%20Sheets\<OBJECT_KEY>\ProductSheet.pdf

Open a chat with multiple participants and the object key as topic

Parameter	Value

Parameter	Value
PROTOCOL	msteams
HOST	teams.microsoft.com
PATH	/l/chat/0/0?users=name1@domain.tld,name2@domain.tld&topicName=<OBJECT_KEY>