Daten und erneutes Laden
Letzte Aktualisierung: 14.10.2026QV2QS konvertiert die QlikView-Benutzeroberfläche und kann mithilfe der Option Auto-binary automatisch Daten in die konvertierte App laden. Aktivieren Sie Reload und Auto-binary im Assistenten oder über die Befehlszeile, und QV2QS übernimmt die Datenübertragung automatisch. Wenn Auto-binary nicht verwendet wird, muss die konvertierte App separat neu geladen werden, um Daten einzulesen.
QV2QS konvertiert die QlikView-UI-Metadaten (PRJ-XML) in Qlik Sense-JSON und erstellt die App direkt auf dem Qlik Cloud-Mandanten. Der Konvertierungsprozess verarbeitet Arbeitsblatt-Layouts, Visualisierungsobjekte, Ausdrücke und Formatierungen. Ohne Neuladen enthält die resultierende Qlik Sense-App nach Abschluss des Build-Schritts keine Daten.
Um Daten in die konvertierte App zu laden, muss die App neu geladen werden. Es gibt drei Lösungsansätze:
- Automatisches Binäres Laden — QV2QS lädt die ursprüngliche QVW-Datei in Qlik Cloud hoch und verwendet eine
Binary-Anweisung, um die Daten während der Erstellung zu laden. Dieser Ansatz ist der schnellste Weg, um unmittelbar nach der Konvertierung eine funktionierende App mit Daten zu sehen. Details finden Sie unten unter Automatisches binäres Laden. - Manuelles Laden — Wenn in Qlik Cloud bereits Datenverbindungen erstellt wurden und auf die QVD-Dateien oder Datenquellen zugegriffen werden kann, kann die App nach Anpassung des Ladeskripts neu geladen werden. QV2QS wendet eine grundlegende Ladeskript-Pfadnormalisierung an, aber Verbindungsnamen und Datenquellenpfade erfordern möglicherweise manuelle Aktualisierungen.
- Ausgelöstes Neuladen — Verwenden Sie das Flag
--reload, um im Rahmen der Bereitstellung ein Neuladen auszulösen. Das Neuladen führt das Ladeskript unverändert aus. Das Neuladen ist nur erfolgreich, wenn die im Ladeskript referenzierten Datenverbindungen und Datenquellen bereits in der Qlik Cloud-Umgebung verfügbar sind.
Zwei Flags steuern Daten in verschiedenen Phasen. Das Flag --noData überspringt Daten während des Build-Schritts, sodass die App-Struktur getestet werden kann, ohne auf ein Neuladen warten zu müssen. Das Flag --exportQvfNoData exportiert die QVF-Datei nach Abschluss des Builds ohne Daten, wodurch eine kleinere Datei für die Weitergabe erzeugt wird. Die Flags können unabhängig voneinander oder gemeinsam verwendet werden.
Automatisches Binäres Laden
Automatisches Binäres Laden lädt die ursprüngliche QVW-Datei in Qlik Cloud hoch, verwendet eine Binary-Anweisung, um die Daten in die konvertierte App zu laden, und entfernt dann die hochgeladene Datei. Die konvertierte App erhält dieselben Daten wie das QlikView-Original, ohne dass eine manuelle Konfiguration der Datenverbindung erforderlich ist.
Um das automatische Binäre Laden zu aktivieren, verwenden Sie --autoBinary in der Befehlszeile oder aktivieren Sie Auto-binary in der Benutzeroberfläche.
QV2QS führt die folgenden Schritte aus, wenn automatisches Binäres Laden aktiviert ist:
- Laden Sie die QVW-Datei als temporäre App in Qlik Cloud hoch.
- Stellen Sie dem konvertierten App-Ladeskript eine
Binary [<appId>];-Anweisung und eineExit Script;-Anweisung voran. - Erstellen Sie die App (und laden Sie sie neu, wenn
--reloadangegeben ist), die Daten aus der hochgeladenen QVW lädt. - Löschen Sie die temporär hochgeladene App aus Qlik Cloud.
- Stellen Sie das ursprüngliche Ladeskript in der Qlik Cloud-App wieder her und entfernen Sie die Anweisungen Binary und Exit Skript.
Nach der Bereinigung enthält die Qlik Cloud-App die geladenen Daten, aber das Ladeskript verweist nicht mehr auf die temporäre App.
Der Upload-Schritt unterliegt den Dateigrößenbeschränkungen von Qlik Cloud. Große QVW-Dateien können das Upload-Limit für die Abonnementstufe des Mandanten überschreiten. Wenn der Upload fehlschlägt, stellen Sie die App in einem Bereich mit aktivierter Unterstützung für große Apps bereit oder verwenden Sie das Argument --binaryAppId, um auf eine vorhandene App zu verweisen, die sich bereits in Qlik Cloud befindet. Details zu Ressourcenlimits für Mandanten finden Sie unter Qlik Cloud-Ressourcenlimits.
Bereinigung im Fehlerfall
Wenn der Build- oder Neuladeschritt fehlschlägt, nachdem die QVW-Datei hochgeladen wurde, versucht QV2QS automatisch, vor dem Beenden eine Bereinigung durchzuführen. Die Bereinigung umfasst das Löschen der temporär hochgeladenen App aus Qlik Cloud und das Wiederherstellen des ursprünglichen Ladeskripts sowohl lokal als auch in der Cloud-App.
Wenn die Bereinigung selbst fehlschlägt (beispielsweise aufgrund einer Netzwerkunterbrechung), verbleibt die temporäre App möglicherweise im Qlik Cloud-Mandanten. Verwaiste temporäre Apps werden QV2QS_Binary_YYYYMMDD_HHMMSS genannt (z. B. QV2QS_Binary_20260219_143025). Überprüfen Sie den Zielbereich auf Apps, die diesem Muster entsprechen, und löschen Sie diese manuell. Die lokale script.qvs-Datei im Build-Verzeichnis kann auch die temporäre Binary-Anweisung enthalten. Führen Sie die Konvertierung erneut aus, um es neu zu generieren.
Automatisches Binäres Laden erfordert das --reload-Flag und einen --qvw-Pfad. QV2QS lehnt den Befehl ab und wird mit Code 1 beendet, wenn eine der beiden Anforderungen fehlt.
Die ursprüngliche QVW-Datei auf dem lokalen Computer wird niemals geändert oder gelöscht. Nur die temporäre Kopie in Qlik Cloud wird entfernt, nachdem der Datenladevorgang abgeschlossen ist.
Automatisches Binäres Laden wird für Apps, die Abschnittszugriff verwenden, nicht unterstützt. Die Qlik Cloud-Reload-Engine kann sich nicht an der Tabelle für den Abschnittszugriff in der QVW-Quelldatei authentifizieren. Wenn QV2QS Abschnittszugriff in der Quell-App erkennt, werden die Schritte für das binäre Hochladen und Neuladen übersprungen und eine Warnung wird protokolliert. Die App wird ohne Daten bereitgestellt. Um Daten zu laden, erstellen Sie Qlik Cloud-Datenverbindungen und aktualisieren Sie das Ladeskript manuell, oder entfernen Sie den Abschnittszugriff aus einer Kopie der Quell-QVW und führen Sie den Vorgang mit --autoBinary erneut aus.
Wenn --preserveTargetAppScript mit --reload kombiniert wird, führt das Neuladen das bestehende Ladeskript in der Ziel-App aus, nicht das konvertierte Skript. Dies ist nützlich, wenn die Ziel-App bereits über funktionierende Qlik Cloud-Datenverbindungen verfügt und nur die UI-Ebene aktualisiert werden muss. Weitere Informationen finden Sie unter Wiederverwenden einer vorhandenen App.