为 Oracle 电子商务套件解决方案项目生成 WCF 客户端或 WCF 服务协定

  • 项目

可以使用添加适配器服务参考 Visual Studio 插件生成 WCF 客户端类或 WCF 服务协定 (接口) 针对 Oracle E-Business Suite 项目的选定操作。 还可以使用 ServiceModel 元数据实用工具 (svcutil.exe) 生成 WCF 客户端类或 WCF 服务协定;但是，添加适配器服务引用插件通过标准 Microsoft Windows 界面公开 ServiceModel 元数据实用工具的功能。 它还提供 svcutil.exe 工具不可用的浏览和搜索功能，并根据连接到 Oracle 电子商务套件时选择的绑定属性生成配置文件。

使用添加适配器服务引用插件生成客户端类

执行以下步骤，使用添加适配器服务引用插件生成 WCF 客户端类。

生成 WCF 客户端类

  1. 在 Visual Studio 解决方案资源管理器中，右键单击项目，然后单击“添加适配器服务引用”。

  2. 打开“ 添加适配器服务引用 ”对话框后，按照 在 Visual Studio 中检索 Oracle 电子商务套件操作的元数据 中的步骤连接到 Oracle 电子商务套件并浏览和搜索操作。 若要为所选操作创建 WCF 客户端类，请确保从“选择协定类型”下拉列表中选择“客户端 (出站操作 ) ”， (这是默认) 。

  3. 选择要面向的所有操作后，单击“ 确定 ”以生成 WCF 客户端类。

    添加适配器服务引用插件将两个文件添加到项目中：

  • OracleEBSBindingClient.cs。 此文件包含为所选操作生成的 WCF 客户端类和帮助程序代码。

  • app.config。此文件包含绑定配置和客户端终结点配置。 这些配置基于你在为添加适配器服务参考插件配置绑定和连接时所做的选择。

    重要

    使用“添加适配器服务参考 Visual Studio 插件”时，如果未为字符串类型的绑定属性指定值，并且其默认值为 null，则该绑定属性在 app.config 文件中不可用。 如果需要，必须在 app.config 文件中手动添加绑定属性及其值。

使用添加适配器服务引用插件生成 WCF 服务协定

适配器公开入站操作，使 Oracle E-Business Suite 能够将消息发送到适配器客户端。 对于此类操作，必须生成 WCF 服务协定。 本部分介绍如何为适配器公开的入站操作生成服务协定。

执行以下步骤，使用添加适配器服务引用插件生成 WCF 服务协定。

为入站操作生成 WCF 服务协定

  1. 在 Visual Studio 解决方案资源管理器中，右键单击项目，然后单击“添加适配器服务引用”。

  2. “ 添加适配器服务引用 ”对话框打开后，请按照在 Visual Studio 中检索 Oracle 电子商务套件操作的元数据 中的步骤连接到 Oracle 电子商务套件。 连接到 Oracle 电子商务套件时，可能需要设置多个绑定属性和 URI 属性。

  3. 连接到 Oracle 电子商务套件后，从“选择合同类型”下拉列表中选择“服务 (入站操作) ”。

  4. 在 “选择类别 ”框中，浏览到要为其生成服务协定的入站操作。 例如，对于“通知操作”，单击根节点 (/) ，从“可用类别和操作”框中选择“通知”，然后单击“添加”。 有关如何浏览入站操作的说明，请参阅 浏览、搜索和检索 Oracle 电子商务套件操作的元数据。

  5. 若要为操作生成 WCF 服务协定，请单击“ 确定”。

    添加适配器服务引用插件将三个文件添加到项目中：

  • OracleEBSBindingInterface.cs。 此文件包含生成的 WCF 服务协定 (接口) 和入站操作的帮助程序代码。

  • OracleEBSBindingService.cs。 此文件包含实现 OracleDBBindingInterface.cs 中定义的接口的类。 可以实现处理入站操作返回的记录的业务逻辑。

  • app.config。此文件包含绑定配置、终结点行为和服务终结点配置，这些配置基于在为添加适配器服务引用插件配置绑定和连接时所做的选择。

    重要

    使用“添加适配器服务参考 Visual Studio 插件”时，如果未为字符串类型的绑定属性指定值，并且其默认值为 null，则该绑定属性在 app.config 文件中不可用。 如果需要，必须在 app.config 文件中手动添加绑定属性及其值。

使用 svcutil.exe 生成 WCF 客户端类或 WCF 服务协定

可以使用 svcutil.exe 为应用程序生成 WCF 客户端类或 WCF 服务接口。 必须配置 svcutil.exe 才能将其与 Oracle 电子商务适配器配合使用。

Svcutil.exe 在输出文件中生成 WCF 客户端类或 WCF 服务协定。 默认文件名为 output.cs。 必须在 Visual Studio 项目中手动包含此文件。 有关 svcutil.exe 的详细信息，请参阅 https://go.microsoft.com/fwlink/?LinkId=139432。