526互联

什么是 sap.ushell.Container

发布时间 2023-03-24 23:31:53作者: JerryWang_汪子熙

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 访问中央实例。