Guidesteg
Senast uppdaterad: 2026-10-14Användargränssnittet är ett guidebaserat gränssnitt för hela konverteringsprocessen. Guiden öppnas i standardwebbläsaren efter att ha dubbelklickat på QV2QS.exe eller kört den körbara filen med --ui flaggan. Det aktuella versionsnumret visas i dialogrutan Om. En temaväxlingsknapp i det övre högra hörnet växlar mellan ljust och mörkt läge. För mer information, se Mörkt läge.
Guiden presenterar följande steg i ordning. Steg som inte gäller för det valda arbetsflödesläget döljs automatiskt.
Installation
Välj ett arbetsflödesläge (obligatoriskt). Det valda läget avgör vilka efterföljande steg som är tillgängliga.
- Bygg till Qlik Cloud (standard) — konverterar QlikView-gränssnittet och distribuerar den resulterande appen direkt till Qlik Cloud-klientorganisationen. Välj det här läget för att se den konverterade appen i Qlik Cloud omedelbart. Detta läge är det rekommenderade arbetsflödet för migrering.
- Exportera QVF — konverterar QlikView-gränssnittet med hjälp av Qlik Cloud-motorn, exporterar den resulterande appen som en QVF-fil och tar sedan bort moln-appen. Välj det här läget för att skapa en fil för delning med ett annat team eller import till en annan klientorganisation. Detta läge kräver fortfarande en Qlik Cloud-klientorganisation och en API-nyckel. Import till Qlik Sense Enterprise Client-Managed har inte testats i alla versioner eller stöds officiellt. Mer information finns i Qlik Sense Enterprise Client-Managed-kompatibilitet.
- Endast lokalt — utför konverteringen på disken utan att ansluta till Qlik Cloud. Ingen Qlik Cloud-klientorganisation eller API-nyckel krävs. Lokalt läge genererar den fullständiga konverteringsrapporten och byggutdata för bedömning, granskning eller offlineanvändning. Den lokala byggutgången inkluderar inte medieuppladdningar, bakgrundsbildsupplösning, skapande av alternativa tillstånd eller arkpublicering — dessa åtgärder kräver distributionsfasen. För en fullständig distribution, använd Bygg till Qlik Cloud eller Export QVF-läge. För mer information om begränsningar för endast lokalt, se Hur konvertering fungerar. Att rikta QSECM med byggutdata är inte testat i alla versioner eller officiellt stöds. Mer information finns i Qlik Sense Enterprise Client-Managed-kompatibilitet.
Projekt
Konfigurera indatakällan. Gör ett av följande:
- Enkelt projekt (standard): ange en QVW-fil (obligatoriskt). Auto-generera PRJ är aktiverad som standard och genererar PRJ-mappen från QVW-filen automatiskt. Inaktivera det här alternativet för att tillhandahålla en PRJ-mapp eller ZIP-fil manuellt. Klicka Prova exempel för att läsa in ett medföljande exempelprojekt utan att bläddra. Knappen är synlig endast när QVW-fältet är tomt. Se Exempelprojekt.
- Batch: ange en eller flera mappar att skanna (obligatoriskt). QV2QS upptäcker alla matchande QVW- och PRJ-par rekursivt. Klicka Prova exempel för att fylla mappfältet med den medföljande exempelmappen. Batcharbetare styr hur många konverteringar som körs parallellt (standard: automatisk identifiering baserad på CPU-kärnor). För mer information, se Batchkonvertering.
Peka alltid QV2QS mot kopior av källdokument i en lokal arbetsmapp, inte mot produktionsfiler på QlikView Server eller delade nätverksenheter. QlikView Desktop-motorn förvärvar ett fillås under PRJ-generering, vilket kan komma i konflikt med aktiva QlikView-sessioner. Mer information finns i Källfilssäkerhet.
Utdata
Ange utdatarotmappen (obligatoriskt). QV2QS skapar automatiskt en undermapp namngiven efter projektet inuti utdataroten (till exempel, <outputDir>/Sales/). Om två projekt delar samma namn, läggs ett _2, _3 suffix till för att undvika kollisioner. Aktivera Rensa loggar för att ta bort befintliga loggfiler före körningen.
Qlik Cloud autentisering
Det här steget visas endast i Bygg till Qlik Cloud och Export QVF-lägen.
Välj eller skapa en qlik-cli-kontext för autentisering med Qlik Cloud-klientorganisationen (obligatoriskt). Skapa en ny kontext genom att ange klientorganisationens URL och API-nyckel. Guiden validerar kopplingen innan du fortsätter.
Qlik Cloud app
Det här steget visas endast i Bygg till Qlik Cloud och Export QVF-lägen.
| Inställning | Beskrivning | Standard |
|---|---|---|
| Appnamn | Namn för Qlik Sense appen i Qlik Cloud | QVW-filnamn, PRJ-mappnamn eller utdatamappnamn |
| Ladda igen | Ladda om appen efter byggnation för att köra laddningsskriptet | På |
| Auto-binär | Ladda tillfälligt upp QVW-filen för binär dataladdning, radera sedan filen efter omladdning. Kräver Ladda igen. | På |
| Binär App-ID | Använd en befintlig QVW- eller QVF-app i Qlik Cloud för den binära laddningen istället för att ladda upp. Kräver Ladda om. Klicka på bläddra-knappen för att öppna QVW-väljaren. | — |
| Återanvänd befintlig app | Uppdatera en tidigare skapad app istället för att skapa en ny. När aktiverat, kontrollerar QV2QS utdatamappen efter en tidigare distribution som matchar den valda QVW-filen och fyller i app-ID:t automatiskt. Om ingen tidigare distribution hittas, ange app-ID manuellt eller klicka på bläddra-knappen för att öppna QVF-väljaren. | Av |
| Bevara laddningsskript | Behåll det befintliga laddningsskriptet i mål-appen. Det konverterade skriptet har inte tillämpats. Kräver Återanvänd befintlig app. Stänger av Ladda om som standard; återaktivera för att köra det befintliga skriptet. | Av |
| Bevara variabler | Behåll de befintliga variablerna i mål-appen. De konverterade variablerna tillämpas inte. Kräver Återanvänd befintlig app. | Av |
| Hoppa över säkerhetskopiering före distribution | Exportera inte en QVF-säkerhetskopia innan du skriver över appen. Som standard sparas en säkerhetskopia utan data till cloud/backups/. Kräver Återanvänd befintlig app. |
Av |
| Publicera blad | Publicera alla konverterade blad som basblad efter byggnation. Basblad är synliga för alla användare som har tillgång till appen. Inaktivera den här inställningen för att behålla blad som personliga (opublicerade) objekt. När Återanvänd befintlig app är aktiverad, gäller inställningen endast nya ark. Tidigare publicerade blad återställs automatiskt oavsett denna inställning. | På |
| Bygg utan data | Hoppa över dataladdning under byggfasen. Appen monteras på klientorganisationen utan data, vilket gör att UI-strukturen kan testas utan att vänta på en omladdning. | Av |
| Exportera utan data | Rensa data från den exporterade QVF-filen. Moln-appen kan fortfarande innehålla data från bygget, men den nedladdade QVF är mindre. Endast QVF-läge för export. | Av |
Fälten Binär AppId och Återanvänd befintlig app innehåller bläddringsknappar som öppnar moduler för val av molnapp. Varje väljare läser in appar från den anslutna klientorganisationen med sökfiltrering efter namn, ägare, utrymme eller app-ID. QVW-väljaren tillhandahåller även ett apptypfilter (QVW, QVF eller alla). Välj en app från listan för att fylla i fältet automatiskt.
Uttrycksjusteringar
| Inställning | Beskrivning | Standard |
|---|---|---|
| Åtgärda sök värden med enkla citattecken | Konvertera enkelt citerade jokertecken och jämförelser till dubbla citattecken i uttryck för mängdanalys. Mer information finns i Argumentreferens. | På |
| Åtgärda omarkerade inställda värden (experimentell) | Omge o-citerade rena strängvärden med enkla citattecken i mängdanalysuttryck. Mer information finns i Argumentreferens. | Av |
Formatinställningar
Följande inställningar styr arkets utseende och layoutbeteende.
Tema
| Inställning | Beskrivning | Standard |
|---|---|---|
| App-tema | Qlik Sense-tema tillämpat på den konverterade appen. Listrutan listar de fyra inbyggda Qlik-teman. När en Qlik Cloud-kontext har konfigurerats, klicka på uppdateringsknappen för att hämta anpassade teman som är installerade i klientorganisationen. Sense Classic ger den högsta 1:1-troheten med QlikView. Icke-klassiska teman kan ändra objektramar, bakgrundsfärger, teckensnitt och utfyllnad. Temat anger endast standardinställningen; användare kan byta teman när som helst i Qlik Sense-klienten. | Sense Klassisk |
Bakgrunder
| Inställning | Beskrivning | Standard |
|---|---|---|
| Arkbakgrundsbilder | Extrahera och tillämpa QlikView-arkbakgrundsbilder | På |
| Återgå till dokumentbakgrund | Använd bakgrunden på dokumentnivå för blad som inte har någon | På |
| Bakgrundsfärgsåsidosättning | Enfärgfyllning tillämpad på alla blad (#RRGGBB) |
— |
Layout
| Inställning | Beskrivning | Standard |
|---|---|---|
| Visa arkrubrik | Lägg till ett sidhuvudsområde till konverterade blad | Av |
| Hoppa över dolda blad | Utelämna blad med konstant falska visningsvillkor | Av |
Listrutor och sortering
| Inställning | Beskrivning | Standard |
|---|---|---|
| Behåll QV-listrutefärger | Tillämpa ursprungliga QlikView-listrutans bakgrundsfärger och transparens | På |
| Skydd för sortering av datumfält | Behåll datumliknande listrutefält (År, Kvartal, Månad och liknande) sorterade kronologiskt istället för efter urvalstillstånd. Mer information finns i Argumentreferens. | På |
Avancerat
| Inställning | Beskrivning | Standard |
|---|---|---|
| Fast ark-arbetsyta | Aktivera pixelprecis positionering i QlikView-stil. Visar skalfaktorer, minimimått och beskärningsalternativ för arbetsytan. Dukskala och objektskala är länkade som standard; klicka på kedjeikonen för att ange oberoende värden. För mer information, se Konverteringslayoutinställningar. | På |
| Automatisk utökning av dynamiskt ark | Tillåt blad att växa vertikalt bortom standardrutnätshöjden | På |
| Medieuppladdningsarbetare | Antal parallella arbetare för uppladdning av mediefiler (bakgrundsbilder och bilder) till Qlik Cloud. Gäller för Bygg till Qlik Cloud och Export QVF-lägen. | 2
|
| Skript-ersättningar | Aktivera eller inaktivera bearbetning av skript-ersättning och hantera enskilda regler. Mer information finns i Argumentreferens. | På |
Delavsnittet Skriptersättningar innehåller en inline regelredigerare. Växla huvudströmbrytaren för att aktivera eller inaktivera all skriptbearbetning. Expandera delavsnittet för att visa, lägga till, redigera eller ta bort enskilda regler. Varje regel kan slås på eller av oberoende. Klicka Återställ till standardinställningar för att återställa de åtta inbyggda reglerna. En sammanfattningsbricka visar antalet aktiverade regler.
Klicka på upp- och nedåtpilsknapparna på en regel för att ändra körningsordning. Regler med lägre körningsordning körs först. Klicka på Exportera för att hämta alla regler som en JSON-fil. Klicka på Importera för att läsa in regler från en JSON-fil, vilket ersätter den aktuella uppsättningen. Importerade filer måste innehålla en JSON-array där varje regel har ett description, pattern, och search fält.
För att skapa en anpassad regelfil för import, klicka först på Exportera för att få de inbyggda reglerna i rätt format. Redigera den exporterade filen för att lägga till, ta bort eller ändra regler, klicka sedan på Importera för att läsa in den uppdaterade uppsättningen.
När anpassade regler eller inaktiverade standardinställningar har konfigurerats, visar kommandoförhandsgranskningen ett meddelande. Det kopierade kommandot inkluderar inte anpassade regler. Exportera regler till en JSON-fil och lägg till --scriptReplacements <path> till kommandot för att inkludera anpassade regler på kommandoraden.
För en förklaring av hur regler fungerar, inklusive matchningsprocessen i två steg och den inbyggda regellistan, se Argumentreferens.
Öppna Mockup Studio från steget Avancerat för att interaktivt förhandsgranska fasta duk- och dynamiska rutnätlayouter, justera skalning och tillämpa inställningar tillbaka till guiden.
Konverteringsrapport
Följande inställningar styr konverteringsrapportutdata.
| Inställning | Beskrivning | Standard |
|---|---|---|
| Generera rapport | Generera en konsolkonverteringsrapport | På |
| Excel-rapport | Exportera rapporten som en XLSX-fil med detaljer per objekt och automatiseringspoäng. Ange ett filnamn (t.ex. MyReport) eller en fullständig sökväg. .xlsx-komplementet läggs till automatiskt. Lämna tomt för att automatiskt namnge i reports/. |
På |
| Inkludera val och sökobjekt | Inkludera rutan Aktuella val och sökobjektet i rapporten. Dessa läggs till automatiskt av Qlik Sense och utesluten som standard. | Av |
Granska
Bekräfta alla inställningar innan du kör. Granskningssteget visar sammanfattningskort för projekt, arbetsflöde, moln och utdatakonfiguration. I batchläge listar en tabell alla upptäckta projekt.
En checklista för obligatoriska åtgärder i sidofältet spårar objekt som måste konfigureras innan körning. Objekt grupperas efter kategori: arbetsflöde, indata, utdata och molnautentisering. Varje objekt visar OK när det är konfigurerat eller INSTÄLLNING när ett värde saknas. Klicka på ett objekt för att navigera direkt till det relevanta guidensteget.
En panel för kommandoförhandsgranskning visar motsvarande CLI-kommando för den aktuella guidekonfigurationen. Växla mellan PowerShell- och Bash-syntax. Klicka på Kopiera för att kopiera kommandot till Urklipp. Kommandoförhandsgranskningen är användbar för att lära sig CLI-argumenten eller för att spara det exakta kommandot för skriptade återkörningar.
Klicka Kör för att starta konverteringen.
Kör
Visar direkt konsolutdata när konverteringen körs. Stoppa en pågående konvertering, följa loggar i realtid och öppna utdatamappen eller Qlik Cloud-appen när körningen är klar.