Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation de feuilles interactives dans Amazon Quick Sight
Une *Interactive Sheet (Feuille interactive)* est un jeu de données exprimées sous forme de visuels avec lesquels les utilisateurs peuvent interagir lorsque la feuille est publiée sur un tableau de bord. Les auteurs d'Amazon Quick peuvent ajouter différentes mises en page, contrôles et filtres à leurs feuilles interactives que les utilisateurs du tableau de bord peuvent utiliser pour obtenir des informations détaillées à partir des données publiées. Par défaut, chaque feuille d’une analyse est une feuille interactive. Si votre compte ne dispose pas du **module complémentaire Pixel Perfect Reporting**, vous ne pouvez créer et publier que des feuilles interactives.
Pour plus d’informations sur la création d’une feuille interactive, consultez la rubrique [Lancer une analyse dans Quick Sight](creating-an-analysis.md).
Pour plus d’informations sur la mise en forme des feuilles interactives, consultez les rubriques suivantes.
**Topics**
+ [Personnalisation de la mise en page du tableau de bord dans Amazon Quick Sight](customizing-dashboards-and-visuals.md)
+ [Paramètres dans Amazon Quick](parameters-in-quicksight.md)
+ [Utilisation d’actions personnalisées pour le filtrage et la navigation](quicksight-actions.md)
# Personnalisation de la mise en page du tableau de bord dans Amazon Quick Sight
Vous pouvez personnaliser la mise en page d’un tableau de bord afin d’organiser vos données en fonction des besoins de votre entreprise. Vous pouvez choisir parmi trois mises en page de tableau de bord. Vous pouvez également modifier la taille, la couleur d’arrière-plan, la couleur de bordure et les interactions d’une représentation visuelle pour créer un tableau de bord entièrement personnalisé.
Consultez les rubriques suivantes pour en savoir plus sur la personnalisation des tableaux de bord et des représentations visuelles.
**Topics**
+ [Types de mise en page](types-of-layout.md)
+ [Choix d’une mise en page](choosing-a-layout.md)
+ [Personnalisation des représentations visuelles dans une mise en page libre](customizing-visuals-in-free-form.md)
+ [Règles conditionnelles](conditional-rules.md)
# Types de mise en page
Vous pouvez choisir parmi trois modèles de mise en page de tableau de bord : **Mosaïque**, **Forme libre** et **Classique**.
## Mise en page en mosaïque
Les représentations visuelles d’une mise en page **Mosaïque** s’adaptent à une grille avec un espacement et un alignement standard. Vous pouvez créer des représentations visuelles de n’importe quelle taille et les placer où vous le souhaitez dans un tableau de bord. Toutefois, ces représentations visuelles ne peuvent pas se chevaucher.
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/images/fixed-layouts-tiled-demo.gif)
Les tableaux de bord sont affichés tels qu’ils ont été conçus, avec des options permettant de les adapter à l’écran ou de les afficher à la taille réelle. Vous pouvez également adapter l’ensemble d’un tableau de bord à votre fenêtre en choisissant **Ajuster à la fenêtre** dans **Affichage** dans le coin supérieur droit. Cette option s’appelait auparavant **Optimisation**.
**Note**
Sur les appareils mobiles, les tableaux de bord ayant une mise en page en mosaïque apparaissent sous forme de colonne unique en mode portrait ou exactement tels qu’ils ont été conçus en mode paysage.
## Mise en page en forme libre
Les représentations visuelles d’une mise en page **Forme libre** peuvent être placées n’importe où dans votre tableau de bord à l’aide de coordonnées précises. Vous pouvez faire glisser une représentation visuelle à l’endroit exact que vous souhaitez ou saisir les coordonnées d’emplacement de la représentation visuelle. Utilisez la procédure suivante pour saisir les coordonnées exactes d’emplacement de la représentation visuelle.
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/images/fixed-layouts-freeform-placement1.gif)
Les tableaux de bord sont affichés selon la façon dont vous les avez conçus, avec des options permettant de les adapter à l’écran ou de les afficher à leur taille réelle. Vous pouvez optimiser les mises en page en forme libre pour les afficher à des résolutions spécifiques, la valeur par défaut étant de 1 600 pixels. Vous pouvez également adapter l’ensemble d’un tableau de bord à la fenêtre d’un navigateur en choisissant **Ajuster à la fenêtre** dans **Affichage** dans le coin supérieur droit.
**Note**
Les tableaux de bord aux résolutions optimisées peuvent apparaître plus ou moins grands sur l’ordinateur d’un utilisateur si la résolution de l’ordinateur de l’utilisateur n’est pas égale à la résolution définie pour le tableau de bord.
Le passage d’une mise en page **Forme libre** à un autre type de mise en page peut entraîner le déplacement de certaines représentations visuelles.
Sur les appareils mobiles, les tableaux de bord en **Forme libre** apparaissent tels qu’ils ont été publiés, sans modification de la mise en page.
## Mise en page classique
Les représentations visuelles d’une mise en page **Classique** s’adaptent à une grille avec un espacement et un alignement standard. Les tableaux de bord masquent les données ou modifient la mise en page pour s’adapter à des tailles d’écran plus petites. Par exemple, si vous modifiez une représentation visuelle pour la rendre nettement plus petite, le menu de représentations visuelles et les éditeurs sont masqués, afin que les éléments du graphique aient plus d’espace pour s’afficher. Les représentations visuelles de diagrammes à barres peuvent également afficher moins de points de données.
Si vous réduisez la taille de la fenêtre du navigateur, Amazon Quick Sight redimensionne et, si nécessaire, réorganise les visuels pour un affichage optimal. Par exemple, des représentations visuelles plus petites qui étaient disposées côte à côte peuvent être affichées dans l’ordre. La disposition d’origine est restaurée lorsque la taille de la fenêtre de navigateur est augmentée à nouveau.
**Note**
Sur les appareils mobiles, les tableaux de bord ayant une mise en page classique apparaissent sous forme de colonne unique ou exactement tels qu’ils ont été conçus en mode paysage.
# Choix d’une mise en page
**Pour modifier la mise en page d’un tableau de bord**
1. Ouvrez la [console Quick](https://quicksight.aws.amazon.com/).
1. Dans la page d'accueil rapide, choisissez **Analyses**, puis choisissez l'analyse que vous souhaitez modifier.
1. Sur la page d’analyse, choisissez **Modifier**, puis **Paramètres d’analyse**.
1. Développez **la mise en page de feuille** et choisissez la mise en page souhaitée.
1. Lorsque vous avez terminé, choisissez **Apply**.
# Personnalisation des représentations visuelles dans une mise en page libre
Vous pouvez utiliser la mise en page libre pour personnaliser entièrement la couleur, la taille, l’emplacement et la visibilité de chaque représentation visuelle d’un tableau de bord.
## Organisation des représentations visuelles
Outre le fait de faire glisser une représentation visuelle vers son emplacement préféré dans un tableau de bord, il existe de nombreuses méthodes pour déplacer une représentation visuelle à l’endroit exact où elle doit se trouver.
**Pour saisir les coordonnées d’emplacement de la représentation visuelle**
1. Choisissez la représentation visuelle que vous souhaitée.
1. Dans le menu de la représentation visuelle situé dans le coin supérieur droit, cliquez sur l’icône **Mettre en forme une représentation visuelle**.
1. Dans le volet **Propriétés** qui s’ouvre, choisissez **Placement**.
1. Saisissez les coordonnées **X** et **Y** de l’emplacement où vous souhaitez placer votre représentation visuelle. Vous pouvez également ajuster la taille de la représentation visuelle en saisissant des valeurs de **largeur** et de **hauteur**.
Les visuels sélectionnés peuvent également être déplacés à pixel-by-pixel l'aide des touches fléchées de votre clavier.
Vous pouvez superposer des représentations visuelles les unes sur les autres pour créer des représentations visuelles multicouches présentant des données.
Les représentations visuelles peuvent être organisées en plusieurs couches qui peuvent être déplacées manuellement vers l’avant et vers l’arrière.
**Pour déplacer des représentations visuelles superposées vers l’avant et vers l’arrière**
1. Choisissez la représentation visuelle que vous souhaitée.
1. **Dans le menu à trois points en haut à droite du visuel, choisissez Options du menu.**
1. Choisissez les **Options de menu** suivantes :
+ **Envoyer vers l’arrière** envoie la représentation visuelle vers l’arrière.
+ **Envoyer en arrière** envoie la représentation visuelle une couche en arrière.
+ **Envoyer en avant** fait avancer la représentation visuelle d’une couche.
+ **Envoyer vers l’avant** fait avance la représentation visuelle vers l’avant.
## Modification de la couleur d’arrière-plan d’une représentation visuelle
Les couleurs d’arrière-plan, de bordure et de cadre de sélection d’une représentation visuelle peuvent être personnalisées dans le volet **Display settings (Paramètres d’affichage)** du volet **Propriétés**.
**Pour modifier la couleur de l’arrière-plan, de la bordure ou du cadre de sélection d’une représentation visuelle**
1. Sélectionnez la représentation visuelle que vous souhaitez modifier.
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui apparaît sur la gauche, choisissez **Display settings (Paramètres d’affichage)**.
1. Accédez à la section **Style de carte** et effectuez une ou plusieurs des actions disponibles :
+ Pour modifier la couleur d’arrière-plan d’une représentation visuelle, sélectionnez la case couleur **Background (Arrière-plan)**, puis sélectionnez la couleur que vous souhaitez utiliser.
+ Pour modifier la couleur de bordure d’une représentation visuelle, sélectionnez la case couleur de la **Bordure**, puis sélectionnez la couleur que vous souhaitez utiliser.
+ Pour modifier la couleur d’une représentation visuelle, cliquez sur la case couleur de **Sélection**, puis sélectionnez la couleur que vous souhaitez utiliser.
Si vous souhaitez utiliser une couleur personnalisée pour l’arrière-plan, la bordure ou le cadre de sélection de votre visuel, choisissez la zone de couleur de la propriété que vous souhaitez modifier, puis choisissez **Couleur personnalisée**. Dans la fenêtre **Couleur personnalisée** qui apparaît, choisissez votre couleur personnalisée ou entrez le code hexadécimal de la couleur. Lorsque vous avez terminé, choisissez **Appliquer**.
Vous pouvez également rétablir l’apparence par défaut de l’arrière-plan personnalisé d’une représentation visuelle.
**Pour réinitialiser l’apparence d’une représentation visuelle**
1. Sélectionnez la représentation visuelle que vous souhaitez modifier.
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui apparaît sur la gauche, choisissez **Display settings (Paramètres d’affichage)**.
1. Choisissez la couleur que vous souhaitez réinitialiser, puis choisissez **Reset to default (Rétablir les valeurs par défaut)**.
## Masquage des arrière-plans, des bordures et des couleurs de sélection d’une représentation visuelle
Vous pouvez également choisir de ne pas afficher la bordure d’arrière-plan ou la couleur d’une représentation visuelle. Cela est utile lorsque vous souhaitez superposer plusieurs représentations visuelles. Vous pouvez masquer les couleurs d’arrière-plan, de bordure et de sélection d’une représentation visuelle en choisissant l’icône d’œil en regard des cases **Bordure**, **Arrière-plan** ou **sélection** de couleur. Vous pouvez également supprimer l’animation de chargement d’une représentation visuelle en désactivant la case **Afficher l’animation de chargement**.
## Désactivation des menus d’une représentation visuelle
Utilisez le panneau **Interactions** du volet **Propriétés** pour masquer le menu **contextuel** et le **menu visuel** des visuels sélectionnés. Vous pouvez masquer les menus visuels secondaires pour réduire l’encombrement de la représentation visuelle ou pour créer un effet visuel tel qu’une superposition.
Le **Menu contextuel** s’ouvre lorsque vous cliquez sur un point de données. Les actions courantes du **Menu contextuel** incluent le **Ciblage**, l’**Exclusion** et l’**Exploration en détail**.
Le menu **Activation des représentations visuelles** apparaît en haut à droite d’une représentation visuelle. Le menu **Activation des représentations visuelles** permet d’accéder au menu **Properties (Propriétés)**, d’**Optimiser** la représentation visuelle, d’accéder au volet **Options de menu** et de consulter un **Aperçu des anomalies**.
Vous pouvez désactiver les menus visuels secondaires en effaçant les options du **Menu contextuel** et les options du menu **Activation des représentations visuelles**.
**Note**
Vous ne pouvez pas avoir un aperçu des modifications apportées au volet **Interactions** dans **Analyses**. Publiez le tableau de bord pour afficher vos modifications.
# Règles conditionnelles
Cette fonctionnalité est actuellement disponible avec la mise en page **Forme libre**. Les règles conditionnelles sont utilisées pour masquer ou afficher des représentations visuelles lorsque des conditions spécifiques sont remplies. Cela peut être utile lorsque plusieurs versions d’une même représentation visuelle se chevauchent et que vous souhaitez que l’utilisateur du tableau de bord puisse voir la version qui représente le mieux la valeur de paramètre sélectionnée.
Les règles conditionnelles utilisent des paramètres et des commandes de paramètres pour masquer et afficher les représentations visuelles. Les paramètres sont des variables nommées qui peuvent transférer une valeur à des fins d’utilisation par une action ou un objet. Cette fonctionnalité prend en charge les paramètres de chaîne et de nombre. Pour rendre les paramètres accessibles pour l’utilisateur du tableau de bord, vous ajoutez un contrôle de paramètre. Un contrôle de paramètre permet aux utilisateurs de choisir une valeur à utiliser dans un filtre ou une action URL prédéfinie. Pour plus d’informations sur les paramètres et les valeurs des paramètres, consultez la rubrique [Paramètres dans Amazon Quick](parameters-in-quicksight.md).
Utilisez les sections ci-dessous pour configurer et utiliser des règles conditionnelles.
**Topics**
+ [Masquage d’une représentation visuelle par défaut](hiding-a-visual-by-default.title.md)
+ [Définition d’une règle conditionnelle](setting-a-conditional-rule.title.md)
+ [Utilisation de règles conditionnelles](using-conditional-rules.md)
# Masquage d’une représentation visuelle par défaut
Dans le volet **Interactions** du volet **Propriétés**, vous pouvez choisir de masquer un visuel par défaut. Il peut être utile de faire cela si vous souhaitez que l’utilisateur ne puisse voir que les représentations visuelles en fonction de conditions spécifiques.
**Pour masquer une représentation visuelle par défaut**
1. Dans la page d'accueil rapide, choisissez **Analyses**, puis choisissez l'analyse que vous souhaitez personnaliser.
1. Choisissez la représentation visuelle à laquelle vous souhaitez ajouter une règle.
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui s’ouvre, choisissez **Interactions** et ouvrez le menu déroulant **Règles**.
1. Dans le volet **Règles**, choisissez **Masquer cette représentation visuelle par défaut**.
Les représentations visuelles masquées apparaissent complètement masquées lors de l’affichage du tableau de bord. Dans le volet **Analyses**, les représentations visuelles masquées sont visibles avec le message « Masquées selon la règle ». Grâce à cet écran, vous pouvez voir où se trouvent toutes les représentations visuelles d’un tableau de bord.
**Note**
Vous ne pouvez pas créer de règles conditionnelles qui masquent des représentations visuelles déjà masquées par défaut ou qui affichent des représentations visuelles qui s’affichent déjà par défaut. Si vous modifiez l’apparence par défaut d’une représentation visuelle, les règles existantes qui contredisent la nouvelle apparence par défaut seront désactivées.
# Définition d’une règle conditionnelle
Lorsque vous configurez une règle conditionnelle, vous créez une instruction conditionnelle qui masque ou affiche une représentation visuelle lorsqu’une condition spécifique est remplie. Vous pouvez actuellement créer des règles conditionnelles qui masquent ou affichent une représentation visuelle. Si vous souhaitez créer une règle conditionnelle qui fait apparaître une représentation visuelle masquée, choisissez **Masquer cette représentation visuelle par défaut** dans le volet **Règles** du menu **Properties (Propriétés)**.
**Note**
Avant de commencer, définissez un paramètre et le contrôle de paramètre correspondant sur lesquels baser votre nouvelle règle conditionnelle. Les paramètres pris en charge sont les paramètres de chaîne et les paramètres numériques. Pour plus d’informations sur les paramètres et les valeurs des paramètres, consultez la rubrique [Paramètres dans Amazon Quick](parameters-in-quicksight.md).
**Pour définir une règle conditionnelle**
1. Dans la page d'accueil rapide, choisissez **Analyses**, puis choisissez l'analyse que vous souhaitez personnaliser.
1. Choisissez la représentation visuelle à laquelle vous souhaitez ajouter une règle.
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui apparaît sur la gauche, choisissez **Interactions**, puis **Règles**.
1. Choisissez **ADD RULE (AJOUTER UNE RÈGLE)**.
1. Dans le premier menu du volet **Ajouter une règle**, choisissez le paramètre souhaité.
1. Dans le deuxième menu du volet **Ajouter une règle**, choisissez la condition que vous souhaitez. Pour les paramètres de chaîne, les conditions prises en charge sont **Égal à**, **Commence par**, **Contient** et **N’est pas égal à**. Pour les paramètres numériques, les conditions prises en charge sont **Égal à**, **Commence par**, **Contient** et **N’est pas égal à**.
1. Saisissez la valeur que vous souhaitez que la règle conditionnelle respecte.
**Note**
Les valeurs sont sensibles à la casse.
1. Choisissez **Ajouter une règle** pour appliquer la nouvelle règle conditionnelle à la représentation visuelle. Pour annuler la règle, choisissez **Annuler**.
Les règles conditionnelles peuvent également être modifiées et supprimées.
**Pour modifier une règle conditionnelle**
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui apparaît sur la gauche, choisissez **Interactions**, puis **Règles**.
1. Choisissez l’icône du menu sur le côté droit de la règle que vous souhaitez modifier, puis choisissez **Modifier**.
1. Apportez les modifications souhaitées, puis cliquez sur **Enregistrer**.
**Pour supprimer une règle conditionnelle**
1. Dans le menu situé dans le coin supérieur droit de la représentation visuelle, choisissez **Properties (Propriétés)**.
1. Dans le volet **Propriétés** qui apparaît sur la gauche, choisissez **Interactions**, puis **Règles**.
1. Choisissez l’icône du menu sur le côté droit de la règle que vous souhaitez modifier, puis choisissez **Supprimer**.
# Utilisation de règles conditionnelles
Une fois que vous avez configuré une règle conditionnelle connectée à un paramètre et à un contrôle de paramètre, vous pouvez utiliser le contrôle de paramètre pour activer ou désactiver les règles conditionnelles que vous avez définies.
**Pour activer une règle conditionnelle**
1. Dans la page d'accueil rapide, choisissez **Analyses**, puis choisissez l'analyse que vous souhaitez personnaliser.
1. Dans la barre **Commandes** située en haut de votre espace de travail, cliquez sur l’icône du menu déroulant.
1. Choisissez le contrôle de paramètre associé à la règle conditionnelle que vous avez créée.
1. Choisissez la valeur associée à la règle conditionnelle que vous avez créée dans le menu du paramètre. Vous pouvez également saisir la valeur que vous souhaitez dans le champ **Valeur de recherche**.
**Note**
Les valeurs sont sensibles à la casse.
La sélection de la valeur correcte fait apparaître ou disparaître la représentation visuelle en fonction de la règle que vous avez définie.
Vous pouvez également apporter un contrôle de paramètre de la feuille sur laquelle se trouve votre représentation visuelle. Cela est utile lorsque vous souhaitez qu’un contrôle de paramètre soit placé à côté de la représentation visuelle à laquelle il est associé ou lorsque vous souhaitez ajouter une règle conditionnelle au contrôle afin qu’il n’apparaisse que lorsque des conditions spécifiques sont remplies.
**Pour apporter un contrôle de paramètre dans une feuille**
1. Dans la page d'accueil rapide, choisissez **Analyses**, puis choisissez l'analyse que vous souhaitez personnaliser.
1. Dans la barre **Commandes** située en haut de votre espace de travail, choisissez le contrôle à déplacer.
1. Dans le coin supérieur droit de la commande, ouvrez le menu **Options de menu**.
1. Choisissez **Déplacer vers la feuille**.
**Pour replacer une commande de paramètre dans la barre de commandes**
1. Sur votre tableau de bord, sélectionnez le contrôle de paramètre que vous souhaitez déplacer.
1. Dans le coin supérieur droit de la commande, ouvrez le menu **Options de menu**.
1. Choisissez **Déplacer vers le haut de la feuille**.
# Paramètres dans Amazon Quick
Les *paramètres* sont des variables nommées qui peuvent transférer une valeur à des fins d’utilisation par une action ou un objet. En utilisant ces paramètres, vous pouvez aider l’utilisateur d’un tableau de bord à interagir plus facilement et de manière moins technique avec les fonctionnalités de tableau de bord. Les paramètres peuvent également connecter un tableau de bord à un autre, permettant ainsi à l’utilisateur d’un tableau de bord de parcourir des données issues d’une autre analyse.
Par exemple, l’utilisateur d’un tableau de bord peut utiliser une liste pour choisir une valeur. Cette valeur définit un paramètre qui définit son tour un filtre, un calcul ou une action URL pour la valeur choisie. Ensuite, les représentations visuelles du tableau de bord réagissent aux choix de l’utilisateur.
Pour rendre les paramètres accessibles pour l’utilisateur du tableau de bord, vous ajoutez un contrôle de paramètre. Vous pouvez configurer des contrôles en cascade, de façon à ce qu’une sélection dans un contrôle filtre les options qui s’affichent dans un autre contrôle. Un contrôle peut apparaître sous la forme d’une liste d’options, d’un curseur ou d’une zone de saisie de texte. Si vous ne créez pas un contrôle, vous pouvez quand-même transmettre une valeur à votre paramètre dans l’URL du tableau de bord.
Pour qu’un paramètre fonctionne, qu’un contrôle lui soit associé ou non, il doit être relié à un élément de votre analyse. Vous pouvez référencer les paramètres dans les éléments suivants :
+ Champs calculés (sauf pour les paramètres à valeurs multiples)
+ Filtres
+ Tableau de bord et analyse URLs
+ Actions
+ Titres et descriptions tout au long d’une analyse
Voici quelques possibilités d’utilisation de paramètres :
+ En utilisant un calcul, vous pouvez transformer les données affichées en une analyse.
+ Si vous ajoutez un contrôle avec un filtre à une analyse que vous publiez, les utilisateurs du tableau de bord peuvent filtrer les données sans créer leurs propres filtres.
+ Avec les contrôles et les actions personnalisées, vous pouvez permettre aux utilisateurs du tableau de bord de définir des valeurs pour les actions d’URL.
**Topics**
+ [Configuration des paramètres dans Amazon Quick](parameters-set-up.md)
+ [Utilisation d'un contrôle avec un paramètre dans Amazon Quick](parameters-controls.md)
+ [Création de paramètres par défaut dans Amazon Quick](parameters-default-values.md)
+ [Connexion aux paramètres dans Amazon Quick](parameters-connections.md)
# Configuration des paramètres dans Amazon Quick
Utilisez la procédure suivante pour créer ou modifier un paramètre de base.
**Pour créer ou modifier un paramètre de base**
1. Choisissez une analyse à utiliser, puis choisissez le champ que vous souhaitez paramétrer.
1. Sélectionnez l’icône **Paramètres** dans la liste d’icônes en haut de la page.
1. Ajoutez un nouveau paramètre en choisissant le signe plus (**\$1Add**) à côté du haut du volet.
Modifiez un paramètre existant en choisissant d’abord l’icône en forme de `v` près du nom de paramètre, puis choisissez **Edit parameter (Modifier le paramètre)**.
1. Dans **Nom**, saisissez une valeur alphanumérique pour le paramètre.
1. Dans **Type de données**, choisissez **Chaîne**, **Nombre**, **Entier** ou **Date et heure**, puis effectuez les étapes suivantes.
+ Si vous choisissez **Chaîne**, **Nombre** ou **Entier**, procédez comme suit :
1. Dans **Valeurs**, sélectionnez **Valeur unique** ou **Valeurs multiples**.
Choisissez l’option « Valeur unique » pour les paramètres qui ne peuvent contenir qu’une seule valeur. Choisissez l’option « Valeurs multiples » pour les paramètres qui peuvent contenir une ou plusieurs valeurs. Les paramètres à valeurs multiples ne peuvent pas être des types de données `datetime`. En outre, ils ne prennent pas en charge les valeurs par défaut dynamiques.
Pour faire basculer un paramètre existant entre une et plusieurs valeurs, supprimez et recréez le paramètre.
1. (Facultatif) Dans **Valeur par défaut statique** ou **Valeurs par défaut statiques multiples**, saisissez une ou plusieurs valeurs.
Ce type de valeur statique est utilisée lors du chargement de la première page si une valeur par défaut dynamique ou un paramètre d’URL n’est pas fourni.
1. (Facultatif) Choisissez **Afficher vide par défaut**.
Sélectionnez cette option pour afficher vide la valeur par défaut des listes à valeurs multiples. Cette option s’applique uniquement aux paramètres à valeurs multiples.
+ Si vous avez sélectionné **Date et heure**, procédez comme suit :
1. Dans **Granularité temporelle**, choisissez **Jour**, **Heure**, **Minute** ou **Seconde**.
1. Dans **Date par défaut**, sélectionnez **Date fixe** ou **Date relative**, puis procédez comme suit :
+ Si vous sélectionnez **Date fixe**, saisissez une date et une heure à l’aide du sélecteur de date et d’heure.
+ Si vous sélectionnez **Date relative**, choisissez une date glissante. Vous pouvez choisir **Aujourd’hui**, **Hier** ou spécifier la **Condition du filtre** (début de ou fin de), la **Plage** (celle-ci, la précédente ou la suivante) ainsi que la **Période** (année, trimestre, mois, semaine ou jour).
1. (Facultatif) Choisissez **Définir une valeur par défaut dynamique** pour créer une valeur par défaut spécifique à l’utilisateur.
Une *valeur par défaut dynamique* est une valeur par utilisateur par défaut pour le chargement de la première page du tableau de bord. Utilisez une valeur par défaut dynamique afin de créer une vue personnalisée pour chaque utilisateur.
Les champs calculés ne peuvent pas être utilisés comme valeurs par défaut dynamiques.
Les valeurs par défaut dynamiques n’empêchent pas un utilisateur de sélectionner une valeur différente. Si vous souhaitez sécuriser les données, vous pouvez ajouter le verrouillage au niveau des lignes. Pour de plus amples informations, veuillez consulter [Utilisation de la sécurité au niveau des lignes (RLS) avec des règles basées sur les utilisateurs pour restreindre l’accès à un jeu de donnéesUtilisation des règles basées sur les utilisateurs](restrict-access-to-a-data-set-using-row-level-security.md).
Cette option s’affiche uniquement si vous sélectionnez un paramètre à valeur unique. Les paramètres à valeurs multiples ne peuvent pas avoir de valeurs par défaut dynamiques.
**Note**
Si vous choisissez un paramètre à valeurs multiples, l’écran change pour supprimer les options par défaut. À la place, vous voyez une case avec le texte **Enter values you want to use for this control (Saisir les valeurs que vous voulez utiliser pour ce contrôle)**. Vous pouvez saisir plusieurs valeurs dans cette case, chacune sur une ligne individuelle. Ces valeurs sont utilisées en tant que valeurs sélectionnées par défaut dans le contrôle du paramètre. Les valeurs ici sont combinées avec ce que vous choisissez de saisir pour le contrôle du paramètre. Pour plus d’informations sur les contrôles des paramètres, consultez [Contrôles de paramètre](parameters-controls.md).
1. (Facultatif) Définissez une valeur réservée pour déterminer la valeur du champ **Tout sélectionner**. La *Valeur réservée* d’un paramètre est la valeur attribuée à un paramètre lorsque vous choisissez **Tout sélectionner** comme valeur. Lorsque vous définissez une valeur réservée spécifique pour votre paramètre, cette valeur n’est plus considérée comme une valeur de paramètre valide dans votre jeu de données. La valeur réservée ne peut être utilisée dans aucun *consommateur de paramètres*, tels que les filtres, les contrôles, les champs calculés et les actions personnalisées. De plus, cette valeur ne s’affiche pas dans la liste de contrôle des paramètres. Vous pouvez choisir entre **Valeur recommandée**, **Valeur nulle** et **Valeur personnalisée**. La **Valeur recommandée** est la valeur par défaut. Si vous choisissez **Valeur recommandée**, la valeur réservée est définie selon les valeurs suivantes en fonction du type de valeur :
+ Chaînes : `"ALL_VALUES"`
+ Chiffres : `"Long.MIN_VALUE"-9,223,372,036,854,775,808`
+ Entiers : `Int.MIN_VALUE"-2147483648`
Pour définir une valeur réservée dans votre nouveau paramètre, choisissez la liste déroulante **Paramètres avancés** sur la page **Créer un nouveau paramètre** ou sur la page **Modifier le paramètre**, puis sélectionnez la valeur souhaitée.
1. Choisissez **Create (Créer)** ou **Update (Mettre à jour)** pour terminer la création ou la mise à jour du paramètre.
Une fois que vous avez créé un paramètre, vous pouvez l’utiliser de diverses manières. Vous pouvez créer un contrôle (comme un bouton) afin que vous puissiez choisir une valeur pour votre paramètre. Pour plus d’informations, consultez les sections suivantes.
# Utilisation d'un contrôle avec un paramètre dans Amazon Quick
Dans les tableaux de bord, les contrôles de paramètres apparaissent en haut de la fiche technique, qui contient un ensemble de représentations visuelles. La fourniture d’un contrôle permet aux utilisateurs de choisir une valeur à utiliser dans un filtre ou une action URL prédéfinie. Les utilisateurs du tableau de bord peuvent utiliser des contrôles pour appliquer le filtrage sur tous les jeux de données de représentations visuelles d’un tableau de bord, sans avoir à créer eux-mêmes les filtres.
Les règles suivantes s’appliquent :
+ Pour créer ou modifier le contrôle d’un paramètre, assurez-vous que le paramètre existe.
+ Les contrôles de liste à sélection multiple sont compatibles avec l'analyse URLs, le tableau de bord URLs, les actions personnalisées et les filtres personnalisés. Le filtre doit être égal ou différent des valeurs fournies. Aucune autre comparaison n’est prise en charge.
+ Les listes peuvent contenir jusqu’à 1 000 valeurs. S’il existe plus de 1 000 valeurs distinctes, une zone de recherche apparaît pour vous permettre de filtrer la liste. Lorsque la liste filtrée contient moins de 1 001 valeurs, le contenu de la liste apparaît sous forme d’éléments de ligne.
+ L’option **Style** affiche uniquement les types de styles appropriés pour le type de données du paramètre et le paramètre à valeur unique ou à valeurs multiples. Si le style que vous souhaitez utiliser ne figure pas dans la liste, recréez votre paramètre avec les réglages appropriés et réessayez.
+ Si votre paramètre est lié à un champ de jeu de données, il doit s’agir d’un champ réel. Les champs calculés ne sont pas pris en charge.
+ Les valeurs s’affichent par ordre alphabétique dans le contrôle, sauf lorsqu’il existe plus de 1 000 valeurs différentes. Ensuite, le contrôle affiche une zone de recherche. Chaque fois que vous recherchez la valeur que vous souhaitez utiliser, une nouvelle requête est lancée. Si le résultat contient plus de 1 000 valeurs, vous pouvez les faire défiler avec la pagination. La recherche par caractère générique est prise en charge. Pour en savoir plus sur la recherche par caractère générique, consultez la rubrique [Utilisation de la recherche par caractères génériques](search-filter.md#search-filter-wildcard).
Utilisez la procédure suivante pour créer ou modifier un contrôle pour un paramètre de existant.
**Pour créer ou modifier le contrôle d’un paramètre existant**
1. Choisissez un menu contextuel d’un paramètre existant, l’icône `v` près du nom de paramètre, puis choisissez **Add control (Ajouter le contrôle)**.
1. Saisissez un nom pour attribuer une étiquette au nouveau contrôle. Cette étiquette apparaît dans la partie supérieure de l’espace de travail, puis en haut de la liste qu’un tableau de bord affiche.
1. Choisissez un style pour le contrôle à partir de ce qui suit :
+ **Champ de texte**
Un champ de texte vous permet de saisir sa propre valeur. Un champ de texte fonctionne avec des nombres et du texte (chaînes).
+ **Champ de texte à plusieurs lignes**
Un champ de texte à plusieurs lignes vous permet de saisir ses propres valeurs. Avec cette option, vous pouvez choisir de séparer les valeurs que vous saisissez dans le contrôle des paramètres par un saut de ligne, une virgule, une barre verticale (\$1) ou un point-virgule. Un champ de texte fonctionne avec des nombres et du texte (chaînes).
+ **Liste déroulante**
Contrôle de liste déroulante que vous pouvez utiliser pour sélectionner une valeur unique. Une liste de contrôle fonctionne avec des nombres et du texte (chaînes).
+ **Liste déroulante à sélection multiple**
Contrôle de liste que vous pouvez utiliser pour sélectionner plusieurs valeurs. Une liste de contrôle fonctionne avec des nombres et du texte (chaînes).
+ **List**
Contrôle de liste que vous pouvez utiliser pour sélectionner une valeur unique. Une liste de contrôle fonctionne avec des nombres et du texte (chaînes).
+ **Liste à sélection multiple**
Contrôle de liste que vous pouvez utiliser pour sélectionner plusieurs valeurs. Une liste de contrôle fonctionne avec des nombres et du texte (chaînes).
+ **Slider**
Un curseur vous permet de sélectionner une valeur numérique en faisant glisser le contrôle d’une extrémité à l’autre de la barre. Un curseur fonctionne avec des chiffres.
+ **Sélecteur de date**
À l’aide d’un sélecteur de date, vous pouvez choisir une date à partir d’un calendrier de contrôle. Lorsque vous choisissez d’ajouter un contrôle sélecteur de date, vous pouvez personnaliser le formatage des dates de votre contrôle. Pour ce faire, dans **Format de date**, saisissez le format de date souhaité à l’aide des jetons décrits dans [Personnalisation des formats de date dans Quick](format-visual-date-controls.md).
1. (Facultatif) Si vous choisissez un contrôle de liste déroulante, l’écran se développe afin que vous puissiez choisir les valeurs à afficher. Vous pouvez spécifier une liste de valeurs, ou utiliser un champ dans un jeu de données. Sélectionnez l’une des méthodes suivantes :
+ **Valeurs spécifiques**
Pour créer une liste de valeurs spécifiques, tapez-en une par ligne, sans espace ni virgule, comme illustré dans la capture d’écran suivante.
Dans le contrôle, les valeurs s’affichent par ordre alphabétique, et non dans l’ordre où vous les avez saisies.
+ **Lien vers un champ d’jeu de données**
Pour lier un champ, choisissez le jeu de données qui contient votre champ, puis choisissez le champ dans la liste.
Si vous modifiez les valeurs par défaut dans le paramètre, choisissez **Reset (Réinitialiser)** dans le contrôle pour afficher les nouvelles valeurs.
Les valeurs que vous choisissez ici sont combinées aux valeurs par défaut statiques dans les réglages des paramètres.
1. (Facultatif) Activez l’option **Masquer [TOUTES] les options du contrôle si le paramètre possède une valeur par défaut configurée**. Cela n’affiche que les valeurs des données et supprime l’option qui permet de sélectionner tous les éléments du contrôle. Si vous ne configurez pas de valeur par défaut statique pour le paramètre, cette option ne fonctionne pas. Vous pouvez ajouter une valeur par défaut après avoir ajouté un contrôle en choisissant le paramètre, puis en sélectionnant **Edit parameter (Modifier le paramètre)**.
1. (Facultatif) Vous pouvez limiter les valeurs affichées dans les contrôles, afin qu’ils affichent uniquement des valeurs valides pour les éléments sélectionnés dans d’autres contrôles. C’est ce que l’on appelle un contrôle en cascade.
Pour en créer un, choisissez **Show relevant values only (Afficher les valeurs pertinentes uniquement)**. Choisissez un ou plusieurs contrôles capables de modifier ce qui apparaît dans ce contrôle.
Les limitations suivantes s’appliquent lors de la création de contrôles en cascade.
+ Les contrôles en cascade doivent être liés aux colonnes du jeu de données du même jeu de données.
+ Le contrôle enfant doit être un contrôle de liste ou de liste déroulante.
+ Pour les contrôles de paramètres, le contrôle enfant doit être lié à une colonne du jeu de données.
+ Pour les contrôles de filtres, le contrôle enfant doit être lié à un filtre (au lieu de n’afficher que des valeurs spécifiques).
+ Le paramètre parent doit être l’une des valeurs suivantes.
+ Un contrôle de paramètre de type chaîne, entier ou numérique.
+ Un contrôle de filtre de chaîne (À L’EXCEPTION des filtres haut-bas).
+ Un contrôle de filtre numérique non agrégé.
+ Un contrôle de filtre de date (À L’EXCEPTION des filtres de haut en bas).
1. Lorsque vous avez fini de choisir les options de votre contrôle, choisissez **Add (Ajouter)**.
Le contrôle terminé s’affiche dans la partie supérieure de l’espace de travail. Le menu contextuel, en forme de `v`, propose quatre options :
+ L’option **Réinitialiser (Reset)** restaure la sélection de l’utilisateur à son état par défaut.
+ **Actualiser la liste** s’applique uniquement aux listes déroulantes liées à un champ dans un jeu de données. La choix de l’option **Refresh list (Actualiser la liste)** interroge les données pour vérifier les changements. Les données utilisées dans le contrôle sont mises en cache.
+ L’option **Edit (Modifier)** rouvre l’écran de création des contrôles, afin que vous pouvez modifier vos paramètres.
Une fois que le volet **Modifier le contrôle** est ouvert, vous pouvez cliquer sur différentes représentations visuelles et différents contrôles pour afficher les données de mise en forme pour la représentation visuelle ou le contrôle en question. Pour plus d’informations sur la mise en forme d’une représentation visuelle, consultez la rubrique [Formatage dans Amazon Quick](formatting-a-visual.md).
+ L’option **Delete (Supprimer)** supprime le contrôle. Vous pouvez le recréer en choisissant le menu contextuel du paramètre.
Dans l’espace de travail, vous pouvez également redimensionner et réorganiser vos contrôles. Les utilisateurs du tableau de bord les voient lorsque vous effectuez ces opérations, sans être en mesure de les modifier ou de les supprimer.
# Création de paramètres par défaut dans Amazon Quick
Utilisez cette section pour en savoir plus sur les types de paramètre par défaut disponibles, et comment configurer chacune d’entre eux.
Chaque champ peut être associé à un paramètre et à un contrôle. Lorsqu’un utilisateur consulte un tableau de bord ou un rapport envoyé par e-mail, tout contrôle de feuille dont une valeur par défaut est configurée utilise cette valeur par défaut statique. La valeur par défaut peut modifier la manière dont les données sont filtrées, le comportement des actions personnalisées et le texte qui s’affiche dans le titre d’une feuille dynamique. Les rapports envoyés par e-mail prennent également en charge les valeurs par défaut dynamiques.
La valeur par défaut la plus simple est une valeur par défaut statique (immuable), qui affiche la même valeur pour tout le monde. En tant que concepteur du tableau de bord, vous choisissez la valeur par défaut. Elle ne peut pas être modifiée par la personne qui utilise le tableau de bord. Toutefois, cette personne peut choisir n’importe quelle valeur parmi les contrôles. La définition d’une valeur par défaut ne change rien à cela. Pour limiter les valeurs qu’une personne peut sélectionner, pensez à utiliser la sécurité au niveau des lignes. Pour de plus amples informations, veuillez consulter [Utilisation de la sécurité au niveau des lignes (RLS) avec des règles basées sur les utilisateurs pour restreindre l’accès à un jeu de donnéesUtilisation des règles basées sur les utilisateurs](restrict-access-to-a-data-set-using-row-level-security.md).
**Pour créer ou modifier une valeur par défaut statique qui s’applique à l’affichage du tableau de bord de chaque utilisateur**
1. Choisissez le menu contextuel (`v`) du paramètre que vous souhaitez modifier ou créez un nouveau paramètre en suivant les étapes indiquées dans [Configuration des paramètres dans Amazon Quick](parameters-set-up.md).
1. Saisissez une valeur dans le champ **Valeur par défaut statique** pour définir une valeur par défaut.
Pour afficher une valeur par défaut différente en fonction de la personne qui consulte le tableau de bord, vous devez créer un paramètre par défaut dynamique (DDP). L’utilisation de valeurs par défaut dynamiques implique une certaine préparation pour mapper les utilisateurs aux paramètres par défaut qui leur ont été attribués. Vous devez d’abord créer une requête de base de données ou un fichier de données contenant des informations sur les personnes, les champs et les valeurs par défaut à afficher. Vous ajoutez cela à un jeu de données, puis vous ajoutez le jeu de données à votre analyse. Vous trouverez ci-dessous les procédures que vous pouvez utiliser pour collecter des informations, créer le jeu de données et ajouter la valeur par défaut dynamique au paramètre.
Utilisez les directives suivantes lors de la création d’un jeu de données pour les valeurs par défaut dynamiques :
+ Nous vous recommandons d’utiliser un seul jeu de données pour contenir toutes les définitions dynamiques par défaut pour un regroupement logique d’utilisateurs ou de groupes. Si possible, conservez-les dans une seule table ou un seul fichier.
+ Nous recommandons également que les noms des champs de votre jeu de données correspondent bien à ceux des champs de l’analyse. Il n’est pas nécessaire que tous les champs du jeu de données fassent partie de l’analyse. Par exemple, si vous utilisez le même jeu de données pour les valeurs par défaut de plusieurs tableaux de bord. Les champs peuvent se trouver dans n’importe quel ordre.
+ Nous vous déconseillons de combiner les noms des utilisateurs et des groupes dans la même colonne ou même dans le même jeu de données. La maintenance et le dépannage de ce type de configuration demandent plus de travail.
+ Si vous utilisez un fichier séparé par des virgules pour créer votre jeu de données, assurez-vous de supprimer tous les espaces entre les valeurs du fichier. L’exemple suivant montre un fichier au format CSV (valeurs séparées par des virgules) correct. Placez le texte (chaînes) contenant des caractères non alphanumériques, tels que des espaces, des apostrophes, etc., entre guillemets simples ou doubles. Vous pouvez placer les champs de date ou d’heure entre guillemets, mais cela n’est pas obligatoire. Vous pouvez placer les champs numériques entre guillemets, par exemple si les nombres contiennent des caractères spéciaux, comme illustré ci-dessous.
```
"Value includes spaces","Field contains ' other characters",12345.6789,"20200808"
ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
```
+ Après avoir créé le jeu de données, assurez-vous de vérifier les types de données sélectionnés par Quick pour les champs.
Avant de commencer, vous avez besoin d’une liste des noms des utilisateurs ou des groupes des personnes qui utiliseront des valeurs par défaut dynamiques. Pour générer une liste d’utilisateurs ou de groupes, vous pouvez utiliser l’ AWS CLI pour obtenir les informations. Pour exécuter l’interface de la ligne de commande, assurez-vous d’avoir installé et configuré l’ AWS CLI . Pour plus d’informations, consultez [Installation d’ AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) dans le *Guide de l’utilisateur AWS CLI *.
Ceci n’est qu’un exemple de la façon dont vous pouvez obtenir la liste des noms des utilisateurs ou des groupes. Utilisez la méthode qui vous convient le mieux.
**Pour identifier des personnes associées à un paramètre par défaut dynamique (DDP)**
+ Répertoriez des noms d’utilisateurs individuels ou des noms de groupes :
+ Pour répertorier les noms des utilisateurs individuels, incluez une colonne qui permet d’identifier les personnes associées à votre DDP. Cette colonne doit contenir le nom d'utilisateur système de chaque personne qu'elle utilise pour se connecter à Quick depuis votre fournisseur d'identité. Ce nom d’utilisateur est souvent le même que l’alias de messagerie d’une personne avant le signe @, mais pas toujours.
Pour obtenir la liste des utilisateurs, utilisez l'opération ou la AWS CLI commande [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html)Quick API. L’interface de la ligne de commande est illustrée dans l’exemple suivant. Spécifiez la Région AWS de votre fournisseur d’identité, par exemple `us-east-1`.
```
awsacct1="111111111111"
namespace="default"
region="us-east-1"
aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region
```
L’exemple suivant modifie la commande précédente en ajoutant une requête qui limite les résultats aux utilisateurs actifs.
```
awsacct1="111111111111"
namespace="default"
region="us-east-1"
aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'
```
L’ensemble de résultats ressemble à l’exemple qui suit. Cet exemple est un extrait de la sortie JSON (`--output json`). Les personnes qui ont des noms d'utilisateur fédérés ont un principal IDs qui commence par le mot`federated`.
```
[
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva",
"UserName": "anacarolinasilva",
"Email": "anacasilva@example.com",
"Role": "ADMIN",
"Active": true,
"PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate",
"UserName": "Reader/liujie-stargate",
"Role": "READER",
"Active": true,
"PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal",
"UserName": "embedding/cxoportal",
"Email": "saanvisarkar@example.com",
"Role": "AUTHOR",
"Active": true,
"PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal"
},
{
"Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com",
"UserName": "zhangwei@example.com",
"Email": "zhangwei@example.com",
"Role": "AUTHOR",
"Active": true,
"PrincipalId": "user/d-96123-example-id-1123"
}
]
```
+ Pour répertorier les noms de groupes, incluez une colonne qui identifie les groupes contenant les noms d’utilisateur de votre DDP. Cette colonne doit contenir les noms des groupes de systèmes utilisés pour vous connecter à Quick depuis votre fournisseur d'identité. Pour identifier les groupes que vous pouvez ajouter à l'ensemble de données, utilisez une ou plusieurs des opérations d'API rapides ou des commandes CLI suivantes :
+ [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html)— Répertorie les groupes rapides par Compte AWS ID et par espace de noms pour ceux Région AWS qui contiennent votre fournisseur d'identité.
+ [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html)— Répertorie les utilisateurs du groupe rapide spécifié.
+ [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html)— Répertorie les groupes Quick dont un utilisateur Quick est membre.
Vous pouvez également demander à votre administrateur réseau d’interroger votre fournisseur d’identité pour obtenir ces informations.
Les deux procédures décrites ci-dessous fournissent des instructions sur la façon de terminer la création d’un jeu de données pour les valeurs par défaut dynamiques. La première procédure consiste à créer un jeu de données pour un DDP à valeur unique. La seconde consiste à créer un jeu de données pour un DDP à valeurs multiples.
**Pour créer un jeu de données pour un DDP à valeur unique**
1. Créez les colonnes du jeu de données avec des paramètres à valeur unique. La première colonne de la requête ou du fichier doit être destinée aux utilisateurs du tableau de bord. Ce champ peut contenir des noms d’utilisateur ou des noms de groupes. Cependant, le support pour les groupes n'est disponible que dans l'édition Quick Enterprise.
1. Pour chaque champ qui affiche une valeur par défaut dynamique pour un paramètre à valeur unique, ajoutez une colonne au jeu de données. Le nom de la colonne n’a pas d’importance : vous pouvez utiliser le même nom que le champ ou le paramètre.
Les paramètres à valeur unique ne fonctionnent comme indiqué que si la combinaison de l’entité utilisateur et de la valeur par défaut dynamique est unique pour le champ de ce paramètre. Si un champ par défaut comporte plusieurs valeurs pour une entité utilisateur, le contrôle à valeur unique de ce champ affiche plutôt la valeur par défaut statique. Si aucune valeur par défaut statique n’est définie, le contrôle n’affiche pas de valeur par défaut. Faites attention si vous utilisez des noms de groupes, car certains noms d’utilisateur peuvent appartenir à plusieurs groupes. Si ces groupes ont des valeurs par défaut différentes, ce type de nom d’utilisateur fonctionne comme une entrée en double.
L’exemple suivant montre une table qui semble contenir deux paramètres à valeur unique. Nous partons de cette hypothèse, car aucun nom d’utilisateur n’est associé à plusieurs valeurs par défaut. Pour faciliter la compréhension de cette table, nous ajoutons les mots `'default'` devant les noms des champs issus de l’analyse. Ainsi, vous pouvez lire la table de la manière suivante, en modifiant les valeurs de chaque ligne : lorsque la table est consultée par `anacarolinasilva`, les contrôles affichent par défaut la région `NorthEast` et le segment `SMB`.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/parameters-default-values.html)
1. Importez ces données dans Quick et enregistrez-les en tant que nouvel ensemble de données.
1. Dans votre analyse, ajoutez le jeu de données que vous avez créé. L’analyse doit utiliser au moins un autre jeu de données correspondant aux colonnes que vous avez définies pour les valeurs par défaut. Pour de plus amples informations, veuillez consulter [Ajout d’un jeu de données à une analyse](adding-a-data-set-to-an-analysis.md).
**Pour créer un jeu de données pour un DDP à valeurs multiples**
1. Créez les colonnes du jeu de données avec des paramètres à valeurs multiples. La première colonne de la requête ou du fichier doit être destinée aux utilisateurs du tableau de bord. Ce champ peut contenir des noms d’utilisateur ou des noms de groupes. Cependant, le support pour les groupes n'est disponible que dans l'édition Quick Enterprise.
1. Pour chaque champ qui affiche une valeur par défaut dynamique pour un paramètre à valeurs multiples, ajoutez une colonne au jeu de données. Le nom de la colonne n’a pas d’importance : vous pouvez utiliser le même nom que le champ ou le paramètre.
Contrairement aux paramètres à valeur unique, les paramètres à valeurs multiples autorisent plusieurs valeurs dans le champ associé au paramètre.
L’exemple suivant montre une table qui semble contenir un paramètre à valeur unique et un paramètre à valeurs multiples. Nous partons de cette hypothèse, car chaque nom d’utilisateur possède une valeur unique dans une colonne, et certains noms d’utilisateur ont plusieurs valeurs dans l’autre colonne. Pour faciliter la compréhension de cette table, nous ajoutons les mots `'default'` devant les noms des champs issus de l’analyse. Ainsi, vous pouvez lire la table de la manière suivante, en modifiant les valeurs de chaque ligne : lorsque la table est `viewed-by` `liujie`, les contrôles affiche la `default-region` pour la valeur `SouthEast`, et la `default-city` pour la valeur `Atlanta`. Et si nous lisons la ligne suivant, nous constatons l’utilisateur `liujie` est également présente à `Raleigh` dans `default-city`.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/parameters-default-values.html)
Dans cet exemple, le paramètre que nous appliquons à la `default-region` fonctionne correctement, qu’il s’agisse d’un paramètre à valeur unique ou à valeurs multiples. S’il s’agit d’un paramètre à valeur unique, deux entrées fonctionnent pour un utilisateur, car les deux entrées ont la même valeur, à savoir `SouthEast`. S’il s’agit d’un paramètre à valeurs multiples, il fonctionne toujours, sauf qu’une seule valeur est sélectionnée par défaut. Toutefois, si nous modifions le paramètre qui utilise `default-city` en tant que paramètre par défaut, le faisant passer d’un paramètre à valeurs multiples à un paramètre à valeur unique, nous constatons que ces valeurs par défaut ne sont pas sélectionnées. Le paramètre utilise plutôt la valeur par défaut statique, si une telle valeur est définie. Par exemple, si la valeur par défaut statique est définie sur `Atlanta`, l’utilisateur `liujie` a sélectionné la valeur `Atlanta` dans ce contrôle, et non pas `Raleigh`.
Dans certains cas, votre valeur par défaut statique peut également être utilisée comme valeur par défaut dynamique. Si tel est le cas, assurez-vous de tester le contrôle pour un nom d’utilisateur qui n’utilise pas de valeur par défaut pouvant être les deux.
Si un nom d’utilisateur appartient à plusieurs groupes, l’utilisateur nommé voit un ensemble de valeurs par défaut qui est une union des valeurs par défaut des deux groupes.
1. Importez ces données dans Quick et enregistrez-les en tant que nouvel ensemble de données.
1. Dans votre analyse, ajoutez le jeu de données que vous avez créé. L’analyse doit utiliser au moins un autre jeu de données correspondant aux colonnes que vous avez définies pour les valeurs par défaut. Pour de plus amples informations, veuillez consulter [Ajout d’un jeu de données à une analyse](adding-a-data-set-to-an-analysis.md).
Utilisez la procédure suivante pour ajouter un paramètre par défaut dynamique à votre analyse. Avant de commencer, assurez-vous d’avoir un jeu de données qui contient les valeurs par défaut dynamiques pour chaque nom d’utilisateur ou nom de groupe. Assurez-vous également que votre analyse utilise ce jeu de données. Pour obtenir de l’aide concernant ces exigences, reportez-vous aux procédures précédentes.
**Pour ajouter un DDP à votre analyse**
1. Dans la console rapide, cliquez sur l'icône **Paramètres** en haut de la page et choisissez un paramètre existant. Choisissez **Modifier le paramètre** dans le menu du paramètre. Pour ajouter un nouveau paramètre, cliquez sur le signe plus (`+`) à côté de **Paramètres**.
1. Choisissez **Définir une valeur par défaut dynamique**.
1. Configurez les options suivantes avec vos paramètres :
+ **Jeu de données contenant des valeurs par défaut et des informations utilisateur** : choisissez le jeu de données que vous avez créé et ajouté à votre analyse.
+ **Colonne des noms d’utilisateur** : pour créer des valeurs par défaut basées sur les noms d’utilisateur, choisissez la colonne du jeu de données qui contient les noms d’utilisateur.
+ **Colonne des noms de groupes** : pour créer des valeurs par défaut basées sur les noms de groupes, choisissez la colonne du jeu de données qui contient les noms de groupes.
+ **Colonne pour la valeur par défaut** : choisissez la colonne qui contient les valeurs par défaut pour ce paramètre.
1. Choisissez **Appliquer** pour enregistrer les modifications apportées à vos paramètres, puis choisissez **Mettre à jour** pour enregistrer ces modifications. Pour quitter sans enregistrer les modifications, choisissez **Annuler**.
1. Ajoutez un filtre pour chaque champ qui contient des valeurs par défaut dynamiques afin de les faire fonctionner. Pour en savoir plus sur l’utilisation des filtres avec les paramètres, consultez la rubrique [Utilisation de filtres avec paramètres dans Amazon Quick](parameters-filtering-by.md)
Amazon Quick utilise la valeur par défaut statique pour toute personne dont le nom d'utilisateur n'existe pas dans l'ensemble de données, n'a pas de valeur par défaut attribuée ou n'a pas de valeur par défaut unique. Chaque personne ne peut avoir qu’un seul ensemble de valeurs par défaut. Si vous ne voulez pas utiliser de valeurs par défaut dynamiques, vous pouvez définir une valeur par défaut statique.
# Connexion aux paramètres dans Amazon Quick
Utilisez cette section après avoir configuré un paramètre pour le connecter et le faire fonctionner.
Une fois que vous avez créé un paramètre, vous pouvez créer des consommateurs des paramètres. Les *consommateurs de paramètres* sont des composants qui consomment la valeur d’un paramètre, comme les filtres, les contrôles, les champs calculés ou les actions d’URL.
Vous pouvez naviguer jusqu’à ces différentes options d’une autre manière, comme suit :
+ Pour créer un filtre, cliquez sur l'icône **Filtre** en haut de la page. En bref, créez un **Custom Filter (Filtre personnalisé)** et activez **Use parameters (Utiliser les paramètres)**. La liste affiche uniquement les paramètres éligibles.
+ Pour ajouter un nouveau contrôle pour le paramètre, cliquez sur l'icône **Paramètres** en haut de la page. En bref, choisissez votre paramètre, puis **Add control (Ajouter le contrôle)**.
+ Pour utiliser un paramètre dans un champ calculé, modifiez un champ calculé existant ou ajoutez-en un nouveau en choisissant **Add (Ajouter)** en haut à gauche. La liste des paramètres apparaît sous la liste de champs.
**Note**
Vous ne pouvez pas utiliser de paramètres à valeurs multiples avec des champs calculés.
+ Pour créer une action d’URL, choisissez le menu en forme de **v** sur une représentation visuelle, puis choisissez **URL Actions (Actions d’URL)**.
Pour plus d’informations sur ces différents sujets, consultez les sections suivantes.
**Topics**
+ [Utilisation de filtres avec des paramètres](parameters-filtering-by.md)
+ [Utilisation de champs calculés avec des paramètres](parameters-calculated-fields.md)
+ [Utilisation d’actions personnalisées avec des paramètres](parameters-custom-actions.md)
+ [Paramètres dans URLs](parameters-in-a-url.md)
+ [Paramètres dans les titres et les descriptions](parameters-in-titles.md)
# Utilisation de filtres avec paramètres dans Amazon Quick
Utilisez cette section pour filtrer les données d’une analyse ou d’un tableau de bord en fonction de la valeur d’un paramètre à valeur unique. Pour utiliser un paramètre à valeurs multiples (un paramètre avec une liste déroulante de contrôles à sélection multiple), créez un filtre personnalisé égal (ou non égal) aux valeurs.
Avant d’utiliser un filtre avec un paramètre, vous devez déjà connaître le fonctionnement des filtres.
1. Vérifiez que votre analyse a un paramètre déjà créé. Choisissez **Modifier** à partir du paramètre ou du menu du contrôle pour savoir quels paramètres sont en cours d’utilisation.
1. Choisissez le volet **Filter (Filtre)** sur la gauche de l’écran. S’il existe déjà un filtre pour le champ que vous souhaitez utiliser, sélectionnez-le pour ouvrir ses paramètres. Sinon, créez un filtre pour le champ que vous souhaitez filtrer par le paramètre.
1. Choisissez **Use Parameters (Utiliser les paramètres)**.
1. Choisissez vos paramètres dans la liste ou les listes sous **Use parameters (Utiliser les paramètres)**. Pour les champs de texte (chaîne), vous devez d’abord choisir **Custom Filter (Filtre personnalisé)**, puis activez **Use Parameters (Utiliser les paramètres)**.
Pour les champs de date, choisissez les paramètres **Start date (Date de début)** et **End date (Date de fin)**, comme illustré dans la capture d’écran suivante.
Pour les champs avec d’autres types de données, choisissez **Select a parameter (Sélectionner un paramètre)**, puis choisissez votre paramètre dans la liste.
**Note**
Les paramètres qui peuvent contenir plusieurs valeurs doivent utiliser le type de comparaison égal ou non égal.
1. Choisissez **Apply (Appliquer)** pour enregistrer les changements.
Testez votre filtre en choisissant le contrôle en haut de l’analyse. Dans cet exemple, nous utilisons un paramètre de base qui n’a pas de valeurs par défaut, et un contrôle dynamique qui est lié au champ **Région** dans l’exemple de jeu de données nommé **Pipeline de ventes**. Le contrôle interroge les données, retournant toutes les valeurs.
Si vous supprimez ou recréez un paramètre que vous utilisez dans un filtre, vous pouvez mettre à jour le filtre avec le nouveau paramètre. Pour ce faire, ouvrez le filtre, choisissez le nouveau paramètre que vous souhaitez utiliser, puis choisissez **Apply (Appliquer)**.
Si vous renommez un paramètre, vous n’avez pas besoin de mettre à jour le filtre ou d’autres consommateurs.
# Utilisation de champs calculés avec paramètres dans Amazon Quick
Vous pouvez transmettre la valeur d’un paramètre à un champ calculé dans une analyse. Lorsque vous créez un calcul, vous pouvez choisir les paramètres existants dans la liste des paramètres sous **Parameter list (Liste des paramètres)**. Vous ne pouvez pas créer un champ calculé qui contient un paramètre à valeurs multiples (valeurs avec une liste de contrôle déroulante à sélection multiple).
Pour la formule, vous pouvez utiliser l’une des fonctions disponibles. Vous pouvez transmettre la sélection de l’utilisateur au contrôle de paramètre pour la fonction `ifElse`. En retour, vous obtenez une métrique. Vous en trouverez un exemple ci-dessous.
```
ifelse(
${KPIMetric} = 'Sales',sum({Weighted Revenue}),
${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),
${KPIMetric} = '# Active', distinct_count(ActiveItem),
NULL
)
```
L’exemple précédent crée une métrique (une décimale) que vous pouvez utiliser dans un sélecteur de champs. Ensuite, lorsque l’utilisateur choisit une valeur à partir du contrôle de paramètre, la représentation visuelle est mise à jour pour refléter sa sélection.
# Utilisation d'actions personnalisées avec des paramètres dans Amazon Quick
Une *action personnalisée* vous permet de lancer URLs ou de filtrer des éléments visuels en sélectionnant un point de données dans un visuel ou en choisissant le nom de l'action dans le menu contextuel. Lorsque vous utilisez une action d’URL avec un paramètre, vous pouvez transmettre ou envoyer les paramètres dynamiquement à l’URL. Pour que cela fonctionne, vous configurez un paramètre, puis l’utilisez dans l’URL lorsque vous créez une action personnalisée avec un type d’action **URL action (Action d’URL)**. Les paramètres côté envoi et côté réception doivent avoir les mêmes noms et types de données. Tous les paramètres sont compatibles avec des actions d’URL
Pour de plus amples informations sur la création d’une action d’URL, veuillez consulter [Création et modification d'actions personnalisées dans Amazon Quick Sight](custom-actions.md). Si vous souhaitez seulement utiliser un paramètre dans un lien, sans créer d’action d’URL, consultez [Utilisation de paramètres dans une URL](parameters-in-a-url.md).
# Utilisation de paramètres dans une URL
Vous pouvez utiliser le nom et la valeur d'un paramètre dans une URL dans Amazon Quick afin de définir une valeur par défaut pour ce paramètre dans un tableau de bord ou une analyse.
L’exemple suivant montre l’URL d’un tableau de bord qui définit un paramètre pour un autre tableau de bord.
```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```
Dans l’exemple précédent, la première partie est le lien vers le tableau de bord cible : `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`. Le signe dièse (`#)` suit la première partie pour introduire les *fragments*, qui contiennent les valeurs que vous voulez définir.
Les valeurs contenues dans les fragments ne sont ni reçues ni enregistrées par AWS les serveurs. Cette fonctionnalité conserve vos valeurs de données de façon plus sécurisée.
Le fragment après `#` suit les règles suivantes :
+ Les paramètres sont préfixés avec un `p.` Les noms correspondent au nom de paramètre, pas à celui du contrôle. Vous pouvez afficher le nom du paramètre en ouvrant l’analyse et en choisissant **Parameter (Paramètre)** dans la barre latérale gauche.
+ La valeur est définie à l’aide du signe égal (`=`). Les règles suivantes s’appliquent :
+ Les valeurs littérales n’utilisent pas de guillemets.
+ Les espaces à l’intérieur des valeurs sont automatiquement codés par le navigateur. Vous n’avez donc pas besoin d’utiliser des caractères d’échappement lors de la création manuelle d’une URL.
+ Pour renvoyer toutes les valeurs, définissez le paramètre égal à `"[ALL]"`.
+ Pour attribuer la valeur du paramètre à `null`, définissez-la comme égale à `%00`. Par exemple, `p.population=%00`.
+ Dans les actions personnalisées, les noms des paramètres cibles commencent par `$` : par exemple, `<<$passThroughParameter>>`
+ Dans les actions personnalisées, les valeurs des paramètres s’affichent entre crochets `<< >>`, par exemple `<>`. L’utilisateur du tableau de bord voit la valeur à rechercher, pas la variable.
+ Dans le cas d’une action d’URL personnalisée, les paramètres à valeurs multiples n’ont besoin que d’une instance du même paramètre dans le fragment, par exemple : `p.city=<<$city>>`
+ Pour une URL directe, plusieurs valeurs d’un paramètre unique ont deux instances du même paramètre dans le fragment. Pour obtenir un exemple, reportez-vous ci-dessous.
+ Des esperluettes (`&`) séparent les paramètres multiples. Pour obtenir un exemple, reportez-vous ci-dessous.
Le serveur convertit la date au format UTC et l’envoie au backend en tant que chaîne sans fuseau horaire. Pour utiliser des dates en heure UTC (Universal Coordinated Time) excluez le fuseau horaire. Voici quelques exemples de formats de date qui fonctionnent :
+ `2017-05-29T00%3A00%3A00`
+ `2018-04-04 14:51 -08:00`
+ `Wed Apr 04 2018 22:51 GMT+0000`
```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```
Dans le navigateur, ce code devient ce qui suit.
```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```
L’exemple précédent définit quatre paramètres :
+ `shipDate` est un paramètre de date : `Sept 30, 2018`.
+ `city` est un paramètre de chaîne à valeurs multiples : `New York` et `Seattle`
+ `teamMember` est un paramètre d’entier : `12`.
+ `percentageRank` est un paramètre décimal : `2.3`
L’exemple suivant montre comment définir des valeurs pour un paramètre qui accepte plusieurs valeurs.
```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA
```
Pour transférer les valeurs d’un tableau de bord (ou d’une analyse) à un autre en fonction de la sélection des points de données de l’utilisateur, utilisez les actions d’URL personnalisées. Si vous le souhaitez, vous pouvez également les générer URLs manuellement et les utiliser pour partager une vue spécifique des données.
Pour de plus amples informations sur la création d’actions personnalisées, veuillez consulter [Utilisation d’actions personnalisées pour le filtrage et la navigation](quicksight-actions.md).
# Utilisation de paramètres dans les titres et les descriptions dans Amazon Quick
Lorsque vous créez des paramètres dans Amazon Quick, vous pouvez les utiliser dans les titres et les descriptions de vos graphiques et analyses afin d'afficher dynamiquement les valeurs des paramètres.
Vous pouvez utiliser des paramètres dans les zones suivantes de votre analyse :
+ Titres et sous-titres des graphiques
+ Titres des axes
+ Titres des légendes
+ Titres des contrôles des paramètres
+ Titres et descriptions des feuilles
L’image suivante montre le titre d’un graphique qui utilise un paramètre.
![\[Image du volet Mettre en forme une représentation visuelle avec un paramètre dans le titre du graphique et un graphique avec la valeur du paramètre entourée en rouge dans le titre.\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/images/parameters-in-titles-labels2.png)
Découvrez comment ajouter des paramètres aux différentes zones de votre analyse à l’aide des procédures suivantes. Pour plus d’informations sur les paramètres et la manière de les créer, consultez la rubrique [Parameters](parameters-in-quicksight.md).
## Ajout de paramètres aux titres et aux sous-titres des graphiques
Découvrez comment ajouter des paramètres aux titres et sous-titres de vos graphiques à l’aide de la procédure suivante.
**Pour ajouter un paramètre au titre ou au sous-titre d’un graphique**
1. Ouvrez le volet **Properties (Propriétés)** de la représentation visuelle que vous souhaitez mettre en forme.
1. Dans le panneau **Properties (Propriétés)**, choisissez l’onglet **Titre**.
1. Sélectionnez **Afficher le titre** ou **Afficher le sous-titre**. Il se peut que ces options soient déjà sélectionnées.
1. Cliquez sur les trois points situés à droite de **Modifier le titre** ou **Modifier le sous-titre**, puis choisissez un paramètre dans la liste.
Le paramètre est ajouté au titre dans le volet **Properties (Propriétés)**. Dans le graphique, la valeur du paramètre est affichée dans le titre.
Pour plus d’informations sur la modification des titres et des sous-titres dans les représentations visuelles, consultez la rubrique [Titres et sous-titres sur les types visuels dans Quick](customizing-a-visual-title.md).
## Ajout de paramètres aux titres des axes
Découvrez comment ajouter des paramètres aux titres des axes à l’aide de la procédure suivante.
**Pour ajouter un paramètre au titre d’un axe**
1. Ouvrez le volet **Properties (Propriétés)** de la représentation visuelle que vous souhaitez mettre en forme.
1. Dans le volet **Properties (Propriétés)**, sélectionnez l’axe que vous souhaitez mettre en forme.
1. Sélectionnez **Afficher le titre**.
1. Cliquez sur les trois points situés à droite du titre des axes par défaut, puis choisissez un paramètre dans la liste.
Le paramètre est ajouté au titre de l’axe dans le volet **Properties (Propriétés)**. Dans le graphique, la valeur du paramètre est affichée dans le titre de l’axe.
Pour plus d’informations sur la modification des titres des axes, consultez la rubrique [Axes et lignes de quadrillage](showing-hiding-axis-grid-tick.md).
## Ajout de paramètres aux titres des légendes
Découvrez comment ajouter des paramètres aux titres des légendes à l’aide de la procédure suivante.
**Pour ajouter un paramètre au titre d’une légende**
1. Ouvrez le volet **Properties (Propriétés)** de la représentation visuelle que vous souhaitez mettre en forme.
1. Dans le panneau **Properties (Propriétés)**, choisissez **Legend**.
1. Sélectionnez **Afficher le titre de la légende**.
1. Cliquez sur les trois points situés à droite de **Titre de la légende**, puis choisissez un paramètre dans la liste.
Le paramètre est ajouté au titre de la légende dans le volet **Properties (Propriétés)**. Dans le graphique, la valeur du paramètre est affichée dans le titre de la légende.
Pour en savoir plus sur la mise en forme des légende, consultez la rubrique [Légendes sur les types visuels dans Quick](customizing-visual-legend.md).
## Ajout de paramètres aux titres des contrôles
Découvrez comment ajouter des paramètres aux titres des contrôles des paramètres à l’aide de la procédure suivante.
**Pour ajouter un paramètre au titre d’un contrôle de paramètre**
1. Sélectionnez le contrôle de paramètre que vous souhaitez modifier, cliquez sur les trois points situés à droite du titre du contrôle de paramètre, puis choisissez **Modifier**.
1. Sur la page **Modifier le contrôle** qui s’ouvre, sélectionnez **Afficher le titre**.
1. Cliquez sur les trois points situés à droite de **Afficher le nom**, puis choisissez un paramètre dans la liste.
Le paramètre est ajouté au titre du contrôle de paramètre.
Pour en savoir plus sur l’utilisation des contrôles des paramètres, consultez la rubrique [Contrôles des paramètres](parameters-controls.md).
## Ajout de paramètres aux titres et aux descriptions des feuilles
Découvrez comment ajouter des paramètres aux titres et descriptions de vos analyses à l’aide de la procédure suivante.
**Pour ajouter un paramètre au titre ou à la description d’une feuille**
1. Sur la page d’analyse, choisissez **Sheets (Feuilles)** dans la barre d’application, puis **Ajouter un titre** ou **Ajouter une description**.
Un titre ou une description apparaît sur la feuille.
1. Dans **Titre de la feuille** ou dans **Description**, cliquez sur les trois points situés à droite, puis choisissez un paramètre dans la liste.
Le paramètre est ajouté au titre ou à la description de la feuille et la valeur du paramètre apparaît dans le texte lorsque vous fermez la zone de texte.
Pour plus d’informations sur l’ajout de titres et de descriptions aux feuilles, consultez la rubrique [Ajout d’un titre et d’une description à une analyse](adding-a-title-and-description.md).
# Utilisation d’actions personnalisées pour le filtrage et la navigation
Pour ajouter des options interactives pour les abonnés au tableau de bord (lecteurs rapides), vous devez créer des actions personnalisées sur un ou plusieurs éléments visuels de votre analyse. L’amélioration des tableaux de bord avec des actions personnalisées permet aux utilisateurs d’explorer les données en ajoutant du contexte à partir du jeu de données. Ainsi, il peut être plus facile d’approfondir les détails et de trouver de nouvelles informations dans le même tableau de bord, un autre tableau de bord ou une autre application. Vous pouvez ajouter jusqu’à dix actions personnalisées à chaque représentation visuelle dans un tableau de bord.
Avant de commencer, il est utile d’effectuer un travail de planification. Par exemple, identifiez les champs qui se prêtent bien au filtrage, à l’ouverture d’une autre feuille, à l’ouverture d’une URL ou à l’envoi d’un e-mail. Pour chaque feuille, identifiez les widgets qui affichent ces champs. Décidez ensuite quels widgets doivent contenir des actions. Il est également conseillé de créer un schéma de dénomination afin que les noms des actions soient cohérents tout au long de l’analyse. Des noms cohérents permettent à la personne qui utilise votre analyse de déterminer plus facilement l’effet de l’action, et ils vous permettent également de gérer plus facilement les actions que vous pourriez dupliquer tout au long de l’analyse.
Les actions existent uniquement sur le widget du tableau de bord dans lequel vous les créez et elles fonctionnent dans le contexte de la feuille parent et des champs enfants de ce widget affiché. Vous ne pouvez créer des actions que sur des types de widgets spécifiques : visuels et aperçus. Vous ne pouvez pas les ajouter à d’autres widgets, par exemple à des contrôles filtre ou à des contrôles de liste. Les actions personnalisées ne peuvent être activées qu’à partir du widget dans lequel vous les créez.
Pour activer une action, la personne qui utilise l’analyse peut cliquer avec le bouton gauche de la souris (sélectionner) ou cliquer avec le bouton droit de la souris (utiliser le menu contextuel) sur un point de données. Un *point de données* est un élément du jeu de données, par exemple un point sur un graphique linéaire, une cellule d’un tableau croisé dynamique, une tranche d’un graphique circulaire, etc. Si la personne clique sur un élément visuel, l’action *Sélectionner* est activée. Il s’agit de l’action qui fait actuellement partie de la catégorie **Activation de la sélection** de l’onglet **Actions** d’une analyse. Si, à la place, la personne effectue un clic droit sur un élément visuel, elle peut choisir parmi une liste d’actions de *menu*. Les actions répertoriées font actuellement partie de la catégorie **Option de menu** de l’onglet **Actions** d’une analyse. La catégorie **Activation de la sélection** ne peut contenir qu’une seule action de membre.
Par défaut, la première action que vous créez devient l’action de sélection, c’est-à-dire celle qui est activée par un clic gauche. Pour supprimer une action de la catégorie **Activation de la sélection**, remplacez le paramètre **Activation** de l’action par **Option de menu**. Après avoir enregistré cette modification, vous pouvez définir le paramètre **Activation** d’une autre action su **Sélectionner**.
Vous pouvez choisir entre trois **Types d’action** lors de la configuration d’une action :
+ **Actions de filtrage** : filtrez les données incluses dans la représentation visuelle ou dans la feuille entière. Par défaut, les filtres sont disponibles pour tous les champs de la représentation visuelle parent. Les filtres en cascade sont activés par défaut. Les actions de filtrage fonctionnent sur plusieurs jeux de données grâce aux mappages de champs générés automatiquement.
Si l’analyse utilise plusieurs jeux de données, vous pouvez afficher les mappages de champs générés automatiquement pour les champs qui existent dans plusieurs jeux de données. Pour ce faire, choisissez ****Afficher le mappage des champs**** à la fin des paramètres d’action, lorsque vous modifiez une action. Si vous affichez une liste d’actions, choisissez ****Afficher le mappage des champs**** dans le menu de chaque action. Les mappages de champs apparaissent dans un nouvel écran qui affiche le mappage entre le jeu de données initial et tous les autres jeux de données de la représentation visuelle. Si aucun champ n’est automatiquement mappé, un message s’affiche avec un lien vers [Mappage et jointure des champs](mapping-and-joining-fields.md).
+ **Actions de navigation** : activez la navigation entre les différentes feuilles d’une même analyse.
+ **Actions d’URL** : ouvrez un lien vers une autre page Web. Si vous souhaitez ouvrir un autre tableau de bord, utilisez une action d’URL. Vous pouvez utiliser une action d'URL pour envoyer des points de données et des paramètres à d'autres URLs. Vous pouvez inclure n’importe quel champ ou paramètre disponible.
Si l’URL utilise le schéma `mailto`, l’exécution de l’action ouvre votre éditeur de messagerie par défaut.
**Topics**
+ [Ajout de filtres interactifs en un clic](quick-actions.md)
+ [Création et modification d'actions personnalisées dans Amazon Quick Sight](custom-actions.md)
+ [Réparation d’actions personnalisées](repairing-custom-actions.md)
+ [Comprendre le mappage des champs pour les actions personnalisées dans Amazon Quick Sight](quicksight-actions-field-mapping.md)
# Ajout de filtres interactifs en un clic
Le *filtrage interactif en un clic* fournit un point-and-click filtrage qui passe du visuel cliquable à tous les autres visuels et informations d'une feuille. Ajoutez ce filtrage à votre analyse pour commencer par des résumés et explorer les métriques, le tout dans la même feuille de tableau de bord.
Après avoir configuré cela, lorsque vous cliquez sur un point de données (par exemple, une point dans un graphique linéaire), vous filtrez instantanément à l’aide de tous les champs mappés de toutes les autres représentations visuelles de la feuille. Si vous disposez de plusieurs jeux de données, tous les champs cibles doivent être mappés pour que cela fonctionne. En outre, vous ne pouvez avoir qu’une seule action qui fonctionne en cliquant sur un point de données ; toutes les autres actions fonctionnent à partir du menu contextuel.
Utilisez la procédure suivante pour créer un filtre en un clic dans une analyse.
**Pour créer un filtre en un clic sur une représentation visuelle ou un aperçu**
1. Dans votre analyse, choisissez une représentation visuelle ou un aperçu auquel vous souhaitez ajouter un filtrage interactif.
1. Choisissez **Actions** dans la liste déroulante d’options de menu dans le coin supérieur droit.
1. Choisissez **Filtrer les représentations visuelles d’une même feuille**. Ainsi, vous ajoutez aussitôt un filtrage en un clic.
1. Répétez cette procédure pour chaque représentation visuelle que vous souhaitez rendre interactive.
# Création et modification d'actions personnalisées dans Amazon Quick Sight
Vous créez une action pour chaque tâche que vous souhaitez pouvoir ajouter à une représentation visuelle. Les actions que vous créez font partie de la fonctionnalité de chaque représentation visuelle ou aperçu.
Le tableau suivant définit les circonstances dans lesquelles chaque type d’action doit être utilisé.
| Action à effectuer | Type d’action |
| --- | --- |
| Ajouter ou personnaliser une action de filtrage interactive, y compris des filtres en un clic | Action de filtre |
| Ouvrir une autre feuille dans le même tableau de bord | Action de navigation |
| Ouvrir une feuille dans un autre tableau de bord dans le même Compte AWS | Action d’URL |
| Ouvrir une URL (`https`, `http`) | Action d’URL |
| Envoyer un e-mail (`mailto`) | Action d’URL |
Vous pouvez définir les attributs et options ci-dessous pour une action personnalisée :
+ ****Nom de l’action**** : il s’agit d’un nom descriptif que vous choisissez pour l’action. Par défaut, les actions sont nommées **Action 1**, **Action 2**, et ainsi de suite. Si votre action personnalisée est activée à partir d’un menu contextuel, le nom s’affiche dans le menu lorsque vous cliquez avec le bouton droit sur un point de données.
Pour rendre le nom de l’action dynamique, vous pouvez le paramétrer. Utilisez l'icône plus située près de l'en-tête du nom de l'action pour afficher la liste des variables disponibles. Les variables sont placées entre chevrons `<< >>`. Les paramètres sont préfixés par un `$`, par exemple `<<$parameterName>>`. Les noms de champs n’ont pas de préfixe, par exemple `<>`.
+ ****Activation**** : les options disponibles sont **Sélectionner** ou **Option de menu**. Pour utiliser une action, vous pouvez *sélectionner* le point de données (clic gauche) ou naviguer jusqu’à l’*option de menu* dans le menu contextuel (clic droit). Les actions de navigation et d’URL sont répertoriées au milieu du menu contextuel, juste au-dessus des options **Couleur**. Les actions activées par le menu sont également disponibles à partir de la légende sur une représentation visuelle.
+ ****Type d’action**** : le type d’action que vous souhaitez. Les paramètres spécifiques à un type d’action ne s’affichent qu’une fois que vous avez sélectionné le type d’action.
+ Les paramètres relatifs aux **actions de filtre** incluent les éléments suivants :
+ ****Portée du filtre**** : les champs auxquels le filtrer s’applique. Pour filtrer tous les champs, choisissez **All fields (Tous les champs)**. Sinon, choisissez **Sélectionner les champs**, puis désactivez les éléments que vous ne souhaitez pas cibler.
La valeur par défaut est **Tous les champs**.
+ ****Cibler les représentations visuelles**** : les widgets du tableau de bord à cibler. Pour appliquer le filtre à toutes les représentations visuelles, choisissez **Toutes les représentations visuelles**. Sinon, choisissez **Sélectionner les représentations visuelles**, puis désactivez les éléments que vous ne souhaitez pas cibler. Lorsque vous appliquez une action de filtrage à d’autres représentations visuelles, l’effet est appelé *filtres en cascade*.
La valeur par défaut est **Toutes les représentations visuelles.**
Un filtre en cascade s’applique à toutes les représentations visuelles configurées dans la section **Target visuals (Représentations visuelles cibles)** d’une action de filtrage spécifique. Amazon Quick Sight évalue initialement vos visuels et préconfigure les paramètres pour vous. Mais vous pouvez modifier les valeurs par défaut si vous le souhaitez. Vous pouvez configurer plusieurs filtres en cascade sur plusieurs représentations visuelles dans la même feuille ou analyse. Lorsque vous utilisez l’analyse ou le tableau de bord, vous pouvez utiliser plusieurs filtres en cascade en même temps, même si vous les activez un par un.
Une action de filtre nécessite au moins une représentation visuelle cible, car une action de filtre exige une source et une cible. Pour filtrer uniquement la représentation visuelle en cours, créez un filtre classique en choisissant **Filter (Filtre)** à gauche.
+ Les paramètres relatifs aux **actions de navigation** incluent les éléments suivants :
+ ****Feuille cible**** : la feuille à cibler.
+ ****Paramètres**** : les paramètres à envoyer à la feuille cible. Cliquez sur l'icône plus pour ajouter un paramètre existant.
+ Les paramètres relatifs aux **actions d’URL** incluent les éléments suivants :
+ ****URL**** : l’URL à ouvrir. Les actions d’URL peuvent être des liens ciblés dans une autre application. Les schémas d’URL valides incluent `https`, `http` et `mailto`.
+ ****\$1** (Valeurs)** — (Facultatif) Les paramètres à envoyer à l'URL cible. Les noms de paramètres commencent par un `$`. Les paramètres côté envoi et côté réception doivent avoir les mêmes noms et types de données.
+ ****Ouvrir dans**** : l’emplacement d’ouverture de l’URL. Vous avez le choix entre l’onglet **New browser (Nouveau navigateur)**, l’onglet **Same browser (Même navigateur)** ou la fenêtre **New browser (Nouveau navigateur)**.
Certains types d’actions vous permettent d’inclure des valeurs issues de paramètres ou de champs disponibles dans la représentation visuelle ou dans l’aperçu. Vous pouvez les saisir manuellement ou choisir **\$1** pour les sélectionner dans une liste. Pour que l’action personnalisée fonctionne, tous les champs et paramètres auxquels elle fait référence doivent être activement utilisés dans le widget parent.
Utilisez la procédure suivante pour créer, afficher ou modifier une action personnalisée dans une analyse.
**Pour créer, afficher ou modifier une action personnalisée**
1. Votre analyse étant ouverte, choisissez **Actions** dans le **menu déroulant des options** du menu situé dans le coin supérieur droit.
Le cas échéant, les actions existantes sont affichées par type d’activation. Pour activer ou désactiver une action existante, utilisez la case située à droite du nom de l’action.
1. (Facultatif) Pour modifier ou afficher une action existante, cliquez sur l'icône de menu à côté du nom de l'action.
Pour modifier l’action, choisissez **Edit (Modifier)**.
Pour la supprimer, choisissez **Delete (Supprimer)**.
1. Pour créer une nouvelle action, choisissez l’une des options suivantes :
+ L'icône d'ajout située près de l'en-tête **Actions**
+ Le bouton **Définir une action personnalisée**
1. Dans **Nom de l’action**, définissez un nom d’action. Pour rendre le nom de l'action dynamique, utilisez l'icône plus pour ajouter des valeurs de paramètre ou de champ.
1. Dans **Activation**, choisissez le mode d’exécution de l’action.
1. Dans **Type d’action**, saisissez l’action que vous voulez utiliser.
1. Pour une **Action de filtre**, procédez comme suit :
1. Dans **Portée du filtre**, choisissez la portée du filtre.
1. Dans **Représentations visuelles cibles**, choisissez jusqu’où vous souhaitez que le filtre se répercute.
1. Pour une **Action de navigation**, procédez comme suit :
1. Dans **Feuille cible**, choisissez la feuille cible.
1. Pour **Paramètres**, cliquez sur l'icône plus près de l'en-tête **Paramètres**, sélectionnez un paramètre, puis choisissez une valeur de paramètre. Vous pouvez choisir toutes les valeurs, saisir des valeurs personnalisées ou sélectionner des champs spécifiques.
1. Pour une **Action d’URL**, procédez comme suit :
1. Dans **URL**, saisissez le lien hypertexte.
1. Cliquez sur l'icône plus à côté de l'en-tête de **l'URL**. Ajoutez ensuite des variables à partir de la liste.
1. Dans **Ouvrir dans**, choisissez la façon dont vous souhaitez ouvrir l’URL.
1. Une fois l’action terminée, choisissez l’une des options suivantes en bas du volet **Actions** (vous devrez peut-être faire défiler la page vers le bas) :
+ **Enregistrer** : enregistrez vos sélections, puis créez l’action personnalisée.
+ **Fermer** : fermez cette action personnalisée et annulez vos modifications.
+ **Supprimer** : supprimez cette action.
# Réparation d’actions personnalisées
Pour qu’une action personnalisée fonctionne, tous les champs et paramètres auxquels elle fait référence doivent être activés dans le widget parent. Si un champ est absent du widget source, ou si un paramètre est absent de l’analyse, l’action pour ce champ ou paramètre devient indisponible. Les actions de menu ne sont plus incluses dans le menu contextuel. Les actions sélectionnées ne répondent plus aux tentatives d’interaction. Cependant, de toutes les autres manières, le widget continue de fonctionner. Aucune erreur ne s’affiche pour vos utilisateurs. Vous pouvez corriger les actions de filtre et les actions d’URL interrompues en ajoutant les champs manquants à la représentation visuelle ou à l’aperçu défectueux.
La procédure suivante explique comment réparer une action qui a échoué parce que qu’une personne a supprimé un champ ou un paramètre sans mettre à jour l’action. Ces étapes fournissent des conseils de base sur la manière de résoudre ce problème. Toutefois, utilisez votre propre jugement pour déterminer comment apporter des modifications à l’analyse ou si cela est nécessaire. En cas de doute, il est préférable de demander de l'aide à un administrateur Amazon Quick avant de modifier quoi que ce soit. Par exemple, il peut y avoir un moyen de restaurer une version précédente de l’analyse, ce qui peut être plus sûr si vous n’êtes pas sûr de ce qui lui est arrivé.
**Pour supprimer un champ d’une action interrompue**
1. Sur la page d’accueil, sélectionnez **Analyses**. Ensuite, choisissez l’analyse à corriger.
1. Choisissez la représentation visuelle ou l’aperçu dans lequel l’action ne fonctionne plus. Assurez-vous que le problème est surligné sur la feuille.
1. Choisissez **Actions** dans la liste déroulante d’options de menu dans le coin supérieur droit.
1. Localisez l'action que vous souhaitez corriger et choisissez **Modifier**.
1. Si le type d’action est **Action de filtre** et que vous voyez s’afficher un message d’erreur indiquant que *le champ utilisé par cette action a été supprimé*, vérifiez les paramètres dans **Portée du filtre**. Les **champs sélectionnés** ne peuvent afficher que les champs figurant dans la représentation visuelle. Pour désactiver les champs sélectionnés qui sont supprimés, choisissez l’une des options suivantes :
+ Modifiez le paramètre **Portée du filtre** sur **Tous les champs**. Cela permet au widget d’appliquer le filtre à tous les champs.
+ Si vous souhaitez utiliser la liste des **Champs sélectionnés**, vérifiez la liste des champs. Si vous devez inclure un autre champ, vous devez d’abord l’ajouter à la représentation visuelle.
1. Si le type d’action est **Action de navigation**, suivez les instructions du message d’erreur, qui reflètent le type de modification à l’origine de l’erreur.
1. Si le type d’action est **Action d’URL**, vérifiez le paramètre d’**URL** pour les variables marquées par des chevrons doubles (`<`). Ouvrez la liste des variables disponibles en cliquant sur l'icône plus. Supprimez les champs ou paramètres qui ne figurent pas dans la liste. Assurez-vous également de supprimer le *paramètre d’URL* correspondant et son séparateur (`?`pour le premier paramètre d’URL ou `&` pour les paramètres suivants). Les exemples suivants montrent quelle partie est supprimée (en **gras**) si vous supprimez le champ nommé `Product` de la représentation visuelle.
```
https://www.example.com/examplefunction?q=<
```
```
https://www.example.com/examplefunction?q=<&uact=<<$CSN>
```
```
https://www.example.com/examplefunction?pass=yes&q=<+<&oq=<+<&uact=<<$CSN>
```
Assurez-vous de tester la nouvelle URL.
1. (Facultatif) Pour supprimer l’action, faites défiler l’écran jusqu’en bas et choisissez **Supprimer**.
1. Lorsque vous avez terminé, confirmez les modifications que vous avez apportées à l’action. Faites défiler vers le bas jusqu’au volet **Action** et choisissez **Enregistrer**.
Si l’erreur existe également dans un tableau de bord associé, partagez et publiez à nouveau le tableau de bord pour propager le correctif.
# Comprendre le mappage des champs pour les actions personnalisées dans Amazon Quick Sight
Le mappage automatique des champs est basé sur des champs identiques. Les champs de même nom et de même type de données sont automatiquement mappés entre les jeux de données. Les noms de champ et les types de données doivent présenter une correspondance exacte. Le fonctionnement est similaire à celui d’une jointure, sauf que la génération s’effectue automatiquement en fonction des noms et des types de données de chaque champ de la correspondance. Si certains champs sont manquants, vous pouvez les créer à l’aide de champs calculés dans le jeu de données où ils sont manquants. Si vous ne souhaitez pas que certains champs soient mappés les uns aux autres, vous pouvez les renommer ou les supprimer de le jeu de données.
Il est important de vous assurer que tous les champs cibles sont mappés s’ils sont activés pour être utilisés dans une action de filtre (dans **Filter scope (Étendue du filtre)**). Le filtrage peut ainsi être appliqué automatiquement. Si certains champs cibles ne sont pas mappés, le filtrage automatique ne fonctionne pas.
Le mappage est généré uniquement lorsque vous créez ou enregistrez une action personnalisée. Il s’ensuit qu’après chaque modification qui affecte le mappage, vous devez revenir sur ce dernier et l’enregistrer à nouveau. Lorsque vous créez une action, le mappage est basé sur les champs tels qu’ils existent à ce stade. Lorsque vous enregistrez une action, tous les champs mappés que vous avez renommés depuis la création de l’action personnalisée restent mappés. Toutefois, si vous modifiez le type de données d’un champ mappé, le mappage est supprimé.
Si certains champs manquent à votre mappage, vous pouvez effectuer l’une des opérations suivantes pour corriger le problème :
+ Ciblez uniquement les champs mappés, en supprimant les champs non mappés de **Filter scope (Étendue du filtre)**.
+ Supprimez la représentation visuelle en question des représentations visuelles cibles.
+ Créez des champs calculés pour fournir les champs manquants du mappage, puis enregistrez votre action personnalisée.
+ Modifiez le jeu de données et renommez les champs ou modifiez leurs types de données, puis enregistrez votre action personnalisée.
+ Modifiez le jeu de données et renommez les champs ou modifiez leurs types de données, puis enregistrez à nouveau votre action personnalisée.
**Note**
Les informations qui s’affichent sur l’écran de mappage indiquent la configuration de l’enregistrement le plus récent. Pour actualiser la vue ou la mettre à jour, enregistrez à nouveau l’action.
Si vous ajoutez ou modifiez des jeux de données, ils ne sont pas automatiquement mappés ou remappés. Il en résulte un mauvais fonctionnement du filtrage. Supposons, par exemple, que vous ajoutiez un nouvel jeu de données, puis que vous créiez des représentations visuelles pour celui-ci. Les nouvelles représentations visuelles ne répondront pas aux actions de filtrage, car il n’y a pas de mappage de champs pour les connecter. Lorsque vous apportez des modifications, n’oubliez pas d’enregistrer à nouveau vos actions personnalisées pour rétablir les mappages de champs.
Si vous supprimez un champ paramétré ou tout autre champ ciblé de la représentation visuelle source, l’action qui l’utilise s’interrompt. L’action du champ manquant ne fonctionne pas lorsque vous sélectionnez un point de données ou n’apparaît pas dans le menu contextuel.
Pour de plus amples informations sur la préparation de votre jeu de données en vue du mappage automatique des champs, veuillez consulter [Mappage des champs](mapping-and-joining-fields.md#mapping-and-joining-fields-automatic).