Cliente de prueba de WCF (WcfTestClient.exe)

El cliente de prueba de Windows Communication Foundation (WCF) (WcfTestClient.exe) es una herramienta de interfaz gráfica de usuario (GUI) que permite a los usuarios especificar parámetros de prueba, enviar esa entrada al servicio y ver la respuesta que éste devuelve. Proporciona un servicio de prueba sin problemas cuando se combina con el host de servicio WCF.

Escenarios para utilizar el cliente de prueba

En las secciones siguientes se discuten los escenarios más comunes en los que puede utilizar el cliente de prueba WCF para hacer su proceso de desarrollo más eficiente.

Descripción general de Visual Studio

El host de servicio de WCF inicia el cliente de prueba de WCF con un servicio único

Después de crear un nuevo proyecto de servicio WCF y presionar F5 para iniciar el depurador, el host de servicio WCF empieza a hospedar el servicio en su proyecto. Entonces, el cliente de prueba WCF se abre automáticamente y muestra una lista de extremos de servicio definidos en el archivo de configuración. Puede probar los parámetros e invocar el servicio y repetir este proceso para probar y validar su servicio de forma continuada.

El host de servicio de WCF inicia el cliente de prueba de WCF con varios servicios

También puede usar el cliente de prueba de WCF como ayuda para depurar un proyecto de servicio que contiene varios servicios. Cuando el cliente de prueba WCF se abre, recorre automáticamente en iteración la lista de servicios de su proyecto y los abre para probarlos.

Fuera de Visual Studio

También puede invocar el cliente de prueba de WCF (WcfTestClient.exe) fuera de Visual Studio para probar un servicio arbitrario en Internet. Para encontrar la herramienta, vaya a la ubicación siguiente:

C:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\

Para usar la herramienta, haga doble clic en el nombre de archivo para abrirlo desde esta ubicación o inicíela desde una línea de comandos.

El cliente de prueba de WCF toma un número arbitrario de URI como argumentos de la línea de comandos. Se trata de los URI de los servicios que se pueden probar.

wcfTestClient.exe URI1 URI2 …

Una vez abierta la ventana del cliente de prueba de WCF, haga clic en Archivo->Agregar servicio y escriba la dirección del extremo del servicio que desea abrir.

Interfaz de usuario del cliente de prueba de WCF

Puede utilizar el cliente de prueba WCF con un servicio único o con varios servicios.

Operaciones del servicio

El panel izquierdo de la ventana principal del cliente de prueba WCF hace una lista de todos los servicios disponibles, junto con sus extremos y operaciones respectivos.

Al hacer doble clic en una operación, puede ver su contenido en el panel derecho dentro de una nueva ficha con el nombre de la operación.

El panel izquierdo también hace una lista de los archivos de configuración del cliente. Haga doble clic en cualquiera de los elementos para mostrar el contenido del archivo en una nueva ventana con fichas en el panel derecho.

Introducir parámetros de prueba

Para ver los parámetros de prueba, haga doble clic en una operación para abrirla en el panel derecho y, a continuación, haga clic en Con formato. Para ver el XML del mensaje, haga clic en XML. Al hacer clic en Con formato, puede especificar valores arbitrarios para los parámetros para probar el servicio. Para enviarlos al servicio, haga clic en Invocar.

La respuesta del servicio aparece debajo de los parámetros de pruebas.

Si especificó una operación determinada como unidireccional cuando creó el contrato para el servicio, no se mostrará ninguna respuesta del servicio. En cuanto el mensaje se ponga en la cola para la entrega, se abrirá un cuadro de diálogo para notificarle que el mensaje se envió correctamente.

Compatibilidad de sesión

La casilla Iniciar nuevo proxy de la ficha de una operación de servicio permite alternar la compatibilidad de la sesión. La casilla está desactivada de forma predeterminada.

Si escribe los parámetros de prueba de una operación concreta (u otra operación en el mismo extremo de servicio) y hace clic varias veces en Invocar con la casilla desactivada, estas operaciones comparten un proxy y el estado del servicio se conserva entre varias operaciones.

Si se activa la casilla Iniciar nuevo proxy, se inicia un nuevo proxy con cada invocación, el escenario de la sesión anterior finaliza y se restablece el estado del servicio.

