Veelvoorkomende workflows
Laatst bijgewerkt: 14-10-2026De volgende voorbeelden behandelen de meest voorkomende gebruiksscenario's. Elk bouwt voort op hetzelfde kernpatroon: geef een QVW-bestand op, een uitvoermap en een Qlik Cloud-context. In alle voorbeelden is --outputDir de uitvoerroot. QV2QS maakt automatisch een submap aan die is vernoemd naar het QVW-bestand (bijvoorbeeld, ./output/Sales/). Al deze workflows kunnen ook worden uitgevoerd via de webgebaseerde wizard. Voor de begeleide aanpak, zie Wizardstappen.
Implementeren in Qlik Cloud met gegevens
De standaard migratieworkflow. QV2QS genereert de PRJ-map, converteert de gebruikersinterface, uploadt de QVW voor het laden van binaire gegevens, herlaadt de app in Qlik Cloud en produceert een Excel-rapport. De geüploade QVW wordt verwijderd en de originele load-script wordt hersteld na herladen.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Een QVF-bestand exporteren
QV2QS bouwt de app met behulp van de Qlik Cloud-engine, exporteert het resultaat als een QVF-bestand en verwijdert vervolgens de cloud-app. De geëxporteerde QVF kan worden geïmporteerd in een andere Qlik Cloud tenant.
Het importeren van door QV2QS gegenereerde QVF-bestanden in Qlik Sense Enterprise Client-Managed is niet getest in alle versies, wordt niet officieel ondersteund en wordt afgeraden. Zie voor meer informatie de compatibiliteit van Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Batchgewijs migreren van een volledige QlikView-omgeving
Scan één of meer mappen op alle QVW- en PRJ-paren, converteer de paren parallel en implementeer elk naar Qlik Cloud. Gebruik --batchWorkers om gelijktijdigheid te beheren.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Behoud QlikView pixel lay-out
Schakel de vaste canvasmodus in om de exacte QlikView-objectposities en werkbladachtergronden te behouden. Pas schaalfactoren aan om te bepalen hoe de lay-out wordt toegewezen aan de schermdimensies van Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Bijwerken van een eerder geconverteerde app
Voer de conversie opnieuw uit op een bestaande Qlik Cloud app zonder een nieuwe te maken. QV2QS hergebruikt de app-ID van de vorige uitvoering.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Een app bijwerken met behoud van de load-script
Voer de conversie opnieuw uit om de UI-laag van een bestaande app bij te werken zonder het load-script te overschrijven. De doel-app behoudt zijn bestaande gegevensverbindingen en herlaadlogica. Een back-up zonder data wordt automatisch geëxporteerd vóór de update. Voeg --reload toe om het bestaande script uit te voeren en gegevens te vernieuwen.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Een app bijwerken met behoud van de variabelen
Voer de conversie opnieuw uit om de UI-laag en het load-script van een bestaande app bij te werken zonder de variabelen te overschrijven. Combineer met --preserveTargetAppScript om zowel de load-script als de variabelen van de doel-app intact te houden.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Instellen van Qlik Cloud-authenticatie
Configureer een qlik-cli context voordat u een conversie uitvoert. De interactieve installatie vraagt om een tenant-URL en API-sleutel en slaat de referenties op voor volgende uitvoeringen.
QV2QS.exe --setupQlikAuth
Programmatisch gebruik (CI/CD)
QV2QS ondersteunt directe authenticatie zonder vooraf aangemaakte qlik-cli contexten. Geef de tenant-URL en API-sleutel uitgelijnd mee. QV2QS valideert de referenties en injecteert authenticatieheaders in elke qlik-cli-aanroep. Er wordt geen contextbestand aangemaakt of gewijzigd. Neem --accept-eula op om de licentieovereenkomst te accepteren zonder een interactieve prompt.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Deze modus is veilig voor gelijktijdige uitvoering voor meerdere tenants en gebruikers. De API-sleutel wordt niet naar schijf geschreven en verschijnt niet in logbestanden.
Referenties kunnen ook worden ingesteld als omgevingsvariabelen:
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
Lokale build zonder Qlik Cloud
Genereer de geconverteerde uitvoer en het conversierapport op schijf zonder verbinding te maken met Qlik Cloud. Alleen-lokale modus is bedoeld voor migratiebeoordeling, pre-implementatiebeoordeling en offline omgevingen. De uitvoer van de lokale build omvat geen media-uploads, resolutie van achtergrondafbeeldingen, creatie van alternatieve statussen of publicatie van werkbladen. Voor een volledige implementatie, gebruik de modus 'Bouwen naar Qlik Cloud' of de modus 'QVF exporteren'. Voor details over alleen-lokale beperkingen en gebruiksscenario's, zie Hoe conversie werkt.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly