Solucionar problemas del convertidor de ClearQuest

Actualización: noviembre 2007

Si se producen problemas al migrar los elementos de trabajo de ClearQuest a Team Foundation Server, el convertidor de ClearQuest registra los errores y advertencias en un archivo de informe. La mejor forma de resolver los problemas es revisar este archivo para determinar lo que ocurrió. La información que se facilita a continuación es una ayuda para resolver los problemas y errores que se producen con el convertidor de ClearQuest.

En esta sección

Solucionar problemas de análisis

No se encontró el archivo license.dll

Error de análisis sin generación de ningún informe al respecto

Solucionar problemas de migración

Error del comando Migrate

Errores críticos cuando se conecta el convertidor

Errores críticos cuando se facilitan tipos de elementos de trabajo

No se expanden las secciones del análisis de informes o del informe de migración

Los cambios del esquema de los elementos de trabajo no migran a Team Foundation Server

Error de migración de elementos de trabajo debido a un error de carga de los datos adjuntos

Solucionar problemas de análisis

Cuando los problemas se producen al ejecutar el comando de análisis, se informa de un error a la consola y se genera el archivo de informe con los detalles del problema. La mayor parte de las veces, puede corregir la causa del error y reiniciar el convertidor. Si no está seguro sobre la causa de un error, busque el número de error o el texto exacto en la Ayuda de Team Foundation. Algunos errores también generan un error interno del que se informó desde la API de ClearQuest que usa el convertidor. Puede encontrar la información adicional sobre estos errores en la documentación de ClearQuest.

No se encontró el archivo license.dll

Al ejecutar el comando Analizar es posible que se produzca el error "Error al iniciar a aplicación porque no se encontró license.dll. La reinstalación de la aplicación puede solucionar el problema." Después de hacer clic en Aceptar, recibe un error adicional, "TF61118: No se pudo llamar a la API de ClearQuest. Aparece el siguiente error: Error al recuperar un generador de clases COM para el componente con CLSID {94773112-72E8-11D0-A42E-00A024DED613} debido al siguiente error: 8007007e. Consulte la documentación de ClearQuest para obtener más ayuda".

Estos errores se producen cuando el convertidor no puede cargar las bibliotecas de ClearQuest, ya que la ruta de acceso de las bibliotecas no está correctamente configurada.

Solución

• Compruebe que está instalado el cliente de ClearQuest en el equipo. De esta forma, se instalan las bibliotecas necesarias.

• Compruebe que no está ejecutando el convertidor desde una ventana de la consola que se inició antes de instalar ClearQuest. En caso afirmativo, abra una nueva ventana de la consola y vuelva a ejecutar el convertidor.

• Compruebe que no se ha modificado la variable de entorno PATH una vez instalado ClearQuest. Esta variable de entorno debe contener las rutas de acceso a los archivos DLL que ha instalado ClearQuest. Si faltan estas rutas de acceso, puede que deba volver a instalar ClearQuest.

Error de análisis sin generación de ningún informe al respecto

Si el convertidor no puede cargar el archivo de configuración, se producirá un error en el comando Analyze y no se generará ningún informe.

Solución

• Utilice un editor XML o una herramienta para comprobar si el código XMl del archivo de configuración es correcto.

• Compruebe que se especifiquen correctamente los elementos y atributos XML del archivo de configuración. Si recibe errores de validación, el mensaje de error indicará el valor no compatible e indicará el número de línea en la que se encuentra el valor. Para obtener más información, vea Archivo de configuración del convertidor de elementos de trabajo.

Solucionar problemas de migración

Cuando el convertidor se ejecuta con el comando Migrate, existen varios puntos en los que se puede producir un error. En primer lugar, el convertidor lee el archivo de configuración y se conecta a la base de datos ClearQuest mediante la información de conexión especificada. Después, el convertidor proporciona los tipos de elementos de trabajo especificados en Team Foundation Server. Por último, el convertidor migra los elementos de trabajo de ClearQuest a Team Foundation Server.

Mientras se ejecuta el convertidor, imprime mensajes del estado en la consola. Puede utilizar estos mensajes para determinar el punto en el que se produjo el error de migración. Por ejemplo, si el último mensaje de estado correcto fue "Validando usuarios en Team Foundation," es probable que el error esté relacionado con el archivo de asignación de usuarios.

La clave para resolver los problemas de migración es examinar todos los errores de los que se informe. Se informa de los errores de la siguiente forma.

1. Se muestra un mensaje en la consola que indica los errores producidos. Por ejemplo, si hay 2 advertencias y 1 error, recibe el siguiente mensaje Migración completada con 2 advertencias, 1 errores.

2. Se crea un archivo de informe de migración con información más específica sobre las advertencias y los errores. El nombre del archivo de informe es CQMigrationReport.xml.

Nota:
En algunos casos, puede que el convertidor no genere ningún archivo de informe y, únicamente, verá el resultado de un mensaje de error en la consola.

Error del comando Migrate

Durante la migración, el convertidor puede experimentar un error crítico en cualquier momento. Un error crítico detiene el convertidor y se dejan de migrar más elementos de trabajo. Un error crítico se puede producir antes de la migración real de los elementos de trabajo. O bien, una vez migrados algunos elementos de trabajo. Cuando se produce un error de migración, el usuario detecta uno de los dos síntomas siguientes:

• Ve un error crítico y el mensaje ‘Error en la migración’ en el archivo de informe de la migración, CQMigrationReport.xml. Verá una cadena en el archivo de informe parecida a la siguiente: Error en la migración { 1 error crítico | 2 errores | 4 advertencias }.

• Se produce el error en la migración con un resultado de error en la consola, pero no se genera ningún informe.

Solución

• Corrija la causa del error y reinicie el convertidor. Al reiniciar el convertidor, no volverá a migrar los elementos de trabajo que ya se migraron. El convertidor no crea elementos de trabajo duplicados.

• Las causas de los errores críticos varían, lo mismo que los mensajes de error. La mayoría de los mensajes de error proporcionan información que identifica su causa. También puede encontrar más información sobre algunos errores si busca el texto del error en la ayuda de Team Foundation. Finalmente, examine las soluciones de los problemas del comando Analyze mostrados previamente en este tema. Muchos de estos mismos problemas se aplican al comando Migrate.

Errores críticos cuando se conecta el convertidor

Los errores críticos se pueden producir cuando el convertidor intenta conectarse con ClearQuest o Team Foundation Server. Se encuentra con uno o más mensajes de error en el informe que indican un problema de conexión.

Solución

Compruebe que puede conectarse con ClearQuest mediante el cliente de ClearQuest y con Team Foundation Server mediante Team Explorer. Los problemas de conexión suelen ser más fáciles de diagnosticar mediante los mensajes de estos clientes. Además, recuerde iniciar los clientes al iniciar sesión con la cuenta de usuario que ejecutará el convertidor. De esta forma, se almacenarán en la memoria caché los datos necesarios para que el convertidor se ejecute correctamente.

Errores críticos cuando se facilitan tipos de elementos de trabajo

Se producen errores críticos cuando se facilitan tipos de elementos de trabajo debido a problemas de nomenclatura. El usuario encuentra un mensaje de error que se parece el siguiente:

"Error de migración debido a "TF61013: El conversor no pudo proporcionar el tipo de elemento de trabajo especificado en el archivo \\<nombreDelEquipo>\e$\temp\CQOGF\Defect.xml debido al siguiente error: TF26177: Team Foundation no admite el cambio de nombre de los campos. Microsoft.TeamFoundation.Converters.Priority_String de 'Priority String' a 'Priority String1'. Team Foundation no admite el cambio de nombre de los campos".

Los campos de Team Foundation Server tienen un ámbito de nomenclatura en el nivel del servidor. La combinación de nombre, nombre de referencia y tipo de un campo debe ser única en el servidor. La fase de análisis del convertidor tiene lógica para evitar conflictos. Cuando el convertidor detecta un conflicto, modifica los nombres de los campos generados adecuadamente. Sin embargo, puede haber un lapso de tiempo que abarca desde el momento en el que se generan los nombres de campo a partir del comando de análisis y el momento en el que se ejecuta el comando de migración. Se pudo modificar un tipo de elemento de trabajo en el servidor en ese lapso de tiempo anterior al conflicto. O bien, puede haber editado los tipos de elementos de trabajo generados y haber elegido un nombre en conflicto con un campo existente inadvertidamente.

Solución

• Modifique los tipos de elementos de trabajo para resolver el conflicto cambiando el nombre, el nombre de referencia o ambos. Con frecuencia, quizá pueda utilizar los nombres de campo existentes. Para ver los tipos de elementos de trabajo existentes, debe exportar los archivos de definición del tipo de elemento de trabajo de Team Foundation Server. Para obtener más información, vea witexport.

