Flux de travail courants
Dernière mise à jour : 14/10/2026Les exemples suivants couvrent les cas d'utilisation les plus fréquents. Chacun s'appuie sur le même modèle de base : spécifiez un fichier QVW, un dossier de sortie et un contexte Qlik Cloud. Dans tous les exemples, --outputDir est la racine de sortie. QV2QS crée automatiquement un sous-dossier nommé d'après le fichier QVW (par exemple, ./output/Sales/). Tous ces flux de travail peuvent également être effectués via l'assistant web. Pour l'approche guidée, voir les étapes de l'assistant.
Déployer sur Qlik Cloud avec les données
Le flux de travail de migration standard. QV2QS génère le dossier PRJ, convertit l'interface utilisateur, télécharge le QVW pour le chargement de données binaires, recharge l'application dans Qlik Cloud, et produit un rapport Excel. Le QVW téléchargé est supprimé et le script de chargement original est restauré après rechargement.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Exporter un fichier QVF
QV2QS construit l'application en utilisant le moteur Qlik Cloud, exporte le résultat sous forme de fichier QVF, puis supprime l'application cloud. Le QVF exporté peut être importé dans un autre client Qlik Cloud.
L'importation de fichiers QVF générés par QV2QS dans Qlik Sense Enterprise Client-Managed n'est pas testée sur toutes les versions, ni officiellement prise en charge, et est déconseillée. Pour plus de détails, voir Compatibilité de Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Migrer par lot l'ensemble d'un patrimoine QlikView
Scanner un ou plusieurs dossiers pour toutes les paires QVW et PRJ, convertir les paires en parallèle, et déployer chacune vers Qlik Cloud. Utilisez --batchWorkers pour contrôler la concurrence.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Préserver la disposition des pixels de QlikView
Activer le mode canevas fixe pour conserver les positions exactes des objets QlikView et les fonds d'écran de feuille. Ajustez les facteurs d'échelle pour contrôler comment la disposition se mappe aux dimensions de l'écran de Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Mettre à jour une application précédemment convertie
Relancer la conversion sur une application Qlik Cloud existante sans en créer une nouvelle. QV2QS réutilise l'ID de l'application de l'exécution précédente.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Mettre à jour une application tout en conservant son script de chargement
Relancer la conversion pour mettre à jour la couche d'interface utilisateur d'une application existante sans écraser le script de chargement. L'application cible conserve ses connexions de données existantes et sa logique de rechargement. Une sauvegarde sans données est exportée automatiquement avant la mise à jour. Ajouter --reload pour exécuter le script existant et actualiser les données.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Mettre à jour une application tout en préservant ses variables
Relancer la conversion pour mettre à jour la couche d'interface utilisateur et le script de chargement d'une application existante sans écraser les variables. Combiner avec --preserveTargetAppScript pour conserver à la fois le script de chargement et les variables de l'application cible intacts.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Configurer l'authentification Qlik Cloud
Configurez un contexte qlik-cli avant d'exécuter toute conversion. La configuration interactive invite à saisir une URL du client et une clé API et stocke les identifiants pour les exécutions ultérieures.
QV2QS.exe --setupQlikAuth
Utilisation programmatique (CI/CD)
QV2QS prend en charge l'authentification directe sans contextes qlik-cli pré-créés. Transmettez l'URL du client et la clé API inline. QV2QS valide les identifiants et injecte les en-têtes d'authentification dans chaque appel qlik-cli. Aucun fichier de contexte n'est créé ou modifié. Inclure --accept-eula pour accepter le contrat de licence sans invite interactive.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Ce mode est sûr pour l'exécution concurrente entre plusieurs locataires et utilisateurs. La clé API n'est pas écrite sur le disque et n'apparaît pas dans les fichiers journaux.
Les informations d'identification peuvent également être définies en tant que variables d'environnement :
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Compilation locale sans Qlik Cloud
Générer la sortie convertie et le rapport de conversion sur le disque sans se connecter à Qlik Cloud. Le mode local uniquement est destiné à l'évaluation de la migration, à l'examen avant le déploiement et aux environnements 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. Pour un déploiement complet, utilisez Build to Qlik Cloud ou le mode Export QVF. Pour plus de détails sur les limitations et les cas d'utilisation du mode Local uniquement, consultez Fonctionnement de la conversion.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly