Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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.
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.