• Use la utilidad de la línea de comandos witfields para cambiar el nombre o eliminar el campo conflictivo de Team Foundation Server. Sin embargo, tenga presente que cambiar de nombre y eliminar campos de elementos de trabajo no es siempre posible. Para obtener más información, vea witfields.

No se expanden las secciones del análisis de informes o del informe de migración

No se expanden las secciones del análisis de informes o del informe de migración correctamente con la configuración de seguridad predeterminada de Internet Explorer. Los botones de expansión y contracción los controlan las secuencias de comandos y la seguridad predeterminada de Internet Explorer impide que se ejecuten las secuencias de comandos.

Solución

Puede corregir este problema cambiando la seguridad de Internet Explorer para que se pueda ver el contenido activo del informe.

Para cambiar la seguridad con el fin de permitir que se vea el contenido activo de los informes

1. Busque la barra de seguridad amarilla situada cerca de la parte superior del explorador en la que se lee "Para ayudar a proteger su seguridad, Internet Explorer impidió que este archivo mostrara contenido activo que podría obtener acceso al equipo".

2. Haga clic en la barra de seguridad amarilla y, a continuación, en Permitir contenido bloqueado.

3. En el cuadro de diálogo Advertencia de seguridad, haga clic en Sí.

Los cambios del esquema de los elementos de trabajo no migran a Team Foundation Server

Los cambios del esquema de los elementos de trabajo no se aplican si ya se ha proporcionado el tipo de elemento de trabajo. Esto suele ocurrir cuando se ejecuta el comando Migrate una vez, se modifican las definiciones del tipo de elemento de trabajo en los archivos de asignaciones de esquema y, a continuación, se vuelve a ejecutar el comando Migrate. Las modificaciones no aparecen en Team Foundation Server. Además, aparece la siguiente advertencia en el informe de migración; "No se puede crear el tipo de elemento de trabajo < nombre del tipo > porque ya existe en su servidor de Team Foundation Server".

El convertidor tiene comprobaciones explícitas para asegurarse de que no se sobrescribe ningún tipo de elemento de trabajo existente. Por consiguiente, en cuanto el convertidor proporcione el tipo de elemento de trabajo, aunque modifique este tipo de elemento, no se incorporan los cambios porque ya se ha proporcionado el tipo de elemento de trabajo.

Solución

Para actualizar los tipos de elemento de trabajo del servidor de Team Foundation, utilice la utilidad de línea de comandos witimport para importar los tipos de elementos de trabajo a Team Foundation Server. A continuación, el convertidor utilizará los tipos actualizados al migrar los elementos de trabajo. Tenga el cuidado y no modifique ni elimine datos del elemento de trabajo al utilizar la utilidad de línea de comandos witimport. Para obtener más información, vea witimport.

Error de migración de elementos de trabajo debido a un error de carga de los datos adjuntos

Si los datos adjuntos sobrepasan el tamaño permitido, no se migran. Además, se muestra el error siguiente en el archivo de informe de migración; "TF61015: Error al guardar los datos adjuntos < nombre de archivo > para el elemento de trabajo < identificador > con el error siguiente: El archivo que se está cargando supera el tamaño máximo de carga de archivos permitido (4 MB)".

Solución

• Puede aumentar el tamaño máximo de los datos adjuntos del servidor de Team Foundation para corregir este problema. El tamaño predeterminado es 4 MB, pero puede aumentarlo a un máximo de 2 GB (2147483648 bytes).

Para establecer el tamaño máximo de datos adjuntos para los elementos de trabajo

1. En Internet Explorer, busque la dirección URL siguiente:

   http://<tfsserver>:8080/WorkItemTracking/v1.0/ConfigurationSettingsService.asmx?op=SetMaxAttachmentSize

   donde <tfsserver> representa el nombre del servidor de Team Foundation.

2. En el cuadro maxSize, escriba el tamaño máximo en bytes para los datos adjuntos y, a continuación, haga clic en Invocar. El tamaño máximo para datos adjuntos es 2 de gigabytes.

Nota:
Para ello, debe ser miembro del grupo Administradores del servidor del nivel de aplicación de Team Foundation y del grupo Administradores de Team Foundation. Para obtener más información, vea Permisos de Team Foundation Server.

Vea también

Conceptos

Permisos de Team Foundation Server

Otros recursos

Solución de problemas de migración de los elementos de trabajo