Assistentenschritte
Letzte Aktualisierung: 14.10.2026Die Benutzeroberfläche ist eine Assistenten-Oberfläche für den gesamten Konvertierungsprozess. Der Assistent öffnet sich im Standardbrowser nach einem Doppelklick auf QV2QS.exe oder durch Ausführen der ausführbaren Datei mit dem --ui Flag. Die aktuelle Versionsnummer wird im Dialogfeld „Über“ angezeigt. Eine Formatvorlagen-Umschalttaste in der oberen rechten Ecke wechselt zwischen hellem und dunklem Modus. Weitere Informationen finden Sie unter Dunkelmodus.
Der Assistent präsentiert die folgenden Schritte der Reihe nach. Schritte, die nicht für den ausgewählten Workflow-Modus gelten, werden automatisch ausgeblendet.
Einrichtung
Wählen Sie einen Workflow-Modus (erforderlich). Der ausgewählte Modus bestimmt, welche nachfolgenden Schritte verfügbar sind.
- Erstellen für Qlik Cloud (Standard) — konvertiert die QlikView-Benutzeroberfläche und stellt die resultierende App direkt im Qlik Cloud-Mandanten bereit. Wählen Sie diesen Modus, um die konvertierte App sofort in Qlik Cloud zu sehen. Dieser Modus ist der empfohlene Arbeitsablauf für die Migration.
- QVF exportieren — konvertiert die QlikView-Benutzeroberfläche mithilfe der Qlik Cloud-Engine, exportiert die resultierende App als QVF-Datei und löscht dann die Cloud-App. Wählen Sie diesen Modus, um eine Datei zum Teilen mit einem anderen Team oder zum Importieren in einen anderen Mandanten zu erstellen. Dieser Modus erfordert weiterhin einen Qlik Cloud Mandanten und einen API-Schlüssel. Der Import in Qlik Sense Enterprise Client-Managed wird nicht über alle Versionen hinweg getestet oder offiziell unterstützt. Weitere Informationen finden Sie unter Qlik Sense Enterprise Client-Managed-Kompatibilität.
- Nur lokal — führt die Konvertierung auf dem Datenträger durch, ohne eine Verbindung zu Qlik Cloud herzustellen. Es ist kein Qlik Cloud Mandant oder API-Schlüssel erforderlich. Der Nur-Lokal-Modus generiert den vollständigen Konvertierungsbericht und die Build-Ausgabe zur Bewertung, Überprüfung oder Offline-Nutzung. Die lokale Build-Ausgabe enthält keine Medien-Uploads, Hintergrundbildauflösung, Erstellung alternativer Zustände oder Arbeitsblattveröffentlichung — diese Vorgänge erfordern die Bereitstellungsphase. Für eine vollständige Bereitstellung verwenden Sie den Modus „Build to Qlik Cloud“ oder „Export QVF“. Weitere Informationen zu den Einschränkungen der Nur-Lokal-Funktion finden Sie unter Wie die Konvertierung funktioniert. Das Anzielen von QSECM mit der Build-Ausgabe wird nicht über alle Versionen hinweg getestet oder offiziell unterstützt. Weitere Informationen finden Sie unter Qlik Sense Enterprise Client-Managed-Kompatibilität.
Projekt
Eingabequelle konfigurieren. Gehen Sie folgendermaßen vor:
- Einzelnes Projekt (Standard): Geben Sie eine QVW-Datei an (erforderlich). Automatische PRJ-Generierung ist standardmäßig aktiviert und generiert den PRJ-Ordner automatisch aus der QVW-Datei. Deaktivieren Sie diese Option, um einen PRJ-Ordner oder eine ZIP-Datei manuell bereitzustellen. Klicken Sie auf Beispiel ausprobieren, um ein gebündeltes Beispielprojekt zu laden, ohne zu suchen. Die Schaltfläche ist nur sichtbar, wenn das QVW-Feld leer ist. Siehe Beispielprojekte.
- Batch: Geben Sie einen oder mehrere zu scannende Ordner an (erforderlich). QV2QS entdeckt alle übereinstimmenden QVW- und PRJ-Paare rekursiv. Klicken Sie auf Beispiel ausprobieren, um das Ordnerfeld mit dem gebündelten Beispiele-Ordner zu füllen. Stapel-Worker steuert, wie viele Konvertierungen parallel ausgeführt werden (Standard: automatische Erkennung basierend auf CPU-Kernen). Weitere Informationen finden Sie unter Stapelkonvertierung.
Richten Sie QV2QS immer auf Kopien von Quelldokumenten in einem lokalen Arbeitsordner aus, nicht auf Produktionsdateien auf dem QlikView Server oder freigegebenen Netzlaufwerken. Die QlikView Desktop-Engine erwirbt während der PRJ-Generierung eine Dateisperre, was mit aktiven QlikView-Sitzungen in Konflikt geraten kann. Weitere Informationen finden Sie unter Sicherheit der Quelldatei.
Ausgabe
Legen Sie den Ausgabe-Stammordner fest (erforderlich). QV2QS erstellt automatisch einen Unterordner, der nach dem Projekt benannt ist, im Ausgabestammverzeichnis (zum Beispiel, <outputDir>/Sales/). Wenn zwei Projekte denselben Namen haben, wird ein _2, _3 Suffix angehängt, um Kollisionen zu vermeiden. Aktivieren Sie Protokolle bereinigen, um vorhandene Protokolldateien vor dem Lauf zu löschen.
Qlik Cloud Authentifizierung
Dieser Schritt wird nur in den Modi Build zu Qlik Cloud und Export QVF angezeigt.
Wählen oder erstellen Sie einen qlik-cli-Kontext zur Authentifizierung beim Qlik Cloud Mandanten (erforderlich). Erstellen Sie einen neuen Kontext, indem Sie die Mandanten-URL und den API-Schlüssel angeben. Der Assistent validiert die Verbindung, bevor fortgefahren wird.
Qlik Cloud App
Dieser Schritt wird nur in den Modi Build zu Qlik Cloud und Export QVF angezeigt.
| Einstellung | Beschreibung | Standard |
|---|---|---|
| App-Name | Name für die Qlik Sense App in Qlik Cloud | QVW-Dateiname, PRJ-Ordnername oder Ausgabeordnername |
| Laden | Laden Sie die App nach dem Erstellen neu, um das Ladeskript auszuführen | Ein |
| Auto-binär | Laden Sie die QVW-Datei temporär für den binären Datenladevorgang hoch und löschen Sie die Datei anschließend nach dem Neuladen. Erfordert Neuladen. | Ein |
| Binäre App-ID | Verwenden Sie eine vorhandene QVW- oder QVF-App in Qlik Cloud für das Binäre Laden, anstatt sie hochzuladen. Erfordert Neuladen. Klicken Sie auf die Schaltfläche „Durchsuchen“, um die QVW-Auswahl zu öffnen. | — |
| Bestehende App wiederverwenden | Aktualisieren Sie eine zuvor erstellte App, anstatt eine neue zu erstellen. Wenn aktiviert, prüft QV2QS den Ausgabeordner auf eine frühere Bereitstellung, die der ausgewählten QVW-Datei entspricht, und füllt die App-ID automatisch aus. Wenn keine vorherige Bereitstellung gefunden wird, geben Sie die App-ID manuell ein oder klicken Sie auf die Schaltfläche „Durchsuchen“, um die QVF-Auswahl zu öffnen. | Aus |
| Ladeskript beibehalten | Lassen Sie das vorhandene Ladeskript in der Ziel-App. Das konvertierte Skript wird nicht angewendet. Erfordert Wiederverwendung einer bestehenden App. Deaktiviert Reload standardmäßig; erneut aktivieren, um das vorhandene Skript auszuführen. | Aus |
| Variablen erhalten | Behalten Sie die vorhandenen Variablen in der Ziel-App bei. Die konvertierten Variablen werden nicht angewendet. Erfordert Vorhandene App wiederverwenden. | Aus |
| Sicherung vor der Bereitstellung überspringen | Exportieren Sie kein QVF-Backup, bevor Sie die App überschreiben. Standardmäßig wird eine Sicherung ohne Daten in cloud/backups/ gespeichert. Erfordert Vorhandene App wiederverwenden. |
Aus |
| Blätter veröffentlichen | Veröffentlichen Sie alle konvertierten Blätter nach dem Erstellen als Basisblätter. Basissheets sind für jeden Benutzer sichtbar, der Zugriff auf die App hat. Deaktivieren Sie diese Einstellung, um Blätter als persönliche (unveröffentlichte) Objekte zu behalten. Wenn Vorhandene App wiederverwenden aktiviert ist, gilt die Einstellung nur für neue Blätter. Zuvor veröffentlichte Blätter werden unabhängig von dieser Einstellung automatisch wiederhergestellt. | Ein |
| Ohne Daten erstellen | Datenladen während der Build-Phase überspringen. Die App wird auf dem Mandanten ohne Daten zusammengebaut, was das Testen der UI-Struktur ermöglicht, ohne auf ein Neuladen warten zu müssen. | Aus |
| Ohne Daten exportieren | Daten aus der exportierten QVF-Datei entfernen. Die Cloud App kann noch Daten aus dem Build enthalten, aber die heruntergeladene QVF ist kleiner. Export nur im QVF-Modus. | Aus |
Die Felder Binäre AppId und Bestehende App wiederverwenden enthalten Schaltflächen zum Durchsuchen, die Cloud-App-Auswahlmodale öffnen. Jeder Picker lädt Apps vom verbundenen Mandanten mit Suchfilterung nach Name, Eigentümer, Bereich oder App-ID. Der QVW-Picker bietet auch einen App-Typ-Filter (QVW, QVF oder alle). Wählen Sie eine App aus der Liste, um das Feld automatisch auszufüllen.
Ausdrucksanpassungen
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Einzeln zitierte Suchwerte korrigieren | Konvertieren Sie einfach zitierte Wildcards und Vergleiche in doppelte Anführungszeichen in Set-Analyse-Ausdrücken. Weitere Informationen finden Sie unter Argumentreferenz. | Ein |
| Nicht-zitierte Set-Werte beheben (experimentell) | Umschließen Sie nicht-zitierte Zeichenfolgenwerte in Mengenanalyse-Ausdrücken mit einfachen Anführungszeichen. Weitere Informationen finden Sie unter Argumentreferenz. | Aus |
Designs
Die folgenden Einstellungen steuern das Aussehen des Arbeitsblatts und das Verhalten des Layouts.
Formatvorlage
| Einstellung | Beschreibung | Standard |
|---|---|---|
| App-Formatvorlage | Qlik Sense Formatvorlage auf die konvertierte App angewendet. Die Dropdown-Liste listet die vier integrierten Qlik-Designs auf. Wenn ein Qlik Cloud-Kontext konfiguriert ist, klicken Sie auf die Schaltfläche „Aktualisieren“, um benutzerdefinierte Designs abzurufen, die auf dem Mandant installiert sind. Sense Classic erzeugt die höchste 1:1-Fidelität mit QlikView. Nicht-klassische Designs können Objektränder, Hintergrundfarben, Schriftarten und Abstände verändern. Die Formatvorlage legt nur die Standardeinstellung fest; Benutzer können Formatvorlagen jederzeit im Qlik Sense Client wechseln. | Sense Classic |
Hintergründe
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Blatthintergrundbilder | Extrahieren und Anwenden von QlikView Arbeitsblatt-Hintergrundbildern | Ein |
| Rückgriff auf den Dokumenthintergrund | Verwenden Sie den dokumentweiten Hintergrund für Blätter, die keinen haben | Ein |
| Überschreibung der Hintergrundfarbe | Einfarbige Füllung auf alle Blätter angewendet (#RRGGBB) |
— |
Layout
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Arbeitsblattkopfzeile anzeigen | Fügen Sie einen Kopfbereich zu konvertierten Blättern hinzu | Aus |
| Versteckte Blätter überspringen | Blätter mit konstant-falschen Anzeige-Bedingungen weglassen | Aus |
Listenfelder & Sortierung
| Einstellung | Beschreibung | Standard |
|---|---|---|
| QV-Listenfeld-Farben beibehalten | Ursprüngliche QlikView Listenfeld-Hintergrundfarben und Transparenz anwenden | Ein |
| Datumfeld-Sortierschutz | Halten Sie datumsähnliche Listenfelder (Jahr, Quartal, Monat und Ähnliches) chronologisch sortiert anstatt nach Auswahlstatus. Weitere Informationen finden Sie unter Argumentreferenz. | Ein |
Erweitert
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Fixierte Arbeitsblatt-Leinwand | Aktivieren Sie die pixelgenaue Positionierung im QlikView-Stil. Zeigt Skalierungsfaktoren, Mindestabmessungen und Optionen zum Zuschneiden der Arbeitsfläche an. Leinwandskalierung und Objektskalierung sind standardmäßig verknüpft; klicken Sie auf das Kettensymbol, um unabhängige Werte festzulegen. Weitere Informationen finden Sie unter Einstellungen für das Konvertierungs-Layout. | Ein |
| Automatisch erweiterndes dynamisches Arbeitsblatt | Blätter vertikal über die Standard-Gitternetzhöhe hinaus wachsen lassen | Ein |
| Medien-Upload-Worker | Anzahl paralleler Worker zum Hochladen von Mediendateien (Hintergrundbilder und Bilder) in Qlik Cloud. Gilt für die Modi Build zu Qlik Cloud und Export QVF. | 2
|
| Skript-Ersetzungen | Skript-Ersetzungsverarbeitung aktivieren oder deaktivieren und einzelne Regeln verwalten. Weitere Informationen finden Sie unter Argumentreferenz. | Ein |
Der Skript-Ersetzungen Abschnitt enthält einen Inline-Regel-Editor. Schalten Sie den Hauptschalter um, um alle Skriptverarbeitung zu aktivieren oder zu deaktivieren. Erweitern Sie den Abschnitt, um einzelne Regeln anzuzeigen, hinzuzufügen, zu bearbeiten oder zu löschen. Jede Regel kann unabhängig voneinander ein- oder ausgeschaltet werden. Klicken Sie auf Auf Standard zurücksetzen, um die acht integrierten Regeln wiederherzustellen. Ein Übersichts-Badge zeigt die Anzahl der aktivierten Regeln an.
Klicken Sie auf die Auf- und Abwärtspfeile einer Regel, um die Ausführungsreihenfolge zu ändern. Regeln mit einer niedrigeren Ausführungsreihenfolge werden zuerst ausgeführt. Klicken Sie auf Export, um alle Regeln als JSON-Datei herunterzuladen. Klicken Sie auf Import, um Regeln aus einer JSON-Datei zu laden und den aktuellen Satz zu ersetzen. Importierte Dateien müssen ein JSON-Array enthalten, bei dem jede Regel ein description, ein pattern und ein search Feld hat.
Um eine benutzerdefinierte Regeldatei für den Import zu erstellen, klicken Sie zuerst auf Exportieren, um die integrierten Regeln im richtigen Format zu erhalten. Bearbeiten Sie die exportierte Datei, um Regeln hinzuzufügen, zu entfernen oder zu ändern, klicken Sie dann auf Importieren, um den aktualisierten Satz zu laden.
Wenn benutzerdefinierte Regeln oder deaktivierte Standardeinstellungen konfiguriert sind, zeigt die Befehlsvorschau einen Hinweis an. Der kopierte Befehl enthält keine benutzerdefinierten Regeln. Regeln in eine JSON-Datei exportieren und --scriptReplacements <path> zum Befehl hinzufügen, um benutzerdefinierte Regeln in der Befehlszeile einzuschließen.
Eine Erklärung zur Funktionsweise von Regeln, einschließlich des zweistufigen Abgleichprozesses und der integrierten Regelliste, finden Sie unter Argumentreferenz.
Öffnen Sie Mockup Studio aus dem Schritt 'Erweitert', um interaktiv eine Vorschau von festen Zeichenflächen- und dynamischen Gitternetz-Layouts anzuzeigen, die Skalierung anzupassen und Einstellungen wieder auf den Assistenten anzuwenden.
Konversionsbericht
Die folgenden Einstellungen steuern die Konvertierungs-Berichtsausgabe.
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Bericht generieren | Erstellen Sie einen Konsolen-Konvertierungsbericht | Ein |
| Excel-Bericht | Exportieren Sie den Bericht als XLSX-Datei mit objektspezifischen Details und Automatisierungsbewertung. Geben Sie einen Dateinamen ein (z.B. MyReport) oder einen vollständigen Pfad. Die .xlsx Erweiterung wird automatisch hinzugefügt. Leer lassen zur automatischen Benennung in reports/. |
Ein |
| Auswahlen und Suchobjekte einschließen | Fügen Sie das Feld „Aktuelle Auswahlen“ und das Suchobjekt in den Bericht ein. Diese werden automatisch von Qlik Sense hinzugefügt und standardmäßig ausgeschlossen. | Aus |
Überprüfen
Bestätigen Sie alle Einstellungen vor dem Ausführen. Der Überprüfungsschritt zeigt Übersichtskarten für Projekt-, Workflow-, Cloud- und Ausgabekonfiguration an. Im Stapelmodus listet eine Tabelle alle gefundenen Projekte auf.
Eine Checkliste für erforderliche Aktionen in der Seitenleiste verfolgt Elemente, die vor dem Ausführen konfiguriert werden müssen. Elemente sind nach Kategorie gruppiert: Workflow, Eingaben, Ausgabe und Cloud-Authentifizierung. Jedes Element zeigt OK an, wenn konfiguriert, oder FESTZULEGEN, wenn ein Wert fehlt. Klicken Sie auf ein Element, um direkt zum entsprechenden Assistentenschritt zu navigieren.
Ein Befehlsvorschau-Panel zeigt den entsprechenden CLI-Befehl für die aktuelle Assistentenkonfiguration an. Umschalten zwischen PowerShell- und Bash-Syntax. Klicken Sie auf Kopieren, um den Befehl in die Zwischenablage zu kopieren. Die Befehlsvorschau ist nützlich, um die CLI-Argumente zu lernen oder den genauen Befehl für skriptgesteuerte Wiederholungen zu speichern.
Klicken Sie auf Ausführen, um die Konvertierung zu starten.
Ausführen
Zeigt die Live-Konsolenausgabe an, während die Konvertierung ausgeführt wird. Eine laufende Konvertierung stoppen, Protokollen in Echtzeit folgen und den Ausgabeordner oder die Qlik Cloud App öffnen, wenn der Durchlauf abgeschlossen ist.