Herramienta del editor de configuración (SvcConfigEditor.exe)

El editor de configuración de servicio Windows Communication Foundation (WCF) permite a los administradores y programadores crear y modificar la configuración para WCF mediante una interfaz gráfica de usuario. Con esta herramienta puede administrar los valores para los enlaces, comportamientos, servicios y diagnósticos WCF sin tener que editar directamente los archivos de configuración XML.

El editor de configuración de WCF

El editor de configuración de servicio viene con un asistente que lo guía a través de todos los pasos para configurar un servicio o cliente WCF. Se le aconseja encarecidamente que utilice directamente el asistente en lugar del editor.

Si ya tiene algunos archivos de configuración que obedecen al esquema estándar de System.Configuration, puede administrar valores concretos para enlaces, comportamiento, servicios y diagnósticos mediante la interfaz de usuario. El editor de configuración de servicio le permite administrar los valores para los archivos de configuración WCF existentes, así como archivos ejecutables, servicios de COM+ y servicios hospedados en Web.

Dado que la configuración WCF se encuentra en la sección <system.serviceModel> del archivo de configuración, el editor actúa exclusivamente sobre el contenido de este elemento y no accede a otros elementos del mismo archivo.

Puede navegar directamente a archivos de configuración existentes o puede seleccionar un ensamblado que contenga un servicio, un directorio virtual o un servicio de COM+. El editor carga el archivo de configuración para ese servicio particular y permite que el usuario agregue elementos nuevos o modifique elementos existentes anidados en la sección <system.serviceModel> del archivo de configuración.

El editor admite IntelliSense y exige la compatibilidad del esquema. Se garantiza que el resultado obtenido es compatible con el esquema del archivo de configuración y tiene valores de datos sintácticamente correctos. Sin embargo, el editor no garantiza que el archivo de configuración sea semánticamente válido. En otras palabras, el editor no garantiza que el archivo de configuración pueda funcionar con el servicio que configura.

Precaución:

El editor no puede purgar un elemento de configuración a partir del archivo de configuración cuando ha modificado el elemento. Por ejemplo, si utiliza el editor para establecer el nombre de extremo en una cadena que no esté vacía y guardarlo, el archivo de configuración tendrá el contenido siguiente: <endpoint binding="basicHttpBinding" name="somename" /> Si intenta quitar el nombre estableciéndolo en una cadena vacía y guardar el archivo, el archivo de configuración todavía contendrá el atributo name: <endpoint binding="basicHttpBinding" name="" /> Para purgar el atributo, debe modificar manualmente el elemento mediante otro editor de texto. Debería tener mucho cuidado con este problema al utilizar el elemento issueToken del comportamiento de extremo clientCredential. Específicamente, el atributo address de su subelemento localIssuer no debe ser una cadena vacía. Si ha modificado el atributo address mediante el editor de configuración y desea quitarlo completamente, debería hacerlo utilizando una herramienta diferente del editor. De lo contrario, el atributo contendrá una cadena vacía y su aplicación iniciará una excepción.

Utilización del editor de configuración

El editor de configuración de servicio se puede encontrar en la siguiente ubicación de instalación de Windows SDK

C:\Archivos de Programa\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe

Después de iniciar el editor de configuración de servicio, puede utilizar el menú Archivo/Abrir para buscar el servicio o ensamblado que desea administrar. Puede abrir directamente los archivos de configuración, busque WCF /servicios COM + y abra los archivos de configuración para servicios hospedados en Web.

La interfaz de usuario del editor de configuración de servicio está dividida en las áreas siguientes:

• Panel Ver árbol, que muestra los elementos de configuración en una estructura de árbol. Puede realizar operaciones en el árbol haciendo clic con el botón secundario en los nodos.
• Panel de tareas, que muestra las tareas comunes para los elementos vigentes.
• Panel Detalle, que muestra valores detallados del nodo de configuración seleccionado en Ver árbol.

Abrir un archivo de configuración

1. Utilice una ventana de comandos para navegar a la ubicación de instalación WCF y, a continuación, escriba SvcConfigEditor.exe para iniciar el editor de configuración de servicio.
2. En el menú Archivo, seleccione Abrir y haga clic en el tipo de archivo que desee administrar.
3. En el cuadro de diálogo Abrir, vaya al archivo concreto que desea administrar y haga doble clic en él.

El visor sigue automáticamente la ruta de acceso de combinación de configuración y crea una vista de la configuración combinada. Por ejemplo, la configuración real de un servicio no hospedado es una combinación de Machine.config y App.config. Cualquier cambio se aplica al archivo activo en SvcConfigEditor. Si desea modificar un archivo concreto en la ruta de acceso de combinación de configuración, debería abrirlo directamente.

Servicios

El nodo Servicios muestra todos los servicios asignados actualmente en el archivo de configuración. Cada subnodo en el árbol corresponde a un subelemento del elemento <services> en el archivo de configuración.

Al hacer clic en el nodo Servicios, puede ver o realizar tareas en la página de resumen del servicio, en el panel Detalle.

Crear una nueva configuración de servicio

Puede crear una nueva configuración de servicio de las maneras siguientes:

• Mediante un Asistente: haga clic en Crear un nuevo servicio… en el panel de tareas o en la página de resumen para iniciar el Asistente. También puede hacer esto en el menú Archivo -> Agregar nuevo elemento.
• Crear manualmente: puede hacer clic con el botón secundario en el nodo Servicios y seleccionar Nuevo servicio.

Crear una nueva configuración de extremo de servicio

Puede crear una nueva configuración de extremo de servicio de las maneras siguientes:

• Mediante un Asistente: haga clic en el vínculo Crear un nuevo extremo de servicio... en el panel de tareas o en la página de resumen para iniciar el Asistente. También puede hacer esto en el menú Archivo> - Agregar nuevo elemento.
• Crear manualmente: cuando cree un servicio, puede hacer clic con el botón secundario en el nodo Extremos y seleccionar “Nuevo extremo de servicio”.

Editar una configuración de servicio

1. Haga clic en un nodo Servicio.
2. Edite la configuración en la cuadrícula de propiedades.

Editar una configuración de extremo de servicio

1. Haga clic en un nodo Extremo de Servicio.
2. Editar la configuración en las cuadrículas de propiedad.

Agregar una dirección base

1. Haga clic en el nodo Host.
2. Haga clic en el botón Nuevo... en la sección Direcciones base.
3. Escriba el URI de la dirección base en el cuadro de diálogo.
4. Haga clic en Aceptar.

Nota: no puede modificar el valor de <baseAddressPrefixFilters> dentro de esta herramienta. Para agregar o modificar este elemento, debe utilizar un editor de texto o Visual Studio.

Cliente

El nodo Cliente muestra todos los extremos de cliente en el archivo de configuración. Cada subnodo en el árbol corresponde a un subelemento del elemento <client> en el archivo de configuración.

Al hacer clic en el nodo Cliente, puede ver o realizar tareas en la Página de resumen del cliente, en el Panel Detalle.

Crear una nueva configuración de extremo de cliente

Puede crear una nueva configuración de extremo de cliente de las maneras siguientes:

• Crear a través de Asistente: haga clic en el vínculo Crear nuevo cliente..., en el Panel de tareas o en la Página de resumen para iniciar el Asistente. También puede hacer esto en el menú Archivo> - Agregar nuevo elemento.
• Crear manualmente: haga clic con el botón secundario en el nodo Extremos, en Cliente, y seleccione Nuevo extremo de cliente.

Editar una configuración de extremo de cliente

1. Haga clic en un nodo Extremo de cliente.
2. Editar la configuración en las cuadrículas de propiedad.

Enlace

Las configuraciones de enlace se utilizan para configurar enlaces en extremos. Esas configuraciones están almacenadas en el nodo Enlace. Los extremos hacen referencia a las configuraciones de enlace por nombre y varios extremos pueden hacer referencia a una configuración de enlace única.

El nodo Enlaces muestra todos los valores de enlace en el archivo de configuración. Cada subnodo en el árbol corresponde a un subelemento del elemento <bindings> en el archivo de configuración.

Al hacer clic en el nodo Enlaces, puede ver o realizar tareas en la Página de resumen de enlaces, en el Panel Detalle.

Crear una nueva configuración de enlace

Puede crear una nueva configuración de enlace de las maneras siguientes.

• Haga clic con el botón secundario en el nodo Enlaces y seleccione Nueva configuración de enlace. Seleccione el tipo de enlace en el cuadro de diálogo y haga clic en Aceptar.
• Seleccione el nodo Enlaces y haga clic en Nueva configuración de enlace... en el Panel de tareas.
• En el servicio o página de resumen del cliente, haga clic en Haga clic para crear en el campo Configuración de enlace para crear una configuración de enlace para el extremo correspondiente.

Agregar extensiones de elemento de enlace a un enlace personalizado

1. Seleccione el enlace al que desea agregar un elemento de extensión.
2. Haga clic en Agregar.
3. De la lista de extensiones disponibles, seleccione la extensión de elemento de enlace que desea agregar. Puede seleccionar varios elementos presionando simultáneamente la tecla CTRL.
4. Haga clic en Agregar.

Ajustar la posición de la extensión en un enlace personalizado

Un enlace personalizado es una colección de elementos de enlace que forman una pila. Cada elemento de enlace en la pila tiene su propia configuración. El orden de las extensiones de elemento de enlace en un enlace personalizado indica sus posiciones en la pila. Se aplican primero los elementos de la parte superior de la pila. Para cambiar el orden,

1. Seleccione el nodo de enlace personalizado.
2. Seleccione un elemento de extensión de enlace en la sección Posición de extensión de elemento de enlace.
3. Utilice los botones “Arriba” o “Abajo” en el lado izquierdo de la lista para cambiar la posición del elemento seleccionado.

Editar la configuración de extensiones de elemento de enlace en un enlace personalizado

1. Seleccione el nodo de enlace en el árbol
2. Seleccione el enlace personalizado que contiene el elemento que desea editar
3. Seleccione la extensión de elemento de enlace que desea editar. La configuración del elemento aparece en el panel derecho, donde se puede editar.

Comportamientos

El nodo Comportamientos muestra los comportamientos que se definen actualmente en el archivo de configuración.

Las configuraciones de comportamiento se utilizan para configurar comportamientos de extremos y servicios. Tal configuración está almacenada en el nodo Opciones avanzadas, bajo Comportamientos de servicio y Comportamientos de extremo. Los servicios utilizan comportamientos de servicios; pero los extremos utilizan comportamientos de extremo.

Los comportamientos son una colección de elementos de extensión que forman una pila. Se aplica primero el elemento en la parte superior de la pila. Cada elemento de extensión puede tener su propia configuración.

Crear una nueva configuración de comportamiento

Puede crear una nueva configuración de comportamiento de dos maneras:

• Haga clic con el botón secundario en uno de los nodos de comportamiento y seleccione “Nueva configuración de comportamiento...
• Seleccione uno de los nodos de comportamiento y haga clic en Nueva configuración de comportamiento..., en el Panel de tareas.

Agregar las extensiones de elemento de comportamiento a un comportamiento

1. Seleccione uno de los nodos de comportamiento.
2. Seleccione el comportamiento que desee editar.
3. Haga clic en Agregar.
4. De la lista de extensiones disponibles, seleccione la extensión de elemento de comportamiento que desea agregar.
5. Haga clic en Agregar.

Ajustar la posición de la extensión en un comportamiento

Los comportamientos son colecciones de elementos que forman una pila. Cada elemento de la pila tiene su propia configuración. El orden de las extensiones de elemento de comportamiento en un comportamiento indica sus posiciones en la pila. Se aplican primero los elementos de la parte superior de la pila. Para cambiar el orden:

1. Seleccione uno de los nodos de comportamiento.
2. Seleccione el comportamiento que desee editar.
3. Seleccione un elemento de extensión de comportamiento en la sección Posición de extensión de elemento de comportamiento.
4. Utilice los botones Arriba o Abajo en el lado izquierdo de la lista para cambiar la posición del elemento seleccionado.

Editar la configuración de extensiones de elemento de comportamiento

1. Seleccione uno de los nodos de comportamiento del árbol.
2. Seleccione el comportamiento que contiene el elemento que desea editar.
3. Seleccione la extensión de elemento de comportamiento que desea editar. La configuración del elemento aparece en el panel derecho, donde se puede editar.

