Wie die Konvertierung funktioniert

Letzte Aktualisierung: 14.10.2026

Die Konvertierungspipeline hat die folgenden Phasen:

Extrahieren — Wenn --generatePrj aktiviert ist, startet QV2QS QlikView Desktop, um die QVW-Datei in einen PRJ-Ordner zu extrahieren. QV2QS verwendet die gebündelte portable Engine, sofern keine Systeminstallation von QlikView Desktop erkannt wird. Weitere Informationen finden Sie unter QlikView Desktop-Engine.
Analysieren — QV2QS liest den PRJ-Ordner und analysiert alle Objektdefinitionen, Arbeitsblatt-Layouts, Ladeskripte, Variablen und Dokumenteigenschaften. QV2QS liest auch die QVW/QVF-Binärdatei direkt, um Metadaten, Variablen und jedes in der Datei eingebettete versteckte Ladeskript zu extrahieren.
Konvertieren — Jedes QlikView-Objekt wird einem Qlik Sense Visualisierungstyp zugeordnet. Dimensionen, Kennzahlen, Ausdrücke, Formatierung und Layoutpositionen werden in das Qlik Sense JSON-Format übersetzt.
Schreiben — QV2QS schreibt die konvertierte App-Struktur als eine Reihe von JSON-Dateien in den Ausgabeordner.
Bereitstellen (nur Cloud-Modi) — QV2QS erstellt die App auf dem Mandanten, lädt Medien hoch, erstellt die App und lädt die App optional mit Daten neu.
Bericht — QV2QS generiert einen Konvertierungsbericht, der Ergebnisse, die Automatisierungsbewertung und alle Elemente zusammenfasst, die eine manuelle Nachverfolgung erfordern.

Die Bereitstellungsphase wird in den Modi Build to Qlik Cloud und Export QVF ausgeführt. Im Nur-Lokal-Modus schreibt QV2QS die konvertierte Ausgabe auf die Festplatte, ohne eine Verbindung zu Qlik Cloud herzustellen. Die Berichtsphase läuft in allen Modi.

Konvertierungsmodi

QV2QS unterstützt drei Konvertierungsmodi. Wählen Sie den Modus im Setup-Schritt des Assistenten oder mit dem entsprechenden CLI-Flag.

Modus	CLI-Flag	Qlik Cloud erforderlich	Ausgabe	Bereitstellungsphase
Erstellen zu Qlik Cloud	(Standard)	Ja	App bereitgestellt für Mandant	Ja — erstellt App, lädt Medien hoch, erstellt, veröffentlicht Blätter
QVF exportieren	`--exportQvf`	Ja	QVF-Datei auf der Festplatte	Ja — erstellt App in Qlik Cloud, exportiert als QVF, löscht dann die Cloud-App
Nur lokal	`--unbuildOnly`	Nein	Build-Ordner und Konvertierungsbericht auf dem Datenträger	Nein

Build zu Qlik Cloud ist der empfohlene Modus für die Migration. Der QVF-Export ist nützlich, um eine portable Datei zu erstellen, die geteilt oder in einen anderen Mandanten importiert werden kann. Der Nur-Lokal-Modus ist für die Bewertung und Überprüfung vorgesehen. Einzelheiten zu den Beschränkungen nur für lokale Geräte finden Sie im folgenden Abschnitt.

Die Benutzeroberfläche ist standardmäßig auf den festen Zeichenflächenmodus, aktiviertes Neuladen und aktiviertes Auto-Binär eingestellt. Die CLI ist standardmäßig im dynamischen Gitternetzmodus, mit deaktiviertem Neuladen und deaktiviertem Auto-Binär. Wenn Sie vom Assistenten zur CLI wechseln, geben Sie diese Flags explizit an, um das Verhalten des Assistenten abzugleichen. Die vollständige Liste der Argumente und Standardwerte finden Sie unter Argumentreferenz.

Nur-Lokal-Modus

Der Nur-Lokal-Modus (--unbuildOnly) führt die Phasen Parsen, Konvertieren, Schreiben und Berichten aus, ohne eine Verbindung zu Qlik Cloud herzustellen. Kein Mandant oder API-Schlüssel ist erforderlich. QV2QS erzeugt den vollständigen Konvertierungsbericht, die Managementzusammenfassung und den Build-Ausgabeordner auf der Festplatte.

Anwendungsfälle

