SAP ERP

配置事件订阅

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

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

1. 为事件监听器选择以下任一身份验证类型。
   • Google 身份验证。如果您启用此选项，请按照使用 JSON Web 令牌进行身份验证中的步骤为 ABAP SDK 配置身份验证。此外，请确保服务账号具有 roles/connectors.listener 角色，该角色的访问令牌用于身份验证。
   • API 密钥身份验证。如果您选择此选项，则必须先创建 API 密钥，然后将该密钥保存为 Secret Manager Secret。如需了解详情，请参阅创建 API 密钥。
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 系统中“系统条目属性”对话框的“连接”标签页中获取这些连接属性。

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

连接到自定义应用服务器

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

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

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

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

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

配置安全网络连接

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

• SNC 模式：如果 SAP 中启用了“启用安全网络连接”复选框，请将 SNC 模式连接属性设置为 True。否则，将 SNC 模式连接属性设置为 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 连接类型的示例配置值。请参阅控制台中的连接创建界面，了解必填字段和选填字段。

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

• 必须在网络端点组 (NEG) 和健康检查中，将 Private Service Connect 和负载均衡器配置为使用端口 33XX 和 36XX 上的 SAP 系统 IP。其中，XX 是所用 SAP 系统的系统或实例编号。
• 您必须在 Cloud DNS 上创建 DNS 区域，并将应用服务器的端点连接（在 33XX 端口上配置，使用 SAP 系统的相应主机名）进行映射。
• 只有当消息服务器返回应用服务器的完全限定域名 (FDQN) 地址时，您才能连接到具有消息服务器（组服务器）的 SAP 系统。如果消息服务器返回 IP 地址，您将无法连接到具有消息服务器（组服务器）的 SAP 系统。
• 当应用发出请求时，消息服务器必须响应应用需要连接的应用服务器的 DNS。
• 应用服务器的 DNS 必须是唯一的，并且不能被任何其他 SAP 系统使用。
• 在 SAP 应用中，必须在 gw/alternative_hostnames 参数下维护应用服务器和消息服务器的端点附件 IP。
  1. 前往事务代码 - RZ10，并在实例配置文件中为“gw/alternative_hostname”参数创建一个条目。
  2. 将 ms/lg\_with\_hostname 参数设置为 1，以配置低于 7.53 的 SAP 消息服务器版本来返回主机名。版本 7.53 及更高版本默认返回主机名。
  3. 重启 SAP 应用，使参数生效。

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

X509 证书连接类型

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

实体、操作和动作

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

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

  但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，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 页面的属性标签页中，选择远程启用模块。
3. 在表格标签页中，将 DATA 参数设置为 CHAR8000（您可能需要右键点击，然后依次点击显示 -> 更改）。
4. 在源代码标签页中，输入自定义的 read-table RFC 代码。如需参考，请参阅 sample Z_CUSTOM_RFC_TABLE_function.txt。
5. 点击保存。
6. 按照提供的自定义读取表中的说明定义导入、表和异常。
7. 激活函数模块。

适用于 ABAP 7.52 的自定义 read-table

如果您使用的是 ABAP 7.52 或更高版本，请参阅示例 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 的授权

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

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

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

BAPI_MATERIAL_SAVEDATA 操作

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

BAPI_MATERIAL_SAVEDATA 操作的输入参数

BAPI_MATERIAL_SAVEDATA 操作的输出参数

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

如需查看有关如何配置 BAPI_MATERIAL_SAVEDATA 操作的示例，请参阅操作示例。

ZFM_GCP_MULTIDATA_TAB 操作

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

ZFM_GCP_MULTIDATA_TAB 操作的输入参数

ZFM_GCP_MULTIDATA_TAB 操作的输出参数

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

如需查看有关如何配置 ZFM_GCP_MULTIDATA_TAB 操作的示例，请参阅操作示例。

PushIDoc 操作

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

PushIDoc 操作的输入参数

PushIDoc 操作的输出参数

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

如需查看有关如何配置 PushIDoc 操作的示例，请参阅操作示例。

ExecuteCustomQuery 操作

此操作可让您执行自定义查询。

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

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

   

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

      默认值：180 秒。

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

      默认值：25。

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

      

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

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

      SELECT * FROM Employees where LastName=?

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

      

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

      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\"}"
   }

如果操作成功，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\"}"
   }

如果操作成功，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\"}"
   }

如果操作成功，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\"}"
   }

如果操作成功，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"
   }

。如果操作成功，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。