Critères de paramètre de texte

Lorsqu’une requête dépend de nombreux paramètres, elle est bloquée jusqu’à ce que chacun de ses paramètres ait été résolu. Parfois, un paramètre peut avoir une requête simple qui concatène une chaîne ou effectue une évaluation conditionnelle. Ces requêtes effectuent toujours des appels réseau aux services qui effectuent ces opérations de base, ce qui augmente le temps nécessaire à un paramètre pour résoudre une valeur. Cela entraîne des temps de chargement longs pour les classeurs complexes.

Lorsque vous utilisez des paramètres de critères, vous pouvez définir un ensemble de critères basés sur des paramètres spécifiés précédemment, qui seront évalués pour fournir une valeur dynamique. Le principal avantage de l'utilisation des paramètres de critères est qu’ils peuvent résoudre les valeurs des paramètres précédemment spécifiés et effectuer des opérations conditionnelles simples sans effectuer d'appels réseau. L’exemple suivant est un cas d’usage de paramètres de critères.

Exemple

Prenons la requête conditionnelle suivante :

let metric = dynamic({Counter});
print tostring((metric.object == 'Network Adapter' and (metric.counter == 'Bytes Received/sec' or metric.counter == 'Bytes Sent/sec')) or (metric.object == 'Network' and (metric.counter == 'Total Bytes Received' or metric.counter == 'Total Bytes Transmitted')))

Si vous vous concentrez sur l’objet metric.counter, la valeur du paramètre isNetworkCounter doit être vraie, si le paramètre Counter a Bytes Received/sec, Bytes Sent/sec, Total Bytes Received ou Total Bytes Transmitted.

Cela peut être traduit en paramètre de critère de texte :

Dans la capture d’écran précédente, les conditions seront évaluées de haut en bas et la valeur du paramètre isNetworkCounter prendra la valeur de la condition qui sera évaluée comme vraie en premier. Toutes les conditions à l’exception de la condition par défaut (la condition « else ») peuvent être réorganisées pour obtenir le résultat souhaité.

Configurer des critères

1. Commencez par un classeur avec au moins un paramètre existant en mode d’édition.

   1. Sélectionnez Ajouter des paramètres>Ajouter un paramètre.
   2. Dans le nouveau volet des paramètres qui apparaît, entrez :
      • Nom du paramètre : rand
      • Type de paramètre : Text
      • Obligatoire : checked
      • Récupérer des données à partir de : Query
      • Saisissez print rand(0-1) dans l'éditeur de requête. Ce paramètre génère une valeur comprise entre 0 et 1.
   3. Sélectionnez Enregistrer pour créer le paramètre.

   Notes

   Le premier paramètre du classeur n’affiche pas l’onglet Critères.

   

2. Dans la table avec le paramètre rand, sélectionnez Ajouter un paramètre.

3. Dans le nouveau volet des paramètres qui apparaît, entrez :

   • Nom du paramètre : randCriteria
   • Type de paramètre : Text
   • Obligatoire : checked
   • Récupérer des données à partir de : Criteria

4. Une grille s’affiche. Sélectionnez Modifier en regard de la zone de texte vide pour ouvrir le formulaire Paramètres des critères. Pour obtenir la description de chaque champ, voir Formulaire Paramètres des critères.

   

5. Entrez les données suivantes pour remplir le premier critère, puis sélectionnez OK :

   • Premier opérande : rand
   • Opérateur : >
   • Valeur de : Static Value
   • Deuxième opérande : 0.25
   • Valeur de : Static Value
   • Résultat : is over 0.25

   

6. Sélectionnez Modifier en regard de la condition Click edit to specify a result for the default condition pour modifier la condition par défaut.

   Notes

   Pour la condition par défaut, tout doit être désactivé à l’exception des derniers champs Value from et Result is.

7. Entrez les données suivantes pour remplir la condition par défaut, puis sélectionnez OK :

   • Valeur de : valeur statique
   • Résultat : est 0,25 ou inférieur

   

8. Enregistrez le paramètre.

9. Actualisez le classeur pour afficher le paramètre randCriteria en action. Sa valeur sera basée sur la valeur de rand.

Formulaire Paramètres des critères

Champs de formulaire	Description
Premier opérande	Cette liste déroulante est composée des noms des paramètres qui ont déjà été créés. La valeur du paramètre sera utilisée sur le côté gauche de la comparaison.
Opérateur	L’opérateur est utilisé pour comparer les premier et deuxième opérandes. Il peut s’agir d’une évaluation numérique ou de chaîne. L'opérateur is empty désactivera Second operand car seul First operand est nécessaire.
Valeur de	Si la valeur est définie sur Parameter, une liste déroulante composée de paramètres qui ont déjà été créés s’affiche. La valeur du paramètre sera utilisée sur le côté droit de la comparaison. Si la valeur est définie sur Static Value, une zone de texte s’affiche, dans laquelle vous pouvez entrer une valeur pour le côté droit de la comparaison.
Deuxième opérande	Il s’agit d’un menu déroulant composé de paramètres créés ou d’une zone de texte en fonction de la sélection Value from précédente.
Valeur de	Si la valeur est définie sur Parameter, une liste déroulante composée de paramètres qui ont déjà été créés s’affiche. La valeur de ce paramètre sera utilisée pour la valeur de retour du paramètre actuel. Si la valeur est Static Value : - Une zone de texte s’affiche, dans laquelle vous pouvez entrer une valeur pour le résultat. - Vous pouvez également déréférencer d’autres paramètres à l’aide d’accolades autour du nom du paramètre. - Il est possible de concaténer plusieurs paramètres et de créer une chaîne personnalisée, par exemple : « {paramA}, {paramB} et une chaîne ». Si la valeur est Expression : - Une zone de texte s’affiche, dans laquelle vous pouvez entrer une expression mathématique qui sera évaluée comme résultat. - Comme dans le cas Static Value, plusieurs paramètres peuvent être déréférencés dans cette zone de texte. - Si la valeur de paramètre référencée dans la zone de texte n’est pas un nombre, elle sera traitée comme la valeur 0.
Le résultat est	Il s’agit d’un menu déroulant composé de paramètres créés ou d’une zone de texte en fonction de la sélection Value from précédente. La zone de texte sera évaluée comme le résultat final du formulaire Paramètres des critères.