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

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

El Editor de configuración de servicio se puede encontrar en la carpeta C:\Archivos de programa\Microsoft SDKs\Windows\v6.0\Bin.

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 de 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 de WCF existentes, así como archivos ejecutables, servicios de COM+ y servicios hospedados en web. Cuando se abre un servicio hospedado en web con el Editor de configuración de servicios, se muestran las secciones de configuraciones heredadas de los nodos de nivel superior y la propia configuración del servicio.

Dado que la configuración de 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.

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

Una vez que inicie el Editor de configuración de servicio, podrá utilizar el menú Archivo/Abrir para buscar el servicio o el ensamblado que quiera 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 a la izquierda. 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 en la parte inferior izquierda de la ventana.

• Panel de detalles, que muestra valores detallados del nodo de configuración seleccionado en Ver árbol a la derecha.

Abrir un archivo de configuración

1. Utilice una ventana de comandos para navegar hasta la ubicación de instalación de WCF y, a continuación, escriba SvcConfigEditor.exe para iniciar el Editor de configuración de servicio.

2. En el menú Archivo, seleccione el elemento Abrir y haga clic en el tipo de archivo que desee administrar.

3. En el cuadro de diálogo Abrir, navegue hasta el archivo concreto que desee administrar y haga doble clic en él.

El visor sigue automáticamente la ruta de acceso de fusión mediante 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 consiste en una combinación de los archivos Machine.config y App.config. Los cambios se aplican al archivo que está activo en la herramienta SvcConfigEditor. Si desea modificar un archivo concreto en la ruta de acceso de fusión mediante combinación de configuración, debería abrirlo directamente.

Servicios

En el nodo de Servicios se muestran todos los servicios que están asignados actualmente en el archivo de configuración. Cada subnodo del árbol se corresponde con uno de los subelementos del elemento <services> del archivo de configuración.

Al hacer clic en el nodo de Servicios, podrá visualizar o realizar tareas desde la página de resumen del servicio, que se ubica en el panel Detalles.

Crear una nueva configuración de servicio

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

• Mediante un asistente: para iniciarlo, haga clic en el vínculo Crear un nuevo servicio…, que se ubica en el panel de tareas o en la página de resumen. También puede hacer esto en el menú Archivo ->Agregar nuevo elemento.

• Manualmente: haga clic con el botón secundario en el nodo de Servicios y, después, seleccione el elemento Nuevo servicio.

Crear una nueva configuración de extremo de servicio

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

• Mediante un asistente: para iniciarlo, haga clic en el vínculo Crear un nuevo punto de conexión de servicio..., que se ubica en el panel de tareas o en la página de resumen. También puede hacer esto en el menú Archivo ->Agregar nuevo elemento.

• Manualmente: una vez que haya creado un servicio, podrá hacer clic con el botón secundario en el nodo Puntos de conexión y, después, seleccionar el elemento "Nuevo punto de conexión de servicio".

Editar una configuración de servicio

1. Haga clic en un nodo de Servicio.

2. Edite la configuración en la cuadrícula de propiedades.

Editar una configuración de punto de conexión de servicio

1. Haga clic en un nodo de punto de conexión de servicio.

2. Edite la configuración en la cuadrícula de propiedades.

Agregar una dirección base

1. Haga clic en el nodo de Host.

2. Haga clic en el botón Nuevo… que se ubica 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 OK.

Remoto

En el nodo Cliente, se muestran todos los puntos de conexión de cliente del archivo de configuración. Cada subnodo del árbol se corresponde con uno de los subelementos del elemento <client> del archivo de configuración.

Al hacer clic en el nodo Cliente, podrá visualizar o realizar tareas desde la Página de resumen del cliente, que se ubica en el Panel de detalles.

Crear una nueva configuración de punto de conexión de cliente

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

• Mediante un asistente: para iniciarlo, haga clic en el vínculo Crear un nuevo cliente… del Panel de tareas que se ubica en la parte inferior izquierda de la ventana o, alternativamente, en la Página de resumen. También puede hacer esto en el menú Archivo ->Agregar nuevo elemento. El asistente le pedirá que indique la ubicación de la configuración de servicio, a partir de la cual se genera la configuración del cliente. A continuación podrá elegir el punto de conexión de servicio con el que conectarse.

• Manualmente: haga clic con el botón secundario en el nodo Puntos de conexión, que se ubica en la sección Cliente, y elija el elemento Nuevo punto de conexión de cliente.

Editar una configuración de punto de conexión de cliente

1. Haga clic en un nodo de punto de conexión de cliente.

2. Edite la configuración en la cuadrícula de propiedades.

punto de conexión estándar

Los puntos de conexión estándar son puntos de conexión especializados que tienen uno o más aspectos de la dirección, contrato y enlace definidos en los valores predeterminados.

Estas configuraciones se almacenan en el nodo Punto de conexión estándar. En el nodo Punto de conexión estándar, se muestran todos los valores de punto de conexión estándar que se incluyen en el archivo de configuración. Cada subnodo del árbol se corresponde con uno de los subelementos del elemento <standardEndpoints> del archivo de configuración.

Al hacer clic en el nodo Punto de conexión estándar, podrá visualizar o realizar tareas desde la Página de resumen del punto de conexión estándar, que se ubica en el Panel de detalles.

Crear una nueva configuración de punto de conexión estándar

Puede crear una nueva configuración de punto de conexión estándar de las maneras siguientes:

• Haga clic con el botón secundario en el nodo Punto de conexión estándar y seleccione el elemento Configuración de un nuevo punto de conexión estándar…. A continuación, seleccione el tipo de enlace en el cuadro de diálogo y haga clic en el botón Aceptar.

• Seleccione el nodo Punto de conexión estándar y haga clic en el elemento Configuración de un nuevo punto de conexión estándar… en el Panel de tareas, que se ubica en la parte inferior izquierda de la ventana.

En el cuadro de diálogo Crear un nuevo punto de conexión estándar, se muestran y enumeran todos los tipos de punto de conexión estándar que estén registrados.

Ver y editar una configuración de punto de conexión estándar

Puede abrir una configuración de extremo estándar para verla y editarla de las siguientes maneras:

• Haga clic para expandir el nodo Punto de conexión estándar y, después, haga clic en el subnodo respectivo del punto de conexión.

• Haga clic en el nodo Punto de conexión estándar y, a continuación, haga clic en el punto de conexión respectivo en el Panel de detalles.

Los atributos para el punto de conexión se muestran en el panel derecho para edición.

Eliminar una configuración de punto de conexión estándar

Puede eliminar una configuración de punto de conexión estándar de las maneras siguientes:

• Haga clic para expandir el nodo Punto de conexión estándar y, después, haga clic con el botón secundario en el subnodo respectivo del punto de conexión. Utilice el comando de contexto Eliminar la configuración de un punto de conexión estándar para eliminar el punto de conexión.

• Haga clic en el nodo de punto de conexión estándar. En el panel Tarea, haga clic en Eliminar la configuración de un punto de conexión estándar.

Si el punto de conexión estándar en cuestión está en uso, se mostrará el siguiente mensaje de advertencia al intentar eliminarlo: El punto de conexión estándar está en uso. Si lo elimina ahora, asegúrese de que elimina todas sus referencias en otras partes de la configuración (por ejemplo, en el punto de conexión de servicio o en el punto de conexión de cliente). De lo contrario, la configuración no será válida y no se podrá abrir la próxima vez. ¿Seguro que desea eliminar el punto de conexión estándar?

Enlace

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

En el nodo Enlaces se muestran todos los valores de enlace que se incluyen en el archivo de configuración. Cada subnodo del árbol se corresponde con uno de los subelementos del elemento <bindings> del archivo de configuración.

Al hacer clic en el nodo Enlaces, podrá visualizar o realizar tareas desde la Página de resumen de enlaces, que se ubica en el Panel de detalles.

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 el elemento Nueva configuración de enlace… Seleccione el tipo de enlace en el cuadro de diálogo y, después, haga clic en el botón Aceptar.

• Seleccione el nodo Enlaces y, a continuación, haga clic en el elemento Nueva configuración de enlace… del Panel de tareas, que se ubica en la parte inferior izquierda de la ventana.

• En la página de resumen de servicio o de cliente, haga clic en el elemento Hacer clic para crear, que se ubica en el campo Configuración de enlace, para crear una configuración de enlace para el punto de conexión 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. Para seleccionar varios elementos, presione 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 extensiones del elemento de enlace.

3. Utilice los botones Arriba y Abajo, que se encuentran en el lado izquierdo de la lista, para cambiar la posición del elemento que haya 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.

Diagnóstico

En el nodo de Diagnósticos, se muestran todos los valores de diagnóstico que se ubican en el archivo de configuración. El uso de este nodo le permitirá activar o desactivar contadores de rendimiento, habilitar o deshabilitar el Instrumental de administración de Windows (WMI) y configurar las características de seguimiento y registro de mensajes de WCF. Los valores del nodo de Diagnósticos se corresponden con la sección <system.diagnostics> y con la sección <diagnostics> del elemento <system.serviceModel> del archivo de configuración.

Al hacer clic en el nodo de Diagnósticos, podrá visualizar o realizar tareas desde la Página de resumen de diagnósticos, que se ubica en el Panel de detalles.

Configurar contadores de rendimiento y WMI

1. Haga clic en el nodo de Diagnósticos.

2. Haga clic en el elemento 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 de Diagnósticos.

2. Para habilitar un proveedor WMI, haga clic en el vínculo Habilitar proveedor WMI.

