sap.ushell.Container 是一个 SAP Fiori Launchpad 的 JavaScript API,它提供了访问 Launchpad 功能和服务的方法和属性。Container 对象由 SAP Fiori Launchpad 创建并提供给运行在 Fiori Launchpad 中的应用程序。在应用程序中,可以使用 Container 对象访问 Fiori Launchpad 中的服务和功能。
sap.ushell.Container 提供了一系列方法和属性,用于与 Fiori Launchpad 进行交互,例如:
- getService:获取指定名称的服务实例。
- getRenderer:获取 Fiori Launchpad 的渲染器。
- getShellConfig:获取 Fiori Launchpad 的配置。
- setDirtyFlag:标记 Fiori Launchpad 数据已更改。
- setHeaderTitle:设置 Fiori Launchpad 的页头标题。
这些方法和属性使应用程序可以与 Fiori Launchpad 进行集成和交互,从而实现与其他 Fiori 应用程序的协作和共享数据等功能。
总之,sap.ushell.Container 是一个 JavaScript API,它提供了访问 SAP Fiori Launchpad 功能和服务的方法和属性,使应用程序能够与 Fiori Launchpad 进行集成和交互。
一个实际例子:
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>如何将本地 SAP UI5 应用配置到本地 Fiori Launchpad 中</title>
<script>
window["sap-ushell-config"] = {
defaultRenderer: "fiori2",
applications: {
"barcode-scan": {
title: "App 1",
description: "应用程序1",
additionalInformation: "SAPUI5.Component=sap.ui5.walkthrough.app1",
applicationType : "URL",
navigationMode: "embedded"
}
}
};
</script>
<script src="https://sapui5.hana.ondemand.com/test-resources/sap/ushell/bootstrap/sandbox.js"></script>
<script src="https://sapui5.hana.ondemand.com/resources/sap-ui-core.js"
data-sap-ui-libs="sap.m, sap.ushell, sap.collaboration, sap.ui.layout" data-sap-ui-compatVersion="edge"
data-sap-ui-theme="sap_fiori_3"
data-sap-ui-resourceroots='{
"sap.ui5.walkthrough": "./"
}'
data-sap-ui-frameOptions="allow"></script>
<script>
sap.ui.getCore().attachInit(() => sap.ushell.Container.createRenderer().placeAt("content"))
</script>
</head>
<body class="sapUiBody" id="content"></body>
</html>
最后的运行时效果:
这个例子的完整源代码,参考笔者的这篇教程:
service 的配置方法:
window["sap-ushell-config"] = {
services: {
Foo: {
module: "my.own.Foo"
config: {header: "hidden"},
adapter: {
module: "my.own.FooAdapter",
config: {foo: "bar"}
}
}
}
}
sap.ushell.Container.getServiceAsync("Foo", "runtimeConfig")
.then(function (Foo) {
// Do something with the service
});
注意:sap.ushell.Container 是 Unified Shell 的容器,用于管理渲染器、服务和适配器。 该容器被设计为单例。 请不要创建实例,而是通过命名空间 sap.ushell.Container 访问中央实例。
网友评论