Argumentreferenz

Letzte Aktualisierung: 14.10.2026

Die folgenden Tabellen führen jedes verfügbare Argument nach Kategorie gruppiert auf.

Eingabe und Ausgabe

Stapelmodus

Qlik Cloud

Authentifizierung

Layout und Styling

Für eine detaillierte Erklärung von festen Zeichenflächen- und dynamischen Gitternetzmodi, siehe Konvertierungs-Layout-Einstellungen.

Konversionsbericht

Der Konsolenbericht und der Excel-Bericht sind beide standardmäßig im CLI-Modus und in der Benutzeroberfläche aktiviert.

Konsole und Protokollierung

QV2QS unterstützt vier Konsolenausgabemodi.

• Schön — Reich formatierte Ausgabe mit Farben, animierten Spinnern, Fortschrittsbalken und thematischen Panels. Der Pretty-Modus ist die Standardeinstellung für die interaktive Terminalnutzung. Erfordert ein farbfähiges Terminal (Windows 10+, PowerShell 5+ oder Unix-ähnliche Shells).
• Klartext — Zeitgestempelte Textausgabe ohne ANSI-Escape-Codes. Jeder Zeile ist ein Zeitstempel und ein Phasen-Tag im Format [MM:SS] [phase] message vorangestellt. Kopfzeilen und Tabellen verwenden ASCII-Zeichen. Geeignet für CI/CD-Pipelines, Protokolldateien und Terminals, die keine ANSI-Formatierung unterstützen.
• Stumm — Unterdrückt die gesamte Standardausgabe. Nur Fehler werden angezeigt. Geeignet für die automatisierte Stapelverarbeitung und skriptgesteuerte Workflows, bei denen keine Konsolenausgabe erforderlich ist.
• UI — Zeilenorientierte Ausgabe ohne Zeitstempel oder ANSI-Codes. Die Benutzeroberfläche stellt diesen Modus automatisch ein, wenn ein Konvertierungsunterprozess gestartet wird. Das Format ist optimiert für den eingebetteten Protokoll-Viewer. Ausführen von --console ui von einem Terminal erzeugt lesbare, aber unformatierte Ausgabe; verwenden Sie stattdessen --plain oder --console pretty für die direkte Terminalnutzung.

Die --dark und --light Flags wählen eine Farbformatvorlage. Die dunkle Formatvorlage (Standard) verwendet eine tiefblaue, von Qlik inspirierte Palette. Die helle Formatvorlage verwendet eine hellgraue Palette. Das --surface Flag ermöglicht eine subtile Hintergrundfüllung hinter jeder Ausgabelinie. Oberflächenfüllung ist standardmäßig im Schönheitsmodus aktiviert. Verwenden Sie --noSurface, um die Hintergrundfüllung zu deaktivieren.

Im Einzelprojektmodus werden Protokolldateien standardmäßig in %LOCALAPPDATA%\QV2QS\logs\ geschrieben. Im Stapelmodus werden Protokolldateien in den logs/ Unterordner im Ausgabeverzeichnis geschrieben. Den Standort mit --logDir überschreiben. Konfigurieren Sie --logLevel DEBUG, um detaillierte Diagnoseausgaben zur Fehlerbehebung bei Konvertierungsproblemen zu erfassen. Verwenden Sie --cleanLogs, um Protokolldateien, die älter als 30 Tage sind, vor jedem Lauf zu löschen. Eine vollständige Beschreibung der Speicherorte, Rotation und des Formats von Protokolldateien finden Sie unter Protokollierung und Diagnose.

Skript laden

Standardmäßig wendet QV2QS acht integrierte Regeln an, die Windows-Backslash-Pfade in Forward-Slashes für die Qlik Cloud-Kompatibilität normalisieren. Die folgende Tabelle listet jede integrierte Regel auf.

Jede Regel verwendet einen zweistufigen Abgleichprozess. Das pattern Feld ist ein Regex, das einen Bereich des Ladeskripts auswählt. Das search Feld wird dann nur innerhalb jeder übereinstimmenden Region angewendet. Dieser Ansatz verhindert unbeabsichtigte Ersetzungen außerhalb des Zielkontexts.

Das --scriptReplacements Argument akzeptiert eine JSON-Datei, die zur einzigen Quelle der Wahrheit für alle Ersetzungsregeln wird. Wenn eine Datei bereitgestellt wird, werden Standardeinstellungen nicht automatisch geladen. Um integrierte Regeln zusammen mit benutzerdefinierten Regeln einzuschließen, exportieren Sie den vollständigen Regelsatz aus dem Assistenten und bearbeiten Sie die exportierte Datei. Regeln werden in execution_order Reihenfolge ausgeführt.

Drei CLI-Verhaltensweisen sind verfügbar:

• Kein Flag — die acht integrierten Regeln werden ausgeführt.
• --scriptReplacements <file> — nur Regeln in der Datei werden ausgeführt. Integrierte Standardwerte werden nicht automatisch geladen.
• --noScriptReplacements — keine Regeln werden ausgeführt.

