Generación de un cliente WCF o un contrato de servicio WCF para artefactos de solución de SAP
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 SAP. También puede usar la Herramienta de utilidad de metadatos de ServiceModel (svcutil.exe) para generar la clase de cliente WCF o el contrato de servicio WCF; sin embargo, el complemento Agregar referencia de servicio de 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 al sistema SAP.
Generación de una clase de cliente mediante el complemento Agregar referencia de servicio de adaptador
Realice los pasos siguientes para generar una clase de cliente WCF mediante el complemento Agregar referencia de servicio de adaptador.
Para generar una clase de cliente WCF
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.
Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador , siga los pasos descritos en Obtener metadatos para operaciones de SAP en Visual Studio para conectarse al sistema SAP 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).
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:
SAPBindingClient.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. La configuración se basa en las selecciones realizadas al configurar el enlace y la conexión para el complemento Agregar referencia del servicio de adaptador.
Importante
Al usar el complemento Agregar referencia de servicio de adaptador, 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 de servicio de adaptador
Cuando se usa el adaptador de SAP para recibir IDC, RFC y TRFC desde el sistema SAP, el código actúa como un servicio para el adaptador. Es decir, el adaptador recibe el artefacto adecuado del sistema SAP y, a continuación, invoca una operación (entrante) en el código para entregar el artefacto a la aplicación.
Por lo tanto, debe implementar un servicio WCF que pueda recibir esta operación de entrada del adaptador. Para ello, use el complemento Agregar referencia de servicio de adaptador para generar una interfaz de .NET que represente el contrato de servicio que muestra el adaptador para la operación. Esta interfaz de .NET también se denomina contrato de servicio WCF. El complemento Add Adapter Service Reference también genera una clase que contiene una implementación de código auxiliar del servicio WCF. A continuación, implemente esta interfaz para crear el servicio WCF que puede usar para recibir la operación.
Realice los pasos siguientes para generar un contrato de servicio WCF mediante el complemento Agregar referencia de servicio de adaptador.
Para generar un contrato de servicio WCF
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.
Una vez que se abra el cuadro de diálogo Agregar referencia de servicio de adaptador , siga los pasos descritos en Obtener metadatos para operaciones de SAP en Visual Studio para conectarse al sistema SAP y examinar y buscar operaciones. Para crear un contrato de servicio WCF para las operaciones que seleccione, asegúrese de que servicio (operaciones entrantes) esté seleccionado en la lista desplegable Seleccionar tipo de contrato .
Después de seleccionar todas las operaciones de destino, haga clic en Aceptar para generar el contrato de servicio WCF.
El complemento Agregar referencia de servicio de adaptador agrega tres archivos al proyecto:
SAPBindingInterface.cs. Este archivo contiene el contrato de servicio WCF generado (interfaz) y el código auxiliar para las operaciones que seleccionó.
SAPBindingService.cs. Este archivo contiene una clase de servicio WCF con código auxiliar que implementa la interfaz definida en SAPBindingInterface.cs. Puede implementar la lógica de negocios que procesa rfC, tRFC o IDOC directamente en los métodos de esta clase.
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 de servicio de adaptador.
Importante
Al usar el complemento Agregar referencia de servicio de adaptador, 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.
Nota
No es necesario especificar los parámetros del servidor RFC al configurar el URI de conexión para el complemento Agregar referencia de servicio de adaptador para generar el contrato de servicio WCF. El adaptador de SAP recupera los metadatos del sistema SAP a través de una conexión de cliente.
Generar una clase de cliente WCF o un contrato de servicio WCF mediante svcutil.exe
Puede usar svcutil.exe para generar una clase de cliente WCF o un contrato de servicio WCF para la aplicación. Debe configurar svcutil.exe para usarlo con el adaptador de SAP. Para obtener más información sobre cómo configurar y usar svcutil.exe con el adaptador de SAP, vea Usar la herramienta de utilidad de metadatos serviceModel con el adaptador de BizTalk para mySAP Business Suite.
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.
Consulte también
Desarrollo de aplicaciones DE SAP con el modelo de canal WCF