Création de paramètres par défaut dans Amazon QuickSight

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

2. Saisissez une valeur dans le champ Valeur par défaut statique pour définir une valeur par défaut.

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 depuis votre fournisseur d'identité QuickSight. 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 de l'ListUsers QuickSight API. L'interface de la ligne de commande est illustrée dans l'exemple suivant. Spécifiez le Région AWS pour votre fournisseur d'identité, par exempleus-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 motfederated.

    [
        {
            "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 se connecter depuis votre fournisseur d'identité à QuickSight. Pour identifier les groupes que vous pouvez ajouter à l'ensemble de données, utilisez une ou plusieurs des opérations d' QuickSight API ou commandes CLI suivantes :

    • ListGroups— Répertorie QuickSight les groupes par Compte AWS ID et par espace de noms pour ceux Région AWS qui contiennent votre fournisseur d'identité.

    • ListGroupMemberships— Répertorie les utilisateurs du QuickSight groupe spécifié.

    • ListUserGroups— Répertorie les QuickSight groupes dont un QuickSight utilisateur est membre.

    Vous pouvez également demander à votre administrateur réseau d'interroger votre fournisseur d'identité pour obtenir ces informations.

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. Toutefois, le support pour les groupes n'est disponible que dans QuickSight l'édition Enterprise.

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

   Consulté par	Région par défaut	Segment par défaut
   anacarolinasilva	NorthEast	SMB
   liujie	SouthEast	SMB
   saanvisarkar	NorthCentral	SMB
   zhangwei	SouthCentral	SMB

3. Importez ces données dans QuickSight et enregistrez-les en tant que nouvel ensemble de données.

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

Pour créer un ensemble 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. Toutefois, le support pour les groupes n'est disponible que dans QuickSight l'édition Enterprise.

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

   Consulté par	Région par défaut	Ville par défaut
   anacarolinasilva	NorthEast	New York
   liujie	SouthEast	Atlanta
   liujie	SouthEast	Raleigh
   saanvisarkar	NorthCentral	Chicago
   zhangwei	SouthCentral	Dallas
   zhangwei	SouthCentral	Kansas City

   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.

3. Importez ces données dans QuickSight et enregistrez-les en tant que nouvel ensemble de données.

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

Pour ajouter un DDP à votre analyse

1. Dans la QuickSight console, 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.

2. Choisissez Définir une valeur par défaut dynamique.

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

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

5. 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 QuickSight

   Amazon QuickSight 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 nom 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.