Function: navigateToApp()
navigateToApp(
page,appId,options?):Promise<void>
Ai
Navigates to a SAP app by semantic object hash.
Parameters
page
NavigationPage
Playwright Page (or compatible subset).
appId
string
Semantic object hash (e.g., 'PurchaseOrder-manage').
options?
Navigation options.
Returns
Promise<void>
Capability
ui5Navigation.navigateToApp
Intent
Navigate to a specific SAP Fiori app using its semantic object hash. Use when the AI agent needs to open a particular app from the FLP.
Guarantee
On success, the FLP hash is set to the given appId and UI5 is stable.
Prerequisite
The page must be on the SAP Fiori Launchpad (FLP).
Ai Context
Commonly used as the first step after authentication to reach the target app.
Sap Module
sap.ushell.Container — FLP shell navigation via hasher.setHash()
Business Context
SAP Fiori Launchpad cross-app navigation using semantic objects.
Throws
NavigationError if appId is empty.
Example
await navigateToApp(page, 'PurchaseOrder-manage');