20. Funciones y variables ¶

La función Regex se usa para analizar la respuesta anterior (o el valor de una variable) usando cualquier expresión regular (proporcionada por el usuario). La función devuelve la cadena de la plantilla con los valores de las variables rellenados.

La __regexFunction también puede almacenar valores para uso futuro. En el sexto parámetro, puede especificar un nombre de referencia. Después de ejecutar esta función, los mismos valores se pueden recuperar en momentos posteriores utilizando la sintaxis para valores definidos por el usuario. Por ejemplo, si ingresa " refName " como sexto parámetro, podrá usar:

• ${refName} para hacer referencia al resultado calculado del segundo parámetro ("Plantilla para la cadena de reemplazo") analizado por esta función
• ${refName_g0} para hacer referencia a la coincidencia completa analizada por esta función.
• ${refName_g1} para hacer referencia al primer grupo analizado por esta función.
• ${refName_g#} para hacer referencia al ^enésimo grupo analizado por esta función.
• ${refName_matchNr} para referirse al número de grupos encontrados por esta función.

El contador genera un nuevo número cada vez que se llama, comenzando con 1 e incrementando en +1 cada vez. El contador se puede configurar para mantener separados los valores de cada usuario simulado o para usar el mismo contador para todos los usuarios. Si los valores de cada usuario se incrementan por separado, es como contar el número de iteraciones a través del plan de prueba. Un contador global es como contar cuántas veces se ejecutó esa solicitud.

El contador usa una variable entera para mantener el conteo, que por lo tanto tiene un máximo de 2,147,483,647.

Las instancias de la función de contador son completamente independientes. El contador global - " FALSO " - es mantenido por separado por cada instancia de contador.

Múltiples llamadas a la función __counter en la misma iteración no incrementarán más el valor.
Si desea tener un conteo que aumente para cada muestra, use la función en un preprocesador como Parámetros de usuario .

La función de número de subproceso simplemente devuelve el número del subproceso que se está ejecutando actualmente. Estos números son únicos localmente con respecto a su grupo de subprocesos, lo que significa que el subproceso n.º 1 en un grupo de subprocesos no se puede distinguir del subproceso n.º 1 en otro grupo de subprocesos, desde el punto de vista de esta función.

ctx.getThreadNum()

No hay argumentos para esta función.

Ejemplo de uso:

${__número de subprocesos}

La función de nombre de grupo de subprocesos simplemente devuelve el nombre del grupo de subprocesos que se está ejecutando.

No hay argumentos para esta función.

Ejemplo de uso:

${__nombre de grupo de subprocesos}

La función intSum se puede utilizar para calcular la suma de dos o más valores enteros.

La función longSum se puede usar para calcular la suma de dos o más valores largos, use esto en lugar de __intSum siempre que sepa que sus valores no estarán en el intervalo -2147483648 a 2147483647.

La función StringFromFile se puede utilizar para leer cadenas de un archivo de texto. Esto es útil para ejecutar pruebas que requieren muchos datos variables. Por ejemplo, al probar una aplicación bancaria, es posible que se requieran 100 o 1000 de diferentes números de cuenta.

Consulte también el elemento de prueba CSV Data Set Config que puede ser más fácil de usar. Sin embargo, eso actualmente no admite múltiples archivos de entrada.

Cada vez que se llama, lee la siguiente línea del archivo. Todos los subprocesos comparten la misma instancia, por lo que subprocesos diferentes obtendrán líneas diferentes. Cuando se llega al final del archivo, comenzará a leerse nuevamente desde el principio, a menos que se haya alcanzado el número máximo de bucles. Si hay varias referencias a la función en un script de prueba, cada una abrirá el archivo de forma independiente, incluso si los nombres de archivo son los mismos. [Si el valor se va a usar nuevamente en otro lugar, use diferentes nombres de variables para cada llamada de función].

Si se produce un error al abrir o leer el archivo, la función devuelve la cadena " **ERR** "

La función machineName devuelve el nombre de host local. Esto usa el método Java InetAddress.getLocalHost() y lo pasa a getHostName()

La función machineIP devuelve la dirección IP local. Esto usa el método Java InetAddress.getLocalHost() y lo pasa a getHostAddress()

La función javaScript ejecuta una pieza de código JavaScript (¡no Java!) y devuelve su valor

La función JMeter Javascript llama a un intérprete de JavaScript independiente. Javascript se utiliza como lenguaje de secuencias de comandos, por lo que puede hacer cálculos, etc.

Las siguientes variables están disponibles para el script:

• log - el Registrador para la función
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• threadName - Cadena que contiene el nombre del hilo actual
• sampler - objeto Sampler actual (si lo hay)
• sampleResult : objeto SampleResult anterior (si lo hay)
• props - objeto JMeterProperties (clase java.util.Properties )

Rhinoscript permite el acceso a métodos estáticos a través de su objeto Packages. Consulte la documentación de Scripting Java . Por ejemplo, se puede acceder a los métodos estáticos de JMeterContextService así: Java.type("org.apache.jmeter.threads.JMeterContextService").getTotalThreads()

La función aleatoria devuelve un número aleatorio que se encuentra entre los valores mínimo y máximo dados.

La función RandomDate devuelve una fecha aleatoria que se encuentra entre los valores de fecha de inicio y fecha de finalización dados.

La función RandomString devuelve una cadena aleatoria de longitud usando caracteres en chars para usar.

La función RandomFromMultipleVars devuelve un valor aleatorio basado en los valores de variable proporcionados por Source Variables .

• Extractor de límites
• Extractor de expresiones regulares
• Extractor de selección de CSS
• Extractor JSON
• Extractor de XPath
• Extractor XPath2

La función UUID devuelve un identificador único universal (UUID) pseudoaleatorio de tipo 4.

La función CSVRead devuelve una cadena de un archivo CSV (cf StringFromFile )

NOTA: JMeter admite varios nombres de archivo.

En la mayoría de los casos, el elemento CSV Data Set Config más nuevo es más fácil de usar.

Cuando se encuentra por primera vez un nombre de archivo, el archivo se abre y se lee en una matriz interna. Si se detecta una línea en blanco, se trata como el final del archivo, lo que permite utilizar comentarios finales.

Todas las referencias posteriores al mismo nombre de archivo utilizan la misma matriz interna. NB: el caso del nombre de archivo es significativo para la función, incluso si al sistema operativo no le importa, por lo que CSVRead (abc.txt, 0) y CSVRead (aBc. txt, 0) se referirían a diferentes matrices internas.

La función *ALIAS permite abrir el mismo archivo más de una vez y también permite nombres de archivo más cortos.

Cada subproceso tiene su propio puntero interno a su fila actual en la matriz de archivos. Cuando un subproceso se refiere por primera vez al archivo, se le asignará la siguiente fila libre en la matriz, por lo que cada subproceso accederá a una fila diferente de todos los demás subprocesos. [A menos que haya más subprocesos que filas en la matriz].

La función de propiedad devuelve el valor de una propiedad de JMeter. Si no se puede encontrar el valor de la propiedad y no se ha proporcionado ningún valor predeterminado, devuelve el nombre de la propiedad. Al proporcionar un valor predeterminado, no es necesario proporcionar un nombre de función: el parámetro se puede establecer en nulo y se ignorará.

• ${__property(user.dir)} - valor de retorno de user.dir
• ${__property(user.dir,UDIR)} - devuelve el valor de user.dir y guarda en UDIR
• ${__property(abcd,ABCD,atod)} - devuelve el valor de la propiedad abcd (o " atod " si no está definido) y guarda en ABCD
• ${__property(abcd,,atod)} - devuelve el valor de la propiedad abcd (o " atod " si no está definido) pero no lo guarda

Esta es una función de propiedad simplificada que está diseñada para usarse con propiedades definidas en la línea de comando. A diferencia de la función __property , no hay opción para guardar el valor en una variable, y si no se proporciona un valor predeterminado, se supone que es 1. Se eligió el valor 1 porque es válido para variables de prueba comunes como bucles, conteo de hilos, rampa, etc.

Defina el valor de la propiedad:

jmeter -Jgroup1.threads=7 -Jhostname1=www.realhost.edu

La función de registro registra un mensaje y devuelve su cadena de entrada

La función logn registra un mensaje y devuelve la cadena vacía

La función BeanShell evalúa el script que se le pasa y devuelve el resultado.

Para obtener detalles completos sobre el uso de BeanShell, consulte el sitio web de BeanShell en http://www.beanshell.org/

Se puede llamar a una única instancia de una función desde varios subprocesos. Sin embargo, el método de función execute() está sincronizado.

Si se define la propiedad " beanshell.function.init ", se pasa al intérprete como el nombre de un archivo fuente. Esto se puede utilizar para definir métodos y variables comunes. Hay un archivo de inicio de muestra en el directorio bin: BeanShellFunction.bshrc .

Las siguientes variables se establecen antes de que se ejecute el script:

• log - el Registrador para la función BeanShell (*)
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• props - objeto JMeterProperties (clase java.util.Properties )
• threadName - el threadName (Cadena)
• Sampler - el Sampler actual , si lo hay
• SampleResult - el SampleResult actual , si lo hay

La función __groovy evalúa los scripts de Apache Groovy que se le pasan y devuelve el resultado.

Si se define la propiedad " groovy.utilities ", el ScriptEngine la cargará. Esto se puede utilizar para definir métodos y variables comunes. Hay un archivo de inicio de muestra en el directorio bin : utility.groovy .

Las siguientes variables se establecen antes de que se ejecute el script:

• log - el registrador para la función groovy (*)
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• props - objeto JMeterProperties (clase java.util.Properties )
• threadName - el threadName (Cadena)
• sampler - el Sampler actual , si lo hay
• prev - el SampleResult anterior , si lo hay
• SALIDA - Sistema.fuera

(*) significa que esto se establece antes de que se procese el archivo de inicio, si lo hay. Otras variables varían de una invocación a otra.

Por ejemplo , no haga lo siguiente:

${__groovy("${myVar}".subcadena(0\,2))}

Imagine que la variable myVar cambia con cada transacción, el Groovy anterior no se puede almacenar en caché ya que el script cambia cada vez.

En su lugar, haga lo siguiente, que se puede almacenar en caché:

${__groovy(vars.get("myVar").substring(0\,2))}

La función split divide la cadena que se le pasa de acuerdo con el delimitador y devuelve la cadena original. Si hay delimitadores adyacentes, se devuelve " ? " como valor. Las cadenas divididas se devuelven en las variables ${VAR_1} , ${VAR_2} etc. El recuento de variables se devuelve en ${VAR_n} . Un delimitador final se trata como una variable faltante y se devuelve " ? ". Además, para permitir que funcione mejor con el controlador ForEach, __split ahora elimina la primera variable no utilizada en caso de que haya sido establecida por una división anterior.

${__dividir(${VAR},VAR,|)}

La función XPath lee un archivo XML y coincide con el XPath. Cada vez que se llama a la función, se devolverá la siguiente coincidencia. Al final del archivo, volverá al principio. Si ningún nodo coincide, la función devolverá la cadena vacía y se escribirá un mensaje de advertencia en el archivo de registro de JMeter.

${__XPath(/ruta/hacia/construir.xml, //objetivo/@nombre)}

La función setProperty establece el valor de una propiedad de JMeter. El valor de retorno predeterminado de la función es la cadena vacía, por lo que la llamada a la función se puede usar en cualquier lugar donde las funciones sean válidas.

El valor original se puede devolver configurando el tercer parámetro opcional ^en " verdadero ".

Las propiedades son globales para JMeter, por lo que se pueden usar para comunicarse entre subprocesos y grupos de subprocesos.

La función de hora devuelve la hora actual en varios formatos.

La función jexl devuelve el resultado de evaluar una expresión Commons JEXL . Consulte los enlaces a continuación para obtener más información sobre las expresiones JEXL.

La función __jexl2 usa Commons JEXL 2

• Descripción de sintaxis JEXL
• ejemplos de JEXL

La función jexl devuelve el resultado de evaluar una expresión Commons JEXL . Consulte los enlaces a continuación para obtener más información sobre las expresiones JEXL.

La función __jexl3 usa Commons JEXL 3

• Descripción de sintaxis JEXL
• ejemplos de JEXL

La función V (variable) devuelve el resultado de evaluar una expresión de nombre de variable. Esto se puede usar para evaluar referencias de variables anidadas (que actualmente no se admiten).

Por ejemplo, si uno tiene las variables A1 , A2 y N = 1 :

• ${A1} - funciona bien
• ${A${N}} - no funciona (referencia de variable anidada)
• ${__V(A${N})} - funciona bien. A${N} se convierte en A1 y la función __V devuelve el valor de A1

La función evalVar devuelve el resultado de evaluar una expresión almacenada en una variable.

Esto permite leer una cadena de un archivo y procesar cualquier referencia de variable en él. Por ejemplo, si la variable " consulta " contiene " seleccione ${columna} de ${tabla} " y " columna " y " tabla " contienen " nombre " y " clientes ", entonces ${__evalVar(consulta)} se evaluará como " seleccione el nombre de los clientes ".

La función eval devuelve el resultado de evaluar una expresión de cadena.

Esto permite interpolar referencias de variables y funciones en una cadena que se almacena en una variable. Por ejemplo, dadas las siguientes variables:

• nombre = Smith
• columna = edad
• mesa = cumpleaños
• SQL = seleccione ${columna} de ${tabla} donde nombre='${nombre}'

Esto se puede usar junto con CSV Dataset, por ejemplo, donde tanto las declaraciones SQL como los valores se definen en el archivo de datos.

La función char devuelve el resultado de evaluar una lista de números como caracteres Unicode. Consulte también __unescape() , a continuación.

Esto permite agregar valores de caracteres arbitrarios en los campos.

La función unescape devuelve el resultado de evaluar una cadena escapada de Java. Ver también __char() arriba.

Esto permite agregar caracteres a campos que de otro modo serían complicados (o imposibles) de definir a través de la GUI.

Función para quitar el escape de una cadena que contiene escapes de entidades HTML a una cadena que contiene los caracteres Unicode reales correspondientes a los escapes. Admite entidades HTML 4.0.

Por ejemplo, la cadena

${__unescapeHtml(<Français>)}

Si no se reconoce una entidad, se deja sola y se inserta textualmente en la cadena de resultados. por ejemplo , ${__unescapeHtml(>&zzzz;x)} devolverá >&zzzz;x .

Utiliza StringEscapeUtils#unescapeHtml(String) de Commons Lang.

Función que escapa los caracteres en una cadena usando entidades HTML. Admite entidades HTML 4.0.

Por ejemplo,

${__escapeHtml("pan" y "mantequilla")}

Utiliza StringEscapeUtils#escapeHtml(String) de Commons Lang.

Función para decodificar una cadena application/x-www-form-urlencoded . Nota: utilice UTF-8 como esquema de codificación.

Por ejemplo, la cadena

${__urldecode(Palabra+%22escuela%22+es+%22%C3%A9cole%22+en+francés)}

Utiliza la clase Java URLDecoder .

Función para codificar una cadena en una cadena application/x-www-form-urlencoded .

Por ejemplo, la cadena

${__urlencode(La palabra "escuela" es "école" en francés)}

Utiliza URLEncoder de clase Java .

La función FileToString se puede utilizar para leer un archivo completo. Cada vez que se llama, lee todo el archivo.

Si se produce un error al abrir o leer el archivo, la función devuelve la cadena " **ERR** "

La función samplerName devuelve el nombre (es decir, la etiqueta) de la muestra actual.

La función no funciona en elementos Test que no tengan un sampler asociado. Por ejemplo el Plan de Pruebas. Los elementos de configuración tampoco tienen una muestra asociada. Sin embargo, los muestreadores hacen referencia directamente a algunos elementos de configuración, como el administrador de encabezado HTTP y el administrador de cookies Http, y en este caso las funciones se resuelven en el contexto del muestreador Http. Los Pre-Procesadores, Post-Procesadores y Aserciones siempre tienen un Sampler asociado.

Ejemplo:

${__nombre de muestra()}

La función TestPlanName devuelve el nombre del plan de prueba actual (se puede usar en Incluir planes para conocer el nombre del plan de prueba que realiza la llamada).

Función que escapa de los metacaracteres ORO Regexp, es el equivalente de \Q \E en Java Regexp Engine.

Por ejemplo,

${__escapeOroRegexpChars([^"].+?,)}

Utiliza Perl5Compiler#quotemeta(String) de ORO.

Función que escapa los caracteres en una cadena usando entidades XML 1.0.

Por ejemplo,

${__escapeXml("pan" y 'mantequilla')}

Utiliza StringEscapeUtils#escapeXml10(String) de Commons Lang.

La función timeShift devuelve una fecha en el formato dado con la cantidad especificada de segundos, minutos, horas, días o meses agregados

La función de resumen devuelve un valor encriptado en el algoritmo hash específico con sal opcional, mayúsculas y nombre de variable.

La función __dateTimeConvert convierte una fecha que está en formato de origen a un formato de destino y almacena el resultado opcionalmente en el nombre de la variable.

La función __isPropDefined devuelve verdadero si la propiedad existe o falso en caso contrario.

La función __isVarDefined devuelve verdadero si la variable existe o falso en caso contrario.

La función de cambio de caso devuelve un valor de cadena cuyo caso se ha cambiado siguiendo un modo específico. El resultado se puede guardar opcionalmente en una variable JMeter.

La función __StringToFile se puede usar para escribir una cadena en un archivo. Cada vez que se llama, escribe una cadena para agregar o sobrescribir el archivo.

El valor de retorno predeterminado de la función es la cadena vacía