# Utilisation de variables et d'expressions dans vos modèles de rapport avec les compléments Qlik pour Microsoft Office

Ajoutez des variables et des expressions sous forme d'objets de rapport à votre modèle de rapport Excel, PowerPoint ou Word. Vous pouvez utiliser une variable ou une expression pour stocker dynamiquement une valeur ou un calcul pouvant être modifié(e) de manière centrale et réutilisé(e) dans un rapport.

[Using variables in a report template](https://play.vidyard.com/Vndm4GuDFYLCC12mP7Ez52)

## S'applique à

Ce contenu s'applique aux types de modèles de rapport Qlik Cloud suivants :

* Excel

  [Complément Qlik pour Microsoft Excel](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Excel)

* PowerPoint

  [Complément Qlik pour Microsoft PowerPoint](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#PowerPoint)

* Word

  [Complément Qlik pour Microsoft Word](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Word)

## Variables

Vous pouvez insérer des variables de Qlik Sense dans le modèle. Comme les autres objets de modèle que vous créez, une variable est ajoutée sous forme d'objet à la configuration du modèle et est accessible depuis la fenêtre du complément. Ajoutez une instance de l'objet de variable sous forme de balise de variable.

Vous pouvez ajouter des variables de script et des variables définies en mode feuille.

### Ajout d'une variable

Procédez comme suit :

1. Cliquez sur l'icône the Variables icon de la barre d'outils supérieure du complément.

2. Cliquez sur Ajouter une variable. Une liste de variables disponibles apparaît.

   Onglet Variables et expressions d'un complément, vous permettant d'ajouter une nouvelle variable ou de revisiter une variable que vous avez déjà ajoutée

   Onglet Variables et expressions d'un complément, vous permettant d'ajouter une nouvelle variable ou de revisiter une variable que vous avez déjà ajoutée

   Onglet Variables et expressionsVariables et expressions d'un complément, vous permettant d'ajouter une nouvelle variable ou de revisiter une variable que vous avez déjà ajoutée ![Onglet « Variables et expressions » d'un complément, à partir duquel vous pouvez ajouter/modifier des objets de variable existants que vous avez ajoutés ou ajouter une nouvelle variable](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_AddVariable.png)

3. Cliquez sur l'icône the Symbole Plus icon à droite d'une variable d'application existante pour l'ajouter.

   Sélection d'une variable à ajouter au modèle

   Sélection d'une variable à ajouter au modèle

   Sélection d'une variable à ajouter au modèle ![Sélection de la variable à ajouter au modèle à partir de la liste disponible](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_AddVariableInstance.png)

4. La balise de variable est insérée. La page Paramètres de la variable apparaît. Sous Expression, vous pouvez voir un Aperçu de la valeur de variable en cours.

   Il est recommandé de fournir un Nom unique à la variable afin de pouvoir l'identifier dans le complément si vous avez besoin ultérieurement de modifier ses paramètres.

5. Ajustez tous les autres paramètres, le cas échéant.

Revisitez une variable que vous avez ajoutée à tout moment pour apporter des modifications à sa configuration, pour la localiser dans le fichier Excel, PowerPoint ou Word ou pour en ajouter une autre instance. Cliquez sur l'icône the Variables icon du complément pour ouvrir la page de destination Variables et expressions et cliquez sur the Flèche vers la droite icon pour accéder à la zone dans laquelle elle est insérée. Ajustez les paramètres dans le complément, si nécessaire.

Pour des informations sur d'autres actions importantes à effectuer avec les variables, voir :

* [Formatage d'une variable ou d'une expression](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Formatti)

* [Suppression d'une variable ou d'une expression](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Removing)

## Expressions

Ajoutez des expressions sous forme d'objets à l'aide de la syntaxe et des fonctions Qlik Sense. Comme les autres objets de modèle que vous créez, une expression est ajoutée sous forme d'objet à la configuration du modèle et est accessible depuis la fenêtre du complément. Ajoutez une instance de l'objet d'expression sous forme de balise d'expression.

Parmi les expressions populaires que vous pouvez ajouter figurent les suivantes :

* `=Count(distinct <your dimension field>)` : renvoie le nombre de valeurs uniques d'un champ de dimension que vous définissez dans l'expression (par exemple, `Customer` ou `Product`).

* `=today()` : renvoie la date actuelle.

* `=year(now)` : renvoie l'année actuelle.

### Ajout d'une expression

1. Cliquez sur l'icône the Variables icon de la barre d'outils supérieure du complément.

2. Cliquez sur Ajouter une expression. Une liste d'expressions disponibles apparaît.

   Onglet Variables et expressions d'un complément, vous permettant d'ajouter une nouvelle expression ou de revisiter une expression que vous avez déjà ajoutée

   Onglet Variables et expressions d'un complément, vous permettant d'ajouter une nouvelle expression ou de revisiter une expression que vous avez déjà ajoutée

   Onglet Variables et expressionsVariables et expressions d'un complément, vous permettant d'ajouter une nouvelle expression ou de revisiter une expression que vous avez déjà ajoutée ![Onglet « Variables et expressions » d'un complément, à partir duquel vous pouvez ajouter/modifier des expressions nouvelles ou existantes](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_AddExpression.png)

3. Cliquez sur l'icône the Symbole Plus icon à droite d'une expression existante pour l'ajouter. Pour ajouter une variable existante, procédez comme suit : [Ajout d'une variable](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Adding).

4. Si, au lieu de cela, vous devez créer une nouvelle expression, cliquez sur Créer une expression.

5. Configurez la nouvelle expression en ajoutant un Nom et une Description (facultative), puis définissez l'Expression.

   Sélection d'une variable à ajouter au modèle

   Sélection d'une variable à ajouter au modèle

   Sélection d'une variable à ajouter au modèle ![Création d'une expression via un complément, en définissant un nom, une description et une expression (un calcul)](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_CreateExpression.png)

6. Vérifiez la valeur Aperçu sous le champ Expression pour vous assurer que vous avez correctement configuré l'expression, puis cliquez sur Créer.

L'objet d'expression est créé et sera disponible dans la fenêtre du complément. La balise d'expression est également insérée à l'emplacement sélectionné.

Revisitez une expression que vous avez ajoutée à tout moment pour apporter des modifications à sa configuration, pour la localiser dans le fichier Excel, PowerPoint ou Word ou pour en ajouter une autre instance. Cliquez sur l'icône the Variables icon du complément pour ouvrir la page de destination Variables et expressions et cliquez sur the Flèche vers la droite icon pour accéder à la zone dans laquelle elle est insérée. Ajustez les paramètres dans le complément, si nécessaire.

Pour des informations sur d'autres actions importantes à effectuer avec les variables, voir :

* [Formatage d'une variable ou d'une expression](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Formatti)

* [Suppression d'une variable ou d'une expression](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-variables-expressions.htm#Removing)

## Formatage d'une variable ou d'une expression

Appliquez un formatage Excel, PowerPoint ou Word natif à vos balises de variable et d'expression. Cela peut inclure un style de police, le formatage des nombres et d'autres personnalisations. Le formatage est appliqué à la sortie du rapport.

## Suppression d'une variable ou d'une expression

Vous pouvez supprimer une variable ou une expression du modèle de rapport et de la liste de ce type d'objet dans le volet du complément.

Procédez comme suit :

1. Sélectionnez la zone à laquelle l'objet est ajouté.

2. Cliquez sur Supprimer au bas de la fenêtre du complément.

Cela supprime les balises et l'objet de la liste d'objets correspondante.

Si, au lieu de cela, vous utilisez des fonctions Microsoft Office pour supprimer un objet, il ne sera pas inséré dans le rapport généré. Cependant, l'objet continuera à apparaître dans la liste d'objets ajoutés. Cela signifie que vous pouvez facilement rajouter l'objet ultérieurement.

## En savoir plus

* [Ajout de contenu à des modèles de rapport avec des compléments Qlik pour Microsoft Office](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-content.htm)

* [Utilisation de niveaux et de pages dans les modèles de rapport tabulaire](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/Excel/add-in-excel-levels-pages.htm)

* [Utilisation des variables dans les expressions](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)

* [Utilisation des variables dans l'éditeur de chargement de données](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/work-with-variables-in-data-load-editor.htm)