Migrationsbewertung — Führen Sie den Nur-Lokal-Modus aus, um den Konvertierungsbericht, die Managementzusammenfassung, die Automatisierungsbewertung und die Ausdrucksergebnisse zu generieren, ohne dass ein Qlik Cloud-Zugriff erforderlich ist. Bewerten Sie die Konvertierungsqualität einer gesamten QVW-Umgebung, bevor Sie Mandanten-Anmeldeinformationen einrichten.
Überprüfung vor der Bereitstellung — Überprüfen Sie die generierte Ausgabe (Ladeskript, Objektdefinitionen, Variablen, Dimensionen), bevor Sie eine Cloud-Bereitstellung festschreiben. Organisationen mit Änderungskontrollprozessen können die Ausgabe als Zwischenartefakt überprüfen.
Offline- oder eingeschränkte Umgebungen — Wenn der Computer, auf dem die QVW-Dateien gehostet werden, keinen ausgehenden Internetzugang hat, führen Sie den Modus „Nur lokal“ aus, um den Konvertierungsbericht lokal zu generieren. Um die konvertierte App bereitzustellen, kopieren Sie die QVW-Dateien auf einen Computer mit Qlik Cloud-Zugriff und führen Sie QV2QS im Modus „Build to Qlik Cloud“ vom verbundenen Computer aus.

Beschränkungen

Die Bereitstellungsphase übernimmt mehrere Operationen, die qlik app build allein nicht ausführt. Der Betrieb im Nur-Lokal-Modus und die anschließende manuelle Bereitstellung des build/ Ordners mit einer eigenständigen qlik-cli-Installation führt zu den folgenden Lücken.

Mediendateien werden nicht hochgeladen. Hintergrundbilder und Schaltflächenbilder werden in den images/ Ordner extrahiert, sind aber nicht im build/ Ordner enthalten. Der qlik app build Befehl verarbeitet keine Mediendateien. Alle Hintergrundbilder und Schaltflächenbilder werden in der bereitgestellten App fehlen.
Blatt- und Objekthintergrundreferenzen werden nicht aufgelöst. QV2QS fügt Hintergrundbild-URLs während der Bereitstellungsphase mithilfe der Cloud-App-ID in die Arbeitsblatt- und Objekt-JSON-Dateien ein. Die lokale Build-Ausgabe enthält keine Referenzen auf Hintergrundbilder. Blätter und Objekte werden keine Hintergründe in der bereitgestellten App haben.
Schaltflächen-Bild-URLs enthalten Platzhalterzeichenfolgen. Schaltflächenbilder in der lokalen Build-Ausgabe verwenden interne Platzhalterwerte anstelle von aufgelösten Medien-URLs. Die Qlik Sense-Engine kann die Platzhalterzeichenfolgen nicht interpretieren. Schaltflächenbilder werden fehlerhaft angezeigt.
Alternative Zustände werden nicht erstellt. Alternative Statusnamen werden in cloud/alternate_states.json außerhalb des build/ Ordners geschrieben. Der qlik app build Befehl verarbeitet keine alternativen Zustände. Objekte, die Nicht-Standardzustände referenzieren, werden möglicherweise nicht korrekt angezeigt.
Blätter sind nicht veröffentlicht. Der qlik app build Befehl erstellt Blätter als persönliche Objekte, die nur dem App-Besitzer sichtbar sind. QV2QS veröffentlicht Blätter als Basisblätter während der Bereitstellungsphase. In einem freigegebenen Bereich sehen andere Benutzer keine Blätter, bis die Blätter manuell veröffentlicht werden.

Für eine vollständige Bereitstellung einschließlich Medien-Upload, Hintergrundauflösung, Erstellung alternativer Zustände und Veröffentlichung von Arbeitsblättern verwenden Sie den Modus „In Qlik Cloud erstellen“ oder den Modus „QVF exportieren“ anstelle des Modus „Nur lokal“.

Quelldateisicherheit

QV2QS ändert den Inhalt der Quell-QVW- oder QVF-Datei nicht. Während der Extraktionsphase öffnet QV2QS das Quelldokument über QlikView Desktop und speichert eine temporäre Kopie in einem temporären Systemordner. QV2QS schließt dann das Original und generiert den PRJ-Ordner aus der temporären Kopie. Nach Abschluss der PRJ-Generierung kopiert QV2QS den resultierenden -prj Ordner zurück in dasselbe Verzeichnis wie die Quelldatei und löscht die temporäre Kopie. Wenn ein -prj Ordner bereits neben der Quelldatei existiert, ersetzt QV2QS den Ordner durch die neu generierte Version. Alle anderen Konvertierungsausgaben werden in das separate Ausgabeverzeichnis geschrieben, das durch --outputDir angegeben ist.

QlikView Desktop erwirbt eine Dateisperre für das Quelldokument, während die temporäre Kopie erstellt wird. Das Ausführen von QV2QS für eine Datei, die aktiv in QlikView Desktop geöffnet ist oder von QlikView Server bereitgestellt wird, kann zu Dateisperrkonflikten oder einer fehlgeschlagenen PRJ-Generierung führen. Dateien auf freigegebenen Netzlaufwerken können die gleichen Konflikte verursachen. Das Schreiben des -prj Ordners zurück auf eine Netzwerkfreigabe oder ein schreibgeschütztes Verzeichnis kann ebenfalls fehlschlagen.

Um jegliches Risiko für Produktionsumgebungen zu vermeiden, arbeiten Sie immer mit Kopien der Quelldokumente. Gehen Sie folgendermaßen vor:

Kopieren Sie die QVW- oder QVF-Dateien in einen lokalen Arbeitsordner auf dem Computer, auf dem QV2QS ausgeführt wird.
Richten Sie QV2QS auf die kopierten Dateien, nicht auf die Originale.
Schließen Sie alle laufenden QlikView Desktop-Instanzen, bevor Sie die Konvertierung starten. QV2QS benötigt exklusiven Zugriff auf QlikView Desktop.

Führen Sie QV2QS nicht direkt auf QlikView Server Dokumentordnern, Produktionsnetzwerkfreigaben oder Dateien aus, die in QlikView Desktop geöffnet sind. Verwenden Sie immer eine lokale Kopie der Quelldokumente.

Typischer Zeitpunkt

QV2QS ist auf Geschwindigkeit ausgelegt. Die gesamte pipeline ist in Minuten, nicht Stunden, abgeschlossen. Die folgende Tabelle zeigt typische Dauern für eine Einzel-App-Konvertierung.

Phase	Typische Dauer	Notizen
Extrakt (PRJ-Generierung)	5–15 Sekunden	Hängt von der QVW-Komplexität ab. Übersprungen, wenn ein PRJ-Ordner bereits existiert.
Parsen + Konvertieren + Schreiben	Unter 30 Sekunden	Die Kern-XML-zu-JSON-Konvertierung. Verarbeitet komplexe Anwendungen mit Hunderten von Objekten.
Bereitstellen (Cloud-Build)	1–3 Minuten	Umfasst App-Erstellung, Medien-Upload und App-Build auf dem Mandanten.
Laden	Variiert	Hängt ab von Datenvolumen, Latenz der Datenquelle und Ressourcen des Mandanten. Ein Binäres Laden eines typischen QVW ist in weniger als einer Minute abgeschlossen.

Eine Einzel-App-Konvertierung mit Cloud-Bereitstellung und Datenneuladung dauert in der Regel zwei bis fünf Minuten Ende-zu-Ende. Nur-lokale Konvertierungen (--unbuildOnly) sind in unter 30 Sekunden abgeschlossen.

Im Stapelmodus konvertiert QV2QS mehrere Projekte parallel. Die Gesamt-Batchzeit skaliert mit der Anzahl der Projekte, geteilt durch die Worker-Anzahl. Für einen Stapel von 20 Anwendungen mit vier Workern erwarten Sie ungefähr die fünffache Dauer einer einzelnen App für die lokale Konvertierungsphase, zuzüglich Cloud-Bereitstellungszeit.

Ausgabeordnerstruktur

Das --outputDir Argument gibt das Ausgabestammverzeichnis an. QV2QS erstellt einen Unterordner, benannt nach der QVW-Datei (oder dem PRJ-Ordner), im Ausgabe-Stammverzeichnis. Alle Konvertierungsausgaben für das Projekt werden in diesen Unterordner geschrieben. Wenn zwei QVW-Dateien denselben Namen haben, hängt QV2QS _2, _3, und nachfolgende Nummern an, um Kollisionen zu vermeiden. Dieses Verhalten entspricht dem Stapelmodus, wobei jedes Projekt ebenfalls einen dedizierten Unterordner erhält.

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

QV2QS erstellt den Ausgabeordner, wenn der Ordner noch nicht existiert. Wenn der Ordner aus einem vorherigen Lauf des gleichen QVW existiert, verwendet QV2QS den Ordner wieder. Bestehende Protokolldateien im Ordner bleiben erhalten, es sei denn, Protokolle bereinigen ist aktiviert. Das Ausgabeverzeichnis darf nicht dasselbe wie oder ein übergeordnetes Verzeichnis eines Quellverzeichnisses sein. QV2QS validiert den Ausgabepfad, bevor die Konvertierung gestartet wird, und meldet einen Fehler, wenn sich die Pfade überlappen. Der Projektunterordner enthält Folgendes:

Ordner / Datei	Inhalt
`build/`	Qlik Sense App-Struktur für `qlik app build`. Enthält `config.yml` (Build-Manifest), `script.qvs` (Ladeskript), `app-properties.json`, `connections.yml` (Datenverbindungen), `dimensions.json` (Master-Dimensionen), `measures.json` (Master-Kennzahlen), `variables.json`, und einen `objects/` Unterordner mit einer JSON-Datei pro Arbeitsblatt und Visualisierung.
`images/`	Extrahierte Mediendateien (nach Inhaltshash dedupliziert) und `backgrounds.json` (Hintergrundmanifest).
`reports/`	`executive_summary.json`, `executive_summary.html`, und den Excel-Konvertierungsbericht (`_conversion_report_.xlsx`) falls aktiviert.
`logs/`	Laufspezifische strukturierte Protokolldateien.
`cloud/`	`cloud_state.json` (App-ID, Medien-Hash, Arbeitsblatt-ID-Zuordnung, Zeitstempel) und `alternate_states.json`. Erstellt während der Cloud-Bereitstellung.
`qvf/`	Exportierte QVF-Dateien (erstellt, wenn `--exportQvf` verwendet wird).
`.qv2qs_source`	Markerdatei, die aufzeichnet, welches QVW den Unterordner erstellt hat. QV2QS verwendet den Marker, um Namenskollisionen zu erkennen und den richtigen Ordner bei nachfolgenden Ausführungen wiederzuverwenden.

Öffnen Sie den Ausgabeordner direkt aus dem Assistenten, nachdem eine Konvertierung abgeschlossen ist.

Nach der Konvertierung

Nach Abschluss einer Konvertierung arbeiten Sie die folgenden, nach Priorität gruppierten Punkte ab.

Vor der Veröffentlichung beheben

Öffnen Sie den Excel-Konvertierungsbericht im reports/ Unterordner und überprüfen Sie das Follow-up_Objects-Arbeitsblatt. Beheben Sie zuerst alle Elemente, die als Fehler markiert sind (Objekte, die nicht konvertiert werden konnten), dann Platzhalter (Objekte, die neu erstellt werden müssen), und dann Anpassungen erforderlich (Objekte, die teilweise konvertiert wurden).
Überprüfen Sie die Analyseergebnisse auf dem Analyse Arbeitsblatt, einschließlich Makroreferenzen, Abschnittszugriffsnutzung und Ladeskriptmustern, die möglicherweise manueller Aufmerksamkeit bedürfen.
Überprüfen Sie, ob Ausdrücke korrekt ausgewertet werden. QV2QS behebt automatisch Probleme mit der Anführungszeichensetzung bei der Set-Analyse während der Konvertierung. Überprüfen Sie berechnete Dimensionen, bedingte Farbgebung und Ausdrücke, die ausschließlich QlikView-Funktionen verwenden (GetCurrentField(), MsgBox()) und eine manuelle Neuschreibung erfordern.
Überprüfen Sie das Overflow_Actions Arbeitsblatt auf Objekte, bei denen überschüssige Dimensionen oder Kennzahlen in die Alternativsammlung verschoben wurden.

Vor der Veröffentlichung überprüfen

Öffnen Sie die konvertierte App in Qlik Sense und überprüfen Sie, ob Arbeitsblatt-Layouts, Objektpositionen und Hintergrundbilder wie erwartet angezeigt werden.
Bestätigen Sie, dass die Navigation der Tab-Sammelbox (Schaltflächenleisten oder getabbte Sammelboxen) korrekt zwischen Inhaltsbereichen wechselt.
Testen Sie das Drilldown-Verhalten und das Wechselverhalten von Zyklischen Gruppen in Diagrammen, die Dimensionsgruppen verwenden.
Überprüfen Sie, ob die Anzeigebedingungen Objekte wie erwartet ausblenden und einblenden.
Überprüfen Sie die Sortierreihenfolgen in Listenfeldern und Tabellen, insbesondere bei datumsähnlichen Feldern.

Polnisch

Passen Sie Schriftarten, Farben oder die Objektpositionierung im Qlik Sense App-Editor nach Bedarf an. Für Anleitungen zur Positionierung des Layouts, siehe Einstellungen für das Konvertierungs-Layout.

Eine vollständige Beschreibung des Berichtsinhalts finden Sie unter Konversionsbericht.

Mehr erfahren

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab