Expressions

Dernière publication : Oct 02, 2026
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 :
  • Concaténer deux listes : $parameters.external-servers + $parameters.internal-servers
  • Si $parameters.ports-1 est et $parameters.port-2 est , le $parameters.ports-1 + $parameters.ports-2 s'affiche sous forme de liste .

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=")}~

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 string et number, définit le type de données de sortie sur string.
$parameters.appname + '_' + $parameters.app_instance_num
  • L'ajout (+) de deux variables de type string et ipaddress, définit le type de données de sortie sur string.
$parameters.appname + '_' + $parameters.instance_ip
  • L'ajout (+) de deux variables de type ipaddress et number, définit le type de données de sortie sur ipaddress.
$parameters.instance_ip + $parameters.number
  • La soustraction (-) de deux variables de type ipaddress et number, définit le type de données de sortie sur ipaddress.
$parameters.instance_ip - $parameters.number
  • La multiplication (*) de deux variables de type string et number, définit le type de données de sortie sur string.
$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ées portnumber avec 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

  1. Accédez à Applications > Configurations > StyleBooks. La page StyleBooks affiche tous les StyleBooks disponibles dans votre NetScaler Console.
  2. Sélectionnez un StyleBook qui inclut des expressions de stratégie dans ses paramètres.
  3. 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.
  4. 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)
  5. 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.
  6. Sélectionnez l'instance NetScaler cible sur laquelle la configuration doit être déployée et cliquez sur Soumettre.
    Pack de configuration avec expressions