SAP ERP

借助 SAP ERP 连接器，您可以对 SAP ERP 数据执行插入、删除、更新和读取操作。

支持的版本

SAP ERP 连接器可以使用以下方法与 SAP R/3 系统通信：

  • 企业应用编程接口 (BAPI)
  • 远程函数调用 (RFC)
  • SAP 表
  • SAP 查询
  • IDoc 消息
支持连接到以下设备：
  • SAP ECC
  • SAP ERP
  • SAP R/3
  • SAP S/4 Hana 本地部署
  • SAP JCo 版本。

    在创建连接时，此连接器需要提供两个 JCo 文件：sapjco3.jar 和 libsapjco3.so（适用于 Unix）。您可以从 SAP 连接器网站下载 JCo 3.1.5 版本。

    • 如果 SAP 系统支持 RFC 连接且有可用的 RFC，则与 SAP 系统的连接有效。也可能支持其他支持 RFC 连接的版本。

您可以通过 SAP ERP 连接器访问以下 SAP 内容：

SAP 表：SAP 表会通过 TableMode 连接属性自动公开为视图。使用 Views 连接属性指定要使用的 SAP 表，该属性会替换 TableMode。SAP 不建议直接修改表。建议改用 BAPI 修改任何表格数据。不支持直接修改 SAP 表。

BAPI 和 RFC：BAPI 和 RFC 会直接作为存储过程公开。默认情况下，以关键字 BAPI 开头的所有 RFC 都会显示为可用存储过程。

IDoc：中间文档 (IDoc) 文件是 SAP 对象，用于以电子邮件形式将业务交易数据从一个系统传输到另一个系统。IDoc 通过电子数据交换 (EDI) 系统将数据从 SAP 传输到非 SAP 系统。

如需详细了解这些术语，请参阅 SAP 术语表。

准备工作

在使用 SAP ERP 连接器之前，请先完成以下任务：

  • 在您的 Google Cloud 项目中：
    • 确保已设置网络连接。如需了解网络模式，请参阅网络连接。
    • 向配置连接器的用户授予 roles/connectors.admin IAM 角色。
    • 将以下 IAM 角色授予您要用其来使用连接器的服务账号：
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
      • roles/storage.objectViewer

      服务账号是一种特殊类型的 Google 账号，用于表示需要验证身份并获得授权以访问 Google API 数据的非人类用户。如果您没有服务账号，则必须创建一个服务账号。如需了解详情，请参阅创建服务账号。

    • 启用以下服务：
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      如需了解如何启用服务，请参阅启用服务。

    如果之前没有为您的项目启用这些服务或权限，则在您配置连接器时，系统会提示您启用。

  • 如果您启用事件订阅，则必须配置 ABAP SDK。如需了解如何配置 ABAP SDK，请参阅 ABAP SDK for Google Cloud 概览。

配置连接器

配置连接器时，您需要创建与数据源（即后端系统）的连接。一个连接需专用于一个数据源。这意味着，如果您有许多数据源，则必须为每个数据源创建单独的连接。如需创建连接，请执行以下步骤：

  1. 在 Cloud 控制台 中，进入 Integration Connectors > 连接页面，然后选择或创建一个 Google Cloud 项目。

    转到“连接”页面

  2. 点击 + 新建以打开创建连接页面。
  3. 在位置部分中，选择连接的位置。
    1. 区域：从下拉列表中选择一个位置。

      如需查看所有受支持区域的列表，请参阅位置。

    2. 点击下一步。
  4. 在连接详情部分中，完成以下操作：
    1. 连接器：从可用连接器的下拉列表中选择 SAP ERP。
    2. 连接器版本：从可用版本的下拉列表中选择一个连接器版本。
    3. 在连接名称字段中，输入连接实例的名称。

      连接名称必须符合以下条件：

      • 连接名称可以使用字母、数字或连字符。
      • 字母必须小写。
      • 连接名称必须以字母开头，以字母或数字结尾。
      • 连接名称不能超过 49 个字符。
      • 对于支持事件订阅的连接器，连接名称不得以“goog”前缀开头。
    4. （可选）输入连接的说明。
    5. 您可以选择启用 Cloud Logging，然后选择日志级别。默认情况下，日志级别设置为 Error。
    6. 服务账号：选择具有所需角色的服务账号。
    7. 如需将该关联用于事件订阅，请选择启用事件订阅。选择此选项后，系统会显示以下选项：
      • 启用事件订阅、实体和操作：选择此选项可将连接用于事件订阅和连接器操作（实体和操作）。
      • 仅启用事件订阅：选择此选项可将连接仅用于事件订阅。如果您选择此选项，请点击下一步，然后配置事件订阅。
    8. 客户端：向 SAP 系统进行身份验证的客户端。
    9. 系统 ID：SAP 系统的系统 ID 或 R3Name 是一个字符串，最多包含 3 个字符。它通常用于负载均衡连接。
    10. 系统编号：用于定义目标系统的编号。用于设置“Host connection”属性。
    11. 项目 ID：包含 SAP JCo jar 的 GCS 存储桶所在的 Google Cloud 项目的 ID。
    12. 存储桶：包含 sapjco3.jar 和 libsapjco3.so 文件的存储桶的名称。
    13. Jaco jar 对象 ID：JCo jar 的对象 ID。
    14. libsapjco3 对象 ID：libsapjco3 jar 的对象 ID。
    15. 表格模式：选择要显示为视图的 SAP 表。
    16. 读取表函数：用于读取表的函数的名称。如需了解详情，请参阅使用自定义读取表函数。
    17. System ID：SAP 系统的系统 ID 或 R3Name。您最多可以输入 3 个字符。
    18. 查询模式：选择必须显示为视图的 SAP 表。
    19. 可浏览的视图：输入要显示的视图的逗号分隔列表。 例如 ViewA,ViewB,ViewC。
    20. 语言：将此属性设置为您在登录 SAP 时指定的语言。此属性是 SAP 系统使用的语言的 ISO 639-1 代码。默认情况下，系统会使用 EN。
    21. 服务条目：要用于连接的服务条目。
    22. SNC 模式：选择此选项可在 Integration Connectors 和 SAP 系统之间启用 SNC 身份验证。如果您选择此选项，请指定以下详细信息：
      • SNC_LIB 对象 ID：SNC 库的对象 ID。
      • PSE 名称：适用于存储桶的个人安全环境 (PSE) 文件的名称。PSE 文件会将公钥和私钥对以及 X.509 证书存储在 ASN.1 结构中。
      • SNC 通行密钥：选择 SNC 库通行密钥的 Secret Manager 密钥。
      • Secret 版本：选择 Secret 版本。
      • SNC 名称：输入 SNC 连接的名称。
      • SNC qop：选择保护级别。支持的级别如下：
        • 1 - 仅应用身份验证。
        • 2 - 应用完整性保护。这还包括身份验证保护。
        • 3 - 应用隐私保护设置。这还包括完整性和身份验证保护。
        • 8 - 应用默认保护。
        • 9 - 应用最高级别的保护。
      • SNC 合作伙伴名称：输入应用服务器的 SNC 名称。
    23. 连接方案：指定您是使用消息服务器 (Group Server) 还是应用服务器连接到 SAP 系统。如需了解您必须满足哪些前提条件才能使用消息服务器连接到 SAP 系统，请参阅消息服务器（群组服务器）连接类型。

      如果您选择 GroupServer，则必须指定以下详细信息：

      • 消息服务器：连接到使用负载均衡的 SAP 系统时，请指定消息服务器。
      • Message Server 服务：您要连接到的 Message Server 服务。
      • 组：使用的登录组。只有在连接到使用负载均衡的 SAP 系统时，您才必须指定此参数。

      如果您要通过消息服务器（群组服务器）连接到 SAP 系统，则无需在目标位置部分中指定主机地址。

    24. （可选）配置连接节点设置：

      • 节点数下限：输入连接节点数下限。
      • 节点数上限：输入连接节点数上限。

      节点是处理事务的连接单元（或副本）。 连接处理越多事务就需要越多节点，相反，处理越少事务需要越少节点。 如需了解节点如何影响连接器价格，请参阅连接节点的价格。如果未输入任何值，则默认情况下，节点数下限设置为 2（以便提高可用性），节点数上限设置为 50。

    25. （可选）点击 + 添加标签，以键值对的形式向连接添加标签。
    26. 点击下一步。
  5. 在目标部分中，输入要连接到的远程主机（后端系统）的详细信息。如果您使用消息服务器连接到 SAP 系统，则无需指定主机地址。
    1. 目标类型：选择目标类型。
      • 从列表中选择主机地址，以指定目标的主机名或 IP 地址。
      • 如果要与后端系统建立专用连接，请从列表中选择端点连接，然后从端点连接列表中选择所需的端点连接。

      如果您想与后端系统建立公共连接以增强安全性，不妨考虑为连接配置静态出站 IP 地址，然后配置防火墙规则，以便仅将特定静态 IP 地址列入许可名单。

      如需输入其他目标，请点击 + 添加目标。

    2. 点击下一步。
  6. 在身份验证部分中，输入身份验证详细信息。
    1. 选择身份验证类型，然后输入相关详细信息。

      SAP ERP 连接支持以下身份验证类型：

      • 基于 X509 证书的身份验证
      • 用户名和密码

      2. 如需了解如何配置这些身份验证类型，请参阅配置身份验证。

    2. 点击下一步。
  7. 如果您已启用事件订阅，则“创建关联”页面上会显示事件订阅详情部分。如需了解如何配置事件订阅详情，请参阅配置事件订阅。
  8. 查看：查看您的连接和身份验证详细信息。
  9. 点击创建。

配置身份验证

根据您要使用的身份验证输入详细信息。

  • 基于 X509Certificate 的身份验证
    • X509Certificate：用于登录的 X509 证书。
    • Secret 版本：选择 Secret 版本。
  • 用户名和密码
    • 用户名：连接器的用户名
    • 密码：包含与连接器关联的密码的 Secret Manager Secret。

配置事件订阅

如果您启用事件订阅，则必须配置 ABAP SDK。如需了解如何配置 ABAP SDK，请参阅 ABAP SDK for Google Cloud 概览。

在事件订阅详情部分中，输入以下值：

  1. 为事件监听器选择以下任一身份验证类型。
  2. 输入事件类型字段名称。此字段用于标识与传入事件请求关联的事件类型。 
    {
"event_type": "user.created",
...
// other request fields
...
}
  3. 选择启用专用连接，以便在后端应用与连接之间建立安全连接。如果您选择此选项，则必须在创建连接后执行其他配置步骤。如需了解详情，请参阅用于事件订阅的专用连接。
  4. 输入死信配置。如果您配置了死信，连接会将未处理的事件写入指定的 Pub/Sub 主题。输入以下详细信息：
    1. 退信项目 ID ：您配置退信 Pub/Sub 主题的 Google Cloud 项目 ID。
    2. 死信主题 ：您要将未处理事件的详细信息写入的 Pub/Sub 主题。

连接配置示例

以下部分列出了创建 SAP ERP 连接时各种字段的示例值，以及不同连接类型所需的参数。

连接到分布式 SAP 系统

如果您连接到分布式 SAP 系统（例如使用负载均衡的系统），则必须指定以下其他连接属性。管理员可以在 SAP 系统的“System Entry Properties”（系统条目属性）对话框的“Connection”（连接）标签页中获取这些连接属性。

  • 系统 ID：指定您从 SystemId 属性中获取的值。系统 ID 是 SAP 系统的系统 ID/R3Name。系统 ID 是一个字符串，最多包含 3 个字符。
  • 消息服务器：连接到使用负载均衡的 SAP 系统时，您必须指定“消息服务器”字段。将此属性设置为您从 SAP 系统中的 MessageServer 属性中获取的值。此外，请在“Message Server”字段的值前面附加 SAProuter 框的值。
  • 组：将此属性设置为您从“组/服务器”属性中获取的值。Group 属性指定要使用的登录组。默认值为 PUBLIC。

连接到自定义应用服务器

如果您使用专用应用服务器或自定义应用服务器连接到 SAP 系统，则必须指定以下额外的连接属性。管理员可以从 SAP 系统中获取这些连接属性。

  • 系统 ID：指定您从 SystemId 属性中获取的值。这是 SAP 系统的系统 ID 或 R3Name。系统 ID 是一个字符串，最多包含 3 个字符。
  • 主机：指定您从应用服务器获取的值。

    此参数用于指定目标系统的主机名。此值可以是常规主机名、IP 地址或 SAP 路由器地址。

  • 系统编号：指定您从 SystemNumber 属性中获取的值。

    SystemNumber 属性用于定义目标系统。

配置安全网络连接

如果管理员已配置安全网络通信 (SNC)，您必须设置以下其他属性。在 SAP 系统中，您可以在“System Entry Properties”（系统条目属性）对话框的“Network”（网络）标签页上获取以下 SNC 连接字符串属性。

  • SNC 模式：如果 SAP 中启用了“启用安全网络连接”复选框，请将 SNC 模式连接属性设为 True。否则，将 SNC Mode 连接属性设置为 False。

    SNCMode 连接属性是一个布尔值，用于确定您是否在使用 SNC。默认值为 False。

  • SNC PartnerName：SNC PartnerName 用于指定应用服务器的 SNC 名称。例如：p:CN=IDS, OU=IT, O=CSW, C=DE
  • SNC 名称：可选。SNCName 属性用于指定 SNC 连接的名称。设置此属性可确保为连接使用正确的 SNC 名称。
  • SNC Qop：将此属性设置为“安全网络设置”部分中所选的选项。例如，如果选择了“完整性”选项，请将 SNCQop 属性设置为 3。

    SNCQop 属性用于指定数据保护级别（或质量）。如果未指定此属性，系统会为此属性设置整数 -1。有效值为 1、2、3、8 或 9，分别对应于保护级别。

  • SNC_Lib 对象 ID：将此属性设置为 SNC 库的路径和文件名。指定您使用的安全库的完整路径，例如 C:\Secude\secude.xll.

ApplicationServer 连接类型

对于应用服务器连接，必须在网络端点组 (NEG) 和健康检查中为 Private Service Connect 和负载均衡器配置 SAP 系统 IP 地址和端口 33XX。其中 XX 是所用 SAP 系统的系统或实例编号。下表列出了 ApplicationServer 连接类型的示例配置值。请参阅控制台中的连接创建界面，了解必填和选填字段。

字段名称 示例值
区域 us-central1
连接器 SAP ERP
连接器版本 1
连接器名称 saperp-applicationserver-conn
说明 不适用
服务账号 xxxxxxxxx-compute@developer.gserviceaccount.com
客户 800
系统编号 00
项目 ID xxxx-gcp-project
存储桶 sap-erp-bucket
Jco Jar 对象 ID sapjco3.jar
libsapjco3 对象 ID libsapjco3.so
表格模式 TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
读取表函数 Z_CUSTOM_READ_TABLE
连接方案 ApplicationServer
系统 ID SA1
查询模式 不适用
可浏览的视图 不适用
详细程度 5
节点数下限 2
节点数上限 50
主机地址 外部 SAP 系统的 10.30.X.XX 或路由器字符串。
身份验证 用户密码
用户名 12345
密码 xyz@12345
版本 1

消息服务器（群组服务器）连接类型

在使用消息服务器（群组服务器）连接到 SAP 系统之前，请确保满足以下前提条件：
  • 必须在网络端点组 (NEG) 和健康检查中，将 Private Service Connect 和负载均衡器配置为使用端口 33XX 和 36XX 上的 SAP 系统 IP。其中 XX 是所用 SAP 系统的系统或实例编号。
  • 您必须在 Cloud DNS 上创建一个 DNS 区域，并映射应用服务器的端点附件（在 33XX 端口上配置，并使用 SAP 系统的主机名）。
  • 只有当消息服务器返回应用服务器的完全限定域名 (FDQN) 地址时，您才能通过消息服务器 (Group Server) 连接到 SAP 系统。如果消息服务器返回 IP 地址，您将无法通过消息服务器（群组服务器）连接到 SAP 系统。
  • 消息服务器必须在应用请求时响应应用需要连接的应用服务器的 DNS。
  • 应用服务器的 DNS 必须是唯一的，并且不能被任何其他 SAP 系统使用。
  • 在 SAP 应用中，必须在 gw/alternative_hostnames 参数下维护应用服务器和消息服务器的端点附加 IP。
    1. 前往 Tcode - RZ10，然后在实例配置文件中为“gw/alternative_hostname”参数创建条目。
    2. 将“ms/lg_with_hostname”参数的值设置为 1。这样可确保消息服务器使用主机名来识别应用服务器并与其通信。
    3. 重启 SAP 应用以使参数生效。

下表列出了 Group Server 连接类型的示例配置值：

字段名称 示例值
区域 us-central1
连接器 SAP ERP
连接器版本 1
连接器名称 saperp-groupserver-conn
说明 不适用
服务账号 SA-compute@developer.gserviceaccount.com
客户 800
系统编号 00
项目 ID Google-cloud-project
存储桶 sap-erp-bucket
Jco Jar 对象 ID sapjco3.jar
libsapjco3 对象 ID libsapjco3.so
表格模式 TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
群组 公开
消息服务器 10.30.X.XX
读取表函数 Z_CUSTOM_READ_TABLE
连接方案 GroupServer
系统 ID SA1
查询模式 不适用
可浏览的视图 不适用
详细程度 5
节点数下限 2
节点数上限 50
身份验证 用户密码
用户名 用户名
密码 PASSWORD
版本 1

X509 证书连接类型

对于具有 X509 连接的安全网络通信 (SNC)，必须在网络端点组 (NEG) 和健康检查中为 Private Service Connect 和负载均衡器配置 SAP 系统 IP 地址和端口 48XX。其中 XX 是所用 SAP 系统的系统编号或实例编号。下表列出了 X509 certificate 连接类型的示例配置值。请参阅控制台中的连接创建界面，了解必填和选填字段。

字段名称 示例值
区域 us-central1
连接器 SAP ERP
连接器版本 1
连接器名称 saperp-X509Certificate-conn
说明 不适用
服务账号 xxxxxxxxx-compute@developer.gserviceaccount.com
客户 800
系统编号 00
项目 ID xxxx-gcp-project
存储桶 sap-erp-bucket
Jco Jar 对象 ID sapjco3.jar
libsapjco3 对象 ID libsapjco3.so
表格模式 TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
SNC_LIB 对象 ID libsapcrypto.so
用于创建 cred_v2 文件的 PSE 名称 EHP8_GCP_SA1.pse
读取表函数 Z_CUSTOM_READ_TABLE
连接方案 ApplicationServer
系统 ID SA1
SNC 密码 xyz@gcp
SNC 模式 一个布尔值，用于确定您是否在使用 SNC。将此属性设置为 true 即可使用 SNC。
SNC 名称 p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
SNC Qop 3
SNC PartnerName p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
查询模式 不适用
可浏览的视图 不适用
详细程度 5
节点数下限 2
节点数上限 50
主机地址 外部 SAP 系统的 10.30.X.XX 或路由器字符串。
身份验证 基于 X509Certificate 的身份验证
X509Certificate X509 证书可以使用指向包含 PEM 格式 X509 证书的文件的文件路径、以“-----BEGIN ...”标头开头的 PEM 数据块或不含“-----BEGIN ...”标头的 PEM 数据块进行指定。
版本 1

