通过

使用 BizTalk Server 将 IDOC 发送到 SAP

对 SAP 的所有 IDOC 调用在内部被视为 tRFC 调用，其中适配器充当 tRFC 客户端，并在 SAP 中调用 RFC 以发送 IDOC。 本部分介绍如何使用适用于 mySAP Business Suite 的 Microsoft BizTalk 适配器和 BizTalk Server 将 IDOC 发送到 SAP。 SAP 适配器会显示两个不同的操作来发送 IDOCs：

  • 发送 操作使适配器客户端能够发送具有强类型架构的 IDOC（信息文档）。

  • SendIdoc 操作使适配器客户端能够发送具有弱类型架构的 IDOC。 使用此适配器客户端可以将平面文件 IDOC 发送到 SAP 系统。 整个平面文件 IDOC 将是 SendIdoc XML 消息中的节点值。

    有关 SAP 适配器如何支持将 IDOC 发送到 SAP 系统的详细信息，请参阅 SAP 中 IDOC 的作。 有关用于发送 IDOC 的 SOAP 消息结构的详细信息，请参阅 IDOC作的消息架构。

使用 SAP 适配器发送 IDOC 的 BizTalk 场景

下表提供了将 IDOC 发送到 SAP 系统的关键 BizTalk 方案：

输入到 BizTalk BizTalk 数据处理 输出到适配器
平面文件 IDOC 元数据设计时间

1.将绑定属性 GenerateFlatFileCompatibleIdocSchema 设置为 True。
2. 使用“Consume Adapter Service 外接程序”为特定 IDOC 生成发送操作的架构。

编排设计时间

1.接收平面数据文件 IDOC
2. 使用平面文件反汇编程序，使用刚生成的架构将平面文件 IDOC 转换为 XML IDOC。
3. 将操作设置为 发送。		 发送消息
平面文件 IDOC 元数据设计时间

1.将绑定属性 GenerateFlatFileCompatibleIdocSchema 设置为 True。
2. 使用 Consume Adapter Service 加载项从 IDOC 节点生成 SendIdoc 操作的架构。

编排设计时间

1.接收平面文件格式的 IDOC
2.使用平面文件反汇编程序使用刚生成的架构将平面文件 IDOC 转换为 XML（在这种情况下，XML 消息包含 <包含整个平面文件 Idoc 消息的 idocData> 节点）。
3. 将操作设置为SendIdoc。		 发送Idoc消息
XML IDOC 元数据设计时间

- 使用适配器服务加载项为特定 IDOC 生成 发送 操作的模式。

编排设计时间

1. 接收 XML IDOC。
2. 将操作设置为发送。		 发送消息
XML 消息中的扁平文件 IDOC 元数据设计时间

- 使用“Consume Adapter Service”外接程序从 IDOC 节点生成 SendIdoc 操作的架构。

编排设计时间

1.接收 XML 消息。
2. 将操作设置为 SendIdoc 操作。		 SendIdoc 消息

如何将 IDOC 发送到 SAP 系统

使用 BizTalk Server 在 SAP 系统上执行操作涉及按照构建 SAP 应用程序所需模块所述的过程任务。 若要将 IDOC 发送到 SAP 系统，这些任务包括：

  1. 创建 BizTalk 项目并为要在 SAP 系统中调用的 IDOC 生成架构。 生成架构时，请确保设置所需的绑定属性，如上表中所示。 有关如何设置绑定属性的说明，请参阅 配置 SAP 适配器的绑定属性。

  2. 在 BizTalk 项目中创建消息，以便从 SAP 系统发送和接收消息。

  3. 创建业务流程以将 IDOC 发送到 SAP 系统。

  4. 生成和部署 BizTalk 项目。

  5. 通过创建物理发送和接收端口来配置 BizTalk 应用程序。

  6. 启动 BizTalk 应用程序。

    本主题提供执行这些任务的说明。

基于本主题的示例

基于本主题的示例 IDOCSend 也随 BizTalk 适配器包一起提供。 有关详细信息，请参阅 SAP 适配器的示例。

生成架构

本主题演示如何通过为 \IDOC\ORDERS\ORDERS05\ORDERS05.V3(620) IDOC 下的 发送 操作生成架构，将 IDOC 发送到 SAP 系统。 如需了解如何为特定的 IDOC 生成架构的详细信息，请参阅 SAP 中的浏览、搜索及获取 IDOC 操作的元数据。

定义消息和消息类型

前面生成的架构描述了业务流程中消息所需的“类型”。 消息通常是变量，类型由相应的架构定义。 必须将在第一步中生成的架构链接到 BizTalk 项目的业务流程视图中的消息。

对于本主题，必须创建两条消息-一个用于将 IDOC 发送到 SAP 系统，另一条消息用于接收响应。

