Ausdrücke

Eines der mächtigsten Funktionen von StyleBook ist die Verwendung von Ausdrücken. Sie können StyleBooks Ausdrücke in verschiedenen Szenarien verwenden, um dynamische Werte zu berechnen. Das folgende Beispiel zeigt einen Ausdruck, um einen Parameterwert mit einer Literalzeichenfolge zu verketten.

Beispiel:

$parameters.appname + -mon

Dieser Ausdruck ruft den Parameter appname ab und verkettet ihn mit der Zeichenfolge -mon.

Die folgenden Ausdruckstypen werden unterstützt:

Arithmetische Ausdrücke

  • Zusatz (+)
  • Substraction (-)
  • Multiplikation (*)
  • Abteilung (/)
  • Modulo (%)

Beispiele:

  • Hinzufügen von zwei Zahlen: $parameters.a + $parameters.b
  • Multiplikation von zwei Zahlen: $parameters.a * 10
  • Den Rest nach der Division einer Nummer durch eine andere finden:

15% 10 Ergebnisse in 5

Zeichenfolgenausdrücke

  • Verketten Sie zwei Strings (+)

Beispiel:

Verketten Sie zwei Strings: str ( app-) + $parameters.appname

Ausdrücke auflisten

Zusammenführen von zwei Listen (+)

Beispiel:

  • Verketten Sie zwei Listen: $parameters.external-servers + $parameters.internal-servers

  • Wenn $parameters.ports-1 ist[80, 81]und $parameters.port-2 ist[81, 82], dann ergibt sich $parameters.ports-1 + $parameters.ports-2 als Liste[80, 81, 81, 82]

Relationale Ausdrücke

  • ==: Prüft, ob zwei Operanden gleich sind und gibt true zurück, wenn sie gleich sind, sonst gibt false zurück.

  • ! =: Prüft, ob zwei Operanden unterschiedlich sind und gibt true zurück, wenn sie unterschiedlich sind, sonst gibt false zurück.

  • : Gibt true zurück, wenn der erste Operand größer als der zweite Operand ist, sonst gibt false zurück.

  • =: Gibt true zurück, wenn der erste Operand größer oder gleich dem zweiten Operanden ist, sonst gibt false zurück.

  • <: Gibt true zurück, wenn der erste Operand kleiner als der zweite Operand ist, sonst gibt false zurück.

  • <=: Gibt true zurück, wenn der erste Operand kleiner oder gleich dem zweiten Operanden ist, sonst gibt false zurück.

Beispiel:

  • Verwendung des Gleichheitsoperators: $parameters.name = abcd
  • Verwendung von Ungleichheitsoperator: $parameters.name! = Standard
  • Beispiele für andere relationale Operatoren
    • 10 > 9
    • 10 >= 10
    • 0 < 9
    • 10 <= 9
    • 10 == 10
    • 10 != 1

Logische (boolesche) Ausdrücke

  • und: Der logische Operator ‘und’. Wenn beide Operanden wahr sind, ist das Ergebnis wahr, sonst ist es falsch.

  • oder: Der logische Operator ‘oder’. Wenn einer der Operanden wahr ist, ist das Ergebnis wahr, sonst ist es falsch.

  • nicht: 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 Umwandlungen eingeben, in denen Zeichenfolgen in Zahlen umgewandelt werden können und Zahlen in Zeichenfolgen konvertiert werden können. Ebenso kann ein tcp-port in eine Zahl umgewandelt werden, und eine IP-Adresse kann in eine Zeichenfolge umgewandelt werden.

Sie müssen ein Trennzeichen vor und nach einem Operator verwenden. Sie können die folgenden Trennzeichen verwenden:

  • Vor einem Operator: Leerzeichen, Tabulator, Komma, (,), [,]

  • Nach einem Operator: space, tab, (, [

  • Zum Beispiel:

  • abc + def

  • 100 % 10

  • 10 > 9

Ausdruckstypvalidierung

StyleBook-Engine ermöglicht jetzt eine stärkere Typprüfung während der Kompilierzeit, dh die beim Schreiben des StyleBook verwendeten Ausdrücke werden während des Imports von StyleBook selbst validiert und nicht beim Erstellen des Konfigurationspakets.

Alle Verweise auf Parameter, Substitutionen, Komponenten, Eigenschaften von Komponenten, Komponentenausgaben, benutzerdefinierte Variablen (repeat-item, repeat-index, Argumente für Substitutionsfunktionen usw.) werden alle auf ihre Existenz und Typen überprüft.

Beispiel für Typprüfungen:

Im folgenden Beispiel lautet der erwartete Typ der Port-Eigenschaft von lbvserver StyleBook tcp-port. In früheren Versionen von Citrix Application Delivery Management (ADM) berechnete der StyleBook-Compiler den Wert als Zeichenfolge, und das StyleBook wurde importiert und ausgeführt. Nun passieren Typvalidierungen zur Kompilierungszeit (Importzeit). Der Compiler stellt fest, dass string und tcp-port nicht kompatible Typen sind und daher der StyleBook-Compiler einen Fehler auslöst und den Import oder die Migration des StyleBook fehlschlägt.

Komponenten:

name: lbvserver-comp

type: ns::lbvserver

properties:

  name: mylb

  ipv46: 10.102.190.15

  port: str("80")

  servicetype: HTTP

Sie sollten dies nun als eine Zahl deklarieren, damit der Compiler dieses StyleBook erfolgreich kompiliert.

port: 80

Beispiel für das Kennzeichnen ungültiger Ausdrücke:

In früheren Versionen hat der Compiler, wenn einem Eigenschaftsnamen ein ungültiger Ausdruck zugewiesen wurde, keine ungültigen Ausdrücke erkannt und die StyleBooks in Citrix ADM importiert werden können. Wenn dieses StyleBook nun in Citrix ADM importiert wird, identifiziert der Compiler solche ungültigen Ausdrücke und kennzeichnet es. Daher wird das StyleBook nicht in Citrix ADM importiert.

In diesem Beispiel lautet der Ausdruck, der der name-Eigenschaft in der lb-sg-binding-comp-Komponente zugewiesen ist: $components.lbvserver-comp.properties.lbvservername. Es gibt jedoch keine Eigenschaft namens lbvservername in der Komponente lbvserver-comp. In früheren Citrix ADM Versionen hätte der Compiler diesen Ausdruck zugelassen und erfolgreich importiert. Der tatsächliche Fehler tritt auf, wenn ein Benutzer ein Konfigurationspaket mit diesem StyleBook erstellen möchte. Diese Art von Fehler wird jedoch beim Import erkannt und das StyleBook wird nicht in Citrix ADM importiert. Sie müssen solche Fehler manuell korrigieren und die StyleBooks importieren.

Komponenten:

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

Indizierungslisten

Auf Elemente einer Liste kann jetzt zugegriffen werden, indem sie direkt indiziert werden:

   
Ausdruck Beschreibung
$components.test-lbs[0] Bezieht sich auf das erste Element in test-lbs Komponente
$components.test-lbs[0].properties.p1 Bezieht sich auf die Eigenschaft p1 des ersten Elements in test-lbs Komponente
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname Bezieht sich auf die Eigenschaft servicegroupname des zweiten Elements in der servicegroups-Komponente, bei der es sich um eine Ausgabe des ersten Elements der lbcomps-Komponente handelt.