SAP Cloud SDK for JavaScript 概述

Jerry Wang

发布于 2021-07-21 12:04:19

7180

发布于 2021-07-21 12:04:19

TypeScript 和 JavaScript 开发人员，这是为您准备的：SAP Cloud SDK (fka SAP S/4HANA Cloud SDK) 现在可用于 JavaScript。今天，我们很自豪地发布了适用于 JavaScript 的 SAP Cloud SDK 1.0.0 版。这是继去年 10 月开始的测试版之后，第一个通用的、高效的 JavaScript 库版本。

与适用于 Java 的 SDK 类似，适用于 JavaScript 的 SAP Cloud SDK 使在 SAP Cloud Platform 上将 SAP S/4HANA 的扩展开发为应用程序变得轻松愉快。适用于 JavaScript 的 SAP Cloud SDK 可帮助您将 SAP S/4HANA 集成到使用 TypeScript 或 JavaScript 编写并在 Node.js 中运行的云原生应用程序中。您可以在本地执行这些应用程序，也可以将它们部署到 SAP Cloud Platform、Cloud Foundry。

Easy access to SAP S/4HANA Cloud APIs

访问 SAP S/4HANA Cloud 可以像下面一样简单——没有样板、低级代码，只有业务逻辑：

import { BusinessPartner } from '@sap/cloud-sdk-vdm-business-partner-service';

BusinessPartner.requestBuilder()
    .getAll()
    .select(BusinessPartner.LAST_NAME)
    .filter(BusinessPartner.FIRST_NAME.equals("John"))
    .execute({destinationName: "S4HANACloud"})
    .then(businessPartners => {
        // process result of type BusinessPartner[]
    }).catch(reason => {
        // handle error
    });

这是通过 OData 虚拟数据模型（VDM，也称为 Java SDK）实现的。适用于 JavaScript 的 SDK 的 OData VDM 提供 SAP S/4HANA Cloud 的 OData API 的 TypeScript/JavaScript 表示，包括 SAP API Business Hub 上列出的所有服务、操作和实体类型。与上面的代码片段类似，您不仅可以访问读取操作，还可以访问写入操作（尚不支持 function import）。

Straightforward integration of SAP Cloud Platform

上面的代码片段还说明了与 SAP Cloud Platform 上的 destination service 的开箱即用集成，用于管理目标系统或目标和身份验证凭据。如果您第一眼看不到它，请不要担心 - 由于直接集成，很容易错过：在 OData VDM 请求上调用 execute 时，您传递目标的名称，在本例中为 S4HANACloud。就是这样，SDK 将负责解析 SAP Cloud Platform 上目标服务中定义的目标并执行所需的身份验证。

如果您愿意，也可以手动定义目的地。此外，在本地运行或测试期间，可以很容易地用简单的环境变量替换目标服务。

TypeScript or JavaScript?

上面的示例使用 TypeScript，这是 JavaScript 的类型化超集。但是，如果您只熟悉 JavaScript，您甚至可能没有注意到。事实上，上面的代码也是完全有效的 JavaScript。 SAP Cloud SDK for JavaScript 已在 TypeScript 中实现，并且可以在 JavaScript 和 TypeScript 项目中使用。JavaScript 和 TypeScript 开发人员都可以使用相同的库并获得相同的功能，并且在提供相应支持的编辑器的情况下，两者都将受益于 TypeScript 启用的代码完成功能。 TypeScript 项目当然会受益于额外的类型安全。

我们只能鼓励每个人检查 TypeScript 是否适合他的需求。如果你不想使用 TypeScript，坚持使用纯 JavaScript 并在 JavaScript 中使用 SDK 仍然是完全可以的。

Continuous delivery pipeline

持续交付工具包是 SAP Cloud SDK 的核心组件，因为它使项目能够持续交付其应用程序，而无需额外的工作来设置持续交付管道。我们很高兴从一开始就能够为 JavaScript 项目提供这种开箱即用的持续交付管道。

为此，我们提供了两个项目脚手架，一个用于 TypeScript，一个用于 JavaScript 项目。它们开箱即用，包括在 Jenkins 服务器上运行持续交付管道所需的一切。您不必编写一行管道代码即可从管道中编纂的最佳实践中受益，只需将其配置到您的项目环境中即可。有关受支持内容的更多详细信息，请查看持续交付工具包 v17 版本的发布公告。

How to Access the JavaScript Libraries

SAP Cloud SDK 的 JavaScript 库可从 SAP 的 npm 注册表免费访问。 SAP 注册表的工作方式类似于用于解析 JavaScript 模块的标准 npmjs 注册表。它托管范围为@sap 的包。为了能够检索 SDK 模块（所有这些模块都随作用域 @sap 提供），您只需执行以下命令：