Flujos de trabajo comunes
Última actualización: 14/10/2026Los siguientes ejemplos cubren los casos de uso más frecuentes. Cada uno se basa en el mismo patrón central: especificar un archivo QVW, una carpeta de salida y un contexto de Qlik Cloud. En todos los ejemplos, --outputDir es la raíz de salida. QV2QS crea automáticamente una subcarpeta con el nombre del archivo QVW (por ejemplo, ./output/Sales/). Todos estos flujos de trabajo también se pueden realizar a través del asistente basado en web. Para el enfoque guiado, consulta Pasos del asistente.
Implementar en Qlik Cloud con datos
El flujo de trabajo de migración estándar. QV2QS genera la carpeta PRJ, convierte la interfaz de usuario, carga el QVW para la carga de datos binarios, recarga la aplicación en Qlik Cloud y produce un informe de Excel. El QVW cargado se elimina y el script de carga original se restaura después de la recarga.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Exportar un archivo QVF
QV2QS construye la aplicación usando el motor de Qlik Cloud, exporta el resultado como un archivo QVF y luego elimina la aplicación en la nube. El QVF exportado se puede importar en un inquilino diferente de Qlik Cloud.
La importación de archivos QVF generados por QV2QS en Qlik Sense Enterprise Client-Managed no está probada en todas las versiones, ni está oficialmente soportada y se desaconseja. Para obtener más detalles, consulte Compatibilidad de Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Migrar por lotes todo un entorno QlikView
Escanear una o más carpetas en busca de todos los pares QVW y PRJ, convertir los pares en paralelo y desplegar cada uno en Qlik Cloud. Utiliza --batchWorkers para controlar la concurrencia.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Conservar el diseño de píxeles de QlikView
Habilitar el modo de lienzo fijo para conservar las posiciones exactas de los objetos de QlikView y los fondos de hoja. Ajuste los factores de escala para controlar cómo el diseño se asigna a las dimensiones de pantalla de Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Actualizar una aplicación previamente convertida
Volver a ejecutar la conversión en una aplicación de Qlik Cloud existente sin crear una nueva. QV2QS reutiliza el ID de la aplicación de la ejecución anterior.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Actualizar una aplicación conservando su script de carga
Vuelve a ejecutar la conversión para actualizar la capa de IU de una aplicación existente sin sobrescribir el script de carga. La aplicación de destino mantiene sus conexiones de datos existentes y la lógica de recarga. Se exporta automáticamente una copia de seguridad sin datos antes de la actualización. Añada --reload para ejecutar el script existente y actualizar los datos.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Actualizar una aplicación conservando sus variables
Vuelve a ejecutar la conversión para actualizar la capa de la interfaz de usuario y el script de carga de una aplicación existente sin sobrescribir las variables. Combinar con --preserveTargetAppScript para mantener intactos tanto el script de carga como las variables de la aplicación de destino.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Configurar la autenticación de Qlik Cloud
Configure un contexto de qlik-cli antes de ejecutar cualquier conversión. La configuración interactiva solicita una URL de inquilino y una clave de API, y almacena las credenciales para ejecuciones posteriores.
QV2QS.exe --setupQlikAuth
Uso programático (CI/CD)
QV2QS admite autenticación directa sin contextos de qlik-cli previamente creados. Pase la URL del inquilino y la clave de API en línea. QV2QS valida las credenciales e inyecta encabezados de autenticación en cada llamada de qlik-cli. No se crea ni se modifica ningún archivo de contexto. Incluya --accept-eula para aceptar el acuerdo de licencia sin una solicitud interactiva.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Este modo es seguro para la ejecución concurrente entre múltiples inquilinos y usuarios. La clave de API no se escribe en el disco y no aparece en los archivos de registro.
Las credenciales también se pueden establecer como variables de entorno:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Compilación local sin Qlik Cloud
Generar la salida convertida y el informe de conversión en disco sin conectarse a Qlik Cloud. El modo solo local está diseñado para la evaluación de la migración, la revisión previa a la implementación y los entornos 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. Para una implementación completa, utilice el modo Compilar en Qlik Cloud o Exportar QVF. Para obtener detalles sobre las limitaciones de solo local y los casos de uso, consulte Cómo funciona la conversión.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly