# Flux de travail courants

Les 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](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm).

## 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.

Note Avertissement

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](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm).

```
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](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode).

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly
```

## En savoir plus

* [Référence d'argument](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)
* [Interface utilisateur](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/user-interface/index.htm)