Créez des paramètres que vous pouvez utiliser dans tous vos widgets avec une source de données d'API AQL ou générique, telle que Time Period et Time Value. L'utilisation de paramètres communs et de valeurs par défaut peut réduire le temps nécessaire pour créer ou modifier des requêtes individuelles pour vos widgets.
Avant de commencer
Les paramètres sont affichés à l'intérieur des accolades, comme dans l'exemple AQL suivant :
Etant donné que les accolades sont également utilisées dans une instruction AQL à l'intérieur d'une chaîne entre guillemets (composée d'un littéral), vous devez utiliser une barre oblique inversée (\) comme caractère d'échappement avant l'accolade d'ouverture dans une chaîne entre guillemets. Cette syntaxe garantit que la chaîne entre guillemets n'est pas interprétée comme un paramètre et ne provoque pas de résultats de requête incorrects. Si vous avez une barre oblique inversée dans une chaîne citée, ajoutez une barre oblique inversée supplémentaire comme caractère d'échappement.
Procédure
- A partir d'un tableau de bord qui contient des widgets basés sur AQL ou sur une API générique, tels que le tableau de bord Evénements et métriques de flux , cliquez sur le menu du tableau de bord ().
La fenêtre Gérer les valeurs de paramètre affiche les paramètres déjà créés dans votre espace de travail. Si l'un des paramètres a des valeurs par défaut, il est répertorié dans la colonne Valeur par défaut . La colonne Nombre d'occurrences indique le nombre de widgets qui utilisent chaque paramètre. Passez la souris sur le chiffre pour voir quels widgets utilisent ce paramètre.
- Pour définir une valeur par défaut pour un paramètre, cliquez sur l'icône Plus d'options , entrez la valeur par défaut dans la zone , puis cliquez sur Sauvegarder.
Remarques :
- Cette action définit la valeur par défaut pour chaque widget qui utilise le paramètre, et la carte Paramètres est automatiquement mise à jour. Vous pouvez également ajouter une valeur pour le paramètre dans des widgets spécifiques.
- Lorsque vous modifiez la valeur par défaut d'un paramètre, vous modifiez la valeur partout où le paramètre est utilisé dans votre espace de travail, sauf dans les tableaux de bord et les widgets développés ou épinglés. Si vous ne définissez pas la valeur comme valeur par défaut, la modification mise à jour s'applique uniquement à la session en cours. Toutefois, si vous définissez la valeur comme valeur par défaut, la valeur de la session actuelle utilise également cette valeur.
- Le paramètre prédéfini SYSTEM:username renvoie le nom d'utilisateur de l'utilisateur connecté. Les paramètres du système sont en lecture seule et vous ne pouvez pas modifier la valeur par défaut.
- Le paramètre SYSTEM:timerange prédéfini représente la valeur du sélecteur de temps.
- Pour ajouter un paramètre à votre espace de travail, cliquez sur Ajouter, attribuez un nom et une valeur par défaut au paramètre, puis cliquez sur Sauvegarder.
- Avant de supprimer un paramètre, vérifiez qu'il n'appartient à aucun widget en passant la souris sur le numéro pour voir les noms des widgets qui utilisent ce paramètre. Une fois que vous avez supprimé le paramètre de ces widgets, vous pouvez cliquer sur Supprimer.
- Cliquez sur Retour au tableau de bord pour revenir à la vue principale et poursuivre votre travail.
