Citrix Application Delivery Management

Expresiones

Una de las funciones más potentes de un StyleBook es el uso de expresiones. Puede utilizar expresiones StyleBooks en varios escenarios para calcular valores dinámicos. El siguiente ejemplo es una expresión para concatenar un valor de parámetro con una cadena literal.

Ejemplo:

$parameters.appname + "-mon"

Esta expresión recupera el parámetro denominadoappname y lo concatena con la cadena-mon.

Se admiten los siguientes tipos de expresiones:

Expresiones aritméticas

  • Adición (+)
  • Resta (-)
  • Multiplicación (*)
  • División (/)
  • Módulo (%)

Ejemplos:

  • Agregar dos números: $parameters.a + $parameters.b
  • Multiplicando dos números: $parámetros.a * 10
  • Encontrar el resto después de la división de un número por otro:

15%10 Resultados en 5

Expresiones de cadena

  • Concatenar dos cadenas (+)

Ejemplo:

Concatenar dos cadenas: Str (“app-“) + $parameters.appname

Expresiones de lista

Fusiona dos listas (+)

Ejemplo:

  • Concatenar dos listas: $parameters.external-servers + $parameters.internal-servers

  • Si$parameters.ports-1 es[80, 81] y$parameters.port-2 es[81, 82], el $parameters.ports-1 + $parameters.ports-2 se muestra como una lista[80, 81, 81, 82].

Expresiones relacionales

  • == : Comprueba si dos operandos son iguales y devuelve verdadero si son iguales, de lo contrario devuelve false.

  • !=: Comprueba si dos operandos son diferentes y devuelve verdadero si son diferentes, de lo contrario devuelve false.

  • >: Devuelve true si el primer operando es mayor que el segundo operando, de lo contrario devuelve false.

  • >= : Devuelve true si el primer operando es mayor o igual que el segundo operando, de lo contrario devuelve false.

  • < : Devuelve true si el primer operando es menor que el segundo operando, de lo contrario devuelve false.

  • <= : Devuelve true si el primer operando es menor o igual que el segundo operando, de lo contrario devuelve false.

Ejemplo:

  • Uso del operador Igualdad:$parameters.name = = "abcd"
  • Uso del operador Desigualdad:$parameters.name != "default"
  • Ejemplos para otros operadores relacionales

    • 10 > 9
    • 10 >= 10
    • 0 < 9
    • 10 <= 9
    • 10 == 10
    • 10 != 1

Expresiones lógicas: Booleanas

  • y: El operador lógico ‘y’. Si ambos operandos son verdaderos, el resultado es verdadero, de lo contrario es falso.

  • o: El operador lógico ‘o’. Si uno de los operandos es verdadero, el resultado es verdadero, de lo contrario es falso.

  • no: El operador unario. Si el operando es verdadero, el resultado es falso, y al contrario.

  • in: Comprueba si el primer argumento es una subcadena del segundo argumento

  • en: Comprueba si un elemento forma parte de una lista

Nota

Puede escribir expresiones donde las cadenas se convierten en números (usando la función int () incorporada) y los números se convierten en cadenas (usando str () función incorporada). Del mismo modo, puede convertir tcp-port a un número (usando la función int () incorporada), y una dirección IP se puede convertir en una cadena (usando la función str () incorporada).

Utilice un delimitador antes y después de cualquier operador. Puede utilizar los siguientes delimitadores:

  • Antes de un operador: space, tab, comma, (, ), [, ]

  • Después de un operador:space,tab,(,[

Por ejemplo:

  • abc + def

  • 100 % 10

  • 10 > 9

  • $item in $parameters.some-list

Expresiones de cadena Verbatim

Puede usar cadenas verbatim cuando los caracteres especiales de una cadena tienen que tomar su forma literal. Estas cadenas pueden contener caracteres de escape, barra diagonal inversa, comillas, paréntesis, espacios en blanco, corchetes, etc. En las cadenas literales, se omite la interpretación habitual de los personajes especiales. Todos los caracteres de la cadena se conservan en su forma literal.

En StyleBooks, puede incluir Citrix ADC Policy Expressions en su forma literal mediante cadenas verbatim. Las expresiones de directiva suelen contener caracteres especiales. Sin cadenas literales, debe escapar de caracteres especiales dividiendo cadenas en subcadenas.

Para crear una cadena literal, encapsula una cadena entre caracteres especiales de la siguiente manera:

~{string}~
<!--NeedCopy-->

Puede utilizar cadenas literales en las expresiones StyleBook.

Nota

No utilice la secuencia de caracteres }~ en una cadena de entrada porque esta secuencia indica el final de una cadena literal.

Ejemplo:

 ~{HTTP.REQ.COOKIE.VALUE("jsessionid") ALT HTTP.REQ.URL.BEFORE_STR("=").AFTER_STR(";jsessionid=") ALT HTTP.REQ.URL.AFTER_STR(";jsessionid=")}~
<!--NeedCopy-->

Concatenar varias cadenas literales

Puede concatenar cadenas literales con las cadenas regulares o cadenas con interpolaciones. Cuando lo hace, el StyleBook omite la interpretación sólo para las cadenas literales. Utilice el operador más (+) entre las cadenas para concatenar.

Ejemplo:

value: "~{"id": "}~ + %{$atom.key}% + ~{", "value": "}~ + %{$atom.value}% + ~{"}~"
<!--NeedCopy-->

En este ejemplo, %{$atom.key}% y %{$atom.value}% se interpretan. Y, la interpretación se omite para el resto.

Expresiones de destino

En una definición de StyleBook, puede utilizar la $current-target expresión para hacer referencia a la instancia ADC de destino actual. Para referirse específicamente a una dirección IP de la instancia ADC de destino, utilice esta expresión de la siguiente manera:

$current-target.ip
<!--NeedCopy-->

Ejemplo:

components:
 -
  name: lb-comp
  type: ns::lbvserver
  properties:
    name: $current-target.ip + "-lbvserver"
<!--NeedCopy-->

En este ejemplo, el nombre de la lbvserver utiliza la dirección IP de la instancia ADC de destino.

Validación de tipo de expresión

El motor StyleBook ahora permite una comprobación de tipo más eficaz durante el tiempo de compilación, es decir, las expresiones utilizadas al escribir el StyleBook se validan durante la importación de un StyleBook en lugar de al crear el paquete de configuración.

Todas las referencias a parámetros, sustituciones, componentes, propiedades de componentes, salidas de componentes, variables definidas por el usuario (repetiat-item, repetiat-index, argumentos a funciones de sustitución) y así sucesivamente se validan para su existencia y tipos.

Ejemplo de comprobaciones de tipo:

En el siguiente ejemplo, el tipo esperado de propiedad port delbvserver StyleBook estcp-port. En Citrix Application Delivery Management (ADM), las validaciones de tipos ocurren en tiempo de compilación (tiempo de importación). El compilador encuentra esa cadena y notcp-port son tipos compatibles y, por lo tanto, el compilador de StyleBook muestra un error y no puede importar o migrar un StyleBook.


components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    properties:
      name: mylb
      ipv46: 10.102.190.15
      port: str("80")
      servicetype: HTTP
<!--NeedCopy-->

Para compilar correctamente este StyleBook, declare lo siguiente como un número en el compilador:

port: 80

Ejemplo de marcado de expresiones no válidas:

En versiones anteriores, cuando se asignó una expresión no válida a un nombre de propiedad, el compilador no detectó expresiones no válidas y permitió que los StyleBooks se importaran en Citrix ADM. Ahora, si este StyleBook se importa a Citrix ADM, el compilador identifica dichas expresiones no válidas y la marca. Como resultado, el StyleBook no puede importar a Citrix ADM.

En este ejemplo, la expresión asignada a la propiedad name del lb-sg-binding-comp componente es: $components.lbvserver-comp.properties.lbvservername. Sin embargo, no hay ninguna propiedad llamada lbvservername en el componente lbvserver-comp. En versiones anteriores de Citrix ADM, el compilador habría permitido esta expresión y la habría importado correctamente. El error real ocurriría cuando un usuario quiere crear un paquete de configuración usando este StyleBook. Sin embargo, ahora, este tipo de error se identifica durante la importación y el StyleBook no se importa a Citrix ADM. Corrija manualmente estos errores e importe los StyleBooks.

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
<!--NeedCopy-->

Listas de indización

Los elementos de una lista se pueden acceder ahora indexándolos directamente:

   
Expresión Descripción
$components.test-lbs[0] Hace referencia al primer elemento del thetest-lbs componente
$components.test-lbs[0].properties.p1 Hace referencia a la propiedad p1 del primer elemento del componente test-lbs
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname Hace referencia a la propiedad servicegroupname del segundo elemento del servicegroups componente, que es una salida del primer elemento del lbcomps componente