# Argumentreferens

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

Anteckning om information

Användargränssnittet tillämpar olika standardvärden för vissa inställningar. Guiden har som standard fast dukläge, omladdning aktiverad och auto-binär aktiverad. CLI:n har som standard dynamiskt rutnätläge, omladdning inaktiverad och auto-binär inaktiverad. När du flyttar från guiden till CLI, ange dessa flaggor uttryckligen för att matcha guidens beteende.

## Indata och utdata

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--prjPath PATH` | Sökväg till QV PRJ-mapp eller ZIP-fil. Accepterar även PRJ zip-arkiv. | — |
| `--qvw PATH` | Sökväg till QVW- eller QVF-fil. Krävs i enprojektläge. | — |
| `--generatePrj` | Automatgenerera PRJ-mappar från QVW-filer före konvertering | Av |
| `--outputDir FOLDER` | Utmatningsrotkatalog. QV2QS skapar automatiskt en undermapp som namnges efter projektet. Krävs. | — |

## Batchläge

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--batchDir FOLDER` | Skanna en eller flera mappar rekursivt efter QVW- och PRJ-par. Separera flera mappar med `;`. | — |
| `--batchWorkers N` | Maximalt antal samtidiga konverteringar (`0` = auto: CPU-kärnor minus 1) | `0` |
| `--batchFlatOutput` | Skriv all utdata direkt under `--outputDir` istället för att bevara källmappshierarkin | Av |

## Qlik Cloud

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--unbuildOnly` | Endast lokalt läge. Generera byggresultat och konverteringsrapport på disk utan att ansluta till Qlik Cloud. Avsedd för bedömning, granskning och offlineanvändning. Den lokala utdata inkluderar inte medieuppladdningar, bakgrundsupplösning, skapande av alternativa tillstånd eller arkpublicering. Mer information finns i [Hur konvertering fungerar](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode). | Av |
| `--qsAppName NAME` | Namn på Qlik Sense appen i Qlik Cloud | QVW-filnamn, PRJ-mappnamn eller utdatamappnamn |
| `--appId APP_ID` | Uppdatera en befintlig Qlik Cloud app istället för att skapa en ny | — |
| `--appIdFile PATH` | Läs in app-ID från en fil | — |
| `--reuseAppId` | Återanvänd app-ID från `cloud/cloud_state.json` om filen finns | Av |
| `--preserveTargetAppScript` | Behåll det befintliga laddningsskriptet i mål-appen. Det konverterade laddningsskriptet har inte tillämpats. Kräver `--appId` och `--reuseAppId`. Kan kombineras med `--reload` för att köra det befintliga skriptet. | Av |
| `--preserveTargetAppVariables` | Behåll de befintliga variablerna i mål-appen. De konverterade variablerna tillämpas inte. Kräver `--appId` och `--reuseAppId`. | Av |
| `--noBackup` | Hoppa över den automatiska säkerhetskopieringen före distribuering när du återanvänder en befintlig app. Som standard exporterar QV2QS en QVF utan data till `cloud/backups/` innan appen ändras. | Av |
| `--reload` | Ladda om appen efter byggnation för att köra laddningsskriptet | Av |
| `--autoBinary` | Ladda upp QVW/QVF till Qlik Cloud för binär laddning, radera sedan efter omladdning. Kräver `--reload`. I enprojektsläge, krävs även `--qvw`. I batchläge upptäcks QVW-filer automatiskt. Ömsesidigt uteslutande med `--binaryAppId`. | Av |
| `--binaryAppId APP_ID` | Använd en befintlig app i Qlik Cloud för den binära laddningen istället för att ladda upp. Ömsesidigt uteslutande med `--autoBinary`. | — |
| `--noPublishSheets` | Publicera inte blad efter byggnation. Som standard publicerar QV2QS alla konverterade blad som basblad så att varje app-användare kan se dem. Använd den här flaggan för att behålla blad som personliga (opublicerade) objekt. När du återanvänder en befintlig app (`--reuseAppId` eller `--appId`), återställs tidigare publicerade blad automatiskt; denna flagga gäller endast nya blad som lagts till i den aktuella konverteringen. | Av |
| `--noData` | Bygg utan data | Av |
| `--exportQvf` | Exportera appen som en QVF-fil, sedan ta bort moln-appen | Av |
| `--exportQvfNoData` | Exportera QVF utan data. Kräver `--exportQvf`. | Av |
| `--mediaUploadWorkers N` | Parallella medieuppladdningstrådar | `2` |
| `--buildConfig PATH` | Byggkonfigurationsmanifest skickades till `qlik app build`. QV2QS genererar automatiskt denna fil under konverteringen. Åsidosätt endast om du tillhandahåller ett anpassat manifest. | `config.yml` |
| `--spaceId SPACE_ID` | Mål-Qlik Cloud-utrymme för app-skapande | Personligt utrymme |

## Autentisering

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--qlikContext NAME` | qlik-cli kontextnamn för autentisering | — |
| `--qlikTenantUrl URL` | Klient-URL (`https://<tenant>.<region>.qlikcloud.com`). När den kombineras med `--qlikApiKey`, autentiserar direkt utan att skapa en qlik-cli-kontext. | — |
| `--qlikApiKey KEY` | API-nyckel för autentisering. När den kombineras med `--qlikTenantUrl`, autentiserar direkt utan att skapa en qlik-cli-kontext. Nyckeln skrivs inte till disk. | — |
| `--qlikCliPath PATH` | Sökväg till qlik-cli-körbar | Paketerad |
| `--qlikContextsFile PATH` | Åsidosätt qlik-cli-kontextfilens plats | — |
| `--qlikNoPrompt` | Misslyckas omedelbart med felkod 1 om autentisering saknas. Inga interaktiva uppmaningar. Lämplig för CI/CD-pipelines. | Av |
| `--setupQlikAuth` | Konfigurera Qlik Cloud-autentisering och avsluta. Krävs inte när både `--qlikTenantUrl` och `--qlikApiKey` anges. | — |

