Flussi di lavoro comuni
Ultimo aggiornamento: 14/10/2026I seguenti esempi coprono i casi d'uso più frequenti. Ciascuno si basa sullo stesso schema fondamentale: specificare un file QVW, una cartella di output e un contesto Qlik Cloud. In tutti gli esempi, --outputDir è la radice di output. QV2QS crea automaticamente una sottocartella denominata come il file QVW (ad esempio, ./output/Sales/). Tutti questi flussi di lavoro possono essere eseguiti anche tramite la procedura guidata basata sul web. Per l'approccio guidato, vedere Passaggi della procedura guidata.
Distribuisci su Qlik Cloud con i dati
Il flusso di lavoro di migrazione standard. QV2QS genera la cartella PRJ, converte l'interfaccia utente, carica il QVW per il caricamento dei dati binari, ricarica l'app in Qlik Cloud e produce un report Excel. Il QVW caricato viene eliminato e lo script di caricamento originale viene ripristinato dopo il ricaricamento.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Esporta un file QVF
QV2QS crea l'app utilizzando il motore di Qlik Cloud, esporta il risultato come file QVF, quindi elimina l'app cloud. Il QVF esportato può essere importato in un diverso tenant di Qlik Cloud.
L'importazione di file QVF generati da QV2QS in Qlik Sense Enterprise Client-Managed non è testata su tutte le versioni o ufficialmente supportata ed è sconsigliata. Per i dettagli, vedere compatibilità di Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Migrare in batch un intero ambiente QlikView
Scansiona una o più cartelle per tutte le coppie QVW e PRJ, converti le coppie in parallelo e distribuisci ciascuna a Qlik Cloud. Utilizza --batchWorkers per controllare la concorrenza.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Conserva il layout pixel di QlikView
Abilita la modalità tela fissa per mantenere esatte le posizioni degli oggetti QlikView e gli sfondi del foglio. Regola i fattori di scala per controllare come il layout si mappa alle dimensioni dello schermo di Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Aggiorna un'app precedentemente convertita
Riesegui la conversione su un'app Qlik Cloud esistente senza crearne una nuova. QV2QS riutilizza l'ID dell'app dall'esecuzione precedente.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Aggiorna un'app preservando il suo script di caricamento
Esegui nuovamente la conversione per aggiornare il livello UI di un'app esistente senza sovrascrivere lo script di caricamento. L'app di destinazione mantiene le sue connessioni dati esistenti e la logica di ricaricamento. Un backup senza dati viene esportato automaticamente prima dell'aggiornamento. Aggiungi --reload per eseguire lo script esistente e aggiornare i dati.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Aggiorna un'app mantenendo le sue variabili
Riesegui la conversione per aggiornare il livello dell'interfaccia utente e lo script di caricamento di un'app esistente senza sovrascrivere le variabili. Combina con --preserveTargetAppScript per mantenere intatti sia lo script di caricamento che le variabili dell'app di destinazione.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Configura l'autenticazione di Qlik Cloud
Configura un contesto qlik-cli prima di eseguire qualsiasi conversione. La configurazione interattiva richiede un URL del tenant e una chiave API e memorizza le credenziali per le esecuzioni successive.
QV2QS.exe --setupQlikAuth
Utilizzo programmatico (CI/CD)
QV2QS supporta l'autenticazione diretta senza contesti qlik-cli pre-creati. Passa l'URL del tenant e la chiave API inline. QV2QS verifica le credenziali e inietta le intestazioni di autenticazione in ogni chiamata qlik-cli. Nessun file di contesto viene creato o modificato. Utilizzare --accept-eula per accettare il contratto di licenza senza una richiesta interattiva.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Questa modalità è sicura per l'esecuzione concorrente su più tenant e utenti. La chiave API non viene scritta su disco e non compare nei file di log.
Le credenziali possono anche essere impostate come variabili di ambiente:
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
Build locale senza Qlik Cloud
Genera l'output convertito e il report di conversione su disco senza connettersi a Qlik Cloud. La modalità solo locale è destinata alla valutazione della migrazione, alla revisione pre-distribuzione e agli ambienti offline. L'output della build locale non include caricamenti di media, risoluzione dell'immagine di sfondo, creazione di stati alternativi o pubblicazione di fogli. Per una distribuzione completa, utilizzare Build to Qlik Cloud o la modalità Export QVF. Per i dettagli sulle limitazioni solo locali e sui casi d'uso, consultare Come funziona la conversione.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly