Utilisation de paramètres dans une 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 une URL

Vous pouvez utiliser le nom et la valeur d'un paramètre dans une URL d'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 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 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 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]".

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

  • 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 générer ces URL manuellement, puis 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.