Gängige Workflows
Letzte Aktualisierung: 14.10.2026Die folgenden Beispiele decken die häufigsten Anwendungsfälle ab. Jeder basiert auf dem gleichen Kernmuster: Geben Sie eine QVW-Datei, einen Ausgabeordner und einen Qlik Cloud-Kontext an. In allen Beispielen ist --outputDir die Ausgabewurzel. QV2QS erstellt automatisch einen Unterordner, der nach der QVW-Datei benannt ist (zum Beispiel, ./output/Sales/). Alle diese Workflows können auch über den webbasierten Assistenten durchgeführt werden. Für den geführten Ansatz, siehe Assistentenschritte.
Bereitstellen in Qlik Cloud mit Daten
Der Standard-Migrations-Workflow. QV2QS generiert den PRJ-Ordner, konvertiert die Benutzeroberfläche, lädt die QVW zum Laden binärer Daten hoch, lädt die App in Qlik Cloud neu und erstellt einen Excel-Bericht. Die hochgeladene QVW wird gelöscht und das ursprüngliche Ladeskript wird nach dem Neuladen wiederhergestellt.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Eine QVF-Datei exportieren
QV2QS erstellt die App mithilfe der Qlik Cloud-Engine, exportiert das Ergebnis als QVF-Datei und löscht dann die Cloud-App. Die exportierte QVF kann in einen anderen Qlik Cloud Mandant importiert werden.
Das Importieren von QV2QS-generierten QVF-Dateien in Qlik Sense Enterprise Client-Managed wird nicht über alle Versionen hinweg getestet oder offiziell unterstützt und wird nicht empfohlen. Weitere Informationen finden Sie unter Qlik Sense Enterprise Client-Managed-Kompatibilität.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Einen gesamten QlikView-Bestand im Stapel migrieren
Scannen Sie einen oder mehrere Ordner nach allen QVW- und PRJ-Paaren, konvertieren Sie die Paare parallel und stellen Sie jedes in Qlik Cloud bereit. Verwenden Sie --batchWorkers, um die Parallelität zu steuern.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
QlikView-Pixel-Layout beibehalten
Aktivieren Sie den Modus 'Feste Arbeitsfläche', um die genauen Positionen der QlikView-Objekte und die Hintergrundbilder der Arbeitsblätter beizubehalten. Passen Sie die Skalierungsfaktoren an, um zu steuern, wie das Layout auf die Bildschirmabmessungen von Qlik Sense abgebildet wird.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Aktualisieren einer zuvor konvertierten App
Führen Sie die Konvertierung erneut für eine bestehende Qlik Cloud App aus, ohne eine neue zu erstellen. QV2QS verwendet die App-ID vom vorherigen Lauf wieder.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Eine App aktualisieren unter Beibehaltung ihres Ladeskripts
Führen Sie die Konvertierung erneut aus, um die UI-Ebene einer bestehenden App zu aktualisieren, ohne das Ladeskript zu überschreiben. Die Ziel-App behält ihre bestehenden Datenverbindungen und Neuladelogik bei. Ein Backup ohne Daten wird vor dem Update automatisch exportiert. Fügen Sie --reload hinzu, um das vorhandene Skript auszuführen und die Daten zu aktualisieren.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Eine App aktualisieren, wobei ihre Variablen erhalten bleiben
Führen Sie die Konvertierung erneut aus, um die UI-Ebene und das Ladeskript einer bestehenden App zu aktualisieren, ohne die Variablen zu überschreiben. Kombinieren Sie mit --preserveTargetAppScript, um sowohl das Ladeskript als auch die Variablen aus der Ziel-App intakt zu halten.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Qlik Cloud-Authentifizierung einrichten
Konfigurieren Sie einen qlik-cli-Kontext, bevor Sie eine Konvertierung ausführen. Die interaktive Einrichtung fordert eine Mandanten-URL und einen API-Schlüssel an und speichert die Anmeldeinformationen für nachfolgende Ausführungen.
QV2QS.exe --setupQlikAuth
Programmatische Nutzung (CI/CD)
QV2QS unterstützt direkte Authentifizierung ohne vorab erstellte qlik-cli-Kontexte. Übergeben Sie die Mandanten-URL und den API-Schlüssel Inline. QV2QS validiert die Zugangsdaten und injiziert Authentifizierungs-Header in jeden qlik-cli-Aufruf. Es wird keine Kontextdatei erstellt oder geändert. Verwenden Sie --accept-eula, um die Lizenzvereinbarung ohne interaktive Aufforderung zu akzeptieren.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Dieser Modus ist sicher für die gleichzeitige Ausführung über mehrere Mandanten und Benutzer hinweg. Der API-Schlüssel wird nicht auf die Festplatte geschrieben und erscheint nicht in Protokolldateien.
Anmeldeinformationen können auch als Umgebungsvariablen festgelegt werden:
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
Lokaler Build ohne Qlik Cloud
Generieren Sie die konvertierte Ausgabe und den Konvertierungsbericht auf dem Datenträger, ohne eine Verbindung zu Qlik Cloud herzustellen. Der Nur-Lokal-Modus ist für die Migrationsbewertung, die Überprüfung vor der Bereitstellung und Offline-Umgebungen vorgesehen. Die lokale Build-Ausgabe enthält keine Medien-Uploads, Hintergrundbildauflösung, Erstellung alternativer Zustände oder Arbeitsblattveröffentlichung. Für eine vollständige Bereitstellung verwenden Sie den Modus „Build to Qlik Cloud“ oder „Export QVF“. Für Details zu den Einschränkungen und Anwendungsfällen von Nur-Lokal, siehe Wie die Konvertierung funktioniert.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly