Expressions
L'une des fonctionnalités les plus puissantes d'un StyleBook est l'utilisation d'expressions. Vous pouvez utiliser les expressions StyleBooks dans divers scénarios pour calculer des valeurs dynamiques. L'exemple suivant est une expression pour concaténer une valeur de paramètre avec une chaîne de caractères littérale.
Exemple :
$parameters.appname + "-mon"
Cette expression récupère le paramètre nommé
appname et le concatène avec la chaîne -mon.
Remarque
StyleBook prend en charge l'utilisation des mots-clés réservés lorsque vous définissez des paramètres et des expressions dans une définition StyleBook. Les mots-clés réservés sont -
and, false, in, not, true et or.
Les types d'expressions suivants sont pris en charge :
Expressions arithmétiques
-
Addition (+)
-
Soustraction (-)
-
Multiplication (*)
-
Division (/)
-
Modulo (%)
Exemples :
-
Ajout de deux nombres : $parameters.a + $parameters.b
-
Multiplication de deux nombres : $parameters.a * 10
-
Recherche du reste après la division d'un nombre par un autre :
15%10 donne 5
Expressions de chaîne
-
Concaténer deux chaînes (+)
Exemple :
Concaténer deux chaînes : str("app-") + $parameters.appname
Expressions de liste
Fusionne deux listes (+)
Exemple :
Expressions relationnelles
-
== : Teste si deux opérandes sont égaux et renvoie vrai s'ils sont égaux, sinon renvoie faux.
-
!= : Teste si deux opérandes sont différents et renvoie vrai s'ils sont différents, sinon renvoie faux.
-
\> : Renvoie vrai si le premier opérande est supérieur au second opérande, sinon renvoie faux.
-
\>= : Renvoie vrai si le premier opérande est supérieur ou égal au second opérande, sinon renvoie faux.
-
\< : Renvoie vrai si le premier opérande est inférieur au second opérande, sinon renvoie faux.
-
\<= : Renvoie vrai si le premier opérande est inférieur ou égal au second opérande, sinon renvoie faux.
Exemple :
-
Utilisation de l'opérateur d'égalité :
$parameters.name = = "abcd" -
Utilisation de l'opérateur d'inégalité :
$parameters.name != "default" -
Exemples pour d'autres opérateurs relationnels
-
10 > 9 -
10 >= 10 -
0 < 9 -
10 <= 9 -
10 == 10 -
10 != 1
-
Expressions logiques - booléennes
-
et : L'opérateur logique 'et'. Si les deux opérandes sont vrais, le résultat est vrai, sinon il est faux.
-
ou : L'opérateur logique 'ou'. Si l'un des opérandes est vrai, le résultat est vrai, sinon il est faux.
-
non : L'opérateur unaire. Si l'opérande est vrai, le résultat est faux, et inversement.
-
in : Teste si le premier argument est une sous-chaîne du second argument
-
in : Teste si un élément fait partie d'une liste
Remarque
Vous pouvez transtyper des expressions où les chaînes sont converties en nombres (à l'aide de la fonction intégrée int()) et les nombres sont convertis en chaînes (à l'aide de la fonction intégrée str()). De même, vous pouvez transtyper
tcp-port en nombre (à l'aide de la fonction intégrée int()), et une adresse IP peut être transtypée en chaîne (à l'aide de la fonction intégrée str()).
Utilisez un délimiteur avant et après tout opérateur. Vous pouvez utiliser les délimiteurs suivants :
-
Avant un opérateur :
space,tab,comma,(,),[,] -
Après un opérateur :
space,tab,(,[
Par exemple :
-
abc + def -
100 % 10 -
10 > 9 -
$item in $parameters.some-list
Expressions splat
Une expression splat
[*] offre un moyen plus simple de récupérer un certain attribut d'une liste complexe pour toutes les itérations. Vous pouvez désormais inclure des expressions splat dans une définition StyleBook.
Syntaxe :
list[*].attribute
Cette expression itère sur tous les éléments de la liste spécifiée à sa gauche et renvoie la valeur d'attribut spécifiée à sa droite.
Lorsque vous souhaitez récupérer une adresse IP ou un nom d'hôte de chaque serveur virtuel de la liste, vous pouvez utiliser les expressions splat suivantes :
Exemple 1 :
$parameters.server-members[*].hostname
Cette expression renvoie une liste de noms d'hôtes de tous les membres du serveur.
Exemple 2 :
$parameters.server-members[*].sub-domains[*].name
Cette expression renvoie une liste de tous les noms sous les sous-domaines de chaque membre du serveur.
Ces expressions renvoient toujours la liste du type d'élément le plus à droite.
Expressions de chaînes littérales
Vous pouvez utiliser des chaînes littérales lorsque des caractères spéciaux dans une chaîne doivent prendre leur forme littérale. Ces chaînes peuvent contenir des caractères d'échappement, des barres obliques inverses, des guillemets, des parenthèses, des espaces, des crochets, etc. Dans les chaînes littérales, l'interprétation habituelle des caractères spéciaux est ignorée. Tous les caractères de la chaîne sont conservés dans leur forme littérale.
Dans les StyleBooks, vous pouvez inclure des expressions de stratégie NetScaler sous leur forme littérale en utilisant des chaînes littérales. Les expressions de stratégie contiennent généralement des caractères spéciaux. Sans chaînes littérales, vous devez échapper les caractères spéciaux en divisant les chaînes en sous-chaînes.
Pour créer une chaîne littérale, encapsulez une chaîne entre des caractères spéciaux comme suit :
~{string}~
Vous pouvez utiliser des chaînes littérales dans les expressions StyleBook.
Remarque
N'utilisez pas la séquence de caractères
}~ dans une chaîne d'entrée, car cette séquence indique la fin d'une chaîne littérale.
Exemple :
~{HTTP.REQ.COOKIE.VALUE("jsessionid") ALT HTTP.REQ.URL.BEFORE_STR("=").AFTER_STR(";jsessionid=") ALT HTTP.REQ.URL.AFTER_STR(";jsessionid=")}~
Pour plus d'informations, consultez Autoriser les caractères spéciaux sous leur forme littérale dans les StyleBooks.
Expressions cibles
Dans une définition de StyleBook, vous pouvez utiliser l'expression
$current-target pour faire référence à l'instance NetScaler cible actuelle. Pour faire spécifiquement référence à une adresse IP de l'instance NetScaler cible, utilisez cette expression comme suit :
$current-target.ip
Exemple :
components:
-
name: lb-comp
type: ns::lbvserver
properties:
name: $current-target.ip + "-lbvserver"
Dans cet exemple, le nom de
lbvserver utilise l'adresse IP de l'instance NetScaler cible.
Validation du type d'expression
Le moteur StyleBook permet désormais une vérification de type plus stricte au moment de la compilation, c'est-à-dire que les expressions utilisées lors de l'écriture du StyleBook sont validées lors de l'importation d'un StyleBook lui-même plutôt que lors de la création du pack de configuration.
Toutes les références aux paramètres, substitutions, composants, propriétés des composants, sorties des composants, variables définies par l'utilisateur (repeat-item, repeat-index, arguments des fonctions de substitution) et ainsi de suite sont toutes validées quant à leur existence et leurs types.
Exemple de vérifications de type :
Dans l'exemple suivant, le type attendu de la propriété de port du StyleBook
lbvserver est tcp-port. Dans NetScaler Console, les validations de type se produisent au moment de la compilation (importation). Le compilateur constate que la chaîne et tcp-port ne sont pas des types compatibles et, par conséquent, le compilateur StyleBook affiche une erreur et ne parvient pas à importer ou à migrer un StyleBook.
components:
-
name: lbvserver-comp
type: ns::lbvserver
properties:
name: mylb
ipv46: 10.102.190.15
port: str("80")
servicetype: HTTP
Pour compiler ce StyleBook avec succès, déclarez ce qui suit comme un nombre dans le compilateur :
port: 80
Exemple de signalement d'expressions invalides :
Lorsque vous importez un StyleBook dans NetScaler Console, le compilateur identifie les expressions invalides et les signale. Par conséquent, l'importation du StyleBook dans NetScaler Console échoue.
Dans l'exemple suivant, l'expression attribuée à la propriété de nom dans le composant
lb-sg-binding-comp est : $components.lbvserver-comp.properties.lbvservername. Cependant, il n'y a pas de propriété appelée lbvservername dans le composant lbvserver-comp.
Components:
-
name: lbvserver-comp
type: ns::lbvserver
properties:
name: mylb
ipv46: 10.102.190.15
port: 80
servicetype: HTTP
-
name: sg-comp
type: ns::servicegroup
properties:
servicegroupname: mysg
servicetype: HTTP
-
name: lb-sg-binding-comp
type: ns::lbvserver_servicegroup_binding
condition: $parameters.create-binding
properties:
name: $components.lbvserver-comp.properties.lbvservername
servicegroupname: $components.sg-comp.properties.servicegroupname
Transtypage implicite des types de données
Lorsque vous utilisez des expressions StyleBook pour différents types de données, le moteur StyleBook transtype désormais implicitement la sortie vers un type de données approprié. Le transtypage implicite des types de données prend en charge les opérations binaires et les affectations de valeurs.
Exemples d'opérations binaires :
-
L'ajout (+) de deux variables de type
stringetnumber, définit le type de données de sortie surstring.
$parameters.appname + '_' + $parameters.app_instance_num
-
L'ajout (+) de deux variables de type
stringetipaddress, définit le type de données de sortie surstring.
$parameters.appname + '_' + $parameters.instance_ip
-
L'ajout (+) de deux variables de type
ipaddressetnumber, définit le type de données de sortie suripaddress.
$parameters.instance_ip + $parameters.number
-
La soustraction (-) de deux variables de type
ipaddressetnumber, définit le type de données de sortie suripaddress.
$parameters.instance_ip - $parameters.number
-
La multiplication (*) de deux variables de type
stringetnumber, définit le type de données de sortie surstring.
$parameters.dummy_str * $parameters.count
Exemples d'affectations de valeurs :
-
Si une variable est définie comme le type de données
string, la valeur attribuée est convertie au type de données défini.
name: $parameters.port * 3
-
Si une variable est définie comme le type de données
portnumber, la valeur attribuée est convertie au type de donnéesportnumberavec des exceptions.
port: $index + $parameters.lower_limit
Indexation des listes
Les éléments d'une liste peuvent désormais être accédés en les indexant directement :
| Expression | Description |
$components.test-lbs[0] |
Fait référence au premier élément du composant thetest-lbs |
$components.test-lbs[0].properties.p1 |
Fait référence à la propriété p1 du premier élément du composant test-lbs |
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname |
Fait référence à la propriété servicegroupname du deuxième élément du composant servicegroups, qui est une sortie du premier élément du composant lbcomps |
Expressions de stratégie dans les StyleBooks
L'interface graphique des StyleBooks vous permet de créer des expressions de stratégie NetScaler® en sélectionnant des éléments dans des listes, ce qui vous aide à créer des expressions plus rapidement et plus précisément.
Les expressions de stratégie dans les StyleBooks vous permettent de créer des configurations flexibles et personnalisables. Vous pouvez spécifier des conditions basées sur divers paramètres, attributs ou variables. Les expressions de stratégie sont couramment utilisées pour implémenter les configurations de stratégie NetScaler.
Activer l'éditeur d'expressions de stratégie dans l'interface graphique des StyleBooks
Pour rendre l'éditeur EPA ou d'expressions disponible pour un paramètre, spécifiez l'attribut d'interface graphique
is_policy_expression dans la définition du paramètre. Lorsqu'il est activé (défini sur true), ce paramètre vous permet d'invoquer l'éditeur d'expressions lors de la saisie d'une valeur pour ce paramètre.
parameters:
-
name: expression
type: string
label: Expression
required: true
gui:
is_policy_expression: true
Créer et élaborer des expressions de stratégie
-
Accédez à Applications > Configurations > StyleBooks. La page StyleBooks affiche tous les StyleBooks disponibles dans votre NetScaler Console.
-
Sélectionnez un StyleBook qui inclut des expressions de stratégie dans ses paramètres.
-
Cliquez sur Créer une configuration. Dans la page Créer une configuration, saisissez les valeurs de tous les paramètres définis dans ce StyleBook.
-
Cliquez sur l'icône à côté du champ Expressions. La page Créer une expression s'affiche.Créer une configuration avec des expressions(/en-us/netscaler-console-service/media/stylebooks-expression-create.png)
-
Dans Créer une expression, utilisez les listes déroulantes intuitives pour construire votre expression de stratégie. Cliquez sur Soumettre.Éditeur d'expressions(/en-us/netscaler-console-service/media/stylebooks-expression-editor.png)Si vous souhaitez créer une expression de stratégie personnalisée, cliquez sur Éditeur EPA ou Éditeur d'expressions pour élaborer vos expressions. Vérifiez vos expressions dans Aperçu des expressions, puis cliquez sur Soumettre.
-
Sélectionnez l'instance NetScaler cible sur laquelle la configuration doit être déployée et cliquez sur Soumettre.
