Compartir a través de

Generación de un cliente WCF o un contrato de servicio WCF para artefactos de soluciones de Oracle E-Business Suite

  • Artículo

Puede usar el complemento Agregar referencia de servicio de adaptador de Visual Studio para generar una clase de cliente WCF o un contrato de servicio WCF (interfaz) destinado a las operaciones seleccionadas en artefactos de Oracle E-Business Suite. También puede usar la Herramienta de utilidad de metadatos serviceModel (svcutil.exe) para generar la clase de cliente WCF o el contrato de servicio WCF; Sin embargo, el complemento Agregar referencia del servicio adaptador expone la funcionalidad de la herramienta de utilidad de metadatos serviceModel a través de una interfaz estándar de Microsoft Windows. También proporciona funcionalidades de búsqueda y exploración que no están disponibles con la herramienta de svcutil.exe y genera un archivo de configuración basado en las propiedades de enlace que seleccione al conectarse a Oracle E-Business Suite.

Generación de una clase de cliente mediante el complemento agregar referencia del servicio adaptador

Realice los pasos siguientes para generar una clase de cliente WCF mediante el complemento Agregar referencia del servicio adaptador.

Para generar una clase de cliente WCF

  1. En Visual Studio Explorador de soluciones, haga clic con el botón derecho en el proyecto y, a continuación, haga clic en Agregar referencia de servicio de adaptador.

  2. Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador , siga los pasos descritos en Recuperación de metadatos para operaciones de Oracle E-Business Suite en Visual Studio para conectarse a Oracle E-Business Suite y examinar y buscar operaciones. Para crear una clase de cliente WCF para las operaciones que seleccione, asegúrese de que el cliente (operaciones salientes) esté seleccionado en la lista desplegable Seleccionar tipo de contrato (este es el valor predeterminado).

  3. Después de seleccionar todas las operaciones de destino, haga clic en Aceptar para generar la clase de cliente WCF.

    El complemento Agregar referencia de servicio de adaptador agrega dos archivos al proyecto:

  • OracleEBSBindingClient.cs. Este archivo contiene la clase de cliente WCF generada y el código auxiliar para las operaciones que seleccionó.

  • app.config. Este archivo contiene una configuración de enlace y configuraciones de punto de conexión de cliente. Estas configuraciones se basan en las selecciones realizadas al configurar el enlace y la conexión para el complemento Agregar referencia del servicio adaptador.

    Importante

    Al usar el complemento Agregar referencia del servicio adaptador de Visual Studio, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo app.config. Debe agregar manualmente la propiedad de enlace y su valor en el archivo app.config, si es necesario.

Generación de un contrato de servicio WCF mediante el complemento Agregar referencia del servicio adaptador

El adaptador expone operaciones entrantes para permitir que Oracle E-Business Suite envíe mensajes a un cliente de adaptador. Para estas operaciones, debe generar un contrato de servicio WCF. En esta sección se proporciona información sobre cómo generar un contrato de servicio para las operaciones entrantes expuestas por el adaptador.

Realice los pasos siguientes para generar un contrato de servicio WCF mediante el complemento Agregar referencia del servicio adaptador.

Para generar un contrato de servicio WCF para las operaciones entrantes

  1. En Visual Studio Explorador de soluciones, haga clic con el botón derecho en el proyecto y, a continuación, haga clic en Agregar referencia de servicio de adaptador.

  2. Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador , siga los pasos descritos en Recuperación de metadatos para operaciones de Oracle E-Business Suite en Visual Studio para conectarse a Oracle E-Business Suite. Hay varias propiedades de enlace y una propiedad URI que puede establecer al conectarse a Oracle E-Business Suite.

  3. Después de conectarse a Oracle E-Business Suite, seleccione Servicio (operaciones de entrada) en la lista desplegable Seleccionar tipo de contrato .

  4. En el cuadro Seleccionar una categoría , vaya a la operación de entrada para la que desea generar el contrato de servicio. Por ejemplo, para la operación notificación , haga clic en el nodo raíz (/), seleccione Notificación en el cuadro Categorías y operaciones disponibles y, a continuación, haga clic en Agregar. Para obtener instrucciones sobre cómo buscar operaciones entrantes, consulte Examinar, buscar y recuperar metadatos para las operaciones de Oracle E-Business Suite.

  5. Para generar el contrato de servicio WCF para la operación, haga clic en Aceptar.

    El complemento Agregar referencia del servicio adaptador agrega tres archivos al proyecto:

  • OracleEBSBindingInterface.cs. Este archivo contiene el contrato de servicio WCF generado (interfaz) y el código auxiliar para la operación entrante.

  • OracleEBSBindingService.cs. Este archivo contiene una clase que implementa la interfaz definida en OracleDBBindingInterface.cs. Puede implementar la lógica de negocios que procesa los registros devueltos por la operación entrante.

  • app.config. Este archivo contiene una configuración de enlace, comportamientos de punto de conexión y configuración de punto de conexión de servicio que se basan en las selecciones realizadas al configurar el enlace y la conexión para el complemento Agregar referencia del servicio adaptador.

    Importante

    Al usar el complemento Agregar referencia del servicio adaptador de Visual Studio, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo app.config. Debe agregar manualmente la propiedad de enlace y su valor en el archivo app.config, si es necesario.

Usar svcutil.exe para generar una clase de cliente WCF o un contrato de servicio WCF

Puede usar svcutil.exe para generar una clase de cliente WCF o una interfaz de servicio WCF para la aplicación. Debe configurar svcutil.exe para usarlo con el adaptador de Oracle E-Business.

Svcutil.exe genera la clase de cliente WCF o el contrato de servicio WCF en un archivo de salida. El nombre de archivo predeterminado es output.cs. Debe incluir manualmente este archivo en el proyecto de Visual Studio. Para obtener más información sobre svcutil.exe, vea https://go.microsoft.com/fwlink/?LinkId=139432.