Ausdrücke

Last published : Oct 02, 2026
Eines der leistungsstärksten Merkmale eines StyleBooks ist die Verwendung von Ausdrücken. Sie können StyleBook-Ausdrücke in verschiedenen Szenarien verwenden, um dynamische Werte zu berechnen. Das folgende Beispiel ist ein Ausdruck, um einen Parameterwert mit einer Literalzeichenfolge zu verketten.
Beispiel:
$parameters.appname + "-mon"
Dieser Ausdruck ruft den Parameter mit dem Namen appname ab und verkettet ihn mit der Zeichenfolge -mon.
Hinweis
StyleBook unterstützt die Verwendung der reservierten Schlüsselwörter, wenn Sie Parameter und Ausdrücke in einer StyleBook-Definition definieren. Die reservierten Schlüsselwörter sind – and, false, in, not, true und or.
Die folgenden Arten von Ausdrücken werden unterstützt:

Arithmetische Ausdrücke

  • Addition (+)
  • Subtraktion (-)
  • Multiplikation (*)
  • Division (/)
  • Modulo (%)
Beispiele:
  • Addieren von zwei Zahlen: $parameters.a + $parameters.b
  • Multiplikation zweier Zahlen: $parameters.a * 10
  • Ermitteln des Rests nach der Division einer Zahl durch eine andere:
15%10 Ergibt 5

Zeichenfolgenausdrücke

  • Zwei Zeichenfolgen verketten (+)
Beispiel:
Zwei Zeichenfolgen verketten: str("app-") + $parameters.appname

Listenausdrücke

Führt zwei Listen zusammen (+)
Beispiel:
  • Zwei Listen verketten: $parameters.external-servers + $parameters.internal-servers
  • Wenn $parameters.ports-1 ist und $parameters.port-2 ist, wird $parameters.ports-1 + $parameters.ports-2 als Liste angezeigt.

Relationale Ausdrücke

  • == : Prüft, ob zwei Operanden gleich sind, und gibt „true“ zurück, wenn sie gleich sind, andernfalls „false“.
  • != : Prüft, ob zwei Operanden unterschiedlich sind, und gibt „true“ zurück, wenn sie unterschiedlich sind, andernfalls „false“.
  • \> : Gibt „true“ zurück, wenn der erste Operand größer als der zweite Operand ist, andernfalls „false“.
  • \>= : Gibt „true“ zurück, wenn der erste Operand größer oder gleich dem zweiten Operanden ist, andernfalls „false“.
  • \< : Gibt „true“ zurück, wenn der erste Operand kleiner als der zweite Operand ist, andernfalls „false“.
  • \<= : Gibt „true“ zurück, wenn der erste Operand kleiner oder gleich dem zweiten Operanden ist, andernfalls „false“.
Beispiel:
  • Verwendung des Gleichheitsoperators: $parameters.name = = "abcd"
  • Verwendung des Ungleichheitsoperators: $parameters.name != "default"
  • Beispiele für andere relationale Operatoren
    • 10 > 9
    • 10 >= 10
    • 0 < 9
    • 10 <= 9
    • 10 == 10
    • 10 != 1

Logische Ausdrücke – boolesch

  • and: Der logische 'und'-Operator. Wenn beide Operanden wahr sind, ist das Ergebnis wahr, andernfalls ist es falsch.
  • or: Der logische 'oder'-Operator. Wenn einer der Operanden wahr ist, ist das Ergebnis wahr, andernfalls ist es falsch.
  • not: Der unäre Operator. Wenn der Operand wahr ist, ist das Ergebnis falsch und umgekehrt.
  • in: Prüft, ob das erste Argument eine Teilzeichenfolge des zweiten Arguments ist
  • in: Prüft, ob ein Element Teil einer Liste ist
