使用端口绑定文件配置 Oracle 电子商务套件的物理端口绑定

使用 Consume Adapter Service BizTalk 项目外接程序为 Oracle E-Business Suite 工件生成元数据时,除了架构文件,该外接程序还会生成端口绑定文件。 可以将此绑定文件导入 BizTalk 应用程序,以创建物理发送或接收端口。 有关导入绑定文件的说明,请参阅 通过 Oracle E-Business Suite 复用适配器绑定。 如果导入此绑定文件,则无需手动创建物理发送或接收端口。

重要

在使用适配器服务 BizTalk 项目外接程序时,如果未为字符串类型的绑定属性指定值,并且其默认值为 null,则绑定属性在绑定文件中将不可用。 如果需要,必须在绑定文件中手动添加绑定属性及其值。

使用端口绑定文件创建端口始终创建双向发送端口或单向接收端口。 如果要创建单向发送端口,可以按照 手动配置到 Oracle 电子商务适配器的物理端口绑定中所述的过程手动创建该端口。 或者,可以按照本主题中所述的解决方法修改端口绑定文件以创建单向发送端口。

注释

对于入站作,端口绑定文件将始终创建单向接收端口。 这是因为 Oracle E-Business 适配器仅支持入站作的单向接收端口。

重要

使用“添加适配器元数据向导”无法创建用于创建 WCF-OracleEBS 端口的端口绑定文件。 但是,你可以对使用适配器服务外接程序生成的端口绑定文件进行一些更改,并使用它来创建 WCF-OracleEBS 端口。 有关详细信息,请参阅 使用适配器服务外接程序生成的端口绑定文件配置 WCF-OracleEBS 端口

以下是您必须了解的有关适配器服务外接程序生成的绑定文件的一些关键点:

  • 这些文件是使用特定的命名约定创建的。 如果为出站操作生成了元数据,也就是说,在将消息发送到 Oracle E-Business Suite 时,该文件的名称为 WcfSendPort_OracleEBSBinding_Custom.bindinginfo.xml。

    如果为入站操作生成了元数据,即从 Oracle E-Business Suite 接收消息,那么该文件的名称为 WcfReceivePort_OracleEBSBinding_Custom.bindinginfo.xml。

  • 该文件包含有关绑定配置、绑定类型、终结点 URI 及基于生成元数据的操作的端口操作的信息。 将此绑定文件导入 BizTalk 应用程序以创建端口时,将自动在端口上设置配置物理端口所需的所有相关信息。

    重要

    默认情况下,发送端口上的操作会映射到为其生成元数据的操作名称。 例如,如果在接口表(例如FA_BOOKS)上为插入操作生成元数据,则端口上的操作将被设置为 <Operation Name="Insert" Action="InterfaceTables/Insert/OFA/FA/FA_BOOKS" />。 但是,您在 BizTalk 业务流程中创建的逻辑发送端口上的操作名称可能会不同。 必须确保逻辑发送端口(在 BizTalk 业务流程中)和物理发送端口(在 BizTalk Server 管理控制台中)的操作名称相同。 否则,通过发送端口将消息发送到 Oracle E-Business Suite 时会收到错误。

  • 只需提供用于连接到 Oracle 电子商务套件的凭据,即可访问端口。 尽管绑定文件确实保留了要连接的用户名,但出于安全原因,绑定文件不包含密码。

使用端口绑定文件时的重要注意事项

  • 导入绑定文件时,可能会收到一条对话框消息,告知绑定文件中的 BizTalk 应用程序名称与导入绑定文件的应用程序名称不匹配。 可以安全地忽略此消息并继续。

  • 绑定文件还包含端口的名称和接收位置。 如果要将绑定文件导入到的 BizTalk 应用程序会创建一个端口或接收位置,该端口的名称与同一 BizTalk 应用程序中已有的端口相同,则会收到错误。 必须手动编辑绑定文件,以指定端口或接收位置的唯一名称。

  • 绑定文件还包含有关连接 URI 的信息。 如果绑定文件创建一个接收位置,该接收位置与同一 BizTalk 应用程序中已有的接收位置具有相同的接收 URI,则会收到错误。 必须手动编辑绑定文件才能指定唯一 URI。

  • 默认情况下,出站操作的端口绑定文件始终包含双向发送端口的定义。 在 BizTalk 应用程序中导入此文件时,它会创建双向发送端口。 但是,可能有一个具有单向发送端口的业务流程。 因此,配置此类编排并使用通过导入绑定文件所创建的端口时,该端口不会出现在列表中。 发生这种情况的原因是,在业务流程中创建的逻辑端口是单向端口,而业务流程中创建的物理端口是双向端口。 在这种情况下,可以编辑绑定文件以进行以下更改:

    为此 执行此操作
    编辑端口绑定文件以配置单向发送端口 1.在以下摘录中,将 IsTwoWay 属性的值更改为 false。 最初,此值设置为 true
    <SendPort Name="port_name" IsStatic="true" IsTwoWay="false " BindingOption="0">
    2. 注释掉以下摘录:
    <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken= token" Type="1" TrackingOption="None" Description=""/>
    <ReceivePipelineData xsi:nil="true" />

    重要

    对于入站作,端口绑定文件将始终创建单向接收端口。 这是因为 Oracle E-Business 适配器仅支持入站作的单向接收端口。

使用使用适配器服务外接程序生成的端口绑定文件配置 WCF-OracleEBS 端口

使用适配器服务外接程序创建可在 BizTalk Server 管理控制台中导入的端口绑定文件。 可以使用同一端口绑定文件在 BizTalk Server 管理控制台中创建 BizTalk WCF-OracleEBS 端口。 但是,在创建 WCF-OracleEBS 端口之前,必须执行以下任务来修改端口绑定文件。

  1. 在文本编辑器中打开端口绑定文件。

  2. 搜索“WCF-Custom”并将其替换为在 BizTalk Server 管理控制台中添加 WCF-OracleEBS 适配器的名称。 例如,如果将 WCF-OracleEBS 适配器添加为“OracleEBSAdapter”,请将“WCF-Custom”替换为“OracleEBSAdapter”。

  3. 搜索“ConfigurationClsid”属性,并将该属性的现有值替换为“F452BB15-7A0D-495d-9395-C630D3FD29CD”。

  4. 保存并关闭绑定文件。

  5. 在 BizTalk Server 管理控制台中导入绑定文件。 有关如何导入绑定文件的指南,请参阅 在 Oracle E-Business Suite 中重用适配器绑定

另请参阅

用于创建 Oracle E-Business Suite 应用程序的构建基块