Edición de la configuración del cliente

El panel izquierdo de la ventana principal del cliente de prueba WCF hace una lista de los archivos de configuración del cliente. Haga doble clic en cualquiera de los elementos para mostrar el contenido del archivo en el panel derecho.

Edición con el Editor de configuración de servicios

Haga clic con el botón secundario en Archivo de configuración en el panel izquierdo y seleccione Editar con SvcConfigEditor en el menú contextual. El Editor de configuración de servicios se inicia con el contenido de la configuración del cliente. Puede editar la configuración y guardarla dentro de la herramienta.

Después de guardar el archivo en el Editor de configuración de servicios, el cliente de prueba de WCF muestra un mensaje de advertencia para informarle de que el archivo se ha modificado fuera y pregunta si desea volver a cargarlo.

Si selecciona Sí, el contenido de configuración de la ficha "Client.dll.config" refleja los cambios que realizó en el editor.

Si selecciona No, el contenido de configuración de la ficha "Client.dll.config" se mantiene sin modificar y el contenido modificado se guarda automáticamente en el archivo de código fuente.

Restauración de la configuración predeterminada

Si desea cancelar todos los cambios y restaurar la configuración predeterminada del cliente, haga clic con el botón secundario en Archivo de configuración en el panel izquierdo y seleccione Restaurar configuración predeterminada en el menú contextual. Se cargará el valor de configuración predeterminado y se restaurará el contenido de la ficha "Client.dll.config".

Validación de los cambios

Cuando se cargan los cambios guardados en el cliente de prueba de WCF, se comprueba la validez de la configuración respecto al esquema de WCF. Si se detectan errores, aparece un cuadro de diálogo con los detalles del error.

Durante la generación de proxies, la compilación de binarios o la invocación de servicios, los elementos de menú que permiten la edición (es decir, "Editar", "Restaurar", etc.) están deshabilitados. La invocación de servicios está también deshabilitada al cargar la configuración actualizada en el cliente de prueba de WCF.

Conservación de la configuración del cliente

La ficha Herramientas->Opciones->Configuración del cliente contiene la opción Volver a generar la configuración siempre cuando se inicien servicios, que está habilitada de forma predeterminada. Esta opción especifica que cada vez que el cliente de prueba de WCF carga un servicio, vuelve a generar un archivo de configuración basado en el último contrato de servicio y en los archivos App.config del servicio.

Si ha editado la configuración del cliente para el servicio de WCF y desea usar siempre este archivo actualizado para depurar el servicio, puede desactivar la opción Volver a generar. Al hacerlo, incluso al actualizar el servicio y volver a abrir el cliente de prueba de WCF, el archivo Client.dll.config es el que actualizó previamente en lugar de uno regenerado a partir del servicio actualizado.

Sin embargo, es posible que necesite modificar el archivo de configuración para que sea coherente con el proxy regenerado. Si el proxy regenerado y el archivo de configuración no coinciden porque se ha actualizado un servicio, se producirán errores cuando se invoque el servicio.

Precaución:
Si modificó el archivo de configuración del cliente y seleccionó su reutilización en el futuro, puede encontrar el archivo en la ubicación siguiente: \Documents and Settings\[cuenta de usuario]\Mis documentos\Test Client Projects. La Lista de control de acceso (ACL) de esta carpeta protege cualquier información de credenciales actualizada almacenada en el archivo de configuración del cliente.

Adición, eliminación y actualización de servicios

Agregar servicio

Haga clic en Archivo->Agregar servicio para agregar un servicio al cliente de prueba de WCF. Después, deberá escribir el URI (dirección del extremo) del servicio que se va a agregar. La dirección del servicio puede ser una dirección mex o WSDL.

También encontrará una lista con los 10 últimos extremos de servicio agregados en el submenú Servicios recientes. Si selecciona uno de ellos, el servicio especificado se agregará al cliente de prueba de WCF.

Para lograr el mismo resultado también puede hacer clic con el botón secundario en la raíz del árbol de servicios Mis proyectos de serviciosy seleccionar Agregar servicio.

Durante la generación de proxies, la compilación de binarios o la invocación de servicios, los elementos de menú que permiten agregar un servicio están deshabilitados. La invocación de servicios también está deshabilitada.

Eliminación de servicios