## Layout och stil

För en detaljerad förklaring av lägena för fast arbetsyta och dynamiskt rutnät, se [Konverteringslayoutinställningar](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm).

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--fixedSheetCanvas` | Aktivera arbetsblad med pixelbaserad duk i fast storlek (QlikView-liknande positionering) | Av |
| `--fixedSheetCanvasScale FACTOR` | Skala dukens dimensioner med denna faktor | `1.4` |
| `--fixedSheetCanvasObjectScale FACTOR` | Skala objektpositioner och storlekar med denna faktor | `1.4` |
| `--fixedSheetCanvasMinWidthPx PX` | Minsta arbetsytebredd i pixlar | `1200` |
| `--fixedSheetCanvasMinHeightPx PX` | Minsta dukhöjd i pixlar | `700` |
| `--perSheetCanvasSize` | Använd arkspecifika dukdimensioner istället för enhetlig storlek | Av |
| `--noAutoExtendDynamicSheet` | Inaktivera automatisk utökning av arkets höjd i dynamiskt läge | Av |
| `--layoutShrinkX STEPS` | Minska layoutbehållarens bredd med N rutnätsteg (0–23) | `0` |
| `--layoutShrinkY STEPS` | Minska layoutbehållarens höjd med N rutnätsteg (0–11) | `0` |
| `--cropCanvasWidth PX` | Beskär arbetsytan till exakt bredd i pixlar. Endast fast kanvasläge. Måste anges tillsammans med `--cropCanvasHeight`. Ömsesidigt uteslutande med `--perSheetCanvasSize`. | `0` |
| `--cropCanvasHeight PX` | Beskär arbetsytan till exakt höjd i pixlar. Endast fast kanvasläge. Måste anges tillsammans med `--cropCanvasWidth`. Ömsesidigt uteslutande med `--perSheetCanvasSize`. | `0` |
| `--maxCanvasWidth PX` | Maximal dukbredd i pixlar. `0` inaktiverar gränsen. Endast fast kanvasläge. | `0` |
| `--maxCanvasHeight PX` | Maximal dukhöjd i pixlar. `0` inaktiverar gränsen. Endast fast kanvasläge. | `0` |
| `--appTheme THEME` | Qlik Sense app-tema tillämpat på den konverterade appen. Accepterar valfri inbyggd temaidentifierare (`sense`, `horizon`, `breeze`, `card`) eller ett anpassat temanavn installerat på klientorganisationen. Sense Classic (`sense`) är det minst påträngande temat och ger den högsta 1:1-troheten med QlikView. Icke-klassiska teman kan ändra objektramar, bakgrundsfärger, teckensnitt och utfyllnad. Temat anger endast standardinställningen; användare kan byta teman när som helst i Qlik Sense-klienten. | `sense` |
| `--disableSheetBackgrounds` | Hoppa över extrahering av bakgrundsbild från ark | Av |
| `--noDocBgFallback` | Tillämpa inte dokumentbakgrunden på blad utan en | Av |
| `--sheetBackgroundColor COLOR` | Enfärgad fyllning för alla blad (`#RRGGBB`, `#RRGGBB@0.5` eller `transparent`) | — |
| `--showSheetHeader` | Visa arkhuvudområdet | Av |
| `--skipHiddenSheets` | Utelämna blad med konstant falska visningsvillkor | Av |