执行以下步骤创建消息并将其链接到架构：

  1. 如果尚未打开，请打开 BizTalk 项目的编排视图。 单击“视图”，指向“其他窗口”，然后单击“编排视图”。

  2. 在 业务流程视图中，右键单击 “消息”，然后单击“ 新建消息”。

  3. 右键单击新创建的消息，然后选择“ 属性”窗口。

  4. 在Message_1的“属性”窗格中，执行以下作：

    用这个 要执行的操作
    标识符 键入 IDOCSend。
    消息类型 从下拉列表中，展开 “架构”，然后选择 IDOCSend.SAPBindingSchema3，其中 IDOCSend 是 BizTalk 项目的名称。 SAPBindingSchema3 是为发送操作生成的架构。

  5. 重复上一步以创建新消息。 在新消息的 “属性 ”窗格中，执行以下作：

    用这个 要执行的操作
    标识符 键入 IDOCResponse。
    消息类型 从下拉列表中，展开 “架构”，然后选择 IDOCSend.SAPBindingSchema4。

设置业务流程

必须创建 BizTalk 业务流程才能使用 BizTalk Server 将 IDOC 发送到 SAP 系统。 在此业务流程中，您将在指定的接收位置投递一个平面文件 IDOC。 此文件使用平面文件反汇编程序转换为 XML 请求消息。 SAP 适配器使用此消息并将其传递到 SAP 系统。 使用 GUID 的响应从 SAP 接收，并保存在另一个位置。 必须包括发送和接收功能，才能将 IDOC 发送到 SAP 系统并接收响应。 还必须包含平面文件反汇编程序，才能将平面文件转换为 XML 文件。 典型的编排将包含发送一个 IDOC 至 SAP 系统的过程：

  • 发送和接收形状以将消息发送到 SAP 系统并接收响应。

  • 用于单向接收平面文件 IDOC 并发送到 SAP 系统的接收端口。

  • 用于将平面文件IDOC转换为XML文件的解码程序。

  • 双向发送端口，用于将 IDOC 发送到 SAP 系统并接收响应。

  • 一个单向发送端口，用于将响应从 SAP 系统发送到文件夹。

    示例编排如下所示：

    将 IDOCs 编排发送至 SAP

添加消息形状

请确保为每个邮件形状指定以下属性。 形状列中列出的名称是上面编排中显示的消息形状的名称。

形状 形状类型 性能
接收文件 接收 - 将 名称 设置为 ReceiveFile
- 将 “激活 ”设置为 True
SendToLOB 发送 - 将 名称 设置为 SendToLOB
接收响应 接收 - 将 名称 设置为 ReceiveResponse
- 将 “激活 ”设置为 False
SendResponse 发送 - 将 名称 设置为 SendResponse

添加端口

请确保为每个逻辑端口指定以下属性。 端口列中列出的名称是业务流程中显示的端口的名称。

港口 性能
FileIn - 将 标识符 设置为 FileIn
- 将 类型 设置为 FileInType
- 将 通信模式 设置为 单向
- 将通信方向设置为接收
LOBPort - 将 标识符 设置为 LOBPort
- 将 类型 设置为 LOBPortType
- 将 通信模式 设置为 请求-响应
- 将 通信方向 设置为 发送接收
保存响应 - 将 标识符 设置为 SaveResponse
- 将 类型 设置为 SaveResponseType
- 将 通信模式 设置为 单向
- 将通信方向设置为发送

添加平面文件拆解器

必须将平面文件反汇编程序添加到业务流程，才能将平面文件 IDOC 转换为 XML 格式。

添加扁平文件反汇编程序

  1. 右键单击 BizTalk 项目，指向 “添加”，然后选择“ 新建项”。

  2. 从对话框中执行以下操作：

    用这个 要执行的操作
    类别 管道文件
    Visual Studio 已安装的模板 接收管道
    名称 IDOCReceive

  3. 这将打开管道设计器。 从 BizTalk 管道组件 工具箱中，将 平面文件反汇编程序 管道组件拖动到接收管道的 反汇编 阶段。

  4. 在 “管道组件属性” 视图中，指定 文档架构 属性的值。 从下拉列表中请确保选择与 IDOC 发送操作对应的架构。

为动作形状指定消息并连接至端口

下表指定要设置的属性及其值，以针对动作形状指定消息并将其连接到端口。 形状列中列出的名称是上面编排中显示的消息形状的名称。

形状 性能
接收文件 - 将 消息 设置为 IDOCSend
- 将 操作 设置为 FileIn.SendIDOC.Request
SendToLob - 将 消息 设置为 IDOCSend
- 将 操作 设置为 LOBPort.SendIDOC.Request
接收响应 - 将 消息 设置为 IDOCResponse
- 将 操作 设置为 LOBPort.SendIDOC.Response
SendResponse - 将 消息 设置为 IDOCResponse
- 将 操作 设置为 SaveResponse.SendIDOC.Request

指定这些属性后，消息形状符和端口被连接，您的编排已完成。

现在必须生成 BizTalk 解决方案并将其部署到 BizTalk Server。 有关详细信息，请参阅 生成和运行业务流程。

配置 BizTalk 应用程序

部署 BizTalk 项目后，前面创建的业务流程将列在 BizTalk Server 管理控制台中的 “业务流程 ”窗格下。 必须使用 BizTalk Server 管理控制台来配置应用程序。 有关配置应用程序的详细信息，请参阅 如何配置应用程序。

配置应用程序涉及：

  • 为应用程序选择主机。

  • 将业务流程中创建的端口映射到 BizTalk Server 管理控制台中的物理端口。 对于此编排，必须：

    • 请在硬盘上指定一个位置及其对应的文件端口，以便放置请求消息。 BizTalk 业务流程将使用请求消息并将其发送到 SAP 系统。

      重要

      对于此端口的 XMLReceive 管道，请确保选择 IDOCReceive。 已将此管道创建为 BizTalk 项目的一部分。

    • 定义硬盘上的位置和相应的文件端口，BizTalk 业务流程将删除包含来自 SAP 系统的响应的响应消息。

    • 定义物理 WCF-Custom 或 WCF-SAP 发送端口以将消息发送到 SAP 系统。 还必须在发送端口中指定操作。 有关如何创建端口的信息，请参阅 手动配置到 SAP 适配器的物理端口绑定。

      注释

      还可以将 AutoConfirmSentIdocs 绑定属性设置为自动将 IDOC 提交到 SAP 系统中。 如果这样做，您无需显式调用 RfcConfirmTransID 操作来提交 IDOCs。 有关绑定属性的详细信息，请参阅 有关 mySAP Business Suite 绑定属性的 BizTalk 适配器的信息。 有关 RfcConfirmTransID 操作的详细信息，请参阅 SAP 中 tRFC 的操作。

      注释

      使用适配器服务 BizTalk 项目插件生成架构时，还会创建一个绑定文件，其中包含有关端口和为这些端口设置的操作的信息。 可以从 BizTalk 管理控制台导入此绑定文件，以创建发送端口（用于出站呼叫）或接收端口（对于入站呼叫）。 有关详细信息，请参阅 使用端口绑定文件配置到 SAP 的物理端口绑定。

启动应用程序

必须启动 BizTalk 应用程序，以便将 IDOC 发送到 SAP 系统。 有关启动 BizTalk 应用程序的说明，请参阅 如何启动业务流程或 如何启动应用程序。

在此阶段，请确保：

  • 用于接收业务流程请求消息的 FILE 接收端口正在运行。

  • 用于从业务流程接收响应消息的 FILE 发送端口正在运行。

  • WCF-Custom 或 WCF-SAP 传送端口正在运行，以将消息发送到 SAP 系统。

  • 正在运行该操作的 BizTalk 业务流程。

执行操作

运行应用程序后，必须投递请求消息给流程编排。 对于此示例，我们会在定义好的 FILE 接收位置投放扁平文件 IDOC。 放下请求消息后，将执行以下操作：

  • 此编排过程选择该平面文件 IDOC，并将其转换为 XML 请求消息，该消息的架构符合您之前生成的架构。

  • 如果提供的请求消息包含 GUID，适配器将生成事务 ID（TID），并将其发送到 SAP 系统。

  • 如果提供的请求消息不包含 GUID，适配器将生成 GUID，并使用该 GUID 生成 TID。 然后，TID 将发送到 SAP 系统。

    在这两种情况下，来自 SAP 系统的响应消息都包含 GUID。 例如：对于 IDOC 的 ORDERS05 发送操作，其响应消息为：

<?xml version="1.0" encoding="utf-8"?>  
<SendResponse xmlns="http://Microsoft.LobServices.Sap/2007/03/Idoc/3/ORDERS05//620/Send">  
  <guid>a5afe162-d5cc-47b0-bf6f-3b0bfe06a97e</guid>  
</SendResponse>

收到 GUID 后，必须调用 RfConfirmTransID 来提交 TID。 有关 RfcConfirmTransID 操作的详细信息，请参阅 SAP 中的 tRFC 操作。 可以创建新的业务流程来调用此操作，或修改现有的业务流程。 如果要创建新的业务流程，它将类似于 SAP 系统上的任何其他业务流程。 若要更新现有业务流程，请参阅 使用 BizTalk Server 在 SAP 中调用 tRFC。 用于调用 tRFC 的编排，如主题中所述，演示如何从同一编排中调用 RfcConfirmTransID 操作。

注释

如果将 AutoConfirmSentIdocs 绑定属性设置为 True，则无需调用 RfcConfirmTransID作。

可能的异常

有关使用 BizTalk Server 将 IDOC 发送到 SAP 系统时可能会遇到的异常的信息，请参阅 SAP 适配器的异常和错误处理。

最佳做法

部署并配置 BizTalk 项目后，可以将配置设置导出到名为绑定文件的 XML 文件。 生成绑定文件后，可以从文件导入配置设置，以便无需为同一业务流程创建发送端口、接收端口等。 有关绑定文件的详细信息，请参阅 重复使用 SAP 适配器绑定。

另请参阅

开发 BizTalk 应用程序