# Flussi di lavoro comuni I 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](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm). ## 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. Nota di avviso 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](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm). ``` 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](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode). ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly ``` ## Scopri di più * [Riferimento argomento](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) * [Interfaccia utente](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/user-interface/index.htm)