Référence d'argument

Dernière mise à jour : 14/10/2026

Les tableaux ci-dessous répertorient tous les arguments disponibles regroupés par catégorie.

Entrée et sortie

Mode batch

Qlik Cloud

Authentification

Mise en page et style

Pour une explication détaillée des modes de canevas fixe et de grille dynamique, consultez Paramètres de disposition de conversion.

Rapport de conversion

Le rapport de console et le rapport Excel sont tous deux activés par défaut en mode CLI et dans l'interface utilisateur.

Console et journalisation

QV2QS prend en charge quatre modes de sortie console.

• Joli — Sortie richement formatée avec des couleurs, des indicateurs de progression animés, des barres de progression et des panneaux thématiques. Le mode joli est le mode par défaut pour l'utilisation interactive du terminal. Requiert un terminal compatible avec les couleurs (Windows 10+, PowerShell 5+, ou les shells de type Unix).
• Simple — Sortie de texte horodatée sans codes d'échappement ANSI. Chaque ligne est précédée d'un horodatage de temps écoulé et d'une balise de phase au format [MM:SS] [phase] message. Les en-têtes et les tableaux utilisent des caractères ASCII. Adapté aux pipelines CI/CD, aux fichiers journaux et aux terminaux qui ne prennent pas en charge le formatage ANSI.
• Silencieux — Supprime toutes les sorties standard. Seules les erreurs sont affichées. Convient pour le traitement par lots automatisé et les flux de travail scriptés où aucune sortie console n'est nécessaire.
• UI — Sortie orientée ligne sans horodatage ni codes ANSI. L'interface utilisateur définit ce mode automatiquement lors du lancement d'un sous-processus de conversion. Le format est optimisé pour la visionneuse du journal intégrée. L'exécution de --console ui depuis un terminal produit une sortie lisible mais non formatée ; utilisez --plain ou --console pretty à la place pour une utilisation directe dans le terminal.

Les --dark et --light indicateurs sélectionnent un thème de couleur. Le thème sombre (par défaut) utilise une palette bleu marine profond inspirée de Qlik. Le thème clair utilise une palette gris clair. L'indicateur --surface active un remplissage d'arrière-plan subtil derrière chaque ligne de sortie. Le remplissage de surface est activé par défaut en mode esthétique. Utiliser --noSurface pour désactiver le remplissage d'arrière-plan.

En mode projet unique, les fichiers journaux sont écrits dans %LOCALAPPDATA%\QV2QS\logs\ par défaut. En mode batch, les fichiers journaux sont écrits dans le sous-dossier logs/ du répertoire de sortie. Remplacer l'emplacement par --logDir. Configurer --logLevel DEBUG pour capturer une sortie de diagnostic détaillée afin de résoudre les problèmes de conversion. Utilisez --cleanLogs pour supprimer les fichiers journaux datant de plus de 30 jours avant chaque exécution. Pour une description complète des emplacements, de la rotation et du format des fichiers journaux, consultez Journalisation et diagnostics.

Charger script

Par défaut, QV2QS applique huit règles intégrées qui normalisent les chemins d'accès Windows avec des barres obliques inverses en barres obliques pour la compatibilité Qlik Cloud. Le tableau suivant répertorie chaque règle intégrée.

Chaque règle utilise un processus de correspondance en deux étapes. Le pattern champ est une expression régulière qui sélectionne une région du script de chargement. Le search champ est ensuite appliqué uniquement au sein de chaque région correspondante. Cette approche empêche les remplacements involontaires en dehors du contexte ciblé.

L'--scriptReplacements argument accepte un fichier JSON qui devient la source unique de vérité pour toutes les règles de remplacement. Lorsqu'un fichier est fourni, les paramètres par défaut intégrés ne se chargent pas automatiquement. Pour inclure les règles intégrées aux côtés des règles personnalisées, exporter l'ensemble complet de règles de l'assistant et modifier le fichier exporté. Les règles s'exécutent dans l'ordre execution_order.

