Hur konverteringen fungerar

Senast uppdaterad: 2026-10-14

Konverteringspipelinen har följande faser:

• Extrahera — Om --generatePrj är aktiverat, startar QV2QS QlikView Desktop för att extrahera QVW-filen till en PRJ-mapp. QV2QS använder den medföljande portabla motorn om inte en systeminstallation av QlikView Desktop upptäcks. Mer information finns i QlikView Desktop-motorn.
• Parsa — QV2QS läser PRJ-mappen och parsar varje objektdefinition, arklayout, laddningsskript, variabel och dokumentegenskap. QV2QS läser även QVW/QVF-binärfilen direkt för att extrahera metadata, variabler och eventuella dolda laddningsskript inbäddade i filen.
• Konvertera — Varje QlikView-objekt mappas till en Qlik Sense-visualiseringstyp. Dimensioner, mått, uttryck, stil och layoutpositioner översätts till Qlik Sense JSON-format.
• Skriv — QV2QS skriver den konverterade appstrukturen till utdatamappen som en uppsättning JSON-filer.
• Distribuera (endast molnlägen) — QV2QS skapar appen i klientorganisationen, laddar upp media, bygger appen och laddar eventuellt om appen med data.
• Rapport — QV2QS genererar en konverteringsrapport som sammanfattar resultat, automatiseringens poängsättning och eventuella objekt som kräver manuell uppföljning.

Distributionsfasen körs i lägena Bygg till Qlik Cloud och Export QVF. I läget Endast lokalt, QV2QS skriver den konverterade utdata till disk utan att ansluta till Qlik Cloud. Rapportfasen körs i alla lägen.

Konverteringslägen

QV2QS stöder tre konverteringslägen. Välj läge på Inställningar-steget i guiden eller med motsvarande CLI-flagga.

Bygg till Qlik Cloud är det rekommenderade läget för migrering. Exportera QVF är användbart för att skapa en portabel fil att dela eller importera till en annan klientorganisation. Endast lokalt läge är avsett för bedömning och granskning. Mer information om begränsningar för endast lokalt, se delavsnittet nedan.

Endast lokalt läge

Lokalt endast-läge (--unbuildOnly) utför faserna Parsa, Konvertera, Skriv och Rapportera utan att ansluta till Qlik Cloud. Ingen klientorganisation eller API-nyckel krävs. QV2QS genererar den fullständiga konverteringsrapporten, ledningssammanfattningen och byggutdatamappen på disken.

Användningsfall

• Migreringsbedömning — Kör läget Endast lokalt för att generera konverteringsrapporten, den sammanfattande rapporten, automatiseringspoängen och uttrycksresultaten utan att kräva åtkomst till Qlik Cloud. Utvärdera konverteringskvaliteten för en hel QVW-miljö innan du ställer in klientorganisationens autentiseringsuppgifter.
• Förhandsgranskning av distribution — Granska den genererade utdata (laddningsskript, objektdefinitioner, variabler, dimensioner) innan du genomför en molndistribution. Organisationer med ändringskontrollprocesser kan granska resultatet som en mellanliggande artefakt.
• Offline- eller begränsade miljöer — När maskinen som är värd för QVW-filerna inte har utgående internetåtkomst, kör läget Endast lokalt för att generera konverteringsrapporten lokalt. För att distribuera den konverterade appen, kopiera QVW-filerna till en maskin med Qlik Cloud-åtkomst och kör QV2QS i läget Bygg till Qlik Cloud från den anslutna maskinen.

Begränsningar

Distributionsfasen hanterar flera operationer som qlik app build ensam inte utför. Att köra läget Endast lokalt och sedan distribuera build/ mappen manuellt med en fristående qlik-cli installation resulterar i följande brister.

• Mediefiler har inte laddats upp. Bakgrundsbilder och knappbilder extraheras till images/ mappen men inkluderas inte i build/ mappen. Kommandot qlik app build bearbetar inte mediefiler. Alla bakgrundsbilder och knappbilder kommer att saknas från den distribuerade appen.
• Referenser till ark- och objektbakgrunder har inte lösts. QV2QS injicerar bakgrundsbilds-URL:er i ark- och objekt-JSON-filer under distributionsfasen med hjälp av molnapp-ID. Den lokala byggutgången innehåller inte referenser till bakgrundsbilder. Ark och objekt kommer inte att ha några bakgrunder i den distribuerade appen.
• Knappbilds-URL:er innehåller platshållarsträngar. Knappbilder i den lokala byggutgången använder interna platshållarvärden istället för lösta medie-URL:er. Qlik Sense-motorn kan inte tolka platshållarsträngarna. Knappbilder kommer att visas trasiga.
• Alternativa tillstånd skapas inte. Alternativa delstatsnamn skrivs till cloud/alternate_states.json utanför build/ mappen. Kommandot qlik app build bearbetar inte parallella tillstånd. Objekt som refererar till icke-standardtillstånd kanske inte visas korrekt.
• Blad publiceras inte. Kommandot qlik app build skapar blad som personliga objekt som endast är synliga för app-ägaren. QV2QS publicerar ark som basark under distributionsfasen. I ett delat utrymme kommer andra användare inte att se några blad förrän bladen publiceras manuellt.

Källfilssäkerhet

QV2QS ändrar inte innehållet i källfilen QVW eller QVF. Under extraktionsfasen öppnar QV2QS källdokumentet via QlikView Desktop och sparar en tillfällig kopia i en systemtempmapp. QV2QS stänger sedan originalet och genererar PRJ-mappen från den tillfälliga kopian. När PRJ-genereringen är klar, kopierar QV2QS den resulterande -prj mappen tillbaka till samma katalog som källfilen och tar bort den tillfälliga kopian. Om en -prj mapp redan finns bredvid källfilen, ersätter QV2QS mappen med den nyligen genererade versionen. All annan konverteringsutdata skrivs till den separata utdatakatalogen som anges av --outputDir.

QlikView Desktop låser källdokumentet medan den temporära kopian skapas. Att köra QV2QS mot en fil som är aktivt öppen i QlikView Desktop eller tillhandahålls av QlikView Server kan orsaka fillåsningskonflikter eller misslyckad PRJ-generering. Filer på delade nätverksenheter kan orsaka samma konflikter. Att skriva -prj mappen tillbaka till en nätverksresurs eller skrivskyddad katalog kan också misslyckas.

För att undvika risker för produktionsmiljöer, arbeta alltid med kopior av källdokument. Gör följande:

1. Kopiera QVW- eller QVF-filerna till en lokal arbetsmapp på maskinen där QV2QS körs.
2. Peka QV2QS mot de kopierade filerna, inte originalen.
3. Stäng alla körande QlikView Desktop-instanser innan du startar konverteringen. QV2QS kräver exklusiv åtkomst till QlikView Desktop.

Typisk tidsåtgång

QV2QS är utformad för snabbhet. Hela pipeline slutförs på minuter, inte timmar. Följande tabell visar typiska varaktigheter för en konvertering av en enskild app.

En konvertering av en enskild app med molndistribution och omladdning av data slutförs vanligtvis på två till fem minuter från början till slut. Lokala konverteringar (--unbuildOnly) slutförs på under 30 sekunder.

I batchläge konverterar QV2QS flera projekt parallellt. Total batchtid skalar med antalet projekt delat med antalet arbetare. För en batch med 20 applikationer och fyra arbetare, förvänta dig ungefär fem gånger varaktigheten för en enskild app för den lokala konverteringsfasen, plus molndistributionstid.

Utmappsstruktur

Argumentet --outputDir anger utdataroten. QV2QS skapar en undermapp namngiven efter QVW-filen (eller PRJ-mappen) inuti utdataroten. All konverteringsutdata för projektet skrivs till den undermappen. Om två QVW-filer har samma namn lägger QV2QS till _2, _3, och efterföljande nummer för att undvika konflikter. Detta beteende matchar batchläge, där varje projekt också får en dedikerad undermapp.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS skapar utdatamappen om mappen inte redan finns. Om mappen finns från en tidigare körning av samma QVW, återanvänder QV2QS mappen. Befintliga loggfiler i mappen bevaras om inte Rensa loggar är aktiverat. Utdatakatalogen får inte vara samma som eller en överordnad katalog till någon källkatalog. QV2QS validerar utdatasökvägen innan konverteringen påbörjas och rapporterar ett fel om sökvägarna överlappar. Projektundermappen innehåller följande:

Efter konvertering

När en konvertering är klar, gå igenom följande punkter grupperade efter prioritet.

Åtgärda före publicering

1. Öppna Excel-konverteringsrapporten i reports/ undermappen och granska Follow-up_Objects arbetsblad. Åtgärda alla objekt markerade Fel först (objekt som inte kunde konverteras), sedan Platshållare (objekt som behöver byggas om), sedan Justeringar krävs (objekt som konverterades delvis).
2. Granska analysresultat på Analys-arbetsbladet, inklusive makroreferenser, användning av avsnittsåtkomst och mönster i laddningsskript som kan kräva manuell uppmärksamhet.
3. Verifiera att uttryck utvärderas korrekt. QV2QS åtgärdar automatiskt problem med citering i mängdanalys under konverteringen. Granska beräknade dimensioner, villkorsstyrd färgning och uttryck som använder QlikView-specifika funktioner (GetCurrentField(), MsgBox()) som kräver manuell omskrivning.
4. Kontrollera Överflödesåtgärder arbetsbladet för objekt där överflödiga dimensioner eller mått flyttades till samlingen med alternativ.

Verifiera före publicering

5. Öppna den konverterade appen i Qlik Sense och verifiera att arklayouter, objektpositioner och bakgrundsbilder visas som förväntat.
6. Bekräfta att navigering i flikbehållare (knapplister eller flikbehållare) växlar mellan innehållsområden korrekt.
7. Testa drill-down och cyklisk grupp-cyklingsbeteende på diagram som använder dimensionsgrupper.
8. Verifiera att visningsvillkor döljer och visar objekt som förväntat.
9. Kontrollera sorteringsordningen i listrutor och tabeller, särskilt för datumliknande fält.

Polska

10. Justera teckensnitt, färger eller objektpositionering i Qlik Sense app-redigeraren vid behov. För vägledning om layoutpositionering, se Inställningar för konverteringslayout.

För en fullständig beskrivning av rapportinnehållet, se Konverteringsrapport.

Läs mer

• Snabbstart
• Användargränssnitt
• Kommandoradsgränssnitt
• Konverteringslayoutinställningar
• Konverteringsresultat