什么是 sap.ushell.Container-阿里云开发者社区

什么是 sap.ushell.Container

2023-10-02 49

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 什么是 sap.ushell.Container

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>

最后的运行时效果：

这个例子的完整源代码，参考笔者的这篇教程：

SAP UI5 应用开发教程之五十四 - 如何将本地 SAP UI5 应用配置到本地 Fiori Launchpad 中

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