Habilitar la traza WCF

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

1. Haga clic en el nodo de Diagnósticos.

2. Haga clic en el elemento 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 la actividad y Propagar actividad pueden usarse para utilizar la característica de seguimiento de actividad de WCF.

4. Haga clic en el nombre del agente de escucha de traza para especificar el archivo y las opciones de seguimiento.

Habilitar el registro del WCF

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

1. Haga clic en el nodo de Diagnósticos.

2. Haga clic en el elemento Habilitar registro de mensajes.

3. Haga clic en el vínculo Nivel de registro para ajustar el nivel de 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 lograr las tareas más comunes de configuración de diagnósticos. Sin embargo, si desea editar manualmente los valores de las escuchas y los orígenes, deberá expandir el nodo de Diagnósticos y editar los valores de los nodos Registro de mensajes, Escuchas y Orígenes.

Habilitar traza personalizada o registro de mensajes de WCF

1. Haga clic en el nodo de Diagnósticos y expándalo.

2. Haga clic con el botón secundario en el nodo de Escuchas y seleccione el elemento Escucha nueva.

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. Si hace clic en la línea TypeName, aparecerá el botón "...". Haga clic en este botón para abrir el Explorador de tipos de escucha de seguimiento, que puede usarse para buscar las escuchas de seguimiento preconfiguradas que ya estén instaladas.

5. Vaya a la sección Origen. En ella, haga clic en Agregar para abrir un cuadro de diálogo con un menú desplegable en el que se mostrará la lista de los orígenes de traza disponibles. Seleccione un origen de traza y haga clic en Aceptar.

6. Para editar los valores del registro de mensajes, haga clic en el nodo de Registro de mensajes. Puede editar los valores en la cuadrícula de propiedad.

Avanzado

Comportamientos

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

Las configuraciones de comportamiento se utilizan para configurar comportamientos de puntos de conexión y servicios. Estas configuración se almacena en el nodo de Opciones avanzadas de los Comportamientos de servicio y los Comportamientos de punto de conexión. Los servicios utilizan comportamientos de servicios; pero los puntos de conexión utilizan comportamientos de punto de conexión.

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 el elemento Nueva configuración de comportamiento…

• Seleccione uno de los nodos de comportamiento y haga clic en el elemento Nueva configuración de comportamiento… del Panel de tareas, que se ubica en la parte inferior izquierda de la ventana.

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 uno de los elementos de extensión de comportamiento de la sección Posición de extensión de elemento de comportamiento.

4. Utilice los botones Arriba y Abajo, que se encuentran en el lado izquierdo de la lista, para cambiar la posición del elemento que haya 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.

ProtocolMapping

Esta sección permite establecer los tipos de enlaces predeterminados para los distintos protocolos como http, tcp, MSMQ o net.pipe mediante la asignación entre los esquemas de direcciones de protocolo y los posibles enlaces. También puede agregar nuevas asignaciones a otros protocolos.

Extensiones

Las nuevas extensiones de enlace, de elemento de enlace, de punto de conexión estándar y de comportamiento se pueden registrar para su uso en la configuración de 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 cuatro 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 extremo estándar definen un extremo estándar completo. Ejemplo: discoveryEndpoint.

• 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 Nueva.

2. Escriba un nombre y tipo.

3. Haga clic en OK.

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.

Entorno de hospedaje

Esta sección permite definir la configuración de creación de instancias para el entorno de hospedaje de servicio.

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 buscará los tipos de servicio que estén instalados y otros elementos del equipo que sean compatibles con WCF, entre los que se incluyen los directorios COM+ y los directorios virtuales hospedados en web. Una vez que los encuentre, los cargará para simplificar el proceso de creación de la configuración.

Crear un archivo de configuración

1. Utilice una ventana de comandos para navegar hasta la ubicación de instalación de 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 elemento Ejecutable, Servicio COM+ o Servicio WebHosted en función del 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 el elemento 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 solo será visible si se incluye la sección <comContract> 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é global de ensamblados (GAC).

1. Seleccione el menú Archivo ->Integrar ->Aplicación COM+. Realizar esta operación hará que se cierre el archivo que esté abierto actualmente. Si hay datos no guardados en el archivo actual, aparece el cuadro de diálogo Guardar. Después, se iniciará el Asistente de integración de COM+.

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é global de ensamblados (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.

Editar una configuración COM+ existente

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

2. Seleccione el servicio COM+ que desee editar en la lista.

3. Edite la configuración en el nodo de 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 sobre Seguridad para averiguar cómo proteger los servicios WCF.

Además, el editor de configuración solo se puede utilizar para leer y escribir elementos de configuración de 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 de WCF conocidos. Es la responsabilidad del usuario determinar si estos elementos suponen una amenaza para la aplicación o el sistema.