步骤 2:配置 WCF-Custom 单向接收端口

第 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-Custom 传输属性 ”对话框中,执行以下作:

    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

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

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

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

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

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

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

    5. 正文路径表达式 文本框中,指定用于从 XML 消息中提取平面文件IDOC的 XPath 查询。 通过这样做,接收端口从 IDOC 中提取数据,并删除作为基于 WCF 的 SAP 适配器操作 ReceiveIdoc 的一部分的 XML 标记。 有关 ReceiveIdoc 操作的消息架构的详细信息,请参阅 IDOC 操作的消息架构

      XPath 查询以提取平面文件 IDOC

      必须指定以下 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 Receive IDOC BizTalk 项目