系统限制

SAP ERP 连接器每个节点每秒可处理 7 笔事务，并会对超出此限制的所有事务进行节流。默认情况下，Integration Connectors 会为连接分配 2 个节点（以提高可用性）。

如需了解适用于 Integration Connectors 的限制，请参阅限制。

在集成中使用 SAP ERP 连接

创建连接后，该连接将在 Apigee Integration 和 Application Integration 中可用。您可以通过连接器任务在集成中使用该连接。

  • 如需了解如何在 Apigee Integration 中创建和使用连接器任务，请参阅连接器任务。
  • 如需了解如何在 Application Integration 中创建和使用连接器任务，请参阅连接器任务。

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

  • 实体：实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如，在数据库连接器中，表是实体；在文件服务器连接器中，文件夹是实体；在消息传递系统连接器中，队列是实体。

    但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，Entities 列表将为空。

  • 操作：操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作：

    从可用列表中选择一个实体，系统会生成该实体可用的操作列表。如需了解操作的详细说明，请参阅连接器任务的实体操作。不过，如果连接器不支持任何实体操作，则 Operations 列表中不会列出此类不受支持的操作。

  • 动作：动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改，并且动作因连接器而异。通常，操作将具有一些输入参数和一个输出参数。但可能的情况是，连接器不支持任何动作，在这种情况下，Actions 列表将为空。

操作

本部分介绍了 RFC，并列出了该连接器支持的操作。如需了解如何配置操作，请参阅操作示例。

使用 RFC

本部分介绍了必需的 RFC 以及如何使用 RFC。

必需的 RFC

如果任何必需的 RFC 不可用，则部分或全部功能都可能无法正常运行。您可以使用 T-Code SE37 查看 SAP 中的可用函数模块。

SAP ERP 连接器使用以下 RFC。

  • DDIF_FIELDINFO_GET
  • RFC_GET_FUNCTION_INTERFACE
  • RFC_GET_STRUCTURE_DEFINITION
  • RFC_GET_SYSTEM_INFO
  • RFC_GET_UNICODE_STRUCTURE
  • RFC_READ_TABLE
  • SLDAG_CHECK_FOR_UNICODE

读取大量数据

本部分介绍了从 SAP 后端读取大量数据时需要遵循的方法。

SAP ERP 连接器使用 SAP RFC_READ_TABLE 函数从 SAP 表中获取数据，并且此函数的固定大小为 512 字节。它可以为每行数据缓冲，因此您选择的列数不得超过此缓冲区中可容纳的数量。如果您选择的字节数超过 512 个，则在运行集成时会发生 DATA_BUFFER_EXCEEDED 异常；这表示您超出了每行允许的最大缓冲区空间，需要选择的列更少。

为了解决此问题，您可以添加 Custom RFC_READ_TABLE 的代码，该代码与 SAP RFC_READ_TABLE 类似，但缓冲区更大，可解决 DATA_BUFFER_EXCEEDED 问题。

使用自定义读取表函数

该连接器支持与 SAP RFC_READ_TABLE 类似但缓冲区更大的 Custom RFC_READ_TABLE，以便解决 DATA_BUFFER_EXCEEDED 问题。

在 SAP 后端创建自定义 RFC_READ_TABLE

请按照以下步骤使用 自定义 RFC_READ_TABLE 示例。

  1. 将 RFC_READ_TABLE 函数用作新函数的模板：选择事务代码 SE37 和 SDTX 函数组，然后将 RFC_READ_TABLE 复制到新函数组或工作函数组。 在此示例中，RFC_READ_TABLE 会复制到 Z_CUSTOM_RFC_TABLE。
  2. 在 SAP 页面的 Attributes（属性）标签页中，选择 Remote Enabled Module（已启用远程模块）。
  3. 在 Tables（表格）标签页中，将 DATA 参数设置为 CHAR8000（您可能需要右键点击，然后依次点击 Display -> Change）。
  4. 在源代码标签页中，输入自定义读取表 RFC 代码。如需参考，请参阅 sample Z_CUSTOM_RFC_TABLE_function.txt。
  5. 点击保存。
  6. 按照提供的自定义读取表中记录的内容定义导入项、表和异常。
  7. 激活函数模块。

适用于 ABAP 7.52 的自定义读取表

