步骤 2：配置 WCF 自定义单向接收端口

  • 项目

步骤 2/3

完成时间： 10 分钟

目的： 在此步骤中，将 WCF-Custom 端口配置为从 SAP 系统接收平面文件 IDOC。 配置端口后，将 BizTalk 应用程序配置为使用 WCF-Custom 接收端口。

必备条件

必须已生成并部署 vPrev BizTalk 项目才能从 SAP 系统接收 IDOC。

配置 WCF-Custom 单向接收端口

  1. 启动BizTalk Server管理控制台。

  2. 在控制台树中，展开 BizTalk 组，然后展开 应用程序。

  3. 展开要在其中创建接收端口的应用程序。

  4. 右键单击“ 接收端口”，指向“ 新建”，然后单击“ 单向接收端口”。

  5. 在“ 接收端口属性 ”对话框中的“ 常规 ”选项卡上，键入接收端口的名称。

  6. 在“ 接收位置 ”选项卡上，单击“ 新建”。 此时将显示“ 接收位置属性 ”对话框。

  7. 在“ 接收位置属性 ”对话框中，执行以下操作：

    1. 指定接收位置的名称。

    2. 在 “类型 ”下拉列表中，选择“ WCF-Custom”，然后单击“ 配置”。

  8. 在 “WCF 自定义传输属性 ”对话框中，执行以下操作：

    1. 单击“ 常规 ”选项卡，在“ 地址 (URI) ”字段中，指定从 SAP 系统接收消息的连接 URI。 从 SAP 系统接收消息的连接 URI 必须采用以下格式：

      sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId

      下图显示了指定了 URI 的端口属性对话框：

      91e12582-aea3-4f13-8cdc-af69a9a11a5c用于从 SAP

      有关连接 URI 的详细信息，请参阅 创建与 SAP 系统的连接。

    2. 单击“ 绑定 ”选项卡，然后从“ 绑定类型 ”下拉列表中选择“ sapBinding”。 请确保为接收端口指定以下绑定属性。

      Binding 属性 将值设置为
      flatFileSegmentIndicator SegmentType。 这表示平面文件应包含 IDOC 中每个段的段类型。
      padReceivedIdocWithSpaces True。 指定 IDOC 中的每一行是否用空格填充到正确的长度。
      receiveIDocFormat 字符串。 这指定 IDOC 消息应表示为单个字符串字段。

      有关绑定属性的详细信息，请参阅 阅读有关 MySAP Business Suite 绑定属性的 BizTalk 适配器。

    3. 单击“ 其他 ”选项卡，并指定用于连接到 SAP 系统的凭据。

    4. 单击“ 消息 ”选项卡，然后在“ 入站 BizTalk 消息正文 ”部分中，选择 “路径” 选项。

    5. 在“ 正文路径表达式 ”文本框中，指定 XPath 查询以从 XML 消息中提取平面文件 IDOC。 这样，接收端口会从 IDOC 中提取数据，并剪裁 XML 标记，该标记是基于 WCF 的 SAP 适配器的 ReceiveIdoc 操作的一部分。 有关 ReceiveIdoc 操作的消息架构的详细信息，请参阅 IDOC 操作的消息架构。

      用于提取平面文件 IDOC 的 XPath 查询

      必须指定以下 XPath 查询：

      /*[local-name()='ReceiveIdoc']/*[local-name()='idocData']

    6. 从 “节点编码 ”下拉列表中，选择“ 字符串”。

    7. 单击“应用”，然后单击“确定”。

  9. 在“接收位置属性”对话框中，从“ 接收处理程序 ”下拉列表中选择“ BizTalkServerApplication”。

  10. 从 “接收管道 ”下拉列表中，选择“ ConvertToXML”。 此平面文件反汇编程序管道已是 vPrev BizTalk 项目的一部分，用于将平面文件 IDOC 转换为 XML IDOC。

  11. 单击 “确定” 。

配置 BizTalk 应用程序

  1. 在BizTalk Server管理控制台中，依次展开 BizTalk 组、应用程序，以及部署业务流程的 BizTalk 应用程序。

  2. 右键单击 BizTalk 应用程序，然后选择“ 配置”。

  3. 在左窗格中，单击要配置的业务流程。 在右窗格中的 “主机 ”下拉列表中，选择 BizTalk 主机实例。

  4. 在“绑定”框中，将 BizTalk 业务流程的逻辑端口映射到BizTalk Server管理控制台中的物理端口。

    1. 选择本主题前面创建的 WCF-Custom 接收端口。

    2. 选择将接收平面文件 IDOC 的文件端口。

    3. 单击 “确定” 。

      有关在 BizTalk Server 中配置应用的详细信息，请参阅如何配置应用程序。

后续步骤

现已完成将 vPrev BizTalk 项目迁移到使用基于 WCF 的 SAP 适配器从 SAP 系统接收 IDOC 的 BizTalk 项目。 现在，必须通过接收平面文件 IDOC 来测试迁移的 BizTalk 应用程序，如 步骤 3：测试迁移的应用程序中所述。

另请参阅

教程 4：迁移 SAP 接收 IDOC BizTalk 项目