Skip to main content
Version: 1.x

Function: navigateToApp()

navigateToApp(page, appId, options?): Promise<void>

Defined in: src/modules/navigation.ts:142

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?

NavigationOptions

Navigation options.

Returns

Promise<void>

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');