## Konverteringsrapport

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

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--report` | Aktivera konsolkonverteringsrapporten | På |
| `--noReport` | Inaktivera konsolkonverteringsrapporten | — |
| `--reportXlsx [PATH]` | Exportera rapporten som en Excel-fil. Accepterar ett filnamn (t.ex. `MyReport`) eller en fullständig sökväg; `.xlsx` läggs till automatiskt. Relativa namn placeras i `outputDir/reports/`. Utelämna sökvägen för automatisk namngivning. | Automatiskt |
| `--noReportXlsx` | Inaktivera Excel-exportera | — |
| `--reportIncludeBuiltIns` | Inkludera aktuella val och sökobjekt i rapporten | Av |

## Konsol och loggning

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--console {pretty,plain,silent,ui}` | Konsolutdataläge | `pretty` |
| `--dark` | Mörkt konsoltema | På |
| `--light` | Ljust konsoltema | Av |
| `--surface` | Aktivera bakgrundsfyllning för konsolen | På (i snyggt läge) |
| `--noSurface` | Inaktivera bakgrundsfyllning | — |
| `--plain` | Genväg för `--console plain` | — |
| `--silent` | Genväg för `--console silent` | — |
| `--logLevel LEVEL` | Loggdetaljnivå: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` | `INFO` |
| `--logDir FOLDER` | Åsidosätt loggutmappen | `%LOCALAPPDATA%\QV2QS\logs\` (enskilt projekt) eller `<outputDir>/logs/` (satsvis) |
| `--cleanLogs` | Ta bort loggfiler äldre än 30 dagar före körningen | Av |

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](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm).

## Läs in skript

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--scriptReplacements PATH` | JSON-fil med skriptersättningsregler. När de anges, körs endast reglerna i filen. Inbyggda standardinställningar laddas inte automatiskt. Se format nedan. | — |
| `--noScriptReplacements` | Inaktivera alla skriptbyten. Inga regler körs, oavsett om en fil tillhandahålls. | Av |

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.

| ID | Beskrivning | Mål: |
| --- | --- | --- |
| 1 | Normalisera omvända snedstreck i `lib://` sökvägar | `lib://DataFiles\subfolder\file.qvd` |
| 2 | Normalisera omvända snedstreck i `STORE...INTO` sökvägar | `STORE table INTO 'C:\data\file.qvd'` |
| 3 | Normalisera omvända snedstreck i `FROM` sökvägar (citerade) | `FROM 'C:\data\file.qvd'` |
| 4 | Normalisera omvända snedstreck i sökvägar för `LET`-satser | `LET vPath = 'C:\data\files';` |
| 5 | Normalisera omvända snedstreck i sökvägar för `SET`-satser | `SET vPath = 'C:\data\files';` |
| 6 | Normalisera omvända snedstreck i sökvägar för `BINARY`-satser | `BINARY 'C:\apps\source.qvw'` |
| 7 | Normalisera omvända snedstreck i `FROM` sökvägar (oanförda) | `FROM C:\data\file.qvd` |
| 8 | Normalisera omvända snedstreck i `$(Variable=path)` utvidgning | `$(Must_Includes=C:\lib\file.qvs)` |

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.

Anteckning om tips

För att skapa en anpassad regelfil, öppna guiden, klicka på Exportera i Skript-ersättningsdelavsnittet, och använd den exporterade JSON-filen som utgångspunkt. Den exporterade filen innehåller alla åtta inbyggda regler i rätt format. Lägg till, ta bort eller ändra regler vid behov, skicka sedan filen med `--scriptReplacements`.

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:

| Fält | Beskrivning | Obligatoriskt fält |
| --- | --- | --- |
| `description` | Människoläsbar etikett för regeln | Ja |
| `pattern` | Regex som väljer ut regioner av skriptet att granska | Ja |
| `search` | Text eller reguljärt uttryck att hitta inom varje matchat område | Ja |
| `replace` | Ersättningstext | Nej (standard: tom sträng, vilket tar bort matchad text) |
| `is_regex` | Om `search` är ett reguljärt uttryck (`true`) eller en literal sträng (`false`) | Nej (standard: `true`) |
| `case_sensitive` | Om matchningen är skiftlägeskänslig | Nej (standard: `false`) |
| `enabled` | Om regeln är aktiv | Nej (standard: `true`) |
| `id` | Numerisk identifierare för UI-spårning | Nej |
| `execution_order` | Numeriskt värde som styr körningsordning. Lägre värden körs först. | Nej (standard: `0`) |

Anteckning om information

Filen accepterar även fältnamn i camelCase (`isRegex`, `caseSensitive`, `executionOrder`) för kompatibilitet med filer exporterade från guiden.

## Annat

| Argument | Beskrivning | Standard |
| --- | --- | --- |
| `--listboxBackgroundExpr EXPR` | Listbox bakgrundsfärg. `dynamic` bevarar QV-färger. Accepterar även `#RRGGBB`, `#AARRGGBB`, `rgb(r,g,b)`, eller `argb(a,r,g,b)`. | `dynamic` |
| `--disableDateStateStickySort` | Inaktivera datumfältets sorteringsskydd. Se nedan. | Av |
| `--fixSingleQuotedSearch` / `--noFixSingleQuotedSearch` | Konvertera enkelt citerade jokertecken och jämförelser till dubbla citattecken i mängdanalys. Se nedan. | På |
| `--fixUnquotedSetValues` / `--noFixUnquotedSetValues` | Experimentell. Omge strängvärden utan citattecken med enkla citattecken i mängdanalys. Se nedan. | Av |
| `--ui` | Starta användargränssnittet istället för att köra en konvertering | Av |
| `--port PORT` | Användargränssnittsport | Automatiskt |
| `--noBrowser` | Öppna inte webbläsaren automatiskt när du startar användargränssnittet | Av |
| `--version` | Visa version och avsluta | — |
| `--accept-eula` | Acceptera slutanvändarlicensavtalet utan en interaktiv uppmaning. Avsedd för CI/CD-pipelines och automatiserade arbetsflöden. | Av |

### 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](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm)
* [Loggning och diagnostik](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)
* [Layoutlägen](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)