Cómo funciona la conversión

Última actualización: 14/10/2026

El proceso de conversión tiene las siguientes fases:

• Extraer — Si --generatePrj está habilitado, QV2QS inicia QlikView Desktop para extraer el archivo QVW en una carpeta PRJ. QV2QS utiliza el motor portátil incluido a menos que se detecte una instalación del sistema de QlikView Desktop. Para obtener más detalles, consulte motor de QlikView Desktop.
• Análisis — QV2QS lee la carpeta PRJ y analiza cada definición de objeto, diseño de hoja, script de carga, variable y propiedad de documento. QV2QS también lee el binario QVW/QVF directamente para extraer metadatos, variables y cualquier script de carga oculto incrustado en el archivo.
• Convertir — Cada objeto de QlikView se asigna a un tipo de visualización de Qlik Sense. Dimensiones, medidas, expresiones, estilo y posiciones de diseño se traducen a formato JSON de Qlik Sense.
• Escribir — QV2QS escribe la estructura de la aplicación convertida en la carpeta de salida como un conjunto de archivos JSON.
• Desplegar (solo modos en la nube) — QV2QS crea la aplicación en el inquilino, carga los medios, compila la aplicación y, opcionalmente, recarga la aplicación con datos.
• Informe — QV2QS genera un informe de conversión que resume los resultados, la puntuación de automatización y cualquier elemento que requiera seguimiento manual.

La fase de implementación se ejecuta en los modos de compilación a Qlik Cloud y exportación de QVF. En el modo solo local, QV2QS escribe la salida convertida en el disco sin conectarse a Qlik Cloud. La fase de informe se ejecuta en todos los modos.

Modos de conversión

QV2QS admite tres modos de conversión. Seleccione el modo en el paso de Configuración del asistente o con el indicador CLI correspondiente.

La compilación en Qlik Cloud es el modo recomendado para la migración. Exportar QVF es útil para generar un archivo portátil para compartir o importar en otro inquilino. El modo solo local está destinado a la evaluación y revisión. Para obtener detalles sobre las limitaciones solo en local, consulte la sección siguiente.

Modo solo local

Modo solo local (--unbuildOnly) realiza las fases de Análisis, Conversión, Escritura e Informe sin conectarse a Qlik Cloud. No se requiere ningún inquilino ni clave de API. QV2QS genera el informe de conversión completo, el resumen ejecutivo y la carpeta de salida de compilación en el disco.

Casos de uso

• Evaluación de la migración — Ejecute el modo Solo local para generar el informe de conversión, el resumen ejecutivo, la puntuación de automatización y los hallazgos de expresiones sin necesidad de acceso a Qlik Cloud. Evalúe la calidad de la conversión en todo un patrimonio QVW antes de configurar las credenciales del inquilino.
• Revisión previa al despliegue — Inspeccione la salida generada (script de carga, definiciones de objetos, variables, dimensiones) antes de confirmar un despliegue en la nube. Las organizaciones con procesos de control de cambios pueden revisar el resultado como un artefacto intermedio.
• Entornos sin conexión o restringidos — Cuando la máquina que aloja los archivos QVW no tiene acceso a Internet saliente, ejecute el modo Solo local para generar el informe de conversión localmente. Para implementar la aplicación convertida, copie los archivos QVW a una máquina con acceso a Qlik Cloud y ejecute QV2QS en modo Compilar en Qlik Cloud desde la máquina conectada.

Limitaciones

La fase de despliegue gestiona varias operaciones que qlik app build por sí sola no realiza. Ejecutar el modo solo local y luego implementar la carpeta build/ manualmente con una instalación independiente de qlik-cli resulta en las siguientes brechas.

• Los archivos multimedia no se han subido. Las imágenes de fondo y las imágenes de los botones se extraen a la images/ carpeta, pero no se incluyen en la build/ carpeta. El qlik app build comando no procesa archivos multimedia. Todas las imágenes de fondo y las imágenes de los botones faltarán en la aplicación implementada.
• Las referencias de fondo de hoja y objeto no están resueltas. QV2QS inyecta URLs de imágenes de fondo en los archivos JSON de hoja y objeto durante la fase de implementación utilizando el ID de la aplicación en la nube. La salida de la compilación local no contiene referencias a imágenes de fondo. Las hojas y los objetos no tendrán fondos en la aplicación implementada.
• Las URL de las imágenes de los botones contienen cadenas de marcador de posición. Las imágenes de los botones en la salida de la compilación local utilizan valores de marcador de posición internos en lugar de URL de medios resueltas. El motor de Qlik Sense no puede interpretar las cadenas de marcador de posición. Las imágenes de los botones aparecerán rotas.
• Los estados alternativos no se crean. Los nombres de estado alternativos se escriben en cloud/alternate_states.json fuera de la carpeta build/. El qlik app build comando no procesa estados alternativos. Los objetos que hacen referencia a estados no predeterminados puede que no se muestren correctamente.
• Las hojas no están publicadas. El comando qlik app build crea hojas como objetos personales visibles solo para el propietario de la aplicación. QV2QS publica hojas como hojas base durante la fase de despliegue. En un espacio compartido, otros usuarios no verán ninguna hoja hasta que las hojas se publiquen manualmente.

Seguridad del archivo de origen

QV2QS no modifica el contenido del archivo QVW o QVF de origen. Durante la fase de extracción, QV2QS abre el documento de origen a través de QlikView Desktop y guarda una copia temporal en una carpeta temporal del sistema. QV2QS cierra entonces el original y genera la carpeta PRJ a partir de la copia temporal. Una vez completada la generación de PRJ, QV2QS copia la carpeta -prj resultante de nuevo en el mismo directorio que el archivo de origen y elimina la copia temporal. Si ya existe una -prj carpeta junto al archivo de origen, QV2QS reemplaza la carpeta con la versión recién generada. Toda la demás salida de conversión se escribe en el directorio de salida independiente especificado por --outputDir.

QlikView Desktop adquiere un bloqueo de archivo en el documento de origen mientras la copia temporal se está creando. Ejecutar QV2QS en un archivo que está activamente abierto en QlikView Desktop o servido por QlikView Server puede causar conflictos de bloqueo de archivos o una generación de PRJ fallida. Los archivos en unidades de red compartidas pueden causar los mismos conflictos. Escribir la -prj carpeta de nuevo en un recurso compartido de red o directorio de solo lectura también puede fallar.

Para evitar cualquier riesgo para los entornos de producción, trabaje siempre con copias de los documentos de origen. Haga lo siguiente:

1. Copie los archivos QVW o QVF a una carpeta de trabajo local en la máquina donde se ejecuta QV2QS.
2. Apunte QV2QS a los archivos copiados, no a los originales.
3. Cierre cualquier instancia de QlikView Desktop en ejecución antes de iniciar la conversión. QV2QS requiere acceso exclusivo a QlikView Desktop.

Plazos habituales

QV2QS está diseñado para la velocidad. El pipeline completo finaliza en minutos, no en horas. La siguiente tabla muestra las duraciones típicas para una conversión de una sola aplicación.

Una conversión de una sola aplicación con implementación en la nube y recarga de datos suele completarse en dos o cinco minutos de principio a fin. Conversiones solo locales (--unbuildOnly) se completan en menos de 30 segundos.

En modo por lotes, QV2QS convierte varios proyectos en paralelo. El tiempo total del lote escala con el número de proyectos dividido por el número de trabajadores. Para un lote de 20 aplicaciones con cuatro trabajadores, espere aproximadamente cinco veces la duración de una sola aplicación para la fase de conversión local, más el tiempo de implementación en la nube.

Estructura de la carpeta de salida

El --outputDir argumento especifica la raíz de salida. QV2QS crea una subcarpeta con el nombre del archivo QVW (o la carpeta PRJ) dentro de la raíz de salida. Toda la salida de conversión del proyecto se escribe en esa subcarpeta. Si dos archivos QVW comparten el mismo nombre, QV2QS añade _2, _3, y números subsiguientes para evitar colisiones. Este comportamiento coincide con el modo por lotes, donde cada proyecto también recibe una subcarpeta dedicada.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS crea la carpeta de salida si la carpeta no existe ya. Si la carpeta existe de una ejecución anterior del mismo QVW, QV2QS reutiliza la carpeta. Los archivos de registro existentes en la carpeta se conservan a menos que Limpiar registros esté habilitado. El directorio de salida no debe ser el mismo que, o un directorio padre de, ningún directorio de origen. QV2QS valida la ruta de salida antes de iniciar la conversión e informa de un error si las rutas se superponen. La subcarpeta del proyecto contiene lo siguiente:

Después de la conversión

Una vez completada una conversión, revisa los siguientes elementos agrupados por prioridad.

Corregir antes de publicar

1. Abra el informe de conversión de Excel en la reports/ subcarpeta y revise la hoja de cálculo Follow-up_Objects. Corrija todos los elementos marcados como Error primero (objetos que no se pudieron convertir), luego Marcador de posición (objetos que necesitan reconstrucción) y, por último, Ajustes necesarios (objetos que se convirtieron parcialmente).
2. Revise los hallazgos del análisis en la hoja de trabajo Análisis, incluyendo referencias a macros, uso de Section Access y patrones de script de carga que puedan requerir atención manual.
3. Verifique que las expresiones se evalúen correctamente. QV2QS corrige automáticamente los problemas de entrecomillado en el análisis de conjuntos durante la conversión. Revisar dimensiones calculadas, colores condicionales y expresiones que utilizan funciones exclusivas de QlikView (GetCurrentField(), MsgBox()) que requieren reescritura manual.
4. Compruebe la hoja de trabajo Overflow_Actions para los objetos donde las dimensiones o medidas en exceso se movieron a la colección de alternativas.

Verificar antes de publicar

5. Abra la aplicación convertida en Qlik Sense y verifique que los diseños de las hojas, las posiciones de los objetos y las imágenes de fondo aparezcan como se espera.
6. Confirme que la navegación de contenedores de pestañas (tiras de botones o contenedores con pestañas) cambia entre áreas de contenido correctamente.
7. Probar el comportamiento de exploración en profundidad y de alternancia de grupos cíclicos en gráficos que utilizan grupos de dimensiones.
8. Verifique que las condiciones de visualización ocultan y revelan objetos según lo esperado.
9. Verifique los órdenes de clasificación en cuadros de lista y tablas, especialmente para campos de tipo fecha.

Polaco

10. Ajuste las fuentes, los colores o el posicionamiento de los objetos en el editor de aplicaciones de Qlik Sense según sea necesario. Para obtener orientación sobre el posicionamiento del diseño, consulte Configuración del diseño de conversión.

Para una descripción completa del contenido del informe, consulte Informe de conversión.

Más información

• Inicio rápido
• Interfaz de usuario
• Interfaz de línea de comandos
• Configuración del diseño de conversión
• Resultados de conversión