Come funziona la conversione

Ultimo aggiornamento: 14/10/2026

La pipeline di conversione ha le seguenti fasi:

Estrazione — Se --generatePrj è abilitato, QV2QS avvia QlikView Desktop per estrarre il file QVW in una cartella PRJ. QV2QS utilizza il motore portatile in bundle, a meno che non venga rilevata un'installazione di sistema di QlikView Desktop. Per i dettagli, vedere motore QlikView Desktop.
Analizza — QV2QS legge la cartella PRJ e analizza ogni definizione di oggetto, layout del foglio, script di caricamento, variabile e proprietà del documento. QV2QS legge anche il binario QVW/QVF direttamente per estrarre metadati, variabili e qualsiasi script di caricamento nascosto incorporato nel file.
Converti — Ogni oggetto QlikView è mappato a un tipo di visualizzazione Qlik Sense. Dimensioni, misure, espressioni, stile e posizioni del layout vengono tradotti nel formato JSON di Qlik Sense.
Scrivi — QV2QS scrive la struttura dell'app convertita nella cartella di output come un insieme di file JSON.
Distribuzione (solo in modalità cloud) — QV2QS crea l'app sul tenant, carica i media, costruisce l'app e, facoltativamente, ricarica l'app con i dati.
Report — QV2QS genera un report di conversione che riassume i risultati, il punteggio di automazione e qualsiasi elemento che richieda un seguito manuale.

La fase di distribuzione viene eseguita nelle modalità Build to Qlik Cloud ed Export QVF. In modalità solo locale, QV2QS scrive l'output convertito su disco senza connettersi a Qlik Cloud. La fase di report viene eseguita in tutte le modalità.

Modalità di conversione

QV2QS supporta tre modalità di conversione. Selezionare la modalità nel passaggio Configurazione della procedura guidata o con il flag CLI corrispondente.

Modalità	Flag CLI	Qlik Cloud richiesto	Output	Fase di distribuzione
Costruisci su Qlik Cloud	(predefinito)	Sì	App distribuita a tenant	Sì — crea l'app, carica i contenuti multimediali, costruisce, pubblica i fogli
Esporta QVF	`--exportQvf`	Sì	File QVF su disco	Sì — crea l'app in Qlik Cloud, esporta come QVF, quindi elimina l'app cloud
Solo locale	`--unbuildOnly`	No	Cartella di build e rapporto di conversione su disco	No

La creazione in Qlik Cloud è la modalità consigliata per la migrazione. L'esportazione QVF è utile per produrre un file portatile da condividere o importare in un tenant diverso. La modalità solo locale è destinata alla valutazione e alla revisione. Per i dettagli sulle limitazioni solo locali, vedere la sezione seguente.

L'interfaccia utente è predefinita su modalità tela fissa, ricarica abilitata e auto-binario abilitato. La CLI per impostazione predefinita usa la modalità griglia dinamica, la ricarica disabilitata e l'auto-binario disabilitato. Quando si passa dalla procedura guidata alla CLI, specificare esplicitamente questi flag per corrispondere al comportamento della procedura guidata. Per l'elenco completo degli argomenti e dei valori predefiniti, consultare Riferimento agli argomenti.

Modalità solo locale

La modalità solo locale (--unbuildOnly) esegue le fasi di analisi, conversione, scrittura e reporting senza connettersi a Qlik Cloud. Nessun tenant o chiave API è richiesto. QV2QS genera il rapporto di conversione completo, il riepilogo esecutivo e la cartella di output della build su disco.

Casi d'uso

Valutazione della migrazione — Esegui la modalità Solo locale per generare il report di conversione, il riepilogo esecutivo, il punteggio di automazione e i risultati delle espressioni senza richiedere l'accesso a Qlik Cloud. Valutare la qualità della conversione su un intero patrimonio QVW prima di configurare le credenziali del tenant.
Revisione pre-distribuzione — Esaminare l'output generato (script di caricamento, definizioni di oggetti, variabili, dimensioni) prima di procedere con una distribuzione nel cloud. Organizzazioni con processi di controllo delle modifiche possono rivedere l'output come un artefatto intermedio.
Ambienti offline o con restrizioni — Quando la macchina che ospita i file QVW non ha accesso a Internet in uscita, eseguire la modalità Solo locale per generare il rapporto di conversione in locale. Per distribuire l'app convertita, copiare i file QVW su una macchina con accesso a Qlik Cloud ed eseguire QV2QS in modalità Build to Qlik Cloud dalla macchina connessa.

Limiti

La fase di distribuzione gestisce diverse operazioni che qlik app build da sola non esegue. L'esecuzione della modalità Solo locale e la successiva distribuzione manuale della cartella build/ con un'installazione standalone di qlik-cli comporta le seguenti lacune.

