Comment fonctionne la conversion

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

La pipeline de conversion comprend les phases suivantes :

Extraction — Si --generatePrj est activé, QV2QS lance QlikView Desktop pour extraire le fichier QVW dans un dossier PRJ. QV2QS utilise le moteur portable fourni, sauf si une installation système de QlikView Desktop est détectée. Pour plus de détails, consultez Moteur QlikView Desktop.
Analyser — QV2QS lit le dossier PRJ et analyse chaque définition d'objet, disposition de feuille, script de chargement, variable et propriété de document. QV2QS lit également le binaire QVW/QVF directement pour extraire les métadonnées, les variables et tout script de chargement masqué intégré dans le fichier.
Convertir — Chaque objet QlikView est mappé à un type de visualisation Qlik Sense. Dimensions, mesures, expressions, style et positions de disposition sont traduites au format JSON de Qlik Sense.
Écriture — QV2QS écrit la structure de l'application convertie dans le dossier de sortie sous forme d'un ensemble de fichiers JSON.
Déployer (modes cloud uniquement) — QV2QS crée l'application sur le client, télécharge les médias, construit l'application et recharge éventuellement l'application avec des données.
Rapport — QV2QS génère un rapport de conversion résumant les résultats, la notation de l'automatisation et tout élément nécessitant un suivi manuel.

La phase de déploiement s'exécute en modes Création vers Qlik Cloud et Exportation QVF. En mode local uniquement, QV2QS écrit la sortie convertie sur le disque sans se connecter à Qlik Cloud. La phase de rapport s'exécute dans tous les modes.

Modes de conversion

QV2QS prend en charge trois modes de conversion. Sélectionnez le mode à l'étape Configuration de l'assistant ou avec l'indicateur CLI correspondant.

Mode :	Option CLI	Qlik Cloud requis	Sortie	Phase de déploiement
Créer pour Qlik Cloud	(par défaut)	Oui	Application déployée sur le client	Oui — crée l'application, importe les médias, construit, publie les feuilles
Exporter QVF	`--exportQvf`	Oui	Fichier QVF sur le disque	Oui — crée une application dans Qlik Cloud, l'exporte en tant que QVF, puis supprime l'application cloud
Local uniquement	`--unbuildOnly`	Non	Dossier de build et rapport de conversion sur le disque	Non

La création vers Qlik Cloud est le mode recommandé pour la migration. L'exportation QVF est utile pour produire un fichier portable à partager ou à importer dans un autre client. Le mode local uniquement est destiné à l'évaluation et à la révision. Pour plus de détails sur les limitations en mode local uniquement, voir la section ci-dessous.

L'interface utilisateur est par défaut en mode toile fixe, avec le rechargement activé et le binaire automatique activé. La CLI est configurée par défaut en mode grille dynamique, le rechargement désactivé et le binaire automatique désactivé. Lorsque vous passez de l'assistant à la CLI, spécifiez explicitement ces options pour correspondre au comportement de l'assistant. Pour la liste complète des arguments et des paramètres par défaut, voir Référence des arguments.

Mode local uniquement

Le mode local uniquement (--unbuildOnly) exécute les phases d'analyse, de conversion, d'écriture et de rapport sans se connecter à Qlik Cloud. Aucun client ou clé API n'est requis. QV2QS génère le rapport de conversion complet, le résumé exécutif et le dossier de sortie de la compilation sur le disque.

Cas d'utilisation