Extensiones

Las nuevas extensiones de enlace, extensiones de elemento de enlace y extensiones de comportamiento se pueden registrar para su uso en la configuración WCF. Las extensiones son pares de nombre/tipo. El nombre define el nombre de la extensión en la configuración, mientras que el tipo implementa la extensión. Hay tres tipos de extensiones:

• Las extensiones de enlace definen un tipo entero de enlace. Ejemplo: basicHttpBinding.
• Las extensiones de elemento de enlace definen un elemento de un enlace. Ejemplo: textMessageEncoding.
• Las extensiones de elemento de comportamiento definen un elemento de un comportamiento. Ejemplo: clientVia.

Las extensiones registradas en configuración se pueden utilizar como cualquier otro componente WCF del mismo tipo.

Agregar una nueva extensión

Seleccione uno de los nodos de extensión en los nodos avanzados:

1. Haga clic en Nuevo.
2. Escriba un nombre y tipo.
3. Haga clic en Aceptar.
4. La extensión aparece ahora en el lugar adecuado en el editor. Por ejemplo, si agrega una extensión de elemento de comportamiento, aparece en la lista de extensiones disponibles.

Diagnósticos

El nodo Diagnósticos muestra toda la configuración de diagnóstico en el archivo de configuración. Le permite activar o desactivar contadores de rendimiento, habilitar o deshabilitar el Instrumental de administración de Windows (WMI) y configurar el seguimiento WCF y el registro de mensajes WCF. La configuración en el nodo Diagnósticos corresponde a la sección <system.diagnostics> y a la sección <diagnostics> en <system.serviceModel>, en el archivo de configuración.

Al hacer clic en el nodo Diagnósticos, puede ver o realizar tareas en la Página de resumen de diagnósticos, en el Panel Detalle.

Configurar contadores de rendimiento y WMI

1. Haga clic en el nodo Diagnósticos.
2. Haga clic en Alternar contadores de rendimiento. El contador de rendimiento tiene tres estados: Apagado (valor predeterminado), ServiceOnly y todos. Al hacer clic en el vínculo, se alterna el valor entre estos tres estados.

Configurar proveedor de WMI

1. Haga clic en el nodo Diagnósticos.
2. Para habilitar un proveedor de WMI, haga clic en el vínculo Habilitar proveedor de WMI.

Habilitar el seguimiento WCF

Puede crear un archivo de seguimiento WCF con propiedades estándar o configurar un archivo de seguimiento personalizado.

1. Haga clic en el nodo Diagnósticos.
2. Haga clic en Habilitar seguimiento.
3. Haga clic en el vínculo Nivel de seguimiento para ajustar el nivel de seguimiento. Hay seis niveles de seguimiento: apagado, crítico, error, advertencia, información y detallado. Las opciones Seguimiento de actividad y Propagar actividad le permiten utilizar la característica de seguimiento de actividad WCF.
4. Haga clic en el nombre de agente de escucha de seguimiento para especificar el archivo y las opciones de seguimiento.

Habilitar el registro de WCF

Puede crear un archivo de seguimiento WCF con propiedades estándar o configurar un archivo de seguimiento personalizado.

1. Haga clic en el nodo Diagnósticos.
2. Haga clic en Habilitar registro de mensajes.
3. Haga clic en el vínculo Nivel de registro para ajustar el nivel del registro. Hay tres niveles de registro: incorrecto, servicio y transporte.
4. Haga clic en el nombre de agente de escucha para especificar el archivo y las opciones de registro.

La Página de resumen de diagnósticos le permite realizar las tareas más comunes de configuración de diagnósticos. Sin embargo, si desea editar manualmente la configuración de agentes de escucha y orígenes, debe expandir el nodo Diagnósticos y editar la configuración en los nodos Registro de mensajes, Agentes de escucha y Orígenes.

Habilitar seguimiento personalizado o registro de mensajes de WCF