如果您使用的是 ABAP 7.52 或更高版本，请参阅 sample Z_CUSTOM_RFC_TABLE_function_ABAP752.txt。 示例函数适用于 ABAP 7.52 及更高版本。它与 Z_CUSTOM_RFC_TABLE 函数类似，但它利用 ABAP 7.52 中新推出的关键字在数据库中执行分页，而不是在 ABAP 脚本本身中执行分页。这样可以大大提高分页效率，并提高处理大型表时的性能。建议尽可能使用 Z_CUSTOM_RFC_TABLE_752 RFC。

访问 RFC_READ_TABLE 函数

本部分介绍了要向 SAP 用户分配的角色，以便其访问 RFC_READ_TABLE 函数。此函数是一个支持远程的函数模块，允许对任意表进行通用读取访问。

如需在配置 SAP ERP 连接器任务时在“实体”下列出表，您必须在 SAP ERP 连接级别使用 RFC_READ_TABLE 函数，并且有权访问 R/3 函数 RFC_READ_TABLE

为 activity 03（显示）添加了授权 S_TABU_DIS，并为函数 RFC_READ_TABLE 添加了授权组“SC”。

以下是 RFC_READ_TABLE 的一些技术限制：

  • 只能读取包含简单数据类型的表。不支持 STRING 或 XSTRING 字段。
  • 行宽上限为 512 个字符。
  • 返回的记录数量受内存阈值的限制。

BAPI_MATERIAL_SAVEDATA 操作

此操作可让您执行特定任务。例如，您可以使用它在 SAP ERP 中创建或更改物料主数据。

BAPI_MATERIAL_SAVEDATA 操作的输入参数

参数名称 数据类型 必填 说明
HEADDATA 字符串 是 输入参数 HEADDATA。
CLIENTDATA 字符串 是 输入参数 CLIENTDATA。
CLIENTDATAX 字符串 是 输入参数 CLIENTDATAX。
MATERIALDESCRIPTION 字符串 是 MATERIALDESCRIPTION 表。

BAPI_MATERIAL_SAVEDATA 操作的输出参数

如果操作成功，此操作会返回状态 200（OK）。

如需了解如何配置 BAPI_MATERIAL_SAVEDATA 操作，请参阅操作示例。

ZFM_GCP_MULTIDATA_TAB 操作

此操作可让用户执行特定任务。例如，您可以在 SAP ERP 中创建多数据类型数据。

ZFM_GCP_MULTIDATA_TAB 操作的输入参数

参数名称 数据类型 必填 说明
ReturnTables 字符串 是 一个逗号分隔的列表，用于指定应输出函数模块中的哪些表。 如果未指定，系统将输出所有返回的表。
T_TABLE 字符串 是 表 T_TABLE。
IM_INPUT_1 字符串 是 输入参数 IM_INPUT_1。
IM_INPUT_2 字符串 是 输入参数 IM_INPUT_2。

ZFM_GCP_MULTIDATA_TAB 操作的输出参数

如果操作成功，此操作会返回状态 200（OK）。

如需了解如何配置 ZFM_GCP_MULTIDATA_TAB 操作，请参阅操作示例。

PushIDoc 操作

此操作可让您执行特定任务。例如，您可以将数据从 SAP 传输到外部系统。

PushIDoc 操作的输入参数

参数名称 数据类型 必填 说明
FileType 字符串 是 文件类型。允许的值为 XML、IDoc。
模式 字符串 是 传输模式。允许的值为 Sync、ASync。
内容 字符串 是 文件的内容。

PushIDoc 操作的输出参数

如果操作成功，此操作会返回状态 200（OK）。

如需了解如何配置 PushIDoc 操作，请参阅操作示例。

ExecuteCustomQuery 操作

通过此操作，您可以执行自定义查询。

如需创建自定义查询，请按照下列步骤操作：

  1. 按照详细说明添加连接器任务。
  2. 配置连接器任务时，在要执行的动作类型中选择动作。
  3. 在动作列表中，选择执行自定义查询，然后点击完成。

    此图片展示了 execute-custom-query-action 此图片展示了 execute-custom-query-action

  4. 展开任务输入部分，然后执行以下操作：
    1. 在在以下时间后超时字段中，输入查询执行前要等待的秒数。

      默认值：180 秒。

    2. 在最大行数字段中，输入要从数据库返回的最大行数。

      默认值：25。

    3. 要更新自定义查询，请点击修改自定义脚本。系统随即会打开脚本编辑器对话框。

      此图片展示了 custom-sql-query 此图片展示了 custom-sql-query

    4. 在脚本编辑器对话框中，输入 SQL 查询，然后点击保存。

      您可以在 SQL 语句中使用问号 (?) 表示必须在查询参数列表中指定的单个参数。例如，以下 SQL 查询会从 Employees 表中选择与为 LastName 列指定的值匹配的所有行： 

      SELECT * FROM Employees where LastName=?

    5. 如果您在 SQL 查询中使用了问号，则必须点击 + 添加参数名称，针对每个问号添加参数。执行集成时，这些参数按顺序替换 SQL 查询中的问号 (?)。例如，如果您添加了三个问号 (?)，那么必须按顺序添加三个参数。

      此图片展示了 add-query-param 此图片展示了 add-query-param

      如需添加查询参数，请执行以下操作：

      1. 从类型列表中，选择参数的数据类型。
      2. 在值字段中，输入参数的值。
      3. 要添加多个参数，请点击 + 添加查询参数。

成功执行后，此操作会返回状态 200（OK），并附带包含查询结果的响应正文。

操作示例

示例 - 创建记录

此示例使用 BAPI_MATERIAL_SAVEDATA 操作创建材料记录。

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 BAPI_MATERIAL_SAVEDATA 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
"CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
"MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
}

    4. 如果操作成功，BAPI_MATERIAL_SAVEDATA 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

示例 - 更新记录

此示例使用 BAPI_MATERIAL_SAVEDATA 操作更新材料记录。

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 BAPI_MATERIAL_SAVEDATA 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
"CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
"MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
}

    4. 如果操作成功，BAPI_MATERIAL_SAVEDATA 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

示例 - 删除记录

此示例使用 BAPI_MATERIAL_SAVEDATA 操作删除材料记录。

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 BAPI_MATERIAL_SAVEDATA 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
"CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
}

    4. 如果操作成功，BAPI_MATERIAL_SAVEDATA 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

示例 - 创建多数据类型数据

此示例使用 ZFM_GCP_MULTIDATA_TAB 操作创建多数据类型数据。

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 ZFM_GCP_MULTIDATA_TAB 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
"IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
"IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
}

    4. 如果操作成功，ZFM_GCP_MULTIDATA_TAB 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    [{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

示例 - 推送 IDoc

此示例将 IDoc 推送到 SAP ERP。

  1. 在 Configure connector task 对话框中，点击 Actions。
  2. 选择 PushIDoc 操作，然后点击完成。
  3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值： 
    {
"Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
"FileType": "XML",
"Mode": "ASync"
}

    4. 。如果操作成功，PushIDoc 任务的 connectorOutputPayload 响应参数的值将类似于以下内容：

    [{
"Result": "Success",
"Message": "Push IDoc success"
}]

实体操作示例

本部分介绍如何在此连接器中执行一些实体操作。

示例 - 列出所有记录

此示例列出了 T001 实体中的所有记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 T001。
  3. 选择 List 操作，然后点击完成。
  4. 您还可以在连接器任务的任务输入部分中，通过指定过滤条件子句来过滤结果集。 请务必使用英文单引号 (') 指定过滤条件子句值。

示例 - 从实体中获取记录

此示例会从 T001 实体中获取指定 ID 的记录。

  1. 在 Configure connector task 对话框中，点击 Entities。
  2. 从 Entity 列表中选择 T001。
  3. 选择 Get 操作，然后点击完成。
  4. 在连接器任务的任务输入部分，点击 EntityId，然后在默认值字段中输入 0001。

    其中，0001 是 T001 实体中的唯一记录 ID。

使用 Terraform 创建连接

您可以使用 Terraform 资源创建新的连接。

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

如需查看用于创建连接的 Terraform 模板示例，请参阅模板示例。

使用 Terraform 创建此连接时，您必须在 Terraform 配置文件中设置以下变量：

参数名称 数据类型 必需 说明
客户端 STRING True 向 SAP 系统进行身份验证的客户端。
群组 STRING 错误 使用的 Logon Group。通常，只有在连接到使用负载均衡的 SAP 系统时，才需要指定此值。
message_server STRING 错误 连接到使用负载均衡的 SAP 系统时，必须指定消息服务器。
read_table_function STRING 错误 用于读取表数据的函数。
connection_scheme ENUM 错误 指定您是连接到包含消息服务器 (GroupServer) 的 SAP 系统，还是连接到不包含消息服务器 (ApplicationServer) 的 SAP 系统。支持的值包括：ApplicationServer、GroupServer
system_id STRING 错误 SAP 系统的系统 ID 或 R3Name 是一个字符串，最多包含 3 个字符。它通常用于负载均衡连接。
system_number STRING True 用于定义目标系统的编号。用于设置“Host connection”属性。
project_id STRING True 包含 SAP JCo jar 的 Cloud Storage 存储桶所在的 Google Cloud 项目的 ID。
存储桶 STRING True 包含 sapjco3.jar 和 libsapjco3.so 文件的存储桶的名称
sapjco3_jar STRING True sapjco3.jar 的对象 ID
libsapjco3_so STRING True libsapjco3.so 的对象 ID
snc_lib STRING 错误 SNC 库的对象 ID
snc_mode BOOLEAN 错误 一个布尔值，用于确定您是否在使用 SNC。将此属性设置为 true 即可使用 SNC。
snc_name STRING 错误 一个可选输入，用于提供 SNC 连接的名称。
snc_qop ENUM 错误 SNC 连接的保护质量。有效值为 1、2、3、8 或 9，分别对应于以下保护级别：1 仅应用身份验证。2 应用完整性保护（身份验证）。3 应用隐私保护（完整性和身份验证）。8 应用默认保护措施。9 应用最高级别的保护措施。支持的值包括：1、2、3、8、9
snc_partner_name STRING 错误 应用服务器的 SNC 名称。使用 SNC 时，此字段为必填字段。
query_mode ENUM 错误 确定哪些 SAP 表将显示为视图（如果有）。支持的值包括：全局、本地、全部、无
table_mode ENUM 错误 确定哪些 SAP 表将显示为视图（如果有）。支持的值包括：TransparentApplication、TransparentCustomer、TransparentSystem、Pooled、Cluster、All、None
详细程度 STRING 错误 连接的详细程度级别，介于 1 到 5 之间。详细级别越高，系统会记录的通信详细信息（请求、响应和 SSL 证书）就越多。

排查 SAP 本地配置问题

如果您的 SAP 系统位于本地，您必须创建具有混合 NEG 的代理负载均衡器。

  1. 在允许的子网之间，在本地系统和 Google Cloud 之间创建 IPSec 隧道。
  2. 允许在本地防火墙中使用负载均衡子网和代理子网。
  3. 添加所有必需的端口，例如用于应用服务器连接的 33XX、用于消息服务器/负载平衡器服务器连接的 36XX 和用于 SNC-X509 连接的 48XX。其中 XX 是 SAP 系统的系统编号或实例编号。在 Google Cloud 项目入站许可名单中添加防火墙所需的 IP，例如 LB IP 和端口、SAP 系统 IP 和端口。
  4. 使用混合 NEG 配置区域级内部代理网络负载平衡器。如需了解详情，请参阅采用混合 NEG 连接的区域级内部代理网络负载平衡器。

如果您在设置网络连接后遇到类似以下的错误，请使用以下解决方法将端点附加 IP 地址列入许可名单。

Initialization of destination SAP--1910584855 failed: Connect from SAP gateway to RFC server failed
connection parameters: TYPE=A DESTINATION=SAP--1910584855 ASHOST=10.128.0.43 SYSNR=00 PCS=1 
LOCATION    SAP-Gateway on host DELVM05S15.bcone.com / sapgw00
ERROR       timeout during allocate
TIME        Wed Apr  3 17:24:40 2024
RELEASE     754
COMPONENT   SAP-Gateway
VERSION     2
RC          242
MODULE      D:/depot/bas/754_REL/src/krn/si/gw/gwr3cpic.c
LINE        2208
DETAIL      no connect of TP sapdp00 from host 10.128.0.43 after 20 sec

COUNTER     2
解决方法：在 SAP 配置文件级别的 gw/alternative_hostnames 中添加您在 Google Cloud 中创建的连接器网络端点附加 IP。

SAP 术语表

SAP：SAP 是指所有受支持的 SAP 版本的统称。这通常表示 SAP ECC 版本 6 或更高版本。SAP ERP 连接器需要连接到支持 RFC SDK 的 SAP 版本才能正常运行。

函数模块：函数模块是 SAP 中一种程序或函数，可用于执行几乎任何操作。您可以通过 SE37 TCode 在 SAP 中测试和编写这些模块。

RFC：远程函数调用 (RFC) 是对给定 RFM/FM 的调用，可由外部应用执行。这包括使用安装在 SAP 服务器上并可能从 sap.com 下载的 SAP 分发的库。在 SAP 升级过程中，特定 RFM 可能会或可能不会得到维护。SAP 提供了标准 RFM，因此旧版中可能存在差异，也可能不存在。自定义 RFM 可以（并且通常会）构建为支持集成，并且必须由 SAP 客户维护。按照惯例，自定义 RFM 以字母 Z 开头。

BAPI：企业 API (BAPI) 是企业对象的 API 方法，该方法实际上是 SAP 支持 RFC 的函数模块，用于授予对业务逻辑操作的访问权限。例如，大约有 60 个 BAPI 仅与 Customer 对象相关。在实践中，通常只会使用其中的几个。

SAP 表：SAP 表是指在 SAP 中存储数据的表。这些与业务对象不同。例如，SAP 中没有“采购订单”表。不过，有许多表包含采购订单数据，例如 EBAN、EBKN、EINA、EKPO 等。根据惯例，自定义表以字母 Z 开头。

SAP 查询：SAP 查询是 SAP 中保存的对象，其中详细说明了要从一个或多个表中检索的信息。这些参数通常用于生成报告。

向 Google Cloud 社区寻求帮助

您可以在 Google Cloud 社区的 Cloud 论坛中发布您的问题以及讨论此连接器。

后续步骤