Évaluation de la migration — Exécutez le mode Local uniquement pour générer le rapport de conversion, le résumé exécutif, le score d'automatisation et les résultats d'expression sans nécessiter d'accès à Qlik Cloud. Évaluer la qualité de la conversion sur l'ensemble d'un parc QVW avant de configurer les identifiants du client.
Révision avant déploiement — Inspectez la sortie générée (script de chargement, définitions d'objets, variables, dimensions) avant de valider un déploiement cloud. Les organisations dotées de processus de contrôle des changements peuvent examiner le résultat en tant qu'artefact intermédiaire.
Environnements hors ligne ou restreints — Lorsque la machine hébergeant les fichiers QVW n'a pas d'accès Internet sortant, exécutez le mode Local uniquement pour générer le rapport de conversion localement. Pour déployer l'application convertie, copiez les fichiers QVW vers une machine avec accès à Qlik Cloud et exécutez QV2QS en mode Générer vers Qlik Cloud depuis la machine connectée.

Limitations

La phase de déploiement gère plusieurs opérations que qlik app build seule n'effectue pas. L'exécution du mode Local uniquement et le déploiement du build/ dossier manuellement avec une installation qlik-cli autonome entraîne les lacunes suivantes.

Les fichiers multimédias ne sont pas téléchargés. Les images d'arrière-plan et les images de bouton sont extraites dans le images/ dossier mais ne sont pas incluses dans le build/ dossier. La qlik app build commande ne traite pas les fichiers multimédias. Toutes les images d'arrière-plan et les images de bouton seront manquantes de l'application déployée.
Les références d'arrière-plan de feuille et d'objet ne sont pas résolues. QV2QS injecte des URL d'images d'arrière-plan dans les fichiers JSON de la feuille et des objets pendant la phase de déploiement en utilisant l'ID de l'application cloud. La sortie de la compilation locale ne contient pas de références d'images de fond. Les feuilles et les objets n'auront pas d'arrière-plans dans l'application déployée.
Les URL d'images de bouton contiennent des chaînes de caractères de remplacement. Les images des boutons dans la sortie de la compilation locale utilisent des valeurs d'espace réservé internes au lieu des URL de médias résolues. Le moteur Qlik Sense ne peut pas interpréter les chaînes d'espace réservé. Les images des boutons apparaîtront cassées.
Les états alternatifs ne sont pas créés. Les noms d'état alternatifs sont écrits dans cloud/alternate_states.json en dehors du build/ dossier. La qlik app build commande ne traite pas les états alternatifs. Les objets faisant référence à des états non par défaut risquent de ne pas s'afficher correctement.
Les feuilles ne sont pas publiées. La qlik app build commande crée des feuilles en tant qu'objets personnels visibles uniquement par le propriétaire de l'application. QV2QS publie des feuilles en tant que feuilles de base pendant la phase de déploiement. Dans un espace partagé, les autres utilisateurs ne verront aucune feuille tant que les feuilles ne sont pas publiées manuellement.

Pour un déploiement complet incluant le téléchargement de médias, la résolution d'arrière-plan, la création d'états alternatifs et la publication de feuilles, utilisez le mode Build to Qlik Cloud ou le mode Export QVF au lieu du mode Local only.

Sécurité des fichiers source

QV2QS ne modifie pas le contenu du fichier QVW ou QVF source. Pendant la phase d'extraction, QV2QS ouvre le document source via QlikView Desktop et enregistre une copie temporaire dans un dossier temporaire système. QV2QS ferme alors l'original et génère le dossier PRJ à partir de la copie temporaire. Une fois la génération PRJ terminée, QV2QS copie le dossier -prj résultant dans le même répertoire que le fichier source et supprime la copie temporaire. Si un -prj dossier existe déjà à côté du fichier source, QV2QS remplace le dossier par la version nouvellement générée. Toutes les autres sorties de conversion sont écrites dans le répertoire de sortie séparé spécifié par --outputDir.

QlikView Desktop acquiert un verrou de fichier sur le document source pendant que la copie temporaire est en cours de création. L'exécution de QV2QS sur un fichier qui est activement ouvert dans QlikView Desktop ou servi par QlikView Server peut entraîner des conflits de verrouillage de fichier ou un échec de la génération de PRJ. Les fichiers sur les lecteurs réseau partagés peuvent provoquer les mêmes conflits. L'écriture du dossier -prj vers un partage réseau ou un répertoire en lecture seule peut également échouer.

Pour éviter tout risque pour les environnements de production, travaillez toujours avec des copies des documents source. Vous pouvez :

Copiez les fichiers QVW ou QVF dans un dossier de travail local sur la machine où QV2QS s'exécute.
Pointez QV2QS vers les fichiers copiés, pas les originaux.
Fermez toutes les instances de QlikView Desktop en cours d'exécution avant de démarrer la conversion. QV2QS nécessite un accès exclusif à QlikView Desktop.

N'exécutez pas QV2QS directement sur les dossiers de documents QlikView Server, les partages réseau de production ou les fichiers ouverts dans QlikView Desktop. Utilisez toujours une copie locale des documents source.

Délai typique

QV2QS est conçu pour la vitesse. La pipeline complète se termine en quelques minutes, et non en heures. Le tableau suivant présente les durées typiques pour une conversion d'une seule application.

Phase	Durée typique	Remarques
Extraction (génération de PRJ)	5–15 secondes	Dépend de la complexité du QVW. Ignoré si un dossier PRJ existe déjà.
Analyser + Convertir + Écrire	En moins de 30 secondes	La conversion XML-vers-JSON principale. Gère des applications complexes avec des centaines d'objets.
Déployer (compilation cloud)	1 à 3 minutes	Comprend la création d'application, le téléchargement de médias et la compilation d'application sur le client.
Recharger	Varie	Dépend du volume de données, de la latence de la source de données et des ressources du client. Un chargement du binaire d'un QVW typique s'achève en moins d'une minute.

Une conversion d'application unique avec un déploiement cloud et un rechargement des données s'achève généralement en deux à cinq minutes de bout en bout. Conversions locales uniquement (--unbuildOnly) se terminent en moins de 30 secondes.

En mode batch, QV2QS convertit plusieurs projets en parallèle. Le temps total de traitement par lots évolue en fonction du nombre de projets divisé par le nombre de travailleurs. Pour un lot de 20 applications avec quatre travailleurs, prévoyez environ cinq fois la durée d'une seule application pour la phase de conversion locale, plus le temps de déploiement dans le cloud.

Structure du dossier de sortie

L'--outputDir argument spécifie la racine de sortie. QV2QS crée un sous-dossier nommé d'après le fichier QVW (ou dossier PRJ) dans la racine de sortie. Toutes les sorties de conversion pour le projet sont écrites dans ce sous-dossier. Si deux fichiers QVW partagent le même nom, QV2QS ajoute _2, _3, et des numéros consécutifs pour éviter les collisions. Ce comportement correspond au mode de traitement par lots, où chaque projet reçoit également un sous-dossier dédié.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS crée le dossier de sortie si le dossier n'existe pas déjà. Si le dossier existe d'une exécution précédente du même QVW, QV2QS réutilise le dossier. Les fichiers journaux existants dans le dossier sont conservés, sauf si Nettoyer les journaux est activé. Le répertoire de sortie ne doit pas être identique à, ni être un parent de, tout répertoire source. QV2QS valide le chemin de sortie avant de démarrer la conversion et signale une erreur si les chemins se chevauchent. Le sous-dossier du projet contient les éléments suivants :

Dossier / fichier	Sommaire
`build/`	Structure de l'application Qlik Sense pour `qlik app build`. Contient `config.yml` (manifeste de construction), `script.qvs` (script de chargement), `app-properties.json`, `connections.yml` (connexions de données), `dimensions.json` (dimensions principales), `measures.json` (mesures principales), `variables.json`, et un sous-dossier `objects/` avec un fichier JSON par feuille et visualisation.
`images/`	Fichiers multimédias extraits (dédupliqués par hachage de contenu) et `backgrounds.json` (manifeste d'arrière-plan).
`reports/`	`executive_summary.json`, `executive_summary.html`, et le rapport de conversion Excel (`_conversion_report_.xlsx`) si activé.
`logs/`	Fichiers journaux structurés par exécution.
`cloud/`	`cloud_state.json` (ID d'application, hachage média, mappage d'ID de feuille, horodatage) et `alternate_states.json`. Créé lors du cloud déploiement.
`qvf/`	Fichiers QVF exportés (créés lorsque `--exportQvf` est utilisé).
`.qv2qs_source`	Fichier marqueur qui enregistre quel QVW a produit le sous-dossier. QV2QS utilise le marqueur pour détecter les collisions de noms et pour réutiliser le bon dossier lors des exécutions ultérieures.

Ouvrir le dossier de sortie directement depuis l'assistant après la fin d'une conversion.

Après conversion

Une fois la conversion terminée, parcourez les éléments suivants regroupés par priorité.

Corriger avant publication

Ouvrez le rapport de conversion Excel dans le sous-dossier reports/ et examinez la feuille de calcul Follow-up_Objects. Corrigez tous les éléments marqués Erreur en premier (objets qui n'ont pas pu être convertis), puis Espace réservé (objets qui nécessitent une reconstruction), puis Ajustements requis (objets qui ont été partiellement convertis).
Passez en revue les résultats de l'analyse sur la feuille de calcul Analyse, y compris les références de macro, l'utilisation de l'Accès de section et les modèles de script de chargement qui pourraient nécessiter une attention manuelle.
Vérifier que les expressions s'évaluent correctement. QV2QS corrige automatiquement les problèmes de guillemets de l'analyse d'ensemble lors de la conversion. Examiner les dimensions calculées, la coloration conditionnelle et les expressions utilisant des fonctions spécifiques à QlikView (GetCurrentField(), MsgBox()) qui nécessitent une réécriture manuelle.
Vérifiez la Overflow_Actions feuille de calcul pour les objets où des dimensions ou mesures excédentaires ont été déplacées vers la collection d'alternatives.

Vérifier avant de publier

Ouvrez l'application convertie dans Qlik Sense et vérifiez que les mises en page des feuilles, les positions des objets et les images d'arrière-plan apparaissent comme prévu.
Confirmez que la navigation des conteneurs à onglets (bandes de boutons ou conteneurs à onglets) bascule correctement entre les zones de contenu.
Tester l'exploration et le comportement de cyclage du groupe cyclique sur les graphiques qui utilisent des groupes de dimensions.
Vérifiez que les conditions d'affichage masquent et révèlent les objets comme prévu.
Vérifiez les ordres de tri sur les listes déroulantes et les tableaux, en particulier pour les champs de type date.

Polonais

Ajustez les polices, les couleurs ou le positionnement des objets dans l'éditeur d'application Qlik Sense selon les besoins. Pour obtenir des conseils sur le positionnement de la disposition, consultez Paramètres de disposition de conversion.

Pour une description complète du contenu du rapport, voir Rapport de conversion.

En savoir plus

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici