Dati e ricarica
Ultimo aggiornamento: 14/10/2026QV2QS converte l'interfaccia utente di QlikView e può caricare automaticamente i dati nell'app convertita utilizzando l'opzione Auto-binary. Abilita Reload e Auto-binary nella procedura guidata o dalla riga di comando e QV2QS gestirà automaticamente il trasferimento dei dati. Se non si utilizza Auto-binary, l'app convertita deve essere ricaricata separatamente per popolare i dati.
QV2QS converte i metadati UI di QlikView (PRJ XML) in JSON di Qlik Sense e crea l'app direttamente sul tenant Qlik Cloud. Il processo di conversione gestisce i layout del foglio, gli oggetti di visualizzazione, le espressioni e lo stile. Senza una ricarica, l'app Qlik Sense risultante non contiene dati dopo il completamento del passaggio di compilazione.
Per popolare i dati nell'app convertita, l'app deve essere ricaricata. Sono disponibili tre approcci:
- Caricamento binario automatico — QV2QS carica il file QVW originale su Qlik Cloud e utilizza un'istruzione
Binaryper caricare i dati durante la build. Questo approccio è il modo più rapido per vedere un'app funzionante con i dati immediatamente dopo la conversione. Per i dettagli, vedere Caricamento binario automatico di seguito. - Ricaricamento manuale — Se le connessioni dati sono già state create in Qlik Cloud e i file QVD o le origini dati sono accessibili, l'app può essere ricaricata dopo aver modificato lo script di caricamento. QV2QS applica una normalizzazione di base del percorso dello script di caricamento, ma i nomi delle connessioni e i percorsi delle sorgenti dati potrebbero richiedere aggiornamenti manuali.
- Ricaricamento attivato — Utilizza il flag
--reloadper attivare un ricaricamento come parte della distribuzione. La ricarica esegue lo script di caricamento così com'è. La ricarica ha esito positivo solo se le connessioni dati e le origini dati a cui si fa riferimento nello script di caricamento sono già disponibili nell'ambiente Qlik Cloud.
Due flag controllano i dati in diverse fasi. Il flag --noData ignora i dati durante la fase di build in modo da poter testare la struttura dell'app senza attendere un ricaricamento. Il flag --exportQvfNoData esporta il QVF senza dati al termine della build, generando un file di dimensioni più ridotte per la condivisione. I flag possono essere utilizzati in modo indipendente o insieme.
Caricamento binario automatico
Il caricamento binario automatico carica il file QVW originale su Qlik Cloud, utilizza un'istruzione Binary per caricare i dati nell'app convertita e quindi rimuove il file caricato. L'app convertita riceve gli stessi dati dell'originale QlikView senza richiedere la configurazione manuale della connessione dati.
Per abilitare il caricamento binario automatico, utilizzare --autoBinary sulla riga di comando o abilitare Auto-binary nell'interfaccia utente.
QV2QS esegue i seguenti passaggi quando è abilitato il caricamento binario automatico:
- Carica il file QVW su Qlik Cloud come app temporanea.
- Anteporre un'istruzione
Binary [<appId>];e un'istruzioneExit Script;allo script di caricamento dell'app convertita. - Crea l'app (e ricarica se viene specificato
--reload), che carica i dati dal QVW caricato. - Eliminare l'app temporanea caricata da Qlik Cloud.
- Ripristinare lo script di caricamento originale nell'app Qlik Cloud, rimuovendo le istruzioni Binary ed Exit Script.
Dopo la pulizia, l'app Qlik Cloud contiene i dati caricati, ma lo script di caricamento non fa più riferimento all'app temporanea.
Il passaggio di caricamento è soggetto ai limiti sulle dimensioni dei file di Qlik Cloud. I file QVW di grandi dimensioni potrebbero superare il limite di caricamento per il livello di abbonamento del tenant. Se il caricamento non riesce, distribuire l'app in uno spazio con il supporto per app di grandi dimensioni abilitato, oppure utilizzare l'argomento --binaryAppId per fare riferimento a un'app esistente già presente in Qlik Cloud. Per informazioni dettagliate sui limiti delle risorse del tenant, vedere Limiti delle risorse di Qlik Cloud.
Pulizia in caso di errore
Se il passaggio di compilazione o di ricaricamento non riesce dopo che il file QVW è stato caricato, QV2QS tenta automaticamente di eseguire la pulizia prima di uscire. La pulizia include l'eliminazione dell'app temporanea caricata da Qlik Cloud e il ripristino dello script di caricamento originale sia in locale che nell'app Cloud.
Se la pulizia stessa non riesce (ad esempio, a causa di un'interruzione di rete), l'app temporanea potrebbe rimanere nel tenant Qlik Cloud. Le app temporanee orfane sono denominate QV2QS_Binary_YYYYMMDD_HHMMSS (ad esempio, QV2QS_Binary_20260219_143025). Verificare la presenza di app corrispondenti a questo pattern nello spazio di destinazione ed eliminarle manualmente. Il file locale script.qvs nella directory di compilazione può contenere anche l'istruzione temporanea Binary. Esegui nuovamente la conversione per rigenerarlo.
Il caricamento binario automatico richiede il flag --reload e un percorso --qvw. QV2QS rifiuta il comando e termina con il codice 1 se manca uno dei due requisiti.
Il file QVW originale sul computer locale non viene mai modificato o eliminato. Solo la copia temporanea in Qlik Cloud viene rimossa al termine del caricamento dei dati.
Il caricamento binario automatico non è supportato per le app che utilizzano Section Access. Il motore di ricarica di Qlik Cloud non è in grado di eseguire l'autenticazione rispetto alla tabella Section Access nel file QVW di origine. Quando QV2QS rileva Section Access nell'app di origine, i passaggi di upload binario e ricaricamento vengono saltati e viene registrato un avviso. L'app viene distribuita senza dati. Per caricare i dati, creare connessioni dati Qlik Cloud e aggiornare manualmente lo script di caricamento, oppure rimuovere Section Access da una copia del QVW sorgente ed eseguire nuovamente con --autoBinary.
Quando --preserveTargetAppScript viene combinato con --reload, la ricarica esegue lo script di caricamento esistente nell'app di destinazione, non lo script convertito. Questo è utile quando l'app di destinazione dispone già di connessioni dati Qlik Cloud funzionanti e occorre aggiornare solo il livello UI. Per i dettagli, consulta Riutilizzo di un'app esistente.