Riferimento argomento

Ultimo aggiornamento: 14/10/2026

Le tabelle seguenti elencano ogni argomento disponibile raggruppato per categoria.

Input e output

Modalità batch

Qlik Cloud

Autenticazione

Layout e stile

Per una spiegazione dettagliata delle modalità tela fissa e griglia dinamica, fare riferimento a Impostazioni del layout di conversione.

Rapporto di conversione

Il report della console e il report Excel sono entrambi abilitati per impostazione predefinita in modalità CLI e nell'interfaccia utente.

Console e registrazione

QV2QS supporta quattro modalità di output della console.

• Bello — Output con formattazione avanzata, con colori, spinner animati, barre di avanzamento e pannelli a tema. La modalità Pretty è l'impostazione predefinita per l'uso interattivo del terminale. Richiede un terminale a colori (Windows 10+, PowerShell 5+, o shell simili a Unix).
• Semplice — Output di testo con timestamp senza codici di escape ANSI. Ogni riga è preceduta da un timestamp del tempo trascorso e da un tag di fase nel formato [MM:SS] [phase] message. Intestazioni e tabelle utilizzano caratteri ASCII. Adatto per pipeline CI/CD, file di log e terminali che non supportano la formattazione ANSI.
• Silenzioso — Sopprime tutto l'output standard. Vengono visualizzati solo gli errori. Adatto per l'elaborazione batch automatizzata e flussi di lavoro scriptati dove non è richiesto alcun output della console.
• UI — Output orientato alle righe senza timestamp o codici ANSI. L'interfaccia utente imposta automaticamente questa modalità all'avvio di un sottoprocesso di conversione. Il formato è ottimizzato per il visualizzatore registro integrato. L'esecuzione di --console ui da un terminale produce un output leggibile ma non formattato; utilizzare --plain o --console pretty invece per l'utilizzo diretto da terminale.

Le --dark e --light bandiere selezionano un tema di colore. Il tema scuro (predefinito) utilizza una tavolozza blu notte profonda ispirata a Qlik. Il tema chiaro utilizza una tavolozza grigio chiaro. Il --surface flag abilita un sottile riempimento dello sfondo dietro ogni riga di output. Il riempimento superficie è abilitato per impostazione predefinita in modalità pretty. Usa --noSurface per disabilitare il riempimento dello sfondo.

In modalità progetto singolo, i file di log vengono scritti su %LOCALAPPDATA%\QV2QS\logs\ per impostazione predefinita. In modalità batch, i file di log vengono scritti nella logs/ sottocartella nella directory di output. Sovrascrivi la posizione con --logDir. Imposta --logLevel DEBUG per acquisire un output diagnostico dettagliato per la risoluzione dei problemi di conversione. Usa --cleanLogs per eliminare i file di log più vecchi di 30 giorni prima di ogni esecuzione. Per una descrizione completa delle posizioni dei file di log, della rotazione e del formato, consultare Registrazione e diagnostica.

Carica script

Per impostazione predefinita, QV2QS applica otto regole predefinite che normalizzano i percorsi con backslash di Windows in barre oblique per la compatibilità con Qlik Cloud. La seguente tabella elenca ciascuna regola predefinita.

Ogni regola utilizza un processo di corrispondenza a due fasi. Il pattern campo è una regex che seleziona una regione dello script di caricamento. Il campo search viene quindi applicato solo all'interno di ogni regione corrispondente. Questo approccio impedisce sostituzioni indesiderate al di fuori del contesto mirato.

L'--scriptReplacements argomento accetta un file JSON che diventa l'unica fonte di verità per tutte le regole di sostituzione. Quando viene fornito un file, le impostazioni predefinite integrate non vengono caricate automaticamente. Per includere regole predefinite insieme a regole personalizzate, esportare il set completo di regole dalla procedura guidata e modificare il file esportato. Le regole vengono eseguite in execution_order ordine.

