Avvio rapido
Ultimo aggiornamento: 14/10/2026Eseguire una prima conversione end-to-end utilizzando la procedura guidata o la riga di comando.
Prerequisiti
- Una macchina Windows (Windows 10, 11 o Windows Server 2019, 2022, 2025)
- Una copia del documento QlikView (
.qvwo un file.qvfcreato da QlikView) in una cartella di lavoro locale. I file QVF di Qlik Sense non sono input sorgente validi. Non puntare QV2QS a file di produzione su unità condivise o punti di montaggio di QlikView Server. Per i dettagli, vedere Sicurezza del file sorgente. In alternativa, utilizzare uno dei progetti di esempio inclusi. Vedi Progetti di esempio. - Un tenant Qlik Cloud con accesso tramite chiave API abilitato (per la distribuzione cloud). Per le istruzioni di configurazione, vedere Configurazione dell'accesso a Qlik Cloud.
Utilizzo della procedura guidata
Procedere come segue:
- Fare doppio clic
QV2QS.exe. Al primo avvio, QV2QS visualizza un contratto di licenza. Accetta l'accordo per continuare. La procedura guidata si apre nel browser predefinito. - Nel passaggio Configurazione, selezionare Crea in Qlik Cloud.
- Nella fase Progetto, selezionare il file QVW. Mantieni Generazione automatica PRJ abilitata (estrae il QVW in un set di file XML e di testo che QV2QS legge durante la conversione).
- Nella fase Output, selezionare una cartella radice di output. QV2QS crea automaticamente una sottocartella denominata come il file QVW.
- Nel passaggio autenticazione Qlik Cloud, immettere l'URL del tenant e la chiave API. La procedura guidata convalida la connessione.
- Nel passaggio Qlik Cloud app, immettere un nome per l'app. Abilita Ricarica e Auto-binario per popolare l'app con i dati.
- Nella fase Revisione, verificare il riepilogo della configurazione. La procedura guidata include anche i passaggi Stile, Avanzato e Rapporto di conversione con valori predefiniti ragionevoli. Adatta questi passaggi secondo necessità prima dell'esecuzione.
- Fare clic su Esegui. QV2QS genera la cartella PRJ, converte l'interfaccia utente di QlikView, distribuisce l'app su Qlik Cloud e genera un report di conversione.
Dopo il completamento della conversione, il dashboard del riepilogo esecutivo visualizza le metriche di conversione e gli elementi da seguire. Apri l'app Qlik Cloud direttamente dal riepilogo per rivedere i fogli convertiti.
Utilizzo della riga di comando
L'esempio seguente genera una cartella PRJ da un file QVW, converte l'interfaccia utente, distribuisce l'app su Qlik Cloud con i dati e genera un report Excel:
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Il --autoBinary flag carica temporaneamente il file QVW su Qlik Cloud in modo che l'app convertita possa caricare i dati tramite un'istruzione Binary. Dopo il completamento del ricaricamento, QV2QS elimina il file caricato e ripristina lo script di caricamento originale nell'app Cloud.
QV2QS applica valori predefiniti per le opzioni non specificate sulla riga di comando. L'output della console utilizza una formattazione avanzata in modalità scura, un rapporto di conversione viene generato automaticamente, e il layout della griglia dinamica viene utilizzato a meno che non sia abilitata la modalità tela fissa. Per l'elenco completo degli argomenti e dei valori predefiniti, consulta Riferimento agli argomenti.
Cosa aspettarsi
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. Il passaggio di conversione locale (estrazione PRJ, analisi XML e generazione JSON) viene eseguito in meno di 30 secondi anche per applicazioni complesse. Distribuzione cloud e creazione di app aggiungono da uno a tre minuti. Il tempo di ricarica dipende interamente dal volume dei dati e dalla configurazione della sorgente dati. Per una scomposizione dettagliata dei tempi per fase della pipeline, consulta Come funziona la conversione.
Cosa viene prodotto
Dopo una conversione riuscita, la sottocartella del progetto (ad esempio, ./output/Sales/) contiene la struttura dell'app convertita, i media estratti, un rapporto di conversione e i log diagnostici. Per una descrizione completa, vedere Come funziona la conversione.