Argumentreferens

Senast uppdaterad: 2026-10-14

Tabellerna nedan listar varje tillgängligt argument grupperat efter kategori.

Indata och utdata

Batchläge

Qlik Cloud

Autentisering

Layout och stil

För en detaljerad förklaring av lägena för fast arbetsyta och dynamiskt rutnät, se Konverteringslayoutinställningar.

Konverteringsrapport

Konsolrapporten och Excel-rapporten är båda aktiverade som standard i CLI-läge och i användargränssnittet.

Konsol och loggning

QV2QS stöder fyra konsolutmatningslägen.

• Snygg — Rikt formaterad utdata med färger, animerade snurror, förloppsindikatorer och temapaneler. Snyggt läge är standard för interaktiv terminalanvändning. Kräver en färgkapabel terminal (Windows 10+, PowerShell 5+, eller Unix-liknande skal).
• Enkel — Tidsstämplad textutdata utan ANSI-escapekoder. Varje rad inleds med en tidsstämpel för förfluten tid och en fas-tagg i formatet [MM:SS] [phase] message. Rubriker och tabeller använder ASCII-tecken. Lämplig för CI/CD-pipelines, loggfiler och terminaler som inte stöder ANSI-formatering.
• Tyst — Undertrycker all standardutdata. Endast fel visas. Lämplig för automatiserad batchbearbetning och skriptbaserade arbetsflöden där ingen konsolutmatning behövs.
• UI — Radorienterad utdata utan tidsstämplar eller ANSI-koder. Användargränssnittet ställer in detta läge automatiskt när en konverteringsunderprocess startas. Formatet är optimerat för den inbäddade loggvisaren. Att köra --console ui från en terminal ger läsbar men oformaterad utdata; använd --plain eller --console pretty istället för direkt terminalanvändning.

Flaggorna --dark och --light väljer ett färgtema. Det mörka temat (standard) använder en djupt marinblå Qlik-inspirerad palett. Det ljusa temat använder en ljusgrå palett. Flaggan --surface aktiverar en diskret bakgrundsfyllning bakom varje utdatarad. Ytfyllning är aktiverad som standard i snyggt läge. Använd --noSurface för att inaktivera bakgrundsfyllningen.

I enprojektsläge skrivs loggfiler till %LOCALAPPDATA%\QV2QS\logs\ som standard. I batchläge skrivs loggfiler till logs/ undermappen i utdatakatalogen. Åsidosätt platsen med --logDir. Ange --logLevel DEBUG för att samla in detaljerad diagnostisk utdata för felsökning av konverteringsproblem. Använd --cleanLogs för att ta bort loggfiler äldre än 30 dagar före varje körning. För en fullständig beskrivning av loggfilsplatser, rotation och format, se Loggning och diagnostik.

Läs in skript

Som standard tillämpar QV2QS åtta inbyggda regler som normaliserar Windows-sökvägar med omvända snedstreck till snedstreck för Qlik Cloud-kompatibilitet. Följande tabell listar varje inbyggd regel.

Varje regel använder en matchningsprocess i två steg. Fältet pattern är ett reguljärt uttryck som väljer ett område av laddningsskriptet. Fältet search tillämpas sedan endast inom varje matchat område. Denna metod förhindrar oavsiktliga ersättningar utanför det avsedda sammanhanget.

Det --scriptReplacements argumentet accepterar en JSON-fil som blir den enda källan till sanning för alla ersättningsregler. När en fil tillhandahålls, laddas inte inbyggda standardinställningar automatiskt. För att inkludera inbyggda regler tillsammans med anpassade regler, exportera hela regeluppsättningen från guiden och redigera den exporterade filen. Regler körs i execution_order ordning.

Tre CLI-beteenden är tillgängliga:

• Ingen flagga — de åtta inbyggda reglerna körs.
• --scriptReplacements <file> — endast regler i filen körs. Inbyggda standardinställningar laddas inte automatiskt.
• --noScriptReplacements — inga regler körs.

Filen --scriptReplacements är en JSON-array med regelobjekt:

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

Varje regel har följande fält:

Annat

Datumfälts sorteringsskydd

Som standard sorterar Qlik Sense markerade värden överst i en listruta. För datumliknande fält som Kvartal, Månad eller År, bryter denna omordning den förväntade kronologiska sekvensen. QV2QS tillämpar en heuristik för att upptäcka datumliknande fältnamn och undertrycka tillståndsbaserad sortering på dessa fält, vilket håller värdena i deras naturliga ordning oavsett urvalstillstånd.

Heuristiken tokeniserar varje fältnamn genom att dela upp vid icke-alfanumeriska tecken och camelCase-gränser (till exempel, OrderDate blir order och date). Alla tokens är gemena. Ett fält matchar om något token är lika med något av följande: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Ett fält matchar också om något token slutar med date, month, eller year (till exempel, OrderDate, FiscalMonth). Tokenerna update, candidate, och validate är uteslutna för att undvika falska positiva resultat. Matchningen är skiftlägesokänslig och använder endast engelska token. Fältnamn som inte är på engelska (till exempel, Monat eller Fecha) identifieras inte.

Fält som matchar heuristiken får tillståndsbaserad sortering borttagen och automatisk sortering inaktiverad.

Använd --disableDateStateStickySort för att stänga av denna heuristik. När inaktiverat, använder alla listrutefält standard Qlik Sense-sorteringsbeteende, inklusive tillståndsbaserad omordning.

Fixar för citattecken i mängdanalys

QlikView och Qlik Sense tolkar citattecken i uppsättningsanalysmodifierare olika. QV2QS tillämpar två oberoende korrigeringar under konverteringen. Korrigeringen för sökning med enkla citattecken är aktiverad som standard. Fixen för omarkerade uppsättningsvärden är experimentell och inaktiverad som standard.

Åtgärda enkelt citerade sökvärden (--fixSingleQuotedSearch)

Enkelciterade värden som innehåller söksyntax konverteras till dubbla citattecken. Identifierade sökmönster inkluderar jokertecken (*, ?, ^), jämförelseoperatorer (>, >=, <, <=), sökning med jokertecken (~), uttryckssökning (=), sökmodifierare (+, -), och sammansatt sökning ((…|…), (…&…)):

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

Enkelciterade oformaterade textliteraler (till exempel, 'USA') och enkelciterade värden på numeriska fält påverkas inte. Använd --noFixSingleQuotedSearch för att inaktivera den här korrigeringen.

Åtgärda ociterade angivna värden (--fixUnquotedSetValues) — experimentell

Ocitaterade rena strängvärden är omslutna av enkla citattecken:

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

Numeriska värden (2024), dollarteckenvariabler ($(vYear)), och dubbelciterade strängar lämnas oförändrade. Som standard är denna korrigering inaktiverad. Skicka --fixUnquotedSetValues för att aktivera det. Använd --noFixUnquotedSetValues för att uttryckligen inaktivera den.

Båda korrigeringarna gäller för dimension och måttuttryck endast. Resultat för funktioner som inte stöds ändras inte. När en korrigering är inaktiverad, finns de flaggade mönstren kvar för manuell granskning i Expression_Findings arbetsbladet.

Läs mer

• Vanliga arbetsflöden
• Loggning och diagnostik
• Layoutlägen