Die --scriptReplacements Datei ist ein JSON-Array von Regelobjekten:

[
  {
    "description": "Replace server path with lib connection",
    "pattern": "FROM\\s+'[^']*'",
    "search": "\\\\\\\\server\\\\share\\\\",
    "replace": "lib://DataFiles/",
    "is_regex": true,
    "case_sensitive": false,
    "enabled": true,
    "execution_order": 1
  }
]

Jede Regel hat die folgenden Felder:

Sonstige

Datumsfeld-Sortierschutz

Standardmäßig sortiert Qlik Sense ausgewählte Werte an den Anfang eines Listenfelds. Für datumsähnliche Felder wie Quartal, Monat oder Jahr unterbricht diese Neuanordnung die erwartete chronologische Reihenfolge. QV2QS wendet eine Heuristik an, um datumsähnliche Feldnamen zu erkennen und die zustandsbasierte Sortierung auf diesen Feldern zu unterdrücken, wobei die Werte unabhängig vom Auswahlstatus in ihrer natürlichen Reihenfolge bleiben.

Die Heuristik tokenisiert jeden Feldnamen, indem sie an nicht-alphanumerischen Zeichen und camelCase-Grenzen aufteilt (zum Beispiel, OrderDate wird zu order und date). Alle Token sind kleingeschrieben. Ein Feld stimmt überein, wenn ein beliebiges Token einem der folgenden entspricht: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Ein Feld stimmt auch überein, wenn ein Token mit date, month oder year endet (zum Beispiel OrderDate, FiscalMonth). Die Token update, candidate und validate sind Ausgeschlossen, um Fehlalarme zu vermeiden. Der Abgleich ist groß-/kleinschreibungsunempfindlich und verwendet ausschließlich englische Token. Nicht-englische Feldnamen (zum Beispiel, Monat oder Fecha) werden nicht erkannt.

Bei Feldern, die der Heuristik entsprechen, wird die zustandsbasierte Sortierung entfernt und die automatische Sortierung deaktiviert.

Verwenden Sie --disableDateStateStickySort, um diese Heuristik zu deaktivieren. Wenn deaktiviert, verwenden alle Listbox-Felder das standardmäßige Qlik Sense Sortierverhalten, einschließlich der zustandsbasierten Neuanordnung.

Korrekturen der Anführungszeichen in der Mengenanalyse

QlikView und Qlik Sense interpretieren Anführungszeichen in Set-Analyse-Modifikatoren unterschiedlich. QV2QS wendet während der Konvertierung zwei unabhängige Korrekturen an. Die Korrektur für die Suche mit einfachen Anführungszeichen ist standardmäßig aktiviert. Der Fix für nicht-zitierte Set-Werte ist experimentell und standardmäßig deaktiviert.

Einfach zitierte Suchwerte korrigieren (--fixSingleQuotedSearch)

Werte in einfachen Anführungszeichen, die Suchsyntax enthalten, werden in doppelte Anführungszeichen umgewandelt. Erkannte Suchmuster umfassen Platzhalter (*, ?, ^), Vergleichsoperatoren (>, >=, <, <=), Fuzzy-Suche (~), Ausdruckssuche (=), Suchmodifikatoren (+, -) und zusammengesetzte Suche ((…|…), (…&…)):

• {<Year={'2*'}>} wird zu {<Year={"2*"}>}
• {<Amount={'>100'}>} wird zu {<Amount={">100"}>}
• {<Customer={'~company'}>} wird zu {<Customer={"~company"}>}

Einfach zitierte Klartextliterale (zum Beispiel, 'USA') und einfach zitierte Werte in numerischen Feldern sind nicht betroffen. Verwenden Sie --noFixSingleQuotedSearch, um diese Korrektur zu deaktivieren.

Nicht-zitierte Set-Werte beheben (--fixUnquotedSetValues) — experimentell

Nicht-zitierte, einfache Zeichenfolgenwerte werden in einfache Anführungszeichen eingeschlossen:

• {<Country={USA}>} wird zu {<Country={'USA'}>}

Numerische Werte (2024), Dollarzeichen-Variablen ($(vYear)) und Zeichenketten in doppelten Anführungszeichen bleiben unverändert. Dieser Fix ist standardmäßig deaktiviert. Übergeben Sie --fixUnquotedSetValues, um es zu aktivieren. Verwenden Sie --noFixUnquotedSetValues, um es explizit zu deaktivieren.

Beide Korrekturen gelten nur für Dimension- und Maßausdrücke. Befunde zu nicht unterstützten Funktionen werden nicht geändert. Wenn eine Korrektur deaktiviert ist, bleiben die markierten Muster zur manuellen Überprüfung im Expression_Findings Arbeitsblatt.

Mehr erfahren

• Gängige Workflows
• Protokollierung und Diagnose
• Layout-Modi