Asistente y problemas de inicio
Última actualización: 14/10/2026El puerto ya está en uso
Posible causa
Otra instancia de QV2QS u otra aplicación está utilizando el mismo puerto de red. La consola muestra ERROR: Port [number] is already in use.
Acción propuesta
Cierre la otra aplicación, o especifique un puerto diferente con --port. Utilice --port 0 para permitir que el sistema seleccione un puerto disponible automáticamente.
El asistente se abre en Internet Explorer o no se muestra correctamente
Posible causa
Internet Explorer es el navegador predeterminado en la máquina. La interfaz de usuario de QV2QS requiere un navegador moderno y no funciona en Internet Explorer.
Acción propuesta
Instala Google Chrome, Microsoft Edge o Mozilla Firefox. QV2QS detecta el navegador predeterminado al inicio y abre automáticamente un navegador compatible cuando hay uno disponible. Si no se encuentra ningún navegador compatible, la consola muestra enlaces de descarga.
En Windows Server 2019, Internet Explorer es el único navegador instalado por defecto. Instale un navegador compatible antes de ejecutar QV2QS en modo asistente. Alternativamente, utilice la interfaz de línea de comandos, que no requiere un navegador. Consulte la referencia de argumentos para ver la lista completa de argumentos de la CLI.
La conversión falla o produce resultados inesperados en el asistente
Posible causa
El asistente muestra un error resumido, pero no expone el detalle de diagnóstico completo necesario para identificar la causa raíz.
Acción propuesta
Vuelve a ejecutar la misma conversión desde la línea de comandos con el registro de depuración habilitado. Haga lo siguiente:
- En el asistente, vaya al paso de Revisión.
- Haga clic en Copiar comando para copiar el comando CLI completo en el portapapeles.
- Abre una ventana de terminal y pega el comando copiado.
- Añade
--logLevel DEBUGal final del comando y pulsa Intro.
La consola muestra una salida detallada que cubre cada decisión de conversión, llamada a la API en la nube y paso de procesamiento de objetos. El registro de depuración completo también se escribe en la logs/ subcarpeta en el directorio de salida.
El comando copiado incluye todos los ajustes configurados en el asistente. Añadir --logLevel DEBUG es el único cambio necesario para habilitar el diagnóstico completo.
Consulte Registro y diagnóstico para obtener detalles sobre el formato y la ubicación del archivo de registro.
QV2QS se ha detenido
aparece una ventana modal en el navegador
Posible causa
El proceso QV2QS se cerró, falló o terminó mientras el asistente aún estaba abierto en el navegador. La interfaz de usuario supervisa el servicio de backend con una comprobación de estado periódica y muestra el modal cuando el servicio deja de estar disponible.
Acción propuesta
Tome una de las opciones siguientes:
- Volver a conectar a la sesión actual. Copia el comando mostrado en el modal y ejecuta el comando en un terminal. El comando incluye
--porty--noBrowserpara volver a conectarse a la misma pestaña del navegador en el mismo puerto. Después de que el servidor se inicie, haz clic en Reconectar en el modal. El asistente se reanuda con todas las configuraciones introducidas previamente intactas. - Cierra la pestaña del navegador. Haz clic en Cerrar ventana en el modal. Se perderán todas las configuraciones no guardadas en la sesión actual del asistente.
El archivo de proyecto de ejemplo falta o está dañado
Posible causa
El archivo QVW de ejemplo en %TEMP%\QV2QS\examples\ se eliminó, movió o modificó fuera de QV2QS.
Acción propuesta
Elimine el archivo afectado de %TEMP%\QV2QS\examples\ y reinicie QV2QS. Se extrae una copia nueva automáticamente al iniciar. Para conservar una copia permanente de un archivo de ejemplo, copie el archivo en una carpeta de trabajo local antes de modificarlo. Ver Proyectos de ejemplo.