1. Haga clic en el nodo Diagnósticos y expándalo.
2. Haga clic con el botón secundario en el nodo Agentes de escucha y seleccione Nuevo agente de escucha.
3. Escriba el nombre del archivo de seguimiento en el campo InitData. Puede hacer clic en el botón "..." para ir a una ruta de acceso.
4. Al hacer clic en la línea TypeName aparece un botón "...". Haga clic en este botón para abrir el Explorador de tipo de agente de escucha de seguimiento, que puede utilizar para buscar agentes de escucha de seguimiento preconfigurados que ya están instalados.
5. Tenga en cuenta la sección Origen. Haga clic en Agregar en esta sección para abrir un cuadro de diálogo con un menú desplegable, que contiene una lista de orígenes de seguimiento disponibles. Seleccione un origen de seguimiento y haga clic en Aceptar.
6. Para editar los valores del registro de mensajes, haga clic en el nodo Registro de mensajes. Puede editar los valores en la cuadrícula de propiedad.

Crear un archivo de configuración mediante el asistente

Una forma de crear un archivo de configuración nuevo es utilizar el Asistente para nuevo elemento de servicio. El Asistente busca los tipos de servicio instalados y otros elementos compatibles con WCF en el equipo, incluidos directorios COM+ y directorios virtuales hospedados en Web, y los carga para que la creación de la configuración sea más simple.

Crear un archivo de configuración

1. Utilice una ventana de comandos para navegar a la ubicación de instalación WCF y, a continuación, escriba SvcConfigEditor.exe para iniciar el editor de configuración de servicio.
2. En el menú Archivo, seleccione Abrir y haga clic en Ejecutable, **Servicio COM+**o Servicio hospedado en Web, según el tipo de archivo de configuración que desee crear.
3. En el cuadro de diálogo Abrir, vaya al archivo concreto para el que desea crear un archivo de configuración y haga doble clic en él.
4. En el menú Archivo, señale Agregar nuevo elemento y haga clic en Servicio. Se abre el Asistente para nuevo elemento de servicio.
5. Siga los pasos en el asistente para crear el nuevo servicio.

Configurar COM+

El editor de configuración de servicio le permite crear un nuevo archivo de configuración para una aplicación COM+ existente o editar una configuración COM+ existente. El nodo Contrato COM sólo es visible cuando la sección <comContract> está en el archivo de configuración.

Crear una nueva configuración de COM+

Antes de crear una nueva configuración de COM+, asegúrese de que su aplicación COM+ esté instalada en servicios de componente y registrada en la caché de ensamblados global (GAC).

1. Seleccione el menú Archivo -> Integrar -> Aplicación COM+. Esta operación cierra el archivo abierto actual. Si hay datos no guardados en el archivo actual, aparece el cuadro de diálogo Guardar. Se inicia el Asistente de integración de COM+ a continuación.
2. En la primera página, seleccione la aplicación COM+ del árbol. Si no encuentra su aplicación COM+ en el árbol, compruebe que está instalada en los servicios de componente y registrada en la caché de ensamblados global (GAC).
3. En la página siguiente, seleccione qué método(s) quiere exponer como servicios WCF. Todos los métodos compatibles en la aplicación COM+ se muestran y se seleccionan de forma predeterminada.
4. Elija un método de hospedaje.
5. Configure otros valores según las guías en el asistente.
6. El editor de configuración de servicio utiliza en segundo plano ComSvcConfig.exe para generar un archivo de configuración. Después de este paso, puede ver un resumen y salir del Asistente. Se abre el archivo de configuración generado para que pueda editarlo directamente.

Modificar una configuración COM+ existente

1. Seleccione el menú Archivo ->Abrir -> Servicio COM+.

2. Seleccione de la lista el servicio COM+ que desea modificar.

3. Modifique la configuración en el nodo Contratos COM.

   Nota

   También puede abrir directamente un archivo de configuración que contenga contratos COM+ y modificarlo.

Seguridad

No se garantiza que un archivo de configuración de servicio generado por el editor de configuración sea seguro. Consulte la documentación Windows Communication Foundation Security para averiguar cómo proteger sus servicios WCF.

Además, el editor de configuración sólo se puede utilizar para leer y escribir elementos de configuración WCF válidos. La herramienta omite los elementos conformes a esquema definidos por el usuario. Tampoco intenta quitar estos elementos del archivo de configuración o determinar sus efectos sobre los elementos WCF conocidos. Es la responsabilidad del usuario determinar si estos elementos suponen una amenaza para la aplicación o el sistema.