I file multimediali non sono stati caricati. Immagini di sfondo e immagini dei pulsanti vengono estratte nella images/ cartella ma non sono incluse nella build/ cartella. Il qlik app build comando non elabora i file multimediali. Tutte le immagini di sfondo e le immagini dei pulsanti mancheranno dall'app distribuita.
I riferimenti allo sfondo di fogli e oggetti non sono risolti. QV2QS inietta gli URL delle immagini di sfondo nel foglio e nei file JSON degli oggetti durante la fase di distribuzione utilizzando l'ID dell'app cloud. L'output della build locale non contiene riferimenti a immagini di sfondo. Fogli e oggetti non avranno sfondi nell'app distribuita.
Gli URL delle immagini dei pulsanti contengono stringhe segnaposto. Le immagini dei pulsanti nell'output della build locale utilizzano valori segnaposto interni invece di URL multimediali risolti. Il motore Qlik Sense non può interpretare le stringhe segnaposto. Le immagini dei pulsanti appariranno danneggiate.
Gli stati alternativi non vengono creati. I nomi di stato alternativi vengono scritti in cloud/alternate_states.json al di fuori della build/ cartella. Il qlik app build comando non elabora stati alternati. Oggetti che fanno riferimento a stati non predefiniti potrebbero non essere visualizzati correttamente.
I fogli non sono pubblicati. Il comando qlik app build crea fogli come oggetti personali visibili solo al proprietario dell'app. QV2QS pubblica i fogli come fogli base durante la fase di distribuzione. In uno spazio condiviso, gli altri utenti non vedranno nessun foglio finché i fogli non saranno pubblicati manualmente.

Per una distribuzione completa che include il caricamento di media, la risoluzione dello sfondo, la creazione di stati alternativi e la pubblicazione di fogli, utilizzare la modalità Crea in Qlik Cloud o la modalità Esporta QVF invece della modalità Solo locale.

Sicurezza del file sorgente

QV2QS non modifica il contenuto del file QVW o QVF sorgente. Durante la fase di estrazione, QV2QS apre il documento di origine tramite QlikView Desktop e salva una copia temporanea in una cartella temporanea di sistema. QV2QS quindi chiude l'originale e genera la cartella PRJ dalla copia temporanea. Dopo il completamento della generazione PRJ, QV2QS copia la cartella risultante -prj nella stessa directory del file sorgente e cancella la copia temporanea. Se una -prj cartella esiste già accanto al file sorgente, QV2QS sostituisce la cartella con la versione appena generata. Tutti gli altri output di conversione vengono scritti nella directory di output separata specificata da --outputDir.

QlikView Desktop acquisisce un blocco file sul documento di origine mentre viene creata la copia temporanea. L'esecuzione di QV2QS su un file aperto attivamente in QlikView Desktop o servito da QlikView Server può causare conflitti di blocco file o la generazione PRJ non riuscita. I file su unità di rete condivise possono causare gli stessi conflitti. Scrivere la -prj cartella di nuovo in una condivisione di rete o in una directory di sola lettura può anche fallire.

Per evitare qualsiasi rischio per gli ambienti di produzione, lavorare sempre con copie dei documenti sorgente. Procedere come segue:

Copia i file QVW o QVF in una cartella di lavoro locale sulla macchina in cui è in esecuzione QV2QS.
Punta QV2QS ai file copiati, non agli originali.
Chiudere eventuali istanze di QlikView Desktop in esecuzione prima di avviare la conversione. QV2QS richiede accesso esclusivo a QlikView Desktop.

Non eseguire QV2QS direttamente su cartelle di documenti di QlikView Server, condivisioni di rete di produzione o file aperti in QlikView Desktop. Utilizzare sempre una copia locale dei documenti di origine.

Tempistiche tipiche

QV2QS è progettato per la velocità. La pipeline completa si completa in minuti, non in ore. La tabella seguente mostra le durate tipiche per una conversione di una singola app.

Fase	Durata tipica	Note
Estrazione (generazione PRJ)	5–15 secondi	Dipende dalla complessità del QVW. Saltato se una cartella PRJ esiste già.
Analizza + Converti + Scrivi	Meno di 30 secondi	Il nucleo della conversione da XML a JSON. Gestisce app complesse con centinaia di oggetti.
Distribuisci (cloud build)	1–3 minuti	Include la creazione di app, il caricamento di media e la compilazione dell'app sul tenant.
Ricarica	Varia	Dipende da volume di dati, latenza della sorgente dati e risorse del tenant. Un caricamento binario di un QVW tipico si completa in meno di un minuto.

Una conversione di una singola app con distribuzione nel cloud e ricaricamento dei dati si completa in genere in due o cinque minuti end-to-end. Le conversioni solo locali (--unbuildOnly) si completano in meno di 30 secondi.

