Funciones de Data Transformer

En esta página, se describe el conjunto adicional de funciones predefinidas de Jsonnet para la tarea Secuencia de comandos de Data Transformer disponible en Application Integration.

Para usar las siguientes funciones predefinidas, debes importar la biblioteca functions en tu secuencia de comandos. Importar la biblioteca functions te permite usar las funciones estándar de Jsonnet y las funciones predefinidas de Data Transformer.

Application Integration es compatible con la biblioteca de funciones de Jsonnet v0.20.0. Para obtener información sobre las funciones estándar de Jsonnet, consulta la Biblioteca estándar de Jsonnet.

Funciones de array

Average

Sintaxis 

avg(arr)
Descripción Calcula el promedio numérico de todos los valores de un array.
Parámetro de datos arr: Es el array de entrada.
Tipo de datos que se muestran DOUBLE
Resultado Muestra el promedio de todos los valores del array.

Contains

Sintaxis 

contains(arr, elem)
Descripción Comprueba el caso del elemento especificado en un array.
Parámetro de datos arr: Es el array de entrada.

elem: El elemento del array que se desea buscar.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra Data Transformer TRUE si se encuentra una coincidencia y FALSE en caso contrario.

Max Array

Sintaxis 

maxArray(arr)
Descripción Encuentra el valor más bajo en un array.
Parámetro de datos arr: Es el array de entrada.
Tipo de datos que se muestran El tipo de datos del array de entrada.
Salida Muestra el valor más alto encontrado en el array.

Min Array

Sintaxis 

minArray(arr)
Descripción Encuentra el valor más bajo en un array.
Parámetro de datos arr: Es el array de entrada.
Tipo de datos que se muestran El tipo de datos del array de entrada.
Output/th> Muestra el valor más bajo encontrado en el array.

Remove

Sintaxis 

remove(arr, elem)
Descripción Quita el elemento especificado de un array.
Parámetro de datos arr: Es el array de entrada.

elem: El elemento del array que se desea quitar.
Tipo de datos que se muestran El tipo de datos del array de entrada.
Resultado Muestra el array actualizado después de quitar el elemento especificado.

Remove At

Sintaxis 

removeAt(arr, index)
Descripción Quita un elemento de un array en el índice especificado.
Parámetro de datos arr: Es el array de entrada.

index: Es el índice del array del elemento que se quitará.
Tipo de datos que se muestran El tipo de datos del array de entrada.
Resultado Muestra el array actualizado después de quitar el elemento especificado.

Sum

Sintaxis 

sum(arr)
Descripción Suma todos los valores de un array.
Parámetro de datos arr: Es el array de entrada.
Tipo de datos que se muestran El tipo de datos del array de entrada.
Salida Muestra la suma de todos los elementos del array.

GroupBy

Sintaxis 

groupBy(array, function)
Descripción Crea un objeto compuesto por claves generadas a partir de los resultados de la ejecución de cada elemento del array a través de la función de iteración. Por ejemplo, f.groupBy([1,1.3,1.8],std.floor) generaría {"1": [1,1.3,1.8]}.
Parámetro de datos
  • array: la colección sobre la que se itera el método.

    function: la función que se invoca para cada elemento del array.
Tipo de datos que se muestra JSON
Resultado Muestra el objeto agregado compuesto.

Zip

Sintaxis 

zip([arrays])
Descripción Crea un array de elementos agrupados, el primero contiene los primeros elementos de los arrays dados, el segundo contiene el segundo elemento de los arrays dados, y así sucesivamente. Por ejemplo, f.zip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) generaría [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Parámetro de datos [arrays]: este parámetro contiene los arrays que se deben procesar.
Tipo de datos que se muestra array
Salida Muestra el array nuevo de elementos reagrupados.

Unzip

Sintaxis 

unzip(array)
Descripción Crea un array de elementos agrupados. Acepta un array de elementos agrupados y también crea un array que reagrupa los elementos a su configuración previa a la compresión. Por ejemplo, f.unzip([[1, "one", "I"],[2, "two", "II"],[3, "three", "III"]]) generaría [[1,2,3],["one", "two", "three"],["I", "II", "III"]].
Parámetro de datos array: este parámetro contiene el array de elementos agrupados que se procesarán.
Tipo de datos que se muestra array
Salida Muestra el array nuevo de elementos reagrupados.

Funciones de agregación

XNOR

Sintaxis 

xnor(a, b)
Descripción Realiza una operación lógica XNOR en los valores booleanos especificados.
Parámetro de datos a:: un valor booleano.

b:: un valor booleano.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra el XNOR de los dos booleanos especificados.

Xor

Sintaxis 

xor(a, b)
Descripción Realiza la operación lógica XOR en los valores booleanos especificados.
Parámetro de datos a:: un valor booleano.

b:: un valor booleano.
Tipo de datos que se muestran BOOLEAN
Salida Muestra el XOR de los dos booleanos especificados.

Funciones de generación de hash

SHA1

Sintaxis 

sha1(str)
Descripción Calcula el hash criptográfico de la STRING de entrada mediante el algoritmo del algoritmo de hash seguro 1 (SHA-1).
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran BYTES
Resultado Muestra un valor de hash de 160 bits (20 bytes).

SHA256

Sintaxis 

sha256(str)
Descripción Calcula el hash criptográfico de la STRING de entrada con el algoritmo de algoritmo de hash seguro 256 (SHA-256).
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran BYTES
Resultado Muestra un valor de hash de 256 bits (32 bytes).

SHA512

Sintaxis 

sha512(str)
Descripción Calcula el hash criptográfico de la STRING de entrada mediante el algoritmo del algoritmo de hash seguro 512 (SHA-512).
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran BYTES
Resultado Muestra un valor de hash de 512 bits (64 bytes).

SHA3

Sintaxis 

sha3(str)
Descripción Calcula el hash criptográfico de la STRING de entrada mediante el algoritmo del algoritmo de hash seguro 3 (SHA-3).
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran BYTES
Resultado Muestra un valor de hash de 512 bits (64 bytes).

Funciones JSON

Manifest XML

Sintaxis 

manifestXml(json, format = "badgerfish", indent_output = false)
Descripción Convierte el objeto JSON de entrada especificado en una cadena XML.
Parámetro de datos json: Es el objeto JSON de entrada.

format: Es el formato de representación JSON de entrada.

indent_output: Es la entrada booleana para indicar si la string XML de salida debe tener sangría. El valor predeterminado es False.
Tipo de datos que se muestran STRING
Resultado Muestra la cadena XML de la representación del objeto JSON proporcionada.

Object Remove Key

Sintaxis 

objectRemoveKey(obj, key)
Descripción Quita una propiedad de un objeto JSON.
Parámetro de datos obj: El objeto JSON de entrada.

key: La propiedad JSON que se quitará.
Tipo de datos que se muestran JSON
Resultado Objeto JSON actualizado después de quitar la propiedad especificada y su valor correspondiente.

Parse XML

Sintaxis 

parseXml(xml, format = "badgerfish")
Descripción Analiza la cadena XML de entrada especificada en un objeto JSON.
Parámetro de datos xml: Es la cadena XML de entrada.

format: Es el formato de representación JSON de salida.

Tipo de datos que se muestran JSON
Resultado Muestra la representación del objeto JSON de la cadena XML proporcionada.

Parse CSV With Header

Sintaxis 

parseCsvWithHeader(input, delimiter = ",", overwrite_duplicate_headers = true)
Descripción Analiza una cadena de CSV de entrada determinada como un archivo JSON. La primera fila se consideraría como encabezado. Por ejemplo, f.parseCsvWithHeader("index,product,company\n1,Application Integration,Google\n2,Pubsub,Google") generaría [{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}].
Parámetro de datos input: la cadena de CSV que se analizará.

delimiter: la cadena de delimitador que se usará. El valor predeterminado es ','.

overwrite_duplicate_headers: es la opción para reemplazar los valores de los encabezados duplicados. Si se establece como falso, se cambiará el nombre del encabezado duplicado. El valor predeterminado es true.
Tipo de datos que se muestran JSON
Resultado Muestra la representación JSON de una cadena de CSV determinada.

Manifest CSV

Sintaxis 

manifestCsv(json, headers = null)
Descripción Convierte el archivo JSON dado en una cadena de CSV. Por ejemplo, f.manifestCsv([{"index": "1", "product": "Application Integration", "company": "Google"},{"index": "2", "product": "Pubsub", "company": "Google"}]) generaría index,product,company\n1,Application Integration,Google\n2,Pubsub,Google.
Parámetro de datos json: JSON que se convertirá en CSV.

headers: lista de encabezados para el archivo CSV. Si no se proporciona ningún valor, se usan todos los encabezados.

Tipo de datos que se muestra STRING
Resultado Muestra la cadena de CSV de JSON en un formato dado.

Funciones matemáticas

Is Decimal

Sintaxis 

isDecimal(num)
Descripción Comprueba si el número especificado es un decimal.
Parámetro de datos num: Es el número de entrada.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si el número es un decimal y TRUE en el caso contrario.

Is Even

Sintaxis 

isEven(num)
Descripción Comprueba si el número dado es par.
Parámetro de datos num: Es el número de entrada.
Tipo de datos que se muestran BOOLEAN
Salida Muestra TRUE si el número es par y TRUE en caso contrario.

Is Integer

Sintaxis 

isInteger(num)
Descripción Comprueba si el número especificado es un número entero.
Parámetro de datos num: Es el número de entrada.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si el número es un número entero y TRUE en el caso contrario.

Is Odd

Sintaxis 

isOdd(num)
Descripción Comprueba si el número especificado es impar.
Parámetro de datos num: Es el número de entrada.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si el número es impar y TRUE en caso contrario.

Random Number

Sintaxis 

randomNumber(lowerBound, upperBound)
Descripción Genera un número real aleatorio entre un rango especificado.
Parámetro de datos lowerBound: el valor del rango más bajo (incluido). El valor predeterminado es 0.

upperBound: Valor de rango más alto (exclusivo). El valor predeterminado es 1.
Tipo de datos que se muestran Es un número real.
Salida Muestra un número real aleatorio entre lowerBound y upperBound.

Round

Sintaxis 

round(input)
Descripción Redondea un número al número entero más cercano.
Parámetro de datos input: Un valor para redondear.
Tipo de datos que se muestran INTEGER
Valor de muestra Muestra el número entero redondeado más cercano.

Funciones de string

Equals Ignore Case

Sintaxis 

equalsIgnoreCase(str1, str2)
Descripción Compara los dos valores de cadena dados, independientemente del uso de mayúsculas y minúsculas (inferior o superior).
Parámetro de datos str1: Es una cadena de entrada.

str2: Es una cadena de entrada.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si el valor especificado coincide con el valor existente (se ignoran las mayúsculas y las minúsculas) y FALSE, en caso contrario.

Is Empty

Sintaxis 

isEmpty(str)
Descripción Comprueba si la longitud de la string dada es 0.
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si la string está vacía y TRUE en caso contrario.

Match

Sintaxis 

match(str, regexp)
Descripción Recupera el resultado de la coincidencia de una string con una expresión regular.
Parámetro de datos str: Es la cadena de entrada.

regexp: Es la expresión regular re2.
Tipo de datos que se muestran ARRAY
Salida Muestra un array de todas las substrings de str que coinciden con la expresión regular, regexp. Muestra un array vacío si no hay coincidencias.

Trim

Sintaxis 

trim(str)
Descripción Quita todos los espacios iniciales y finales de una string determinada.
Parámetro de datos str: Es la string de entrada.
Tipo de datos que se muestran STRING
Salida Muestra una copia de la string sin el espacio en blanco al principio ni al final.

Funciones de marca de tiempo

Date Format

Sintaxis 

dateFormat(timestamp, format_string, timezone, current_format)
Descripción Formatea una marca de tiempo de acuerdo con el valor format_string especificado.
Parámetro de datos timestamp: La marca de tiempo de entrada

format_string: Es el nuevo formato de marca de tiempo. Consulta Elementos de formato de marca de tiempo admitidos para obtener una lista de los elementos de formato que se pueden usar para formar la nueva string de formato de marca de tiempo.

timezone: La zona horaria de la marca de tiempo de entrada proporcionada El valor predeterminado es UTC.

current_format: es el formato que se usaría para analizar la marca de tiempo de entrada proporcionada. El valor predeterminado es E (época).
Tipo de datos que se muestran STRING
Resultado Muestra una string nueva después de convertir el objeto timestamp de entrada según el format_string especificado.

Elementos de formato de marca de tiempo admitidos

En la siguiente tabla, se indican los elementos de formato admitidos para la función dateFormat():

Elemento de formato Descripción Ejemplo
YYYY Año (4 dígitos). 2023
YY Últimos 2 dígitos del año. 23
MMMM Nombre del mes en mayúsculas de título. March
MMM Nombre abreviado del mes en mayúsculas de título. Mar
MM Mes del 1 al 12 03
M Mes del 1 al 12. 3
DDDD Nombre del día en mayúscula inicial. Monday
DDD Nombre abreviado del día. Mon
DD Día del 01 al 31. 06
D Día de 1 a 31. 6
HH Es la hora en formato de 24 horas, de 00 a 23. 15
hh Hora en formato de 12 horas, de 01 a 12. 03
h Hora en formato de 12 horas del 1 al 12. 3
mm Minuto de 00 a 59. 04
m Minuto de 0 a 59. 4
ss Segundos de 00 a 59. 08
s Segundos del 0 al 59. 8
FFFFFFFFF Segundos fraccionarios con 9 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.123456789
FFFFFFFF Segundos fraccionarios con 8 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.12345678
FFFFFFF fracciones de segundos con 7 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.1234567
FFFFFF fracciones de segundos con 6 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.123456
FFFFF Segundos fraccionarios con 5 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.12345
FFFF Segundos fraccionarios con 4 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.1234
FFF Segundos fraccionarios con 3 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.123
FF Segundos fraccionarios con 2 dígitos, incluidos ceros, a la derecha de los dígitos especificados. 00.12
F Segundos fraccionarios con 1 dígito, incluidos ceros, a la derecha de los dígitos especificados. 00.1
fffffffff Segundos fraccionarios con 9 dígitos. 987654321
ffffffff Segundos fraccionarios con 8 dígitos. 98765432
fffffff Segundos fraccionarios con 7 dígitos. 9876543
ffffff Segundos fraccionarios con 6 dígitos. 987654
fffff Segundos fraccionarios con 5 dígitos. 98765
ffff Segundos fraccionarios con 4 dígitos. 9876
fff Segundos fraccionarios con 3 dígitos. 987
ff Segundos fraccionarios con 2 dígitos. 98
f Fracciones de segundos con 1 dígito. 9
tt Indicador del meridiano (mañana o noche). Cuando se da formato, es A.M. o P.M. PM
t Indicador corto del meridiano (mañana o noche). Se asigna a am o pm en minúscula. pm
K Nombre de la zona horaria PST
kk Zona horaria en formato ±xx:xx. -8:00:00
k Zona horaria en formato ±xxxx -8000

Is Leap Year

Sintaxis 

isLeapYear(year)
Descripción Comprueba si el año determinado es bisiesto.
Parámetro de datos año: Año de entrada (número real).
Tipo de datos que se muestran BOOLEAN
Resultado Muestra TRUE si el año es bisiesto y TRUE en el caso contrario.

Now In Millis

Sintaxis 

nowInMillis()
Descripción Muestra el tiempo de época actual de Unix de la integración en milisegundos.
Parámetro de datos N/A
Tipo de datos que se muestran INT64
Salida Muestra el tiempo de época Unix actual en milisegundos.

Funciones de utilidad

UUID

Sintaxis 

uuid()
Descripción Genera un identificador único universal aleatorio (UUID) como una STRING. La STRING que se muestra consta de 32 dígitos hexadecimales en cinco grupos separados por guiones en formato 8-4-4-4-12. Los dígitos hexadecimales representan 122 bits aleatorios y 6 bits fijos, en conformidad con RFC 4122 sección 4.4. La STRING que se muestra está en minúscula.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Resultado Muestra el UUID generado en formato de cadena.

Integration name

Sintaxis 

getIntegrationName()
Descripción Obtén el nombre de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Salida Muestra el nombre de la integración actual.

Integration region

Sintaxis 

getIntegrationRegion()
Descripción Obtén la región de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Salida Muestra la región de la integración actual.

Integration version ID

Sintaxis 

getIntegrationVersionId()
Descripción Obtén el ID de la versión de integración de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Resultado Muestra el ID de la versión de integración de la integración actual.

Integration version number

Sintaxis 

getIntegrationVersionNumber()
Descripción Obtén el número de versión de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran NUMBER
Resultado Muestra el número de versión de la integración actual.

Execution ID

Sintaxis 

getExecutionId()
Descripción Obtén el ID de ejecución de la ejecución de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Resultado Muestra el ID de ejecución de la ejecución de la integración actual.

Project ID

Sintaxis 

getProjectId()
Descripción Obtén el ID del proyecto de Google Cloud de la integración actual.
Parámetro de datos N/A
Tipo de datos que se muestran STRING
Salida Muestra el ID del proyecto de Google Cloud de la integración actual.

Recomendación