Trois comportements CLI sont disponibles :

• Aucun drapeau — les huit règles intégrées s'exécutent.
• --scriptReplacements <file> — seules les règles du fichier s'exécutent. Les paramètres par défaut intégrés ne se chargent pas automatiquement.
• --noScriptReplacements — aucune règle ne s'exécute.

Le --scriptReplacements fichier est un tableau JSON d'objets de règles :

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

Chaque règle possède les champs suivants :

Autre

Garde de tri du champ de date

Par défaut, Qlik Sense trie les valeurs sélectionnées en haut d'une zone de liste. Pour les champs de type date tels que Trimestre, Mois ou Année, ce réordonnancement rompt la séquence chronologique attendue. QV2QS applique une heuristique pour détecter les noms de champs de type date et supprimer le tri basé sur l'état sur ces champs, en conservant les valeurs dans leur ordre naturel quel que soit l'état de sélection.

L'heuristique tokenise chaque nom de champ en le divisant par les caractères non alphanumériques et les limites camelCase (par exemple, OrderDate devient order et date). Tous les jetons sont en minuscules. Un champ correspond si l'un des jetons est égal à l'un des éléments suivants : date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Un champ correspond également si un jeton se termine par date, month, ou year (par exemple, OrderDate, FiscalMonth). Les jetons update, candidate et validate sont exclus pour éviter les faux positifs. La mise en correspondance est insensible à la casse et utilise uniquement des jetons anglais. Les noms de champs non-anglais (par exemple, Monat ou Fecha) ne sont pas détectés.

Les champs qui correspondent à l'heuristique voient le tri basé sur l'état supprimé et le tri automatique désactivé.

Utilisez --disableDateStateStickySort pour désactiver cette heuristique. Lorsqu'il est désactivé, tous les champs de zone de liste utilisent le comportement de tri par défaut de Qlik Sense, y compris le réordonnancement basé sur l'état.

Correctifs de guillemets pour l'analyse d'ensemble

QlikView et Qlik Sense interprètent différemment la mise entre guillemets dans les modificateurs d'analyse d'ensemble. QV2QS applique deux correctifs indépendants lors de la conversion. La correction de recherche entre guillemets simples est activée par défaut. Le correctif des valeurs d'ensemble non citées est expérimental et désactivé par défaut.

Correction des valeurs de recherche entre guillemets simples (--fixSingleQuotedSearch)

Les valeurs entre guillemets simples contenant une syntaxe de recherche sont converties en guillemets doubles. Les modèles de recherche détectés incluent les caractères génériques (*, ?, ^), les opérateurs de comparaison (>, >=, <, <=), la recherche partielle (~), la recherche d'expressions (=), les modificateurs de recherche (+, -), et la recherche composée ((…|…), (…&…)) :

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

Les littéraux de texte brut entre guillemets simples (par exemple, 'USA') et les valeurs entre guillemets simples sur les champs numériques ne sont pas affectés. Utilisez --noFixSingleQuotedSearch pour désactiver ce correctif.

Correction des valeurs d'ensemble non citées (--fixUnquotedSetValues) — expérimental

Les valeurs de chaîne brutes non citées sont entourées de guillemets simples :

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

Valeurs numériques (2024), variables avec signe dollar ($(vYear)), et les chaînes de caractères entre guillemets doubles restent inchangées. Ce correctif est désactivé par défaut. Transmettez --fixUnquotedSetValues pour l'activer. Utilisez --noFixUnquotedSetValues pour le désactiver explicitement.

Les deux correctifs s'appliquent uniquement aux expressions de dimension et de mesure. Les constatations de fonctions non prises en charge ne sont pas modifiées. Lorsqu'une correction est désactivée, les motifs signalés demeurent pour examen manuel dans la feuille de calcul Expression_Findings.

En savoir plus

• Flux de travail courants
• Journalisation et diagnostics
• Modes d'affichage