In modalità batch, QV2QS converte più progetti in parallelo. Il tempo totale del batch scala con il numero di progetti diviso per il numero di lavoratori. Per un batch di 20 app con quattro worker, aspettati circa cinque volte la durata di una singola app per la fase di conversione locale, più il tempo di distribuzione nel cloud.

Struttura della cartella di output

L' --outputDir argomento specifica la radice di output. QV2QS crea una sottocartella denominata come il file QVW (o la cartella PRJ) all'interno della radice di output. Tutto l'output di conversione per il progetto viene scritto in quella sottocartella. Se due file QVW condividono lo stesso nome, QV2QS aggiunge _2, _3 e numeri successivi per evitare collisioni. Questo comportamento corrisponde alla modalità batch, dove ogni progetto riceve anche una sottocartella dedicata.

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

QV2QS crea la cartella di output se la cartella non esiste già. Se la cartella esiste da un'esecuzione precedente dello stesso QVW, QV2QS riutilizza la cartella. I file di log esistenti nella cartella vengono conservati a meno che Pulisci log non sia abilitato. La directory di output non deve essere uguale a, né una directory padre di, alcuna directory di origine. QV2QS verifica il percorso di output prima di avviare la conversione e segnala un errore se i percorsi si sovrappongono. La sottocartella del progetto contiene quanto segue:

Cartella / file	Indice
`build/`	Struttura dell'app Qlik Sense per `qlik app build`. Contiene `config.yml` (manifest di build), `script.qvs` (script di caricamento), `app-properties.json`, `connections.yml` (connessioni dati), `dimensions.json` (dimensioni master), `measures.json` (misure master), `variables.json`, e una sottocartella `objects/` con un file JSON per foglio e visualizzazione.
`images/`	File multimediali estratti (deduplicati tramite hash del contenuto) e `backgrounds.json` (manifest in background).
`reports/`	`executive_summary.json`, `executive_summary.html`, e il report di conversione Excel (`_conversion_report_.xlsx`) se abilitato.
`logs/`	File di log strutturati per esecuzione.
`cloud/`	`cloud_state.json` (ID app, hash del media, mappatura ID foglio, timestamp) e `alternate_states.json`. Creato durante la distribuzione cloud.
`qvf/`	File QVF esportati (creati quando `--exportQvf` viene utilizzato).
`.qv2qs_source`	File marcatore che registra quale QVW ha prodotto la sottocartella. QV2QS utilizza il marcatore per rilevare collisioni di nomi e per riutilizzare la cartella corretta nelle esecuzioni successive.

Apri la cartella di output direttamente dalla procedura guidata dopo il completamento di una conversione.

Dopo la conversione

Dopo il completamento di una conversione, esaminare i seguenti elementi raggruppati per priorità.

Correggi prima di pubblicare

Aprire il report di conversione Excel nella reports/ sottocartella e rivedere il foglio di lavoro Follow-up_Objects. Correggi tutti gli elementi contrassegnati come Errore per primi (oggetti che non sono stati convertiti), quindi Segnaposto (oggetti che necessitano di ricostruzione), quindi Regolazioni richieste (oggetti convertiti solo parzialmente).
Esaminare i risultati dell'analisi sul foglio di lavoro Analisi, inclusi i riferimenti alle macro, l'utilizzo di Section Access e i modelli dello script di caricamento che potrebbero richiedere un'attenzione manuale.
Verificare che le espressioni siano valutate correttamente. QV2QS risolve automaticamente i problemi di virgolettatura dell'analisi set durante la conversione. Rivedere le dimensioni calcolate, la colorazione condizionale e le espressioni che utilizzano funzioni esclusive di QlikView (GetCurrentField(), MsgBox()) che richiedono una riscrittura manuale.
Controlla il foglio di lavoro Overflow_Actions per gli oggetti in cui dimensioni o misure in eccesso sono state spostate nella raccolta delle alternative.

Verifica prima di pubblicare

Apri l'app convertita in Qlik Sense e verifica che i layout dei fogli, le posizioni degli oggetti e le immagini di sfondo vengano visualizzati come previsto.
Verificare che la navigazione del contenitore a schede (strisce di pulsanti o contenitori a schede) passi correttamente tra le aree di contenuto.
Verifica il comportamento di drill-down e di scorrimento del gruppo ciclico sui grafici che utilizzano gruppi di dimensioni.
Verificare che le condizioni di visualizzazione nascondano e rivelino gli oggetti come previsto.
Verifica gli ordinamenti su caselle di riepilogo e tabelle, in particolare per i campi simili a date.

Polacco

Regola caratteri, colori o il posizionamento degli oggetti nell'editor dell'app Qlik Sense secondo necessità. Per indicazioni sul posizionamento del layout, vedere Impostazioni del layout di conversione.

Per una descrizione completa del contenuto del rapporto, consultare Rapporto di conversione.

Scopri di più

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback