Étapes de l'assistant
Dernière mise à jour : 14/10/2026L'interface utilisateur est une interface de type assistant pour l'ensemble du processus de conversion. L'assistant s'ouvre dans le navigateur par défaut après avoir double-cliqué sur QV2QS.exe ou en exécutant l'exécutable avec l'--ui option. Le numéro de version actuel est affiché dans la boîte de dialogue À propos. Un bouton de basculement de thème dans le coin supérieur droit permet de basculer entre le mode clair et le mode sombre. Pour plus d'informations, consultez Mode sombre.
L'assistant présente les étapes suivantes dans l'ordre. Les étapes qui ne s'appliquent pas au mode de flux de travail sélectionné sont masquées automatiquement.
Configuration
Sélectionner un mode de flux de travail (obligatoire). Le mode sélectionné détermine les étapes suivantes disponibles.
- Créer pour Qlik Cloud (par défaut) — convertit l'interface utilisateur de QlikView et déploie l'application résultante directement vers le client Qlik Cloud. Choisissez ce mode pour voir l'application convertie dans Qlik Cloud immédiatement. Ce mode est le flux de travail recommandé pour la migration.
- Exporter le QVF — convertit l'interface utilisateur QlikView à l'aide du moteur Qlik Cloud, exporte l'application résultante en tant que fichier QVF, puis supprime l'application cloud. Choisissez ce mode pour produire un fichier à partager avec une autre équipe ou à importer dans un autre client. Ce mode nécessite toujours un client Qlik Cloud et une clé API. L'importation dans Qlik Sense Enterprise Client-Managed n'est pas testée sur toutes les versions ni officiellement prise en charge. Pour plus de détails, consultez la compatibilité de Qlik Sense Enterprise Client-Managed.
- Local uniquement — effectue la conversion sur le disque sans se connecter à Qlik Cloud. Aucun client Qlik Cloud ou clé API n'est requis. Le mode local uniquement génère le rapport de conversion complet et la sortie de build pour évaluation, révision ou utilisation hors ligne. La sortie de la compilation locale n'inclut pas les téléchargements de médias, la résolution d'images d'arrière-plan, la création d'états alternatifs ou la publication de feuilles — ces opérations nécessitent la phase de déploiement. Pour un déploiement complet, utilisez Build vers Qlik Cloud ou le mode Exporter QVF. Pour plus de détails sur les limitations en mode local uniquement, consultez Comment fonctionne la conversion. Cibler QSECM avec la sortie de la compilation n'est pas testé sur toutes les versions ni officiellement pris en charge. Pour plus de détails, consultez la compatibilité de Qlik Sense Enterprise Client-Managed.
Projet
Configurer la source d'entrée. Procédez de l'une des manières suivantes :
- Projet unique (par défaut) : fournissez un fichier QVW (obligatoire). La génération automatique de PRJ est activée par défaut et génère automatiquement le dossier PRJ à partir du fichier QVW. Désactiver cette option pour fournir un dossier PRJ ou un ZIP manuellement. Cliquez sur Essayer l'exemple pour charger un projet d'exemple intégré sans naviguer. Le bouton est visible uniquement lorsque le champ QVW est vide. Voir Exemples de projets.
- Lot : fournissez un ou plusieurs dossiers à analyser (obligatoire). QV2QS découvre toutes les paires QVW et PRJ correspondantes récursivement. Cliquez sur Essayer l'exemple pour remplir le champ du dossier avec le dossier d'exemples fourni. Processus par lots contrôle le nombre de conversions exécutées en parallèle (par défaut : détection automatique basée sur les cœurs de CPU). Pour plus d'informations, voir Conversion par lots.
Toujours faire pointer QV2QS vers des copies de documents source dans un dossier de travail local, et non vers les fichiers de production sur QlikView Server ou des lecteurs réseau partagés. Le moteur QlikView Desktop acquiert un verrou de fichier pendant la génération PRJ, ce qui peut entrer en conflit avec des sessions QlikView actives. Pour plus de détails, voir Sécurité des fichiers source.
Sortie
Définissez le dossier racine de sortie (obligatoire). QV2QS crée automatiquement un sous-dossier portant le nom du projet dans la racine de sortie (par exemple, <outputDir>/Sales/). Si deux projets partagent le même nom, un _2, _3 suffixe est ajouté pour éviter les collisions. Activer Nettoyer les journaux pour supprimer les fichiers journaux existants avant l'exécution.
Authentification Qlik Cloud
Cette étape apparaît uniquement dans les modes Build to Qlik Cloud et Export QVF.
Sélectionnez ou créez un contexte qlik-cli pour l'authentification auprès du client Qlik Cloud (obligatoire). Créer un nouveau contexte en fournissant l'URL du client et la clé API. L'assistant valide la connexion avant de continuer.
application Qlik Cloud
Cette étape apparaît uniquement dans les modes Build to Qlik Cloud et Export QVF.
| Paramètre | Description | Par défaut |
|---|---|---|
| Nom de l'application | Nom de l'application Qlik Sense dans Qlik Cloud | Nom de fichier QVW, Nom de dossier PRJ, ou Nom du dossier de sortie |
| Charger | Recharger l'application après la construction pour exécuter le script de chargement | Sur |
| Auto-binaire | Téléchargez temporairement le fichier QVW pour le chargement des données binaires, puis supprimez le fichier après le rechargement. Nécessite Charger. | Sur |
| AppId binaire | Utilisez une application QVW ou QVF existante dans Qlik Cloud pour le chargement du binaire au lieu de télécharger. Nécessite Rechargement. Cliquez sur le bouton Parcourir pour ouvrir le sélecteur QVW. | — |
| Réutiliser l'application existante | Mettre à jour une application précédemment créée au lieu d'en créer une nouvelle. Lorsqu'il est activé, QV2QS vérifie le dossier de sortie pour un précédent déploiement correspondant au fichier QVW sélectionné et renseigne automatiquement l'ID de l'application. Si aucun déploiement précédent n'est trouvé, saisissez l'ID de l'application manuellement ou cliquez sur le bouton Parcourir pour ouvrir le sélecteur QVF. | Désactivé |
| Préserver le script de chargement | Conserver le script de chargement existant dans l'application cible. Le script converti n'est pas appliqué. Nécessite Réutiliser l'application existante. Désactive Recharger par défaut ; réactivez-le pour exécuter le script existant. | Désactivé |
| Préserver les variables | Conserver les variables existantes dans l'application cible. Les variables converties ne sont pas appliquées. Nécessite Réutiliser l'application existante. | Désactivé |
| Ignorer la sauvegarde avant le déploiement | N'exportez pas de sauvegarde QVF avant d'écraser l'application. Par défaut, une sauvegarde sans données est enregistrée dans cloud/backups/. Nécessite Réutiliser l'application existante. |
Désactivé |
| Publier des feuilles | Publier toutes les feuilles converties en feuilles de base après la construction. Les feuilles de base sont visibles à tous les utilisateurs qui ont accès à l'application. Désactiver ce paramètre pour conserver les feuilles comme des objets personnels (non publiés). Lorsque Réutiliser l'application existante est activé, le paramètre s'applique uniquement aux nouvelles feuilles. Les feuilles précédemment publiées sont restaurées automatiquement indépendamment de ce paramètre. | Sur |
| Construire sans données | Ignorer le chargement des données pendant la phase de construction. L'application est assemblée sur le client sans données, permettant de tester la structure de l'interface utilisateur sans attendre un rechargement. | Désactivé |
| Exporter sans les données | Supprimer les données du fichier QVF exporté. L'application cloud peut encore contenir des données de la build, mais le QVF téléchargé est plus petit. Exportation en mode QVF uniquement. | Désactivé |
Les champs ID d'application binaire et Réutiliser l'application existante comprennent des boutons Parcourir qui ouvrent des modales de sélection d'application cloud. Chaque sélecteur charge les applications depuis le client connecté avec un filtrage de recherche par nom, propriétaire, espace ou ID d'application. Le sélecteur QVW fournit également un filtre de type d'application (QVW, QVF ou tous). Sélectionnez une application dans la liste pour remplir automatiquement le champ.
Ajustements d'expression
| Paramètre | Description | Par défaut |
|---|---|---|
| Corriger les valeurs de recherche entre guillemets simples | Convertir les caractères génériques et les comparaisons entre guillemets simples en guillemets doubles dans les expressions d'analyse d'ensemble. Pour plus d'informations, consultez Référence d'argument. | Sur |
| Correction des valeurs définies non citées (expérimental) | Enveloppez les valeurs de chaîne brutes non citées entre guillemets simples dans les expressions d'analyse d'ensemble. Pour plus d'informations, consultez Référence d'argument. | Désactivé |
Styles
Les paramètres suivants contrôlent l'apparence de la feuille et le comportement de la disposition.
Thème
| Paramètre | Description | Par défaut |
|---|---|---|
| Thème de l'application | Thème Qlik Sense appliqué à l'application convertie. La liste déroulante répertorie les quatre thèmes Qlik intégrés. Lorsqu'un contexte Qlik Cloud est configuré, cliquez sur le bouton d'actualisation pour récupérer les thèmes personnalisés installés sur le client. Sense Classic produit la plus haute fidélité 1:1 avec QlikView. Les thèmes non classiques peuvent modifier les bordures d'objets, les couleurs d'arrière-plan, les polices et le remplissage. Le thème définit uniquement les valeurs par défaut ; les utilisateurs peuvent changer de thème à tout moment dans le client Qlik Sense. | Sense Classique |
Arrière-plans
| Paramètre | Description | Par défaut |
|---|---|---|
| Images d'arrière-plan de feuille | Extraire et appliquer les fonds d'écran des feuilles QlikView | Sur |
| Revenir à l'arrière-plan du document | Utilisez l'arrière-plan au niveau du document pour les feuilles qui n'en ont pas | Sur |
| Substitution de la couleur d'arrière-plan | Remplissage de couleur unie appliqué à toutes les feuilles (#RRGGBB) |
— |
Disposition
| Paramètre | Description | Par défaut |
|---|---|---|
| Afficher l'en-tête de feuille | Ajouter une région d'en-tête aux feuilles converties | Désactivé |
| Ignorer les feuilles masquées | Omettre les feuilles avec des conditions d'affichage constamment fausses | Désactivé |
Zones de liste et tri
| Paramètre | Description | Par défaut |
|---|---|---|
| Conserver les couleurs des zones de liste QV | Appliquer les couleurs d'arrière-plan et la transparence d'origine des zones de liste QlikView | Sur |
| Protection de tri de champ de date | Conserver les champs de zone de liste de type date (Année, Trimestre, Mois et similaires) triés chronologiquement au lieu de par état de sélection. Pour plus d'informations, consultez Référence d'argument. | Sur |
Avancé
| Paramètre | Description | Par défaut |
|---|---|---|
| Canevas de feuille fixe | Activer le positionnement de style QlikView précis au pixel près. Affiche les facteurs d'échelle, les dimensions minimales et les options de recadrage de la zone de travail. L'échelle du canevas et l'échelle de l'objet sont liées par défaut ; cliquez sur l'icône de la chaîne pour définir des valeurs indépendantes. Pour plus d'informations, voir Paramètres de la disposition de conversion. | Sur |
| Extension automatique de la feuille dynamique | Autoriser les feuilles à s'étendre verticalement au-delà de la hauteur de grille par défaut | Sur |
| Travailleurs de téléversement de médias | Nombre de processus parallèles pour le téléversement de fichiers multimédias (fonds d'écran et images) vers Qlik Cloud. S'applique aux modes de création pour Qlik Cloud et d'exportation QVF. | 2
|
| Remplacements de Script | Basculer le traitement de remplacement de script activé ou désactivé et gérer les règles individuelles. Pour plus d'informations, consultez Référence d'argument. | Sur |
La Remplacements de Script section comprend un éditeur de règles inline. Basculez l'interrupteur principal pour activer ou désactiver tout traitement de script. Développer la section pour afficher, ajouter, modifier ou supprimer des règles individuelles. Chaque règle peut être activée ou désactivée indépendamment. Cliquez sur Réinitialiser les valeurs par défaut pour restaurer les huit règles intégrées. Un badge récapitulatif affiche le nombre de règles activées.
Cliquez sur les boutons flèche haut et bas d'une règle pour modifier l'ordre d'exécution. Les règles avec un ordre d'exécution inférieur s'exécutent en premier. Cliquez sur Export pour télécharger toutes les règles sous forme de fichier JSON. Cliquez sur Importer pour charger des règles à partir d'un fichier JSON, remplaçant l'ensemble actuel. Les fichiers importés doivent contenir un tableau JSON où chaque règle a un description, un pattern et un search champ.
Pour créer un fichier de règles personnalisé à importer, cliquez sur Exporter d'abord pour obtenir les règles intégrées au format correct. Modifiez le fichier exporté pour ajouter, supprimer ou modifier des règles, puis cliquez sur Importer pour charger l'ensemble mis à jour.
Lorsque des règles personnalisées ou des valeurs par défaut désactivées sont configurées, l'aperçu de la commande affiche un avertissement. La commande copiée n'inclut pas de règles personnalisées. Exporter les règles vers un fichier JSON et ajouter --scriptReplacements <path> à la commande pour inclure des règles personnalisées sur la ligne de commande.
Pour une explication du fonctionnement des règles, y compris le processus de correspondance en deux étapes et la liste de règles intégrée, consultez Référence des arguments.
Ouvrir Mockup Studio depuis l'étape Avancé pour prévisualiser de manière interactive les mises en page de canevas fixe et de grille dynamique, ajuster la mise à l'échelle et réappliquer les paramètres à l'assistant.
Rapport de conversion
Les paramètres suivants contrôlent la sortie du rapport de conversion.
| Paramètre | Description | Par défaut |
|---|---|---|
| Générer un rapport | Produire un rapport de conversion de console | Sur |
| Rapport Excel | Exporter le rapport au format XLSX avec des détails par objet et la notation de l'automatisation. Saisissez un nom de fichier (par ex. MyReport) ou un chemin complet. L'.xlsx extension est ajoutée automatiquement. Laisser vide pour nommer automatiquement dans reports/. |
Sur |
| Inclure les sélections et les objets de recherche | Inclure la boîte de sélections actuelles et l'objet de recherche dans le rapport. Ceux-ci sont ajoutés automatiquement par Qlik Sense et exclus par défaut. | Désactivé |
Révision
Confirmez tous les paramètres avant l'exécution. L'étape de révision affiche des cartes récapitulatives pour la configuration du projet, du workflow, du cloud et de la sortie. En mode batch, un tableau répertorie tous les projets découverts.
Une liste de contrôle des actions requises dans la barre latérale suit les éléments qui doivent être configurés avant l'exécution. Les éléments sont regroupés par catégorie : flux de travail, entrées, sortie et authentification cloud. Chaque élément affiche OK lorsqu'il est configuré ou À DÉFINIR lorsqu'une valeur est manquante. Cliquez sur un élément pour naviguer directement vers l'étape pertinente de l'assistant.
Un panneau d'aperçu de la commande affiche la commande CLI équivalente pour la configuration actuelle de l'assistant. Basculer entre la syntaxe PowerShell et Bash. Cliquez sur Copier pour copier la commande dans le Presse-papiers. L'aperçu de la commande est utile pour apprendre les arguments de la CLI ou pour enregistrer la commande exacte pour des réexécutions scriptées.
Cliquez Exécuter pour démarrer la conversion.
Exécuter
Affiche la sortie console en direct pendant l'exécution de la conversion. Arrêter une conversion en cours, suivre les journaux en temps réel, et ouvrir le dossier de sortie ou l'application Qlik Cloud lorsque l'exécution est terminée.