Hinweis
Sie können Ausdrücke typumwandeln, bei denen Zeichenfolgen in Zahlen (mithilfe der integrierten Funktion int()) und Zahlen in Zeichenfolgen (mithilfe der integrierten Funktion str()) konvertiert werden. Ähnlich können Sie tcp-port in eine Zahl (mithilfe der integrierten Funktion int()) und eine IP-Adresse in eine Zeichenfolge (mithilfe der integrierten Funktion str()) umwandeln.
Verwenden Sie einen Trennzeichen vor und nach jedem Operator. Sie können die folgenden Trennzeichen verwenden:
  • Vor einem Operator: space, tab, comma, (, ), [, ]
  • Nach einem Operator: space, tab, (, [
Zum Beispiel:
  • abc + def
  • 100 % 10
  • 10 > 9
  • $item in $parameters.some-list

Splat-Ausdrücke

Ein Splat-Ausdruck [*] bietet eine einfachere Möglichkeit, ein bestimmtes Attribut aus einer komplexen Liste für alle Iterationen abzurufen. Sie können jetzt Splat-Ausdrücke in eine StyleBook-Definition aufnehmen.
Syntax:
list[*].attribute
Dieser Ausdruck iteriert über alle Elemente der links angegebenen Liste und gibt den rechts angegebenen Attributwert zurück.
Wenn Sie eine IP-Adresse oder einen Hostnamen jedes virtuellen Servers aus der Liste abrufen möchten, können Sie die folgenden Splat-Ausdrücke verwenden:
Beispiel 1:
$parameters.server-members[*].hostname
Dieser Ausdruck gibt eine Liste von Hostnamen aller Servermitglieder zurück.
Beispiel 2:
$parameters.server-members[*].sub-domains[*].name
Dieser Ausdruck gibt eine Liste aller Namen unter den Subdomains jedes Servermitglieds zurück.
Diese Ausdrücke geben immer die Liste des am weitesten rechts stehenden Elementtyps zurück.

Wörtliche Zeichenfolgenausdrücke

Sie können wörtliche Zeichenfolgen verwenden, wenn Sonderzeichen in einer Zeichenfolge ihre wörtliche Form annehmen müssen. Diese Zeichenfolgen können Escape-Zeichen, Backslashes, Anführungszeichen, Klammern, Leerzeichen, eckige Klammern usw. enthalten. Bei wörtlichen Zeichenfolgen wird die übliche Interpretation der Sonderzeichen übersprungen. Alle Zeichen in der Zeichenfolge bleiben in ihrer wörtlichen Form erhalten.
In StyleBooks können Sie NetScaler-Richtlinienausdrücke in ihrer wörtlichen Form mithilfe wörtlicher Zeichenfolgen einfügen. Die Richtlinienausdrücke enthalten typischerweise Sonderzeichen. Ohne wörtliche Zeichenfolgen müssten Sie Sonderzeichen durch Aufteilen von Zeichenfolgen in Unterzeichenfolgen escapen.
Um eine wörtliche Zeichenfolge zu erstellen, schließen Sie eine Zeichenfolge wie folgt zwischen Sonderzeichen ein:
~{string}~
Sie können wörtliche Zeichenfolgen in den StyleBook-Ausdrücken verwenden.
Hinweis
Verwenden Sie die Zeichenfolge }~ nicht in einer Eingabezeichenfolge, da diese Sequenz das Ende einer wörtlichen Zeichenfolge anzeigt.
Beispiel:
~{HTTP.REQ.COOKIE.VALUE("jsessionid") ALT HTTP.REQ.URL.BEFORE_STR("=").AFTER_STR(";jsessionid=") ALT HTTP.REQ.URL.AFTER_STR(";jsessionid=")}~
Weitere Informationen finden Sie unter Sonderzeichen in ihrer wörtlichen Form in StyleBooks zulassen.

Zielausdrücke

In einer StyleBook-Definition können Sie den Ausdruck $current-target verwenden, um auf die aktuelle Ziel-NetScaler-Instanz zu verweisen. Um speziell auf eine IP-Adresse der Ziel-NetScaler-Instanz zu verweisen, verwenden Sie diesen Ausdruck wie folgt:
$current-target.ip
Beispiel:
components:
 -
  name: lb-comp
  type: ns::lbvserver
  properties:
    name: $current-target.ip + "-lbvserver"
In diesem Beispiel verwendet der Name des lbvserver die IP-Adresse der Ziel-NetScaler-Instanz.

Validierung des Ausdruckstyps

Die StyleBook-Engine ermöglicht jetzt eine strengere Typüberprüfung zur Kompilierungszeit, d. h. die beim Schreiben des StyleBooks verwendeten Ausdrücke werden beim Import eines StyleBooks selbst und nicht beim Erstellen des Konfigurationspakets validiert.
Alle Verweise auf Parameter, Substitutionen, Komponenten, Eigenschaften von Komponenten, Ausgaben von Komponenten, benutzerdefinierte Variablen (repeat-item, repeat-index, Argumente für Substitutionsfunktionen) usw. werden auf ihre Existenz und Typen validiert.
Beispiel für Typüberprüfungen:
Im folgenden Beispiel ist der erwartete Typ der Port-Eigenschaft des lbvserver StyleBooks tcp-port. In NetScaler Console erfolgen die Typvalidierungen zur Kompilierungszeit (Importzeit). Der Compiler stellt fest, dass String und tcp-port keine kompatiblen Typen sind, und daher zeigt der StyleBook-Compiler einen Fehler an und kann ein StyleBook nicht importieren oder migrieren.

components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    properties:
      name: mylb
      ipv46: 10.102.190.15
      port: str("80")
      servicetype: HTTP
Um dieses StyleBook erfolgreich zu kompilieren, deklarieren Sie Folgendes als Zahl im Compiler:
port: 80
Beispiel für die Kennzeichnung ungültiger Ausdrücke:
Wenn Sie ein StyleBook in die NetScaler Console importieren, identifiziert der Compiler die ungültigen Ausdrücke und kennzeichnet sie. Infolgedessen kann das StyleBook nicht in die NetScaler Console importiert werden.
Im folgenden Beispiel ist der Ausdruck, der der Name-Eigenschaft in der Komponente lb-sg-binding-comp zugewiesen ist: $components.lbvserver-comp.properties.lbvservername. Es gibt jedoch keine Eigenschaft namens lbvservername in der Komponente 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

Implizite Typumwandlung von Datentypen

Wenn Sie StyleBook-Ausdrücke für verschiedene Datentypen verwenden, wandelt die StyleBook-Engine die Ausgabe nun implizit in einen geeigneten Datentyp um. Die implizite Typumwandlung von Datentypen unterstützt binäre Operationen und Wertzuweisungen.
Beispiele für binäre Operationen:
  • Das Addieren (+) zweier Variablen vom Typ string und number setzt den Ausgabedatentyp auf string.
$parameters.appname + '_' + $parameters.app_instance_num
  • Das Addieren (+) zweier Variablen vom Typ string und ipaddress setzt den Ausgabedatentyp auf string.
$parameters.appname + '_' + $parameters.instance_ip
  • Das Addieren (+) zweier Variablen vom Typ ipaddress und number setzt den Ausgabedatentyp auf ipaddress.
$parameters.instance_ip + $parameters.number
  • Das Subtrahieren (-) zweier Variablen vom Typ ipaddress und number setzt den Ausgabedatentyp auf ipaddress.
$parameters.instance_ip - $parameters.number
  • Das Multiplizieren (*) zweier Variablen vom Typ string und number setzt den Ausgabedatentyp auf string.
$parameters.dummy_str * $parameters.count
Beispiele für Wertzuweisungen:
  • Wenn eine Variable als string Datentyp definiert ist, wird der zugewiesene Wert in den definierten Datentyp konvertiert.
name: $parameters.port * 3
  • Wenn eine Variable als portnumber Datentyp definiert ist, wird der zugewiesene Wert mit Ausnahmen in den portnumber Datentyp konvertiert.
port: $index + $parameters.lower_limit

Listen indizieren

Elemente einer Liste können nun direkt durch Indizierung aufgerufen werden:
Ausdruck Beschreibung
$components.test-lbs[0] Bezieht sich auf das erste Element in der thetest-lbs Komponente
$components.test-lbs[0].properties.p1 Bezieht sich auf die Eigenschaft p1 des ersten Elements in der test-lbs Komponente
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname Bezieht sich auf die Eigenschaft servicegroupname des zweiten Elements in der Komponente servicegroups, die eine Ausgabe des ersten Elements der Komponente lbcomps ist.

Richtlinienausdrücke in StyleBooks

Die StyleBooks-GUI ermöglicht es Ihnen, NetScaler®-Richtlinienausdrücke zu erstellen, indem Sie Elemente aus Listen auswählen, was Ihnen hilft, Ausdrücke schneller und genauer zu erstellen.
Richtlinienausdrücke in StyleBooks ermöglichen Ihnen die Erstellung flexibler und anpassbarer Konfigurationen. Sie können Bedingungen basierend auf verschiedenen Parametern, Attributen oder Variablen festlegen. Richtlinienausdrücke werden häufig verwendet, um NetScaler-Richtlinienkonfigurationen zu implementieren.

Richtlinien-Ausdruckseditor in der StyleBooks-GUI aktivieren

Um den EPA- oder Ausdruckseditor für einen Parameter verfügbar zu machen, geben Sie das GUI-Attribut is_policy_expression in der Parameterdefinition an. Wenn diese Einstellung aktiviert ist (auf true gesetzt), können Sie den Expressions Editor aufrufen, wenn Sie einen Wert für diesen Parameter eingeben.
parameters:
  -
    name: expression
    type: string
    label: Expression
    required: true
    gui:
      is_policy_expression: true

Richtlinienausdrücke erstellen und aufbauen

  1. Navigieren Sie zu Applications > Configurations > StyleBooks. Die Seite StyleBooks zeigt alle StyleBooks an, die in Ihrer NetScaler Console verfügbar sind.
  2. Wählen Sie ein StyleBook aus, das Richtlinienausdrücke in seinen Parametern enthält.
  3. Klicken Sie auf Create Configuration. Geben Sie auf der Seite Create Configuration Werte für alle in diesem StyleBook definierten Parameter ein.
  4. Klicken Sie auf das Symbol neben dem Feld Expressions. Die Seite Create an expression wird angezeigt.
    Konfiguration mit Ausdrücken erstellen
  5. Verwenden Sie unter Create an expression die intuitiven Dropdown-Menüs, um Ihren Richtlinienausdruck zu erstellen. Klicken Sie auf Submit.
    Ausdruckseditor
    Wenn Sie einen benutzerdefinierten Richtlinienausdruck erstellen möchten, klicken Sie auf EPA Editor oder Expression Editor, um Ihre Ausdrücke zu erstellen. Überprüfen Sie Ihre Ausdrücke unter Preview Expressions und klicken Sie dann auf Submit.
  6. Wählen Sie die Ziel-NetScaler-Instanz aus, auf der die Konfiguration bereitgestellt werden soll, und klicken Sie auf Senden.
    Konfigurationspaket mit Ausdrücken