Haga clic con el botón secundario en la raíz del servicio que desea quitar y seleccione Quitar servicio para quitar un servicio del cliente de prueba de WCF.

Durante la generación de proxies, la compilación de binarios o la invocación de servicios, los elementos de menú que permiten quitar un servicio están deshabilitados. La invocación de servicios también está deshabilitada.

Actualización de servicios

Si se realiza un cambio en el servicio mientras se está ejecutando el cliente de prueba de WCF y desea asegurarse de que la implementación del cliente de prueba de WCF para ese servicio está actualizada, haga clic con el botón secundario en la raíz del servicio y seleccione Actualizar servicio. Observe que, después de actualizar, se restablece el estado del servicio.

Durante la generación de proxies, la compilación de binarios o la invocación de servicios, los elementos de menú que permiten actualizar un servicio están deshabilitados. La invocación de servicios también está deshabilitada.

Ubicación de los archivos generados por el cliente de prueba

De forma predeterminada, el cliente de prueba de WCF almacena el código de cliente generado y los archivos de configuración en la carpeta “%appdata%\Local\temp\Test Client Projects". Esta carpeta se elimina después de cerrar el cliente de prueba de WCF. Si se modifica un archivo de configuración en el cliente de prueba de WCF y la opción Volver a generar la configuración siempre cuando se inicien servicios está deshabilitada, el archivo modificado se copia en la carpeta “Cached Config” de “Mis documentos\Test Client Projects Documents\Test Client Projects” con un archivo XML de asignación (dirección de metadatos a nombre de archivo) a modo de índice.

También puede iniciar el cliente de prueba de WCF en una línea de comandos, usar el modificador /ProjectPath para especificar la nueva ruta de acceso donde desea almacenar los archivos generados o usar el modificador /RestoreProjectPath para restaurar la ubicación predeterminada. La sintaxis es la siguiente:

wcfTestClient.exe /ProjectPath [desired location]

Al ejecutar este comando, no se abre el cliente de prueba de WCF. Sólo cambia la ubicación de la carpeta. Puede ejecutar este comando tanto si el cliente de prueba de WCF se está ejecutando como si no. La nueva ubicación se aplica cuando se reinicia el cliente de prueba de WCF. La información sobre la ubicación se puede guardar en el Registro o en el archivo WcfTestClient.exe.option de la carpeta "%appdata%\Local\temp\Test Client Projects".

Características admitidas por WCF Test Client

En la siguiente lista se muestran las características admitidas por el cliente de prueba de WCF:

• Invocación de servicio: solicitud/respuesta y mensaje unidireccional.
• Enlaces: todos los enlaces admitidos por Svcutil.exe.
• Control de sesión.
• Contrato de mensaje.
• Serialization XML.

En la siguiente lista se muestran las características no admitidas por el cliente de prueba de WCF:

• Tipos: Stream, Message, XmlElement, XmlAttribute, XmlNode, tipos que implementan la interfaz IXmlSerializable, incluido el atributo relacionado XmlSchemaProviderAttribute, y los tipos XDocument y XElement, el tipo DataTable de ADO.NET y el tipo DataSet (así como sus clases derivadas con tipo).
• Contrato dúplex.
• Transacción.
• Seguridad: CardSpace, mediante certificado y mediante nombre de usuario/contraseña.
• Enlaces: WSFederationbinding, cualquier enlace de contexto y enlace HTTPS, WebHttpbinding (compatibilidad con mensajes de respuesta JSON).

Cerrar el cliente de prueba de WCF

El cliente de prueba WCF se puede cerrar de las maneras siguientes:

• En el menú Archivo, haga clic en Salir. Alternativamente, en la ventana principal del cliente de prueba WCF, haga clic en Cerrar. Estas dos acciones también cierran el host de servicio de WCF y detienen el proceso de depuración de Visual Studio si Visual Studio ha iniciado el cliente de prueba de WCF.
• Haga clic con el botón secundario en el icono Host de servicio de WCF en el área de notificación y, a continuación, haga clic en Salir. Esto apaga el host automático de servicio WCF y el cliente de prueba WCF y detiene el proceso de depuración Visual Studio.

Consulte también

Conceptos

Host de servicio WCF (WcfSvcHost.exe)

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.