用途:指导 SAP Fiori Elements 应用中的导航配置与实现,包括应用内路由和跨应用跳转。
主要能力:
- 标准 List Report → Object Page 导航:在 manifest.json 中定义两个 target 并正确注解 UI.LineItem 后自动生效,无需自定义代码。路由 pattern 中的关键参数须与实体键匹配,如 "Orders({key}):?query:";复合键写作 "Orders(ID={ID},IsActiveEntity={IsActiveEntity}):?query:"。
- 子对象页(嵌套导航):为子实体定义形如 "Orders({key})/items({key2}):?query:" 的路由,并在 target 的 settings.navigation 中指定 detail.route。
- Flexible Column Layout:在 sap.ui5.routing.config.flexibleColumnLayout 中设置 defaultTwoColumnLayoutType 与 defaultThreeColumnLayoutType,并在导航参数中指定 layout。
- 基于意图的跨应用导航:通过 Common.SemanticObject 与 Common.SemanticObjectMapping 注解字段,目标应用需在 Launchpad 注册匹配的语义对象与动作。
- 控制器扩展中编程导航:应用内用 getRouting().navigateToRoute;跨应用用 CrossApplicationNavigation 服务的 toExternal。
- Launchpad target mapping 与 manifest.json 的 sap.app.crossNavigation.inbounds 需语义对象与动作一致。
常见错误:跨应用硬编码 URL、草稿实体路由缺少 IsActiveEntity、在 shell 内使用 window.location.href、深链缺少父路由、忘记注册 inbound 意图。
限制:资料未提供具体版本要求、依赖安装方式或收费信息。