Tre comportamenti CLI sono disponibili:

• Nessun flag — le otto regole integrate vengono eseguite.
• --scriptReplacements <file> — vengono eseguite solo le regole presenti nel file. Le impostazioni predefinite integrate non si caricano automaticamente.
• --noScriptReplacements — nessuna regola viene eseguita.

Il --scriptReplacements file è un array JSON di oggetti regola:

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

Ogni regola ha i seguenti campi:

Altro

Protezione ordinamento campo data

Per impostazione predefinita, Qlik Sense ordina i valori selezionati in cima a una casella di riepilogo. Per i campi di tipo data, come Trimestre, Mese o Anno, questo riordino interrompe la sequenza cronologica prevista. QV2QS applica un'euristica per rilevare nomi di campi simili a date e sopprimere l'ordinamento basato sullo stato su tali campi, mantenendo i valori nel loro ordine naturale indipendentemente dagli stati di selezione.

L'euristica tokenizza ogni nome di campo dividendo in base a caratteri non alfanumerici e ai confini camelCase (ad esempio, OrderDate diventa order e date). Tutti i token sono minuscoli. Un campo corrisponde se qualsiasi token è uguale a uno dei seguenti: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Un campo corrisponde anche se qualsiasi token termina con date, month o year (ad esempio, OrderDate, FiscalMonth). I token update, candidate, e validate sono esclusi per evitare falsi positivi. La corrispondenza non fa distinzione tra maiuscole e minuscole e utilizza solo token inglesi. Nomi di campo non inglesi (ad esempio, Monat o Fecha) non vengono rilevati.

I campi che corrispondono all'euristica hanno l'ordinamento basato sullo stato rimosso e l'ordinamento automatico disabilitato.

Usa --disableDateStateStickySort per disattivare questa euristica. Quando disabilitato, tutti i campi delle caselle di riepilogo utilizzano il comportamento di ordinamento predefinito di Qlik Sense, inclusa la riorganizzazione basata sullo stato.

Correzioni alla virgolettatura dell'analisi set

QlikView e Qlik Sense interpretano la citazione nei modificatori di analisi set in modo diverso. QV2QS applica due correzioni indipendenti durante la conversione. La correzione della ricerca con virgolette singole è abilitata per impostazione predefinita. La correzione dei valori non quotati è sperimentale e disabilitata per impostazione predefinita.

Correggi i valori di ricerca tra virgolette singole (--fixSingleQuotedSearch)

I valori tra virgolette singole che contengono sintassi di ricerca vengono convertiti in virgolette doppie. I modelli di ricerca rilevati includono caratteri jolly (*, ?, ^), operatori di confronto (>, >=, <, <=), ricerca fuzzy (~), ricerca per espressione (=), modificatori di ricerca (+, -) e ricerca composta ((…|…), (…&…)):

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

Valori letterali di testo semplice tra virgolette singole (ad esempio, 'USA') e valori tra virgolette singole su campi numerici non sono interessati. Utilizza --noFixSingleQuotedSearch per disabilitare questa correzione.

Correzione valori impostati non tra virgolette (--fixUnquotedSetValues) — sperimentale

Valori stringa semplici non quotati sono racchiusi tra apici singoli:

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

Valori numerici (2024), variabili con il simbolo del dollaro ($(vYear)) e stringhe tra virgolette doppie rimangono invariati. Per impostazione predefinita, questa correzione è disabilitata. Passa --fixUnquotedSetValues per abilitarlo. Utilizzare --noFixUnquotedSetValues per disabilitarlo esplicitamente.

Entrambe le correzioni si applicano soltanto alle espressioni di dimensione e di misura. I risultati delle funzioni non supportate non vengono modificati. Quando una correzione è disabilitata, i modelli segnalati rimangono per la revisione manuale nel foglio di lavoro Expression_Findings.

Scopri di più

• Flussi di lavoro comuni
• Registrazione e diagnostica
• Modalità di layout