Utilisation de paramètres dans un URL - Amazon QuickSight

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 paramètres dans un URL

Vous pouvez utiliser le nom et la valeur d'un paramètre URL dans Amazon QuickSight pour définir une valeur par défaut pour ce paramètre dans un tableau de bord ou une analyse.

L'exemple suivant montre un tableau URL 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 des fragments ne sont pas reçues ou journalisées par les serveurs AWS . 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 de caractères d'échappement lors de la création manuelle d'unURL.

    • Pour renvoyer toutes les valeurs, définissez le paramètre égal à "[ALL]".

    • 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 <<dashboardParameter1>>. L'utilisateur du tableau de bord voit la valeur à rechercher, pas la variable.

  • Pour une URL action personnalisée, les paramètres à valeurs multiples n'ont besoin que d'une seule instance du même paramètre dans le fragment, par exemple : p.city=<<$city>>

  • Pour une valeur directeURL, plusieurs valeurs pour un seul paramètre 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 en UTC et l'envoie au backend sous forme de chaîne sans fuseau horaire. Pour utiliser les dates du temps universel coordonné (UTC), 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 transmettre des valeurs d'un tableau de bord (ou d'une analyse) à un autre tableau de bord en fonction de la sélection des points de données par l'utilisateur, utilisez URL des actions 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.