Expresiones
Una de las características más potentes de un StyleBook es el uso de expresiones. Puede utilizar las expresiones de 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 denominado
appname y lo concatena con la cadena -mon.
Nota
StyleBook admite el uso de palabras clave reservadas al definir parámetros y expresiones en una definición de StyleBook. Las palabras clave reservadas son:
and, false, in, not, true y or.
Se admiten los siguientes tipos de expresiones:
Expresiones aritméticas
-
Suma (+)
-
Resta (-)
-
Multiplicación (*)
-
División (/)
-
Módulo (%)
Ejemplos:
-
Suma de dos números: $parameters.a + $parameters.b
-
Multiplicar dos números: $parameters.a * 10
-
Hallar el resto de la división de un número por otro:
Resulta en
15%10 5
Expresiones de cadena
-
Concatenar dos cadenas (+)
Ejemplo:
Concatenar dos cadenas: str("app-") + $parameters.appname
Expresiones de lista
Combina dos listas (+)
Ejemplo:
Expresiones relacionales
-
== : Comprueba si dos operandos son iguales y devuelve verdadero si lo son; de lo contrario, devuelve falso.
-
!= : Comprueba si dos operandos son diferentes y devuelve verdadero si lo son; de lo contrario, devuelve falso.
-
\> : Devuelve verdadero si el primer operando es mayor que el segundo operando; de lo contrario, devuelve falso.
-
\>= : Devuelve verdadero si el primer operando es mayor o igual que el segundo operando; de lo contrario, devuelve falso.
-
\< : Devuelve verdadero si el primer operando es menor que el segundo operando; de lo contrario, devuelve falso.
-
\<= : Devuelve verdadero si el primer operando es menor o igual que el segundo operando; de lo contrario, devuelve falso.
Ejemplo:
-
Uso del operador de igualdad:
$parameters.name = = "abcd" -
Uso del operador de desigualdad:
$parameters.name != "default" -
Ejemplos de otros operadores relacionales
-
10 > 9 -
10 >= 10 -
0 < 9 -
10 <= 9 -
10 == 10 -
10 != 1
-
Expresiones lógicas - booleanas
-
and: El operador lógico 'and'. Si ambos operandos son verdaderos, el resultado es verdadero; de lo contrario, es falso.
-
or: El operador lógico 'or'. Si uno de los operandos es verdadero, el resultado es verdadero; de lo contrario, es falso.
-
not: El operador unario. Si el operando es verdadero, el resultado es falso, y viceversa.
-
in: Comprueba si el primer argumento es una subcadena del segundo argumento.
-
in: Comprueba si un elemento forma parte de una lista.
Nota
Puede realizar conversiones de tipo en expresiones donde las cadenas se convierten en números (usando la función incorporada int()) y los números se convierten en cadenas (usando la función incorporada str()). Del mismo modo, puede convertir
tcp-port a un número (usando la función incorporada int()) y una dirección IP se puede convertir a una cadena (usando la función incorporada str()).
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 splat
Una expresión splat
[*] proporciona una forma más sencilla de recuperar un atributo determinado de una lista compleja para todas las iteraciones. Ahora puede incluir expresiones splat en una definición de StyleBook.
Sintaxis:
list[*].attribute
Esta expresión itera sobre todos los elementos de la lista especificada a su izquierda y devuelve el valor del atributo especificado a su derecha.
Cuando desee recuperar una dirección IP o un nombre de host de cada servidor virtual de la lista, puede utilizar las siguientes expresiones splat:
Ejemplo 1:
$parameters.server-members[*].hostname
Esta expresión devuelve una lista de nombres de host de todos los miembros del servidor.
Ejemplo 2:
$parameters.server-members[*].sub-domains[*].name
Esta expresión devuelve una lista de todos los nombres bajo los subdominios de cada miembro del servidor.
Estas expresiones siempre devuelven la lista del tipo de elemento más a la derecha.
Expresiones de cadena literal
Puede usar cadenas literales cuando los caracteres especiales de una cadena deben tomar su forma literal. Estas cadenas pueden contener caracteres de escape, barras invertidas, comillas, paréntesis, espacios en blanco, corchetes, etc. En las cadenas literales, se omite la interpretación habitual de los caracteres especiales. Todos los caracteres de la cadena se conservan en su forma literal.
En StyleBooks, puede incluir expresiones de política de NetScaler en su forma literal utilizando cadenas literales. Las expresiones de política suelen contener caracteres especiales. Sin cadenas literales, tendría que escapar los caracteres especiales dividiendo las cadenas en subcadenas.
Para crear una cadena literal, encapsule una cadena entre caracteres especiales de la siguiente manera:
~{string}~
Puede usar cadenas literales en las expresiones de 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=")}~
Para obtener más información, consulte Permitir caracteres especiales con su forma literal en StyleBooks.
Expresiones de destino
En una definición de StyleBook, puede usar la expresión
$current-target para hacer referencia a la instancia de NetScaler de destino actual. Para hacer referencia específicamente a una dirección IP de la instancia de NetScaler de destino, use esta expresión de la siguiente manera:
$current-target.ip
Ejemplo:
components:
-
name: lb-comp
type: ns::lbvserver
properties:
name: $current-target.ip + "-lbvserver"
En este ejemplo, el nombre de
lbvserver utiliza la dirección IP de la instancia de NetScaler de destino.
Validación de tipo de expresión
El motor de StyleBook ahora permite una comprobación de tipos más estricta 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 sí mismo 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 (elemento de repetición, índice de repetición, argumentos de funciones de sustitución) y así sucesivamente se validan en cuanto a su existencia y tipos.
Ejemplo de comprobaciones de tipo:
En el siguiente ejemplo, el tipo esperado de la propiedad de puerto del StyleBook
lbvserver es tcp-port. En NetScaler Console, las validaciones de tipo ocurren en tiempo de compilación (tiempo de importación). El compilador encuentra que la cadena y tcp-port no 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
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:
Cuando importa un StyleBook a NetScaler Console, el compilador identifica las expresiones no válidas y las marca. Como resultado, el StyleBook no se importa a NetScaler Console.
En el siguiente ejemplo, la expresión asignada a la propiedad de nombre en el componente
lb-sg-binding-comp es: $components.lbvserver-comp.properties.lbvservername. Sin embargo, no hay ninguna propiedad llamada lbvservername en el componente 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
Conversión de tipos implícita de tipos de datos
Cuando utiliza expresiones de StyleBook para diferentes tipos de datos, el motor de StyleBook ahora convierte implícitamente el resultado a un tipo de datos apropiado. La conversión de tipos implícita de tipos de datos admite operaciones binarias y asignaciones de valores.
Ejemplos de operaciones binarias:
-
Al sumar (+) dos variables de tipo
stringynumber, el tipo de datos de salida se establece enstring.
$parameters.appname + '_' + $parameters.app_instance_num
-
Al sumar (+) dos variables de tipo
stringyipaddress, el tipo de datos de salida se establece enstring.
$parameters.appname + '_' + $parameters.instance_ip
-
Al sumar (+) dos variables de tipo
ipaddressynumber, el tipo de datos de salida se establece enipaddress.
$parameters.instance_ip + $parameters.number
-
Al restar (-) dos variables de tipo
ipaddressynumber, el tipo de datos de salida se establece enipaddress.
$parameters.instance_ip - $parameters.number
-
Al multiplicar (*) dos variables de tipo
stringynumber, el tipo de datos de salida se establece enstring.
$parameters.dummy_str * $parameters.count
Ejemplos de asignaciones de valores:
-
Si una variable se define como el tipo de datos
string, el valor asignado se convierte al tipo de datos definido.
name: $parameters.port * 3
-
Si una variable se define como el tipo de datos
portnumber, el valor asignado se convierte al tipo de datosportnumbercon excepciones.
port: $index + $parameters.lower_limit
Indexación de listas
Ahora se puede acceder a los elementos de una lista indexándolos directamente:
| Expresión | Descripción |
$components.test-lbs[0] |
Se refiere al primer elemento del componente thetest-lbs |
$components.test-lbs[0].properties.p1 |
Se refiere a la propiedad p1 del primer elemento del componente test-lbs |
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname |
Se refiere a la propiedad servicegroupname del segundo elemento del componente servicegroups, que es una salida del primer elemento del componente lbcomps |
Expresiones de directiva en StyleBooks
La GUI de StyleBooks le permite crear expresiones de directiva de NetScaler® seleccionando elementos de listas, lo que le ayuda a crear expresiones de forma más rápida y precisa.
Las expresiones de directiva en StyleBooks le permiten crear configuraciones flexibles y personalizables. Puede especificar condiciones basadas en varios parámetros, atributos o variables. Las expresiones de directiva se utilizan comúnmente para implementar configuraciones de directivas de NetScaler.
Habilitar el editor de expresiones de directiva en la GUI de StyleBooks
Para que el editor de EPA o de expresiones esté disponible para un parámetro, especifique el atributo de GUI
is_policy_expression en la definición del parámetro. Cuando está habilitada (establecida en true), esta configuración le permite invocar el Editor de expresiones al introducir un valor para este parámetro.
parameters:
-
name: expression
type: string
label: Expression
required: true
gui:
is_policy_expression: true
Crear y generar expresiones de directiva
-
Vaya a Aplicaciones > Configuraciones > StyleBooks. La página StyleBooks muestra todos los StyleBooks disponibles en su NetScaler Console.
-
Seleccione un StyleBook que incluya expresiones de directiva en sus parámetros.
-
Haga clic en Crear configuración. En la página Crear configuración, introduzca los valores de todos los parámetros definidos en este StyleBook.
-
Haga clic en el icono junto al campo Expresiones. Aparecerá la página Crear una expresión.

-
En Crear una expresión, utilice los menús desplegables intuitivos para construir su expresión de directiva. Haga clic en Enviar.
Si desea crear una expresión de directiva personalizada, haga clic en Editor de EPA o Editor de expresiones para crear sus expresiones. Revise sus expresiones en Previsualizar expresiones y, a continuación, haga clic en Enviar. -
Seleccione la instancia de NetScaler de destino en la que se debe implementar la configuración y haga clic en Submit.
