Pasos del asistente
Última actualización: 14/10/2026La interfaz de usuario es una interfaz de estilo asistente para el proceso de conversión completo. El asistente se abre en el navegador predeterminado después de hacer doble clic en QV2QS.exe o de ejecutar el archivo ejecutable con el --ui indicador. El número de versión actual se muestra en el cuadro de diálogo Acerca de. Un botón para alternar el tema en la esquina superior derecha cambia entre el modo claro y oscuro. Para obtener más información, consulta Modo oscuro.
El asistente presenta los siguientes pasos en orden. Los pasos que no se aplican al modo de flujo de trabajo seleccionado se ocultan automáticamente.
Configuración
Seleccione un modo de flujo de trabajo (obligatorio). El modo seleccionado determina qué pasos subsiguientes están disponibles.
- Compilar en Qlik Cloud (predeterminado) — convierte la interfaz de usuario de QlikView y despliega la aplicación resultante directamente en el inquilino de Qlik Cloud. Elija este modo para ver la aplicación convertida en Qlik Cloud inmediatamente. Este modo es el flujo de trabajo recomendado para la migración.
- Exportar QVF — convierte la interfaz de usuario de QlikView utilizando el motor de Qlik Cloud, exporta la aplicación resultante como un archivo QVF y luego elimina la aplicación en la nube. Elija este modo para producir un archivo para compartir con otro equipo o importar en un inquilino diferente. Este modo todavía requiere un inquilino de Qlik Cloud y una clave de API. La importación a Qlik Sense Enterprise Client-Managed no está probada en todas las versiones ni cuenta con soporte oficial. Para obtener más detalles, consulte Compatibilidad de Qlik Sense Enterprise gestionado por el cliente.
- Solo en local — realiza la conversión en disco sin conectarse a Qlik Cloud. No se requiere un inquilino de Qlik Cloud ni una clave de API. El modo solo local genera el informe de conversión completo y la salida de compilación para evaluación, revisión o uso sin conexión. La salida de la compilación local no incluye cargas de medios, resolución de imágenes de fondo, creación de estados alternativos o publicación de hojas — estas operaciones requieren la fase de implementación. Para una implementación completa, utilice el modo Compilar en Qlik Cloud o Exportar QVF. Para obtener detalles sobre las limitaciones solo locales, consulte Cómo funciona la conversión. Apuntar a QSECM con la salida de compilación no está probado en todas las versiones ni oficialmente soportado. Para obtener más detalles, consulte Compatibilidad de Qlik Sense Enterprise gestionado por el cliente.
Proyecto
Configure la fuente de entrada. Tome una de las opciones siguientes:
- Proyecto único (predeterminado): proporcione un archivo QVW (obligatorio). Autogenerar PRJ está habilitado por defecto y genera la carpeta PRJ del archivo QVW automáticamente. Deshabilite esta opción para proporcionar una carpeta PRJ o un ZIP manualmente. Haz clic en Probar ejemplo para cargar un proyecto de ejemplo incluido sin necesidad de buscarlo. El botón es visible solo cuando el campo QVW está vacío. Ver Proyectos de ejemplo.
- Lote: proporcione una o más carpetas para escanear (obligatorio). QV2QS descubre todos los pares QVW y PRJ coincidentes recursivamente. Haz clic en Probar ejemplo para rellenar el campo de la carpeta con la carpeta de ejemplos incluida. Trabajadores por lotes controla cuántas conversiones se ejecutan en paralelo (predeterminado: detección automática basada en los núcleos de la CPU). Para obtener más información, consulte Conversión por lotes.
Siempre apunte QV2QS a copias de documentos de origen en una carpeta de trabajo local, no a archivos de producción en QlikView Server o unidades de red compartidas. El motor de QlikView Desktop adquiere un bloqueo de archivo durante la generación de PRJ, lo que puede entrar en conflicto con sesiones activas de QlikView. Para obtener más información, consulte Seguridad de los archivos de origen.
Salida
Establezca la carpeta raíz de salida (obligatorio). QV2QS crea automáticamente una subcarpeta con el nombre del proyecto dentro de la raíz de salida (por ejemplo, <outputDir>/Sales/). Si dos proyectos comparten el mismo nombre, se añade un _2, _3 sufijo para evitar colisiones. Habilitar Limpiar registros para eliminar los archivos de registro existentes antes de la ejecución.
Autenticación de Qlik Cloud
Este paso aparece solo en los modos Crear para Qlik Cloud y Exportar QVF.
Seleccione o cree un contexto de qlik-cli para autenticarse con el inquilino de Qlik Cloud (obligatorio). Cree un nuevo contexto proporcionando la URL del inquilino y la clave de API. El asistente valida la conexión antes de continuar.
aplicación Qlik Cloud
Este paso aparece solo en los modos Crear para Qlik Cloud y Exportar QVF.
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Nombre de la aplicación | Nombre para la aplicación de Qlik Sense en Qlik Cloud | Nombre de archivo QVW, nombre de carpeta PRJ o nombre de carpeta de salida |
| Recargar | Recargue la aplicación después de la compilación para ejecutar el script de carga | Activado |
| Auto-binario | Cargue temporalmente el archivo QVW para la carga de datos binarios, luego elimine el archivo después de la recarga. Requiere Recarga. | Activado |
| Id. de aplicación binaria | Utilice una aplicación QVW o QVF existente en Qlik Cloud para la carga binaria en lugar de cargarla. Requiere Recarga. Haz clic en el botón de examinar para abrir el selector de QVW. | — |
| Reutilizar aplicación existente | Actualizar una aplicación creada previamente en lugar de crear una nueva. Cuando está habilitado, QV2QS comprueba la carpeta de salida en busca de una implementación anterior que coincida con el archivo QVW seleccionado y rellena automáticamente el ID de la aplicación. Si no se encuentra ninguna implementación anterior, introduzca el ID de la aplicación manualmente o haga clic en el botón de examinar para abrir el selector de QVF. | Desactivado |
| Conservar script de carga | Mantén el script de carga existente en la aplicación de destino. El script convertido no se aplica. Requiere Reutilizar aplicación existente. Desactiva Recargar por defecto; vuelve a activarlo para ejecutar el script existente. | Desactivado |
| Conservar variables | Mantener las variables existentes en la aplicación de destino. Las variables convertidas no se aplican. Requiere Reutilizar aplicación existente. | Desactivado |
| Omitir copia de seguridad previa a la implementación | No exporte una copia de seguridad QVF antes de sobrescribir la aplicación. Por defecto, una copia de seguridad sin datos se guarda en cloud/backups/. Requiere Reutilizar aplicación existente. |
Desactivado |
| Publicar hojas | Publicar todas las hojas convertidas como hojas base después de la construcción. Las hojas base son visibles para todos los usuarios que tienen acceso a la aplicación. Desactivar esta configuración para mantener las hojas como objetos personales (no publicados). Cuando Reutilizar aplicación existente está habilitado, la configuración se aplica solo a las hojas nuevas. Las hojas publicadas anteriormente se restauran automáticamente independientemente de esta configuración. | Activado |
| Crear sin datos | Omitir la carga de datos durante la fase de compilación. La aplicación se ensambla en el inquilino sin datos, lo que permite probar la estructura de la interfaz de usuario sin esperar una recarga. | Desactivado |
| Exportar sin datos | Eliminar datos del archivo QVF exportado. La aplicación en la nube aún puede contener datos de la compilación, pero el QVF descargado es más pequeño. Solo modo de exportación QVF. | Desactivado |
Los campos ID de aplicación binaria y Reutilizar aplicación existente incluyen botones de exploración que abren modales de selección de aplicaciones en la nube. Cada selector carga aplicaciones del inquilino conectado con filtrado de búsqueda por nombre, propietario, espacio o ID de aplicación. El selector QVW también proporciona un filtro de tipo de aplicación (QVW, QVF o todos). Seleccione una aplicación de la lista para rellenar el campo automáticamente.
Ajustes de expresión
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Corregir valores de búsqueda entre comillas simples | Convertir comodines y comparaciones entre comillas simples a comillas dobles en expresiones de análisis de conjuntos. Para obtener más información, consulte Referencia de argumentos. | Activado |
| Corregir valores de conjunto sin comillas (experimental) | Encierre los valores de cadena sin comillas entre comillas simples en expresiones de análisis de conjuntos. Para obtener más información, consulte Referencia de argumentos. | Desactivado |
Opciones de estilo
Los siguientes ajustes controlan la apariencia de la hoja y el comportamiento del diseño.
Plantilla
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Tema de la aplicación | Tema de Qlik Sense aplicado a la aplicación convertida. El desplegable muestra los cuatro temas integrados de Qlik. Cuando se configura un contexto de Qlik Cloud, haga clic en el botón de actualizar para obtener los temas personalizados instalados en el inquilino. Sense Classic produce la mayor fidelidad 1:1 con QlikView. Los temas no clásicos pueden alterar los bordes de los objetos, los colores de fondo, las fuentes y el relleno. El tema establece el valor predeterminado solamente; los usuarios pueden cambiar de tema en cualquier momento en el cliente de Qlik Sense. | Sense Clásico |
Fondos
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Imágenes de fondo de hoja | Extraer y aplicar fondos de pantalla de hoja de QlikView | Activado |
| Volver al fondo del documento | Utilice el fondo a nivel de documento para las hojas que no tienen uno | Activado |
| Anulación del color de fondo | Relleno de color sólido aplicado a todas las hojas (#RRGGBB) |
— |
Diseño
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Mostrar encabezado de hoja | Añadir una región de encabezado a las hojas convertidas | Desactivado |
| Omitir hojas ocultas | Omitir hojas con condiciones de visualización siempre falsas | Desactivado |
Cuadros de lista y ordenación
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Conservar los colores del cuadro de lista de QV | Aplicar los colores de fondo y la transparencia originales del cuadro de lista de QlikView | Activado |
| Protección de ordenación de campo de fecha | Mantener los campos de cuadro de lista con formato de fecha (Año, Trimestre, Mes y similares) ordenados cronológicamente en lugar de por estado de selección. Para obtener más información, consulte Referencia de argumentos. | Activado |
Avanzado
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Lienzo de hoja fija | Habilitar el posicionamiento estilo QlikView con precisión de píxel. Muestra los factores de escala, las dimensiones mínimas y las opciones de recorte del lienzo. La escala del lienzo y la escala del objeto están vinculadas por defecto; haga clic en el icono de la cadena para establecer valores independientes. Para obtener más información, consulte Configuración del diseño de conversión. | Activado |
| Extensión automática de hoja dinámica | Permitir que las hojas crezcan verticalmente más allá de la altura predeterminada de la cuadrícula | Activado |
| Trabajadores de carga de medios | Número de trabajadores paralelos para cargar archivos multimedia (fondos de pantalla e imágenes) en Qlik Cloud. Se aplica a los modos de Compilación en Qlik Cloud y Exportación de QVF. | 2
|
| Reemplazos de scripts | Activar o desactivar el procesamiento de reemplazo de scripts y gestionar reglas individuales. Para obtener más información, consulte Referencia de argumentos. | Activado |
La sección de sustituciones de scripts incluye un editor de reglas en línea. Alternar el interruptor principal para habilitar o deshabilitar todo el procesamiento de scripts. Expandir la sección para ver, añadir, editar o eliminar reglas individuales. Cada regla se puede activar o desactivar de forma independiente. Haz clic en Restablecer valores predeterminados para restaurar las ocho reglas integradas. Una insignia de resumen muestra el número de reglas habilitadas.
Haz clic en los botones de flecha hacia arriba y hacia abajo de una regla para cambiar el orden de ejecución. Las reglas con un orden de ejecución inferior se ejecutan primero. Haz clic en Exportar para descargar todas las reglas como un archivo JSON. Haga clic en Importar para cargar reglas desde un archivo JSON, reemplazando el conjunto actual. Los archivos importados deben contener una matriz JSON donde cada regla tenga un campo description, pattern y search.
Para crear un archivo de reglas personalizado para importar, haz clic en Exportar primero para obtener las reglas integradas en el formato correcto. Edite el archivo exportado para añadir, eliminar o modificar reglas, luego haga clic en Importar para cargar el conjunto actualizado.
Cuando se configuran reglas personalizadas o valores predeterminados deshabilitados, la vista previa del comando muestra un aviso. El comando copiado no incluye reglas personalizadas. Exportar reglas a un archivo JSON y añadir --scriptReplacements <path> al comando para incluir reglas personalizadas en la línea de comandos.
Para una explicación de cómo funcionan las reglas, incluido el proceso de coincidencia en dos etapas y la lista de reglas incorporada, consulte Referencia de argumentos.
Abrir Mockup Studio desde el paso Avanzado para previsualizar de forma interactiva diseños de lienzo fijo y de cuadrícula dinámica, ajustar el escalado y aplicar la configuración de nuevo al asistente.
Informe de conversión
Las siguientes configuraciones controlan la salida del informe de conversión.
| Configuración | Descripción | Predeterminado |
|---|---|---|
| Generar informe | Generar un informe de conversión de consola | Activado |
| Informe de Excel | Exportar el informe como un archivo XLSX con detalles por objeto y puntuación de automatización. Introduzca un nombre de archivo (p. ej. MyReport) o una ruta completa. La .xlsx extensión se añade automáticamente. Dejar en blanco para nombrar automáticamente en reports/. |
Activado |
| Incluir selecciones y objetos de búsqueda | Incluir el cuadro de selecciones actuales y el objeto de búsqueda en el informe. Estos se añaden automáticamente por Qlik Sense y se excluyen por defecto. | Desactivado |
Revisar
Confirmar todos los ajustes antes de ejecutar. El paso de revisión muestra tarjetas de resumen para la configuración del proyecto, el flujo de trabajo, la nube y la salida. En modo por lotes, una tabla enumera todos los proyectos descubiertos.
Una lista de verificación de acciones requeridas en la barra lateral hace un seguimiento de los elementos que deben configurarse antes de la ejecución. Los elementos se agrupan por categoría: flujo de trabajo, entradas, salida y autenticación en la nube. Cada elemento muestra Correcto cuando está configurado o Pendiente cuando falta un valor. Haz clic en un elemento para navegar directamente al paso relevante del asistente.
Un panel de vista previa del comando muestra el comando CLI equivalente para la configuración actual del asistente. Alternar entre la sintaxis de PowerShell y Bash. Haga clic en Copiar para copiar el comando al portapapeles. La vista previa del comando es útil para aprender los argumentos de la CLI o para guardar el comando exacto para ejecuciones repetidas mediante scripts.
Haz clic en Ejecutar para iniciar la conversión.
Ejecutar
Muestra la salida de la consola en vivo mientras se ejecuta la conversión. Detener una conversión en curso, seguir los registros en tiempo real y abrir la carpeta de salida o la aplicación Qlik Cloud cuando la ejecución finalice.