Argumentverwijzing

Laatst bijgewerkt: 14-10-2026

De onderstaande tabellen vermelden elk beschikbaar argument gegroepeerd per categorie.

Invoer en uitvoer

Batchmodus

Qlik Cloud

Verificatie

Lay-out en styling

Voor een gedetailleerde uitleg over vaste canvas- en dynamische rastermodi, zie Conversie-lay-outinstellingen.

Conversierapport

Het consolerapport en het Excel-rapport zijn beide standaard ingeschakeld in CLI-modus en in de gebruikersinterface.

Console en logboekregistratie

QV2QS ondersteunt vier console-uitvoermodi.

• Mooi — Rijk opgemaakte uitvoer met kleuren, geanimeerde spinners, voortgangsbalken en themapanelen. Mooie modus is de standaard voor interactief terminalgebruik. Vereist een terminal met kleurondersteuning (Windows 10+, PowerShell 5+, of Unix-achtige shells).
• Standaard — Tijdgestempelde tekstuitvoer zonder ANSI-escapescodes. Elke regel wordt voorafgegaan door een tijdstempel en een faselabel in het formaat [MM:SS] [phase] message. Kopteksten en tabellen gebruiken ASCII-tekens. Geschikt voor CI/CD-pijplijnen, logbestanden en terminals die geen ANSI-opmaak ondersteunen.
• Stil — Onderdrukt alle standaarduitvoer. Alleen fouten worden weergegeven. Geschikt voor geautomatiseerde batchverwerking en gescripte workflows waarbij geen console-uitvoer nodig is.
• UI — Regelgeoriënteerde uitvoer zonder tijdstempels of ANSI-codes. De gebruikersinterface stelt deze modus automatisch in bij het starten van een conversiesubproces. De indeling is geoptimaliseerd voor de ingebouwde logboekweergave. Het uitvoeren van --console ui vanaf een terminal produceert leesbare maar ongeformatteerde uitvoer; gebruik --plain of --console pretty in plaats daarvan voor direct terminalgebruik.

De --dark en --light vlaggen selecteren een kleurthema. Het donkere thema (standaard) gebruikt een diep marineblauw, door Qlik geïnspireerd palet. Het lichte thema gebruikt een lichtgrijs palet. De --surface vlag activeert een subtiele achtergrondvulling achter elke uitvoerregel. Oppervlaktevulling is standaard ingeschakeld in de mooie modus. Gebruik --noSurface om de achtergrondvulling uit te schakelen.

In de single-projectmodus worden logbestanden standaard geschreven naar %LOCALAPPDATA%\QV2QS\logs\. In batchmodus worden logbestanden geschreven naar de logs/ submap in de uitvoermap. Overschrijf de locatie met --logDir. Stel --logLevel DEBUG in om gedetailleerde diagnostische uitvoer vast te leggen voor het oplossen van conversieproblemen. Gebruik --cleanLogs om logbestanden ouder dan 30 dagen te verwijderen voor elke uitvoering. Voor een volledige beschrijving van de locaties, rotatie en indeling van logbestanden, zie Logboekregistratie en diagnostiek.

Script laden

Standaard past QV2QS acht ingebouwde regels toe die Windows-paden met backslashes normaliseren naar forward slashes voor compatibiliteit met Qlik Cloud. De volgende tabel geeft een overzicht van elke ingebouwde regel.

Elke regel gebruikt een tweefasig matchingproces. Het pattern veld is een reguliere expressie die een gedeelte van de load-script selecteert. Het search veld wordt dan alleen toegepast binnen elke overeenkomende regio. Deze aanpak voorkomt onbedoelde vervangingen buiten de beoogde context.

Het --scriptReplacements argument accepteert een JSON-bestand dat de enige bron van waarheid wordt voor alle vervangingsregels. Wanneer een bestand wordt opgegeven, worden ingebouwde standaardinstellingen niet automatisch geladen. Om ingebouwde regels naast aangepaste regels op te nemen, exporteer de volledige regelset vanuit de wizard en bewerk het geëxporteerde bestand. Regels worden uitgevoerd in execution_order volgorde.

Drie CLI-gedragingen zijn beschikbaar:

• Geen vlag — de acht ingebouwde regels worden uitgevoerd.
• --scriptReplacements <file> — alleen regels in het bestand worden uitgevoerd. Ingebouwde standaardinstellingen worden niet automatisch geladen.
• --noScriptReplacements — geen regels worden uitgevoerd.

Het --scriptReplacements bestand is een JSON-array van regelobjecten:

[
  {
    "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
  }
]

Elke regel heeft de volgende velden:

Overig

Datumveld sorteerbeveiliging

Standaard sorteert Qlik Sense geselecteerde waarden naar de bovenkant van een lijstvak. Voor datumachtige velden zoals Kwartaal, Maand of Jaar, verbreekt deze herordening de verwachte chronologische volgorde. QV2QS past een heuristiek toe om datumachtige veldnamen te detecteren en statusgebaseerde sortering op die velden te onderdrukken, waarbij waarden in hun natuurlijke volgorde blijven ongeacht de selectiestatus.

De heuristiek tokeniseert elke veldnaam door te splitsen op niet-alfanumerieke tekens en camelCase-grenzen (bijvoorbeeld, OrderDate wordt order en date). Alle tokens zijn in kleine letters. Een veld komt overeen als een token gelijk is aan een van de volgende: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Een veld komt ook overeen als een token eindigt op date, month, of year (bijvoorbeeld, OrderDate, FiscalMonth). De tokens update, candidate, en validate zijn uitgesloten om vals-positieven te voorkomen. Matchen is niet hoofdlettergevoelig en gebruikt alleen Engelse tokens. Niet-Engelse veldnamen (bijvoorbeeld, Monat of Fecha) worden niet gedetecteerd.

Velden die overeenkomen met de heuristiek hebben sortering op basis van status verwijderd en automatische sortering uitgeschakeld.

Gebruik --disableDateStateStickySort om deze heuristiek uit te schakelen. Wanneer uitgeschakeld, gebruiken alle lijstvakvelden het standaard sorteergedrag van Qlik Sense, inclusief herschikking op basis van status.

Oplossingen voor quotering in set-analyse

QlikView en Qlik Sense interpreteren aanhalingstekens in setanalyse-modifiers anders. QV2QS past twee onafhankelijke oplossingen toe tijdens de conversie. De oplossing voor zoeken met enkele aanhalingstekens is standaard ingeschakeld. De oplossing voor niet-gequote setwaarden is experimenteel en standaard uitgeschakeld.

Zoekwaarden tussen enkele aanhalingstekens herstellen (--fixSingleQuotedSearch)

Enkel aangehaalde waarden die zoekopdrachtsyntaxis bevatten, worden omgezet in dubbele aanhalingstekens. Gedetecteerde zoekpatronen omvatten jokers (*, ?, ^), vergelijkingsoperatoren (>, >=, <, <=), fuzzy zoeken (~), expressie zoeken (=), zoekmodificatoren (+, -), en samengesteld zoeken ((…|…), (…&…)):

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

Literalen met enkele aanhalingstekens (bijvoorbeeld, 'USA') en waarden tussen enkele aanhalingstekens op numerieke velden worden niet beïnvloed. Gebruik --noFixSingleQuotedSearch om deze oplossing uit te schakelen.

Repareer niet-gequoteerde setwaarden (--fixUnquotedSetValues) — experimenteel

Ongequote kale tekenreekswaarden worden omgeven door enkele aanhalingstekens:

• {<Country={USA}>} wordt {<Country={'USA'}>}

Numerieke waarden (2024), dollartekenvariabelen ($(vYear)), en dubbel aangehaalde strings worden ongewijzigd gelaten. Deze oplossing is standaard uitgeschakeld. Voer --fixUnquotedSetValues in om het in te schakelen. Gebruik --noFixUnquotedSetValues om het expliciet uit te schakelen.

Beide oplossingen zijn uitsluitend van toepassing op dimensie- en maatexpressies. Bevindingen van niet-ondersteunde functies worden niet gewijzigd. Als een oplossing is uitgeschakeld, blijven de gemarkeerde patronen voor handmatige beoordeling in het Expression_Findings werkblad.

Meer informatie

• Veelvoorkomende workflows
• Logboekregistratie en diagnostiek
• Indelingsmodi