Passaggi della procedura guidata
Ultimo aggiornamento: 14/10/2026L'interfaccia utente è un'interfaccia a procedura guidata per l'intero processo di conversione. La procedura guidata si apre nel browser predefinito dopo aver fatto doppio clic su QV2QS.exe o aver eseguito il file eseguibile con il flag --ui. Il numero di versione attuale è visualizzato nella finestra di dialogo Informazioni. Un pulsante di attivazione/disattivazione del tema nell'angolo in alto a destra passa dalla modalità chiara a quella scura. Per maggiori informazioni, vedere Modalità scura.
La procedura guidata presenta i seguenti passaggi nell'ordine. I passaggi che non si applicano alla modalità di flusso di lavoro selezionata vengono nascosti automaticamente.
Configurazione
Seleziona una modalità di flusso di lavoro (obbligatorio). La modalità selezionata determina quali passaggi successivi sono disponibili.
- Crea in Qlik Cloud (predefinito) — converte l'interfaccia utente di QlikView e distribuisce l'app risultante direttamente al tenant di Qlik Cloud. Scegli questa modalità per visualizzare l'app convertita in Qlik Cloud immediatamente. Questa modalità è il flusso di lavoro consigliato per la migrazione.
- Esporta QVF — converte l'interfaccia utente di QlikView utilizzando il motore di Qlik Cloud, esporta l'app risultante come file QVF, quindi elimina l'app cloud. Scegli questa modalità per produrre un file da condividere con un altro team o da importare in un tenant diverso. Questa modalità richiede comunque un tenant Qlik Cloud e una chiave API. L'importazione in Qlik Sense Enterprise Client-Managed non è testata su tutte le versioni o ufficialmente supportata. Per i dettagli, vedere compatibilità con Qlik Sense Enterprise Client-Managed.
- Solo locale — esegue la conversione su disco senza connettersi a Qlik Cloud. Non è richiesto alcun tenant Qlik Cloud o chiave API. La modalità solo locale genera il rapporto di conversione completo e l'output di build per valutazione, revisione o uso offline. L'output della build locale non include caricamenti di media, risoluzione delle immagini di sfondo, creazione di stati alternativi o pubblicazione di fogli — queste operazioni richiedono la fase di distribuzione. Per una distribuzione completa, utilizzare Build to Qlik Cloud o la modalità Export QVF. Per i dettagli sulle limitazioni della modalità solo locale, vedere Come funziona la conversione. L'utilizzo di QSECM con l'output di build non è testato su tutte le versioni o ufficialmente supportato. Per i dettagli, vedere compatibilità con Qlik Sense Enterprise Client-Managed.
Progetto
Configura la sorgente di input. Effettuare una delle seguenti operazioni:
- Progetto singolo (predefinito): fornire un file QVW (obbligatorio). Generazione automatica PRJ è abilitata per impostazione predefinita e genera automaticamente la cartella PRJ dal file QVW. Disabilita questa opzione per fornire manualmente una cartella PRJ o un file ZIP. Fai clic su Prova esempio per caricare un progetto di esempio predefinito senza dover navigare. Il pulsante è visibile solo quando il campo QVW è vuoto. Vedi Progetti di esempio.
- Lotto: fornire una o più cartelle da scansionare (obbligatorio). QV2QS scopre ricorsivamente tutte le coppie QVW e PRJ corrispondenti. Fai clic su Prova l'esempio per popolare il campo cartella con la cartella degli esempi inclusi. Lavoratori batch controlla quante conversioni vengono eseguite in parallelo (predefinito: rilevamento automatico basato sui core della CPU). Per maggiori informazioni, vedere Conversione batch.
Puntare sempre QV2QS a copie dei documenti di origine in una cartella di lavoro locale, non ai file di produzione su QlikView Server o unità di rete condivise. Il motore QlikView Desktop acquisisce un blocco file durante la generazione PRJ, che può entrare in conflitto con sessioni QlikView attive. Per i dettagli, vedere Sicurezza dei file sorgente.
Output
Imposta la cartella radice di output (obbligatorio). QV2QS crea automaticamente una sottocartella con il nome del progetto all'interno della radice di output (ad esempio, <outputDir>/Sales/). Se due progetti condividono lo stesso nome, viene aggiunto un suffisso _2, _3 per evitare collisioni. Abilita Pulizia log per eliminare i file di log esistenti prima dell'esecuzione.
Qlik Cloud autenticazione
Questo passaggio appare solo nelle modalità Build to Qlik Cloud ed Export QVF.
Selezionare o creare un contesto qlik-cli per l'autenticazione con il tenant di Qlik Cloud (obbligatorio). Crea un nuovo contesto fornendo l'URL del tenant e la chiave API. La procedura guidata convalida la connessione prima di procedere.
Qlik Cloud app
Questo passaggio appare solo nelle modalità Build to Qlik Cloud ed Export QVF.
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Nome app | Nome per l'app Qlik Sense in Qlik Cloud | Nome file QVW, nome cartella PRJ o nome cartella di output |
| Ricarica | Ricarica l'app dopo la creazione per eseguire lo script di caricamento | Su |
| Auto-binario | Carica temporaneamente il file QVW per il caricamento dei dati binari, quindi elimina il file dopo il ricaricamento. Richiede Ricarica. | Su |
| AppId binario | Usa un'app QVW o QVF esistente in Qlik Cloud per il caricamento binario invece di caricarla. Richiede Ricarica. Fare clic sul pulsante Sfoglia per aprire il selettore QVW. | — |
| Riutilizza app esistente | Aggiorna un'app creata in precedenza invece di crearne una nuova. Quando abilitato, QV2QS controlla la cartella di output per una precedente distribuzione corrispondente al file QVW selezionato e popola automaticamente l'ID dell'app. Se non viene trovata alcuna distribuzione precedente, immettere manualmente l'ID dell'app o fare clic sul pulsante Sfoglia per aprire il selettore QVF. | Disattivato |
| Preserva script di caricamento | Mantieni lo script di caricamento esistente nell'app di destinazione. Lo script convertito non è applicato. Richiede Riutilizzo dell'app esistente. Disattiva Ricarica per impostazione predefinita; riattiva per eseguire lo script esistente. | Disattivato |
| Preserva variabili | Mantieni le variabili esistenti nell'app di destinazione. Le variabili convertite non sono applicate. Richiede Riutilizza l'app esistente. | Disattivato |
| Saltare il backup pre-distribuzione | Non esportare un backup QVF prima di sovrascrivere l'app. Per impostazione predefinita, un backup senza dati viene salvato in cloud/backups/. Richiede Riutilizza l'app esistente. |
Disattivato |
| Pubblica fogli | Pubblica tutti i fogli convertiti come fogli base dopo la creazione. I fogli base sono visibili a ogni utente che ha accesso all'app. Disabilita questa impostazione per mantenere i fogli come oggetti personali (non pubblicati). Quando Riutilizza app esistente è abilitato, l'impostazione si applica solo ai nuovi fogli. I fogli pubblicati in precedenza vengono ripristinati automaticamente indipendentemente da questa impostazione. | Su |
| Crea senza dati | Salta il caricamento dei dati durante la fase di compilazione. L'app è assemblata sul tenant senza dati, consentendo di testare la struttura dell'interfaccia utente senza attendere un ricaricamento. | Disattivato |
| Esporta senza dati | Rimuovi i dati dal file QVF esportato. L'app cloud potrebbe ancora contenere dati dalla build, ma il QVF scaricato è più piccolo. Esporta solo in modalità QVF. | Disattivato |
I campi ID app binaria e Riutilizza app esistente includono pulsanti Sfoglia che aprono modali di selezione dell'app cloud. Ogni selettore carica le app dal tenant connesso con filtro di ricerca per nome, proprietario, spazio o ID app. Il selettore QVW fornisce anche un filtro per il tipo di app (QVW, QVF o tutti). Seleziona un'app dall'elenco per popolare automaticamente il campo.
Regolazioni dell'espressione
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Correggi i valori di ricerca con virgolette singole | Converti i caratteri jolly e i confronti racchiusi tra virgolette singole in virgolette doppie nelle espressioni di analisi set. Per maggiori informazioni, vedere Riferimento argomenti. | Su |
| Correggi valori impostati non quotati (sperimentale) | Avvolgi i valori stringa non quotati tra virgolette singole nelle espressioni di analisi set. Per maggiori informazioni, vedere Riferimento argomenti. | Disattivato |
Stile
Le seguenti impostazioni controllano l'aspetto del foglio e il comportamento del layout.
Tema
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Tema dell'app | Tema Qlik Sense applicato all'app convertita. L'elenco a discesa elenca i quattro temi Qlik predefiniti. Quando un contesto Qlik Cloud è configurato, fare clic sul pulsante di aggiornamento per recuperare i temi personalizzati installati sul tenant. Sense Classic produce la massima fedeltà 1:1 con QlikView. I temi non classici possono alterare i bordi degli oggetti, i colori di sfondo, i caratteri e la spaziatura interna. Il tema imposta solo l'impostazione predefinita; gli utenti possono cambiare tema in qualsiasi momento nel client Qlik Sense. | Sense Classic |
Sfondi
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Immagini di sfondo del foglio | Estrarre e applicare sfondi del foglio QlikView | Su |
| Ripiega sullo sfondo del documento | Utilizza lo sfondo a livello di documento per i fogli che non ne hanno uno | Su |
| Sostituzione colore sfondo | Riempimento a tinta unita applicato a tutti i fogli (#RRGGBB) |
— |
Layout
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Mostra intestazione foglio | Aggiungi un'area di intestazione ai fogli convertiti | Disattivato |
| Salta fogli nascosti | Ometti fogli con condizioni di visualizzazione costantemente false | Disattivato |
Listbox & ordinamento
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Mantieni i colori delle listbox QV | Applica i colori di sfondo e la trasparenza originali della casella di riepilogo di QlikView | Su |
| Protezione ordinamento campo data | Mantieni i campi listbox di tipo data (Anno, Trimestre, Mese e simili) ordinati cronologicamente invece che per stati di selezione. Per maggiori informazioni, vedere Riferimento argomenti. | Su |
Avanzate
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Tela fissa del foglio | Abilita il posizionamento accurato al pixel in stile QlikView. Mostra fattori di scala, dimensioni minime e opzioni di ritaglio della tela. La scala della tela e la scala dell'oggetto sono collegate per impostazione predefinita; fare clic sull'icona della catena per impostare valori indipendenti. Per maggiori informazioni, vedere Impostazioni del layout di conversione. | Su |
| Estensione automatica del foglio dinamico | Consenti ai fogli di crescere verticalmente oltre l'altezza predefinita della griglia | Su |
| Addetti al caricamento dei media | Numero di worker paralleli per il caricamento di file multimediali (sfondi e immagini) su Qlik Cloud. Si applica a Build to Qlik Cloud e modalità Export QVF. | 2
|
| Sostituzioni Script | Attiva o disattiva l'elaborazione della sostituzione dello script e gestisci le singole regole. Per maggiori informazioni, vedere Riferimento argomenti. | Su |
La sezione Sostituzioni Script include un editor di regole inline. Attiva/disattiva l'interruttore principale per abilitare o disabilitare tutta l'elaborazione degli script. Espandi la sezione per visualizzare, aggiungere, modificare o eliminare singole regole. Ogni regola può essere attivata o disattivata indipendentemente. Fai clic su Ripristina impostazioni predefinite per ripristinare le otto regole predefinite. Un badge di riepilogo mostra il numero di regole abilitate.
Fare clic sui pulsanti freccia su e giù su una regola per modificare l'ordine di esecuzione. Le regole con un ordine di esecuzione inferiore vengono eseguite per prime. Fai clic su Export per il download di tutte le regole come file JSON. Fai clic su Importa per caricare le regole da un file JSON, sostituendo quelle attuali. I file importati devono contenere un array JSON in cui ogni regola ha un campo description, pattern e search.
Per creare un file di regole personalizzato per l'importazione, fare clic su Esporta prima per ottenere le regole predefinite nel formato corretto. Modifica il file esportato per aggiungere, rimuovere o modificare regole, quindi fai clic su Importa per caricare il set aggiornato.
Quando vengono configurate regole personalizzate o impostazioni predefinite disabilitate, l'anteprima del comando visualizza un avviso. Il comando copiato non include regole personalizzate. Esporta le regole in un file JSON e aggiungi --scriptReplacements <path> al comando per includere regole personalizzate sulla riga di comando.
Per una spiegazione di come funzionano le regole, incluso il processo di corrispondenza a due fasi e l'elenco di regole predefinite, vedi Riferimento agli argomenti.
Apri Mockup Studio dal passaggio Avanzate per visualizzare in anteprima in modo interattivo i layout a tela fissa e a griglia dinamica, regolare la scalatura e applicare le impostazioni di nuovo alla procedura guidata.
Rapporto di conversione
Le seguenti impostazioni controllano l'output report di conversione.
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Genera report | Genera un rapporto di conversione della console | Su |
| Report Excel | Esporta il report come file XLSX con dettagli per oggetto e punteggio di automazione. Inserisci un nome file (ad es. MyReport) o un percorso completo. L' .xlsx estensione viene aggiunta automaticamente. Lascia vuoto per assegnare automaticamente un nome in reports/. |
Su |
| Includi selezioni e oggetti di ricerca | Includi la casella Selezioni correnti e l'oggetto Cerca nel report. Questi vengono aggiunti automaticamente da Qlik Sense e esclusi per impostazione predefinita. | Disattivato |
Rivedi
Conferma tutte le impostazioni prima di eseguire. La fase di revisione visualizza schede di riepilogo per il progetto, il flusso di lavoro, il cloud e la configurazione di output. In modalità batch, una tabella elenca tutti i progetti scoperti.
Una lista di controllo delle azioni richieste nella barra laterale tiene traccia degli elementi che devono essere configurati prima dell'esecuzione. Gli elementi sono raggruppati per categoria: flusso di lavoro, input, output e autenticazione cloud. Ogni elemento mostra OK quando configurato o DA IMPOSTARE quando manca un valore. Fai clic su un elemento per navigare direttamente al passaggio pertinente della procedura guidata.
Un pannello di anteprima del comando visualizza il comando CLI equivalente per la configurazione corrente della procedura guidata. Alterna tra la sintassi di PowerShell e Bash. Fare clic su Copia per copiare il comando negli Appunti. L'anteprima del comando è utile per apprendere gli argomenti della CLI o salvare il comando esatto per riesecuzioni tramite script.
Fai clic su Esegui per avviare la conversione.
Esegui
Visualizza l'output della console in tempo reale mentre la conversione è in esecuzione. Interrompi una conversione in corso, segui i log in tempo reale e apri la cartella di output o l'app Qlik Cloud al completamento dell'esecuzione.