使用 BizTalk Server 将 IDOC 发送到 SAP

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

  • 发送 操作使适配器客户端能够发送具有强类型架构的 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. 使用“使用适配器服务外接程序”为特定 IDOC 生成 发送 操作的架构。

业务流程设计时间

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

1.将绑定属性 GenerateFlatFileCompatibleIdocSchema 设置为 True
2. 使用“使用适配器服务外接程序”从 IDOC 节点生成 SendIdoc 操作的架构。

业务流程设计时间

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

- 使用“使用适配器服务外接程序”为特定 IDOC 生成 发送 操作的架构。

业务流程设计时间

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

- 使用“使用适配器服务外接程序”从 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\ORDERS05 下的 发送 操作生成架构,将 IDOC 发送到 SAP 系统。V3 (620) IDOC。 有关如何为特定 IDOC 生成架构的详细信息 ,请参阅 SAP 中的浏览、搜索和获取 IDOC 操作的元数据

定义消息和消息类型

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

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

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

  1. 打开业务流程视图 BizTalk 项目(如果尚未打开)。 单击“视图”,指向“其他Windows”,然后单击“业务流程视图”。

  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 文件。 要发送到 SAP 系统的典型业务流程和 IDOC 将包含:

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

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

  • 用于将平面文件 IDOC 转换为 XML 文件的平面文件反汇编程序。

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

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

    示例业务流程如下所示:

    Orchestration to send IDOCs to SAP

添加消息形状

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

形状 形状类型 属性
ReceiveFile 接收 - 将 名称 设置为 ReceiveFile
- 将 激活 设置为 True
SendToLOB 发送 - 将 名称 设置为 SendToLOB
ReceiveResponse 接收 - 将 名称 设置为 ReceiveResponse
- 将 激活 设置为 False
SendResponse 发送 - 将 名称 设置为 SendResponse

添加端口

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

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

添加平面文件反汇编程序

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

添加平面文件反汇编程序
  1. 右键单击 BizTalk 项目,指向 “添加”,然后选择“ 新建项”。

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

    使用此选项 要执行此操作
    类别 管道文件
    Visual Studio 已安装模板 接收管道
    名称 IDOCReceive
  3. 这会打开管道设计器。 从 BizTalk 管道组件 工具箱中,将 平面文件反汇编器 管道组件拖动到接收管道的 反汇编 阶段。

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

为操作形状和端口连接指定消息

下表指定要设置的属性及其值,以指定要指定操作形状的消息并将其链接到端口。 形状列中列出的名称是上面业务流程中显示的消息形状的名称。

形状 属性
ReceiveFile - 将 消息 设置为 IDOCSend
- 将 操作 设置为 FileIn.SendIDOC.Request
SendToLob - 将 消息 设置为 IDOCSend
- 将 操作 设置为 LOBPort.SendIDOC.Request
ReceiveResponse - 将 消息 设置为 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 操作来提交 IDOC。 有关绑定属性的详细信息,请参阅 有关 mySAP Business Suite 绑定属性的 BizTalk 适配器的信息。 有关 RfcConfirmTransID 操作的详细信息,请参阅 SAP 中 tRFC 上的操作

      注意

      使用使用适配器服务 BizTalk 生成架构Project外接程序还会创建一个绑定文件,其中包含有关这些端口和要为这些端口设置的操作的信息。 可以从 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。 例如,ORDERS05 IDOC 上发送操作的响应消息为:

<?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 应用程序