Vanliga arbetsflöden
Senast uppdaterad: 2026-10-14Följande exempel täcker de vanligaste användningsfallen. Var och en bygger på samma kärnmönster: ange en QVW-fil, en utdatamapp och en Qlik Cloud-kontext. I alla exempel, --outputDir är utdataroten. QV2QS skapar automatiskt en undermapp uppkallad efter QVW-filen (till exempel, ./output/Sales/). Alla dessa arbetsflöden kan också utföras via den webbaserade guiden. För den guidade metoden, se Guidesteg.
Distribuera till Qlik Cloud med data
Standardmigreringsarbetsflödet. QV2QS genererar PRJ-mappen, konverterar användargränssnittet, laddar upp QVW för binär dataladdning, laddar om appen i Qlik Cloud och skapar en Excel-rapport. Den uppladdade QVW raderas och det ursprungliga laddningsskriptet återställs efter omladdning.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Exportera en QVF-fil
QV2QS bygger appen med hjälp av Qlik Cloud-motorn, exporterar resultatet som en QVF-fil och raderar sedan moln-appen. Den exporterade QVF kan importeras till en annan Qlik Cloud-klientorganisation.
Att importera QV2QS-genererade QVF-filer till Qlik Sense Enterprise Client-Managed har inte testats i alla versioner eller stöds officiellt och avråds från. För mer information, se Qlik Sense Enterprise Client-Managed kompatibilitet.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Batchmigrera ett helt QlikView-bestånd
Skanna en eller flera mappar efter alla QVW- och PRJ-par, konvertera paren parallellt, och distribuera var och en till Qlik Cloud. Använd --batchWorkers för att kontrollera samtidig åtkomst.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Bevara QlikView pixellayout
Aktivera läget för fast arbetsyta för att behålla exakta QlikView-objektpositioner och arkbakgrundsbilder. Justera skalningsfaktorer för att styra hur layouten mappas till Qlik Sense skärmdimensioner.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Uppdatera en tidigare konverterad app
Kör om konverteringen mot en befintlig Qlik Cloud-app utan att skapa en ny. QV2QS återanvänder app-ID:t från den föregående körningen.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Uppdatera en app samtidigt som dess laddningsskript bevaras
Kör om konverteringen för att uppdatera UI-skiktet i en befintlig app utan att skriva över laddningsskriptet. Mål-appen behåller sina befintliga dataanslutningar och omladdningslogik. En säkerhetskopia utan data exporteras automatiskt före uppdateringen. Lägg till --reload för att köra det befintliga skriptet och uppdatera data.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Uppdatera en app samtidigt som dess variabler bevaras
Kör konverteringen igen för att uppdatera UI-skiktet och laddningsskriptet för en befintlig app utan att skriva över variablerna. Kombinera med --preserveTargetAppScript för att behålla både laddningsskriptet och variabler från mål-appen intakta.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Konfigurera Qlik Cloud-autentisering
Konfigurera en qlik-cli-kontext innan du kör någon konvertering. Den interaktiva installationen ber om en klientorganisations-URL och en API-nyckel och lagrar autentiseringsuppgifterna för efterföljande körningar.
QV2QS.exe --setupQlikAuth
Programmatisk användning (CI/CD)
QV2QS stöder direkt autentisering utan förskapade qlik-cli-kontexter. Skicka klientorganisationens URL och API-nyckel inline. QV2QS validerar autentiseringsuppgifterna och injicerar autentiseringshuvuden i varje qlik-cli-anrop. Ingen kontextfil skapas eller ändras. Inkludera --accept-eula för att acceptera licensavtalet utan en interaktiv fråga.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Detta läge är säkert för samtidig körning över flera klienter och användare. API-nyckeln skrivs inte till disk och visas inte i loggfiler.
Autentiseringsuppgifter kan också ställas in som miljövariabler:
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
Lokal bygg utan Qlik Cloud
Generera den konverterade utdata och konverteringsrapporten på disk utan att ansluta till Qlik Cloud. Endast lokalt läge är avsett för migreringsbedömning, granskning före distribution och offline-miljöer. Den lokala byggutgången inkluderar inte medieuppladdningar, bakgrundsbildsupplösning, skapande av alternativa tillstånd eller arkpublicering. För en fullständig distribution, använd Bygg till Qlik Cloud eller Export QVF-läge. För mer information om begränsningar och användningsfall för endast lokalt, se Hur konvertering fungerar.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly