Guía de referencia de las funciones de expresión de flujo de trabajo en Azure Logic Apps y Power Automate
Se aplica a: Azure Logic Apps (consumo + estándar)
En las definiciones de flujo de trabajo en Azure Logic Apps y Power Automate, algunas expresiones obtienen sus valores de las acciones del entorno de ejecución que puede que no existan aún cuando comienza a ejecutarse el flujo de trabajo. Para hacer referencia a los valores en estas expresiones o procesarlos, puede usar las funciones de expresión que proporciona el lenguaje de definición de flujo de trabajo.
Nota
Esta página de referencia se aplica a Azure Logic Apps y Power Automate, pero aparece en la documentación de Azure Logic Apps. Aunque esta página se refiere específicamente a los flujos de trabajo de aplicaciones lógicas, estas funciones son válidas tanto para flujos como para flujos de trabajo de aplicaciones lógicas. Para más información sobre las funciones y las expresiones en Power Automate, consulte Uso de expresiones en condiciones.
Por ejemplo, puede calcular valores con funciones matemáticas, como la función add(), cuando quiera obtener la suma de números enteros y float. A continuación se muestran otras tareas de ejemplo que puede realizar con funciones:
Tarea | Sintaxis de la función | Resultado |
---|---|---|
Devuelve una cadena en formato de minúsculas. | toLower('<text>') Por ejemplo: toLower('Hello') |
"Hola" |
Devuelve un identificador único global (GUID). | guid() | "c2ecc88d-88c8-4096-912c-d6f2e2b138ce" |
Para buscar funciones según su propósito general, utilice las siguientes tablas. O bien, para obtener información detallada acerca de cada función, consulte la lista alfabética.
Funciones en expresiones
Para mostrar cómo usar una función en una expresión, en este ejemplo se muestra cómo obtener el valor del parámetro customerName
y asignar dicho valor a la propiedad accountName
mediante la función parameters() en una expresión:
"accountName": "@parameters('customerName')"
Estas son algunas otras formas generales en que puede usar funciones en expresiones:
Tarea | Sintaxis de la función en una expresión |
---|---|
Realice el trabajo con un elemento y para ello pase ese elemento a una función. | "@<functionName>(<item>)" |
1. Obtenga el valor de parameterName mediante la función anidada parameters() . 2. Realice el trabajo con el resultado y para ello pase ese valor a functionName. |
"@<functionName>(parameters('<parameterName>'))" |
1. Obtenga el resultado de la función interna anidada functionName. 2. Pase el resultado a la función externa functionName2. |
"@<functionName2>(<functionName>(<item>))" |
1. Obtenga el resultado de functionName. 2. Dado que el resultado es un objeto con la propiedad propertyName, obtenga el valor de la propiedad. |
"@<functionName>(<item>).<propertyName>" |
Por ejemplo, la función concat()
puede tomar dos o más valores de cadena como parámetros. Esta función combina esas cadenas en una cadena. Puede pasar literales de cadena, por ejemplo, "Sophia" y "Owen" para obtener una cadena combinada, "SophiaOwen":
"customerName": "@concat('Sophia', 'Owen')"
O bien, puede obtener valores de cadena de los parámetros. En este ejemplo se usa la función parameters()
en cada parámetro concat()
y en los parámetros firstName
y lastName
. Luego se pasan las cadenas resultantes a la función concat()
para obtener una cadena combinada, por ejemplo, "SophiaOwen":
"customerName": "@concat(parameters('firstName'), parameters('lastName'))"
En cualquier de los casos, ambos ejemplos asignan el resultado a la propiedad customerName
.
Consideraciones a la hora de usar funciones
El diseñador no evalúa las expresiones en tiempo de ejecución que se usan como parámetros de función durante el tiempo de diseño. El diseñador requiere que todas las expresiones se puedan evaluar completamente durante el tiempo de diseño.
Los parámetros de función se evalúan de izquierda a derecha.
En la sintaxis de las definiciones de parámetros, el signo de interrogación (?) que aparece después de un parámetro significa que el parámetro es opcional. Por ejemplo, consulte getFutureTime().
Las expresiones de función que aparecen insertadas en texto sin formato requieren llaves ({}) para usar el formato interpolado de la expresión en su lugar. Este formato ayuda a evitar problemas de análisis. Si la expresión de función no aparece insertada en texto sin formato, no se necesita ninguna llave.
En el ejemplo siguiente se muestra la sintaxis correcta e incorrecta:
Correcto:
"<text>/@{<function-name>('<parameter-name>')}/<text>"
Incorrecto:
"<text>/@<function-name>('<parameter-name>')/<text>"
Correcto:
"@<function-name>('<parameter-name>')"
Las siguientes secciones organizan las funciones por su uso general, o bien puede examinarlas por orden alfabético.
Funciones de cadena
Para trabajar con cadenas, puede usar estas funciones de cadena y también algunas funciones de colección. Las funciones de cadena solo funcionan en cadenas.
Función de cadena | Tarea |
---|---|
chunk | Divide una cadena o colección en fragmentos de igual longitud. |
concat | Combina dos o más cadenas y devuelve la cadena combinada. |
endsWith | Comprueba si una cadena termina con la subcadena especificada. |
formatNumber | Devuelve un número como una cadena según el formato especificado. |
guid | Genera un identificador único global (GUID) como una cadena. |
indexOf | Devuelve la posición inicial de una subcadena. |
isFloat | Devuelve un valor booleano que indica si una cadena es un número de punto flotante. |
isInt | Devuelve un valor booleano que indica si una cadena es un entero. |
lastIndexOf | Devuelve la posición inicial de la última repetición de una subcadena. |
length | Devuelve el número de elementos de una cadena o una matriz. |
nthIndexOf | Devuelve la posición inicial o el valor de índice donde la enésima repetición de una subcadena aparece en una cadena. |
replace | Reemplaza una subcadena por la cadena especificada y devuelve la cadena actualizada. |
slice | Devuelve una subcadena especificando el valor o la posición inicial y final. Consulte también subcadena. |
split | Devuelve una matriz que contiene subcadenas, separadas por comas, de una cadena mayor en función de un carácter delimitador especificado en la cadena original. |
startsWith | Comprueba si una cadena comienza con una subcadena especificada. |
substring | Devuelve caracteres de una cadena, a partir de la posición especificada. Consulte también segmento. |
toLower | Devuelve una cadena en formato de minúsculas. |
toUpper | Devuelve una cadena en formato de mayúsculas. |
trim | Quita el espacio en blanco inicial y final de una cadena y devuelve la cadena actualizada. |
Funciones de colección
Para trabajar con colecciones, por lo general matrices, cadenas y, en ocasiones, diccionarios, puede usar estas funciones de colección.
Función de colección | Tarea |
---|---|
chunk | Divide una cadena o colección en fragmentos de igual longitud. |
contains | Comprueba si una colección contiene un elemento específico. |
empty | Comprueba si una colección está vacía. |
first | Devuelve el primer elemento de una colección. |
intersection | Devuelve una colección que tiene solo los elementos comunes en las colecciones especificadas. |
item | Si esta función aparece dentro de una acción de repetición sobre una matriz, devuelve el elemento actual de la matriz durante la iteración actual de la acción. |
join | Devuelve una cadena que tiene todos los elementos de una matriz, separados por el carácter especificado. |
last | Devuelve el último elemento de una colección. |
length | Devuelve el número de elementos de una cadena o una matriz. |
reverse | Invierte el orden de los elementos de una matriz. |
skip | Quita elementos del principio de una colección y devuelve todos los demás elementos. |
sort | Ordena elementos de una colección. |
take | Devuelve elementos del principio de una colección. |
union | Devuelve una colección que tiene todos los elementos de las colecciones especificadas. |
Funciones de comparación lógica
Para trabajar con condiciones, comparar valores y resultados de expresiones, o evaluar varios tipos de lógica, puede usar estas funciones de comparación lógica. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Nota
Si usa funciones o condiciones lógicas para comparar valores, los valores NULL se convierten en valores de cadena vacía (""
). El comportamiento de las condiciones es distinto cuando se compara con una cadena vacía, en lugar de con un valor NULL. Para más información, consulte la función string().
Función de comparación lógica | Tarea |
---|---|
and | Comprueba si todas las expresiones son true. |
equals | Comprueba si ambos valores son equivalentes. |
greater | Comprueba si el primer valor es mayor que el segundo. |
greaterOrEquals | Comprueba si el primer valor es mayor o igual que el segundo. |
if | Comprueba si una expresión es true o false. En función del resultado, devuelve un valor especificado. |
isFloat | Devuelve un valor booleano que indica si una cadena es un número de punto flotante. |
isInt | Devuelve un valor booleano que indica si una cadena es un entero. |
less | Comprueba si el primer valor es menor que el segundo. |
lessOrEquals | Compruebe si el primer valor es menor o igual que el segundo valor. |
not | Comprueba si una expresión es false. |
or | Comprueba si al menos una expresión es true. |
Funciones de conversión
Para cambiar el tipo o el formato de un valor, puede usar estas funciones de conversión. Por ejemplo, puede cambiar un valor de booleano a entero. Para más información sobre el modo en que Azure Logic Apps administra los tipos de contenido durante la conversión, consulte Administración de los tipos de contenido. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Conversiones implícitas de tipos de datos.
Función de conversión | Tarea |
---|---|
array | Devuelve una matriz a partir de una única entrada especificada. Para varias entradas, consulte createArray. |
base64 | Devuelve la versión de una cadena codificada en base64. |
base64ToBinary | Devuelve la versión binaria de una cadena codificada en base64. |
base64ToString | Devuelve la versión de cadena de una cadena codificada en base64. |
binary | Devuelve la versión binaria de un valor de entrada. |
bool | Devuelve la versión booleana de un valor de entrada. |
createArray | Devuelve una matriz a partir de varias entradas. |
dataUri | Devuelve el URI de datos de un valor de entrada. |
dataUriToBinary | Devuelve la versión binaria de un URI de datos. |
dataUriToString | Devuelve la versión de cadena de un URI de datos. |
decimal | Devuelve el número decimal de una cadena decimal. |
decodeBase64 | Devuelve la versión de cadena de una cadena codificada en base64. |
decodeDataUri | Devuelve la versión binaria de un URI de datos. |
decodeUriComponent | Devuelve una cadena que reemplaza los caracteres de escape por versiones descodificadas. |
encodeUriComponent | Devuelve una cadena que reemplaza los caracteres no seguros de la dirección URL por caracteres de escape. |
float | Devuelve un número de punto flotante de un valor de entrada. |
int | Devuelve la versión como número entero de una cadena. |
json | Devuelve el valor o el objeto de tipo Notación de objetos JavaScript (JSON) de una cadena o XML. |
string | Devuelve la versión de cadena de un valor de entrada. |
uriComponent | Devuelve la versión codificada con el URI de un valor de entrada mediante la sustitución de los caracteres no seguros de la dirección URL por caracteres de escape. |
uriComponentToBinary | Devuelve la versión binaria de una cadena codificada con el URI. |
uriComponentToString | Devuelve la versión de cadena de una cadena codificada con el URI. |
xml | Devuelve la versión XML de una cadena. |
Conversiones implícitas de tipos de datos
Azure Logic Apps realiza conversiones de forma automática o implícita entre algunos tipos de datos para que no tenga que realizar estas conversiones automáticamente. Por ejemplo, si usa valores que no son de cadena donde se esperan cadenas como entradas, Azure Logic Apps convierte automáticamente los valores que no son de cadena en cadenas.
Por ejemplo, supongamos que un desencadenador devuelve un valor numérico como salida:
triggerBody()?['123']
Si usa esta salida numérica donde se espera una entrada de cadena, como una dirección URL, Azure Logic Apps convierte automáticamente el valor en una cadena mediante la notación de llaves ({}
):
@{triggerBody()?['123']}
Codificación y descodificación Base64
Azure Logic Apps realiza de manera automática o implícita la codificación o descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones correspondientes:
base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)
Nota
Si agrega manualmente cualquiera de estas funciones mientras usa el diseñador, ya sea directamente mediante un desencadenador o una acción o mediante el editor de expresiones, sale del diseñador y, a continuación, vuelve a entrar en él, la función desaparece del diseñador y deja solo los valores de los parámetros. Este comportamiento también se produce si selecciona un desencadenador o una acción que usa esta función sin modificar los valores de los parámetros de la función. Este resultado afecta solo a la visibilidad de la función y no al efecto. En la vista de código, la función no se ve afectada. Sin embargo, si edita los valores de los parámetros de la función, la función y su efecto se quitan de la vista de código, lo que deja detrás solo los valores de parámetro de la función.
Funciones matemáticas
Para trabajar con números enteros y flotantes, puede usar estas funciones matemáticas. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Función matemática | Tarea |
---|---|
add | Devuelve el resultado de sumar dos números. |
div | Devuelve el resultado de dividir dos números. |
max | Devuelve el valor más alto de un conjunto de números o una matriz. |
min | Devuelve el valor más bajo de un conjunto de números o una matriz. |
mod | Devuelve el resto de dividir dos números. |
mul | Devuelve el producto de multiplicar dos números. |
rand | Devuelve un entero aleatorio desde un intervalo especificado. |
range | Devuelve una matriz de enteros que comienza en un entero especificado. |
sub | Devuelve el resultado de restar el segundo número del primero. |
Funciones de fecha y hora
Para trabajar con fechas y horas, puede usar estas funciones de fecha y hora. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Función de fecha u hora | Tarea |
---|---|
addDays | Agrega días a una marca de tiempo. |
addHours | Agrega horas a una marca de tiempo. |
addMinutes | Agrega minutos a una marca de tiempo. |
addSeconds | Agrega segundos a una marca de tiempo. |
addToTime | Agrega unidades de tiempo especificadas a una marca de tiempo. Consulte también getFutureTime. |
convertFromUtc | Convierte una marca de tiempo del formato Hora Universal Coordinada (UTC) a la zona horaria de destino. |
convertTimeZone | Convierte una marca de tiempo de la zona horaria de origen a la zona horaria de destino. |
convertToUtc | Convierte una marca de tiempo de la zona horaria de origen al formato Hora Universal Coordinada (UTC). |
dateDifference | Devuelve la diferencia entre dos fechas como un intervalo de tiempo. |
dayOfMonth | Devuelve el día del componente de mes de una marca de tiempo. |
dayOfWeek | Devuelve el día del componente de semana de una marca de tiempo. |
dayOfYear | Devuelve el día del componente de año de una marca de tiempo. |
formatDateTime | Devuelve la fecha de una marca de tiempo. |
getFutureTime | Devuelve la marca de tiempo actual más las unidades de tiempo especificadas. Consulte también addToTime. |
getPastTime | Devuelve la marca de tiempo actual menos las unidades de tiempo especificadas. Consulte también subtractFromTime. |
parseDateTime | Devuelve la marca de tiempo de una cadena que contiene una marca de tiempo. |
startOfDay | Devuelve el inicio del día de una marca de tiempo. |
startOfHour | Devuelve el inicio de la hora de una marca de tiempo. |
startOfMonth | Devuelve el inicio del mes de una marca de tiempo. |
subtractFromTime | Resta un número de unidades de tiempo de una marca de tiempo. Consulte también getPastTime. |
ticks | Devuelve el valor de la propiedad ticks de una marca de tiempo especificada. |
utcNow | Devuelve la marca de tiempo actual como una cadena. |
Funciones de flujo de trabajo
Estas funciones de flujo de trabajo pueden ayudarle a:
- Obtener detalles sobre una instancia de flujo de trabajo en tiempo de ejecución
- Trabaje con las entradas usadas para crear instancias de aplicaciones lógicas o flujos.
- Hacer referencia a las salidas de desencadenadores y acciones
Por ejemplo, puede hacer referencia a las salidas de una acción y usar esos datos en una acción posterior. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Función de flujo de trabajo | Tarea |
---|---|
action | Devuelve la salida de la acción actual en tiempo de ejecución, o valores de otros pares de nombre y valor JSON. Consulte también actions. |
actions | Devuelve la salida de una acción en tiempo de ejecución, o valores de otros pares de nombre y valor JSON. Consulte también action. |
body | Devuelve la salida en tiempo de ejecución del elemento body de una acción. |
formDataMultiValues | Crea una matriz con los valores que coinciden con un nombre de clave en las salidas de acción form-data o form-encoded. |
formDataValue | Devuelve un valor único que coincide con un nombre de clave en las salidas form-data o form-encoded de una acción. |
item | Si esta función aparece dentro de una acción de repetición sobre una matriz, devuelve el elemento actual de la matriz durante la iteración actual de la acción. |
items | Si esta función aparece dentro de un bucle Foreach o Until, devuelve el elemento actual del bucle especificado. |
iterationIndexes | Si esta función aparece dentro de un bucle Until, devuelve el valor de índice de la iteración actual. Puede usar esta función dentro de bucles Until anidados. |
listCallbackUrl | Devuelve la "dirección URL de devolución de llamada" que llama a un desencadenador o una acción. |
multipartBody | Devuelve el elemento body de una parte específica de la salida de una acción que consta de varias partes. |
outputs | Devuelve la salida en tiempo de ejecución de una acción. |
parameters | Se devuelve el valor de un parámetro que se describe en la definición de flujo de trabajo. |
result | Devuelve las entradas y salidas de las acciones de nivel superior dentro de la acción de ámbito especificada, como For_each , Until y Scope . |
trigger | Devuelve la salida de un desencadenador en tiempo de ejecución, o desde otros pares de nombre y valor JSON. Consulte también triggerOutputs y triggerBody. |
triggerBody | Devuelve la salida body de un desencadenador en tiempo de ejecución. Consulte trigger. |
triggerFormDataValue | Devuelve un valor único que coincide con un nombre de clave en las salidas del desencadenador form-data o form-encoded. |
triggerMultipartBody | Devuelve el cuerpo de una parte específica de la salida de varias partes de un desencadenador. |
triggerFormDataMultiValues | Crea una matriz cuyos valores coinciden con un nombre de clave en las salidas del desencadenador form-data o form-encoded. |
triggerOutputs | Devuelve la salida de un desencadenador en tiempo de ejecución o valores de otros pares de nombre y valor JSON. Consulte trigger. |
variables | Devuelve el valor de una variable especificada. |
workflow | Devuelve todos los detalles sobre el propio flujo de trabajo durante el tiempo de ejecución. |
Funciones de análisis de URI
Para trabajar con identificadores uniformes de recursos (URI) y obtener distintos valores de propiedad para estos URI, puede usar estas funciones de análisis de URI. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Función de análisis de URI | Tarea |
---|---|
uriHost | Devuelve el valor host de un identificador uniforme de recursos (URI). |
uriPath | Devuelve el valor path de un identificador uniforme de recursos (URI). |
uriPathAndQuery | Devuelve los valores path y query de un identificador uniforme de recursos (URI). |
uriPort | Devuelve el valor port de un identificador uniforme de recursos (URI). |
uriQuery | Devuelve el valor query de un identificador uniforme de recursos (URI). |
uriScheme | Devuelve el valor scheme de un identificador uniforme de recursos (URI). |
Funciones de manipulación: JSON y XML
Para trabajar con objetos JSON y nodos XML, puede usar estas funciones de manipulación. Para obtener la referencia completa sobre cada función, consulte la lista en orden alfabético.
Función de manipulación | Tarea |
---|---|
addProperty | Agrega una propiedad y su valor o un par de nombre y valor a un objeto JSON y devuelve el objeto actualizado. |
coalesce | Devuelve el primer valor distinto de null de uno o más parámetros. |
removeProperty | Quita una propiedad de un objeto JSON y devuelve el objeto actualizado. |
setProperty | Establece el valor de propiedad de un objeto JSON y devuelve el objeto actualizado. |
xpath | Comprueba el código XML de los nodos o valores que coinciden con una expresión XPath (XML Path Language) y devuelve los nodos o valores coincidentes. |
---------------------------------
Todas las funciones: lista alfabética
En esta sección se enumeran todas las funciones disponibles en orden alfabético.
A
action
Devuelve la salida en tiempo de ejecución de la acción actual o los valores de otros pares de nombre y valor JSON, que puede asignar a una expresión. De forma predeterminada, esta función hace referencia al objeto de acción entero, pero también puede especificar una propiedad cuyo valor desee obtener. Consulte también actions().
Puede usar la función action()
únicamente en estas ubicaciones:
- La propiedad
unsubscribe
de una acción de webhook de forma que pueda acceder al resultado de la solicitud originalsubscribe
- La propiedad
trackedProperties
de una acción - La condición del bucle
do-until
de una acción
action()
action().outputs.body.<property>
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<propiedad> | No | String | Nombre de la propiedad del objeto de acción cuyo valor desee: name, startTime, endTime, inputs, outputs, status, code, trackingId y clientTrackingId. En Azure Portal, revise los detalles de un historial de ejecución específico para encontrar estas propiedades. Para más información, consulte API REST: acciones de ejecución de flujo de trabajo. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-de-la-acción> | String | Salida de la acción o propiedad actual |
actions
Devuelve la salida en tiempo de ejecución de una acción o los valores de otros pares de nombre y valor JSON, que puede asignar a una expresión. De forma predeterminada, la función hace referencia al objeto de acción entero, pero también puede especificar una propiedad cuyo valor desee obtener. Para obtener versiones abrevias, consulte body(). Para la acción actual, consulte action().
Sugerencia
La función actions()
devuelve la salida como cadena. Si necesita trabajar con un valor devuelto como objeto JSON, antes debe convertir el valor de cadena. Puede transformar el valor de cadena en un objeto JSON mediante la acción de análisis de JSON.
Nota
Anteriormente, podía usar la función actions()
o el elemento conditions
al especificar que una acción se ejecutó basándose en la salida de otra acción. Sin embargo, para declarar explícitamente las dependencias entre las acciones, ahora debe usar la propiedad runAfter
de la acción dependiente.
Para más información sobre la propiedad runAfter
, consulte Detección y control de errores con la propiedad runAfter.
actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Nombre del objeto de acción cuya salida desea |
<propiedad> | No | String | Nombre de la propiedad del objeto de acción cuyo valor desee: name, startTime, endTime, inputs, outputs, status, code, trackingId y clientTrackingId. En Azure Portal, revise los detalles de un historial de ejecución específico para encontrar estas propiedades. Para más información, consulte API REST: acciones de ejecución de flujo de trabajo. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-de-la-acción> | String | Salida de la acción o propiedad especificada |
Ejemplo
En este ejemplo se obtiene el status
valor de propiedad de la acción Get user
X en tiempo de ejecución:
actions('Get_user').outputs.body.status
Y devuelve este resultado: "Succeeded"
add
Devuelve el resultado de sumar dos números.
add(<summand_1>, <summand_2>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<summand_1>, <summand_2> | Sí | Integer, Float o mixto | Números que se van a sumar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<resultado-de-la-suma> | Integer o Float | Resultado de sumar los números especificados |
Ejemplo
Este ejemplo suma los números especificados:
add(1, 1.5)
Y devuelve este resultado: 2.5
addDays
Agrega días a una marca de tiempo.
addDays('<timestamp>', <days>, '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<días> | Sí | Entero | Número positivo o negativo de días que desea agregar |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo más el número de días especificado |
Ejemplo 1
Este ejemplo agrega 10 días a la marca de tiempo especificada:
addDays('2018-03-15T00:00:00Z', 10)
Y devuelve este resultado: "2018-03-25T00:00:00.0000000Z"
Ejemplo 2
Este ejemplo resta cinco días a la marca de tiempo especificada:
addDays('2018-03-15T00:00:00Z', -5)
Y devuelve este resultado: "2018-03-10T00:00:00.0000000Z"
addHours
Agrega horas a una marca de tiempo.
addHours('<timestamp>', <hours>, '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<horas> | Sí | Entero | Número positivo o negativo de horas que desea agregar |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo más el número de horas especificado |
Ejemplo 1
Este ejemplo agrega 10 horas a la marca de tiempo especificada:
addHours('2018-03-15T00:00:00Z', 10)
Y devuelve este resultado: "2018-03-15T10:00:00.0000000Z"
Ejemplo 2
Este ejemplo resta cinco horas a la marca de tiempo especificada:
addHours('2018-03-15T15:00:00Z', -5)
Y devuelve este resultado: "2018-03-15T10:00:00.0000000Z"
addMinutes
Agrega minutos a una marca de tiempo.
addMinutes('<timestamp>', <minutes>, '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<minutos> | Sí | Entero | Número positivo o negativo de minutos que desea agregar |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo más el número de minutos especificado |
Ejemplo 1
Este ejemplo agrega 10 minutos a la marca de tiempo especificada:
addMinutes('2018-03-15T00:10:00Z', 10)
Y devuelve este resultado: "2018-03-15T00:20:00.0000000Z"
Ejemplo 2
Este ejemplo resta cinco minutos a la marca de tiempo especificada:
addMinutes('2018-03-15T00:20:00Z', -5)
Y devuelve este resultado: "2018-03-15T00:15:00.0000000Z"
addProperty
Agrega una propiedad y su valor o un par de nombre y valor a un objeto JSON y devuelve el objeto actualizado. Si la propiedad ya existe en tiempo de ejecución, la función genera un error.
addProperty(<object>, '<property>', <value>)
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON al que desea agregar una propiedad |
<propiedad> | Sí | String | Nombre de la propiedad que se va a agregar |
<value> | Sí | Any | Valor de la propiedad |
Valor devuelto | Tipo | Descripción |
---|---|---|
<objeto-actualizado> | Object | Objeto JSON actualizado con la propiedad especificada |
Para agregar una propiedad primaria a una existente, utilice la función setProperty()
, no addProperty()
. De lo contrario, la función devuelve solo el objeto secundario como salida.
setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON al que desea agregar una propiedad |
<parent-property> | Sí | String | Nombre de la propiedad primaria en la que desea agregar la propiedad secundaria |
<child-property> | Sí | String | Nombre de la propiedad secundaria que se va a agregar |
<value> | Sí | Any | Valor que se va a establecer para la propiedad especificada |
Valor devuelto | Tipo | Descripción |
---|---|---|
<objeto-actualizado> | Object | Objeto JSON actualizado cuya propiedad se ha establecido |
Ejemplo 1
En este ejemplo se agrega la propiedad middleName
a un objeto JSON, que se convierte de una cadena a JSON mediante la función JSON(). El objeto ya incluye las propiedades firstName
y surName
. La función asigna el valor especificado a la nueva propiedad y devuelve el objeto actualizado:
addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')
Este es el objeto JSON actual:
{
"firstName": "Sophia",
"surName": "Owen"
}
Este es el objeto JSON actualizado:
{
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
Ejemplo 2
En este ejemplo se agrega la propiedad secundaria middleName
a la propiedad existente customerName
en un objeto JSON, que se convierte de una cadena a JSON mediante la función JSON(). La función asigna el valor especificado a la nueva propiedad y devuelve el objeto actualizado:
setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))
Este es el objeto JSON actual:
{
"customerName": {
"firstName": "Sophia",
"surName": "Owen"
}
}
Este es el objeto JSON actualizado:
{
"customerName": {
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
}
addSeconds
Agrega segundos a una marca de tiempo.
addSeconds('<timestamp>', <seconds>, '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<segundos> | Sí | Entero | Número positivo o negativo de segundos que desea agregar |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo más el número de segundos especificado |
Ejemplo 1
Este ejemplo agrega 10 segundos a la marca de tiempo especificada:
addSeconds('2018-03-15T00:00:00Z', 10)
Y devuelve este resultado: "2018-03-15T00:00:10.0000000Z"
Ejemplo 2
Este ejemplo resta cinco segundos a la marca de tiempo especificada:
addSeconds('2018-03-15T00:00:30Z', -5)
Y devuelve este resultado: "2018-03-15T00:00:25.0000000Z"
addToTime
Agrega las unidades de tiempo especificadas a una marca de tiempo. Consulte también getFutureTime().
addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<intervalo> | Sí | Entero | Número de unidades de tiempo especificadas que se va a agregar |
<unidad_de_tiempo> | Sí | String | La unidad de tiempo que se usará con intervalo: "Segundo", "Minuto", "Hora", "Día", "Semana", "Mes", "Año" |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo más el número de unidades de tiempo especificado |
Ejemplo 1
Este ejemplo agrega un día a la marca de tiempo especificada:
addToTime('2018-01-01T00:00:00Z', 1, 'Day')
Y devuelve este resultado: "2018-01-02T00:00:00.0000000Z"
Ejemplo 2
Este ejemplo agrega un día a la marca de tiempo especificada:
addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')
Y devuelve el resultado con el formato "D" opcional: "Tuesday, January 2, 2018"
y
Comprueba si todas las expresiones son true. Devuelve true cuando todas las expresiones son verdaderas o devuelve false cuando al menos una expresión es falsa.
and(<expression1>, <expression2>, ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<expression1>, <expression2>, ... | Sí | Boolean | Expresiones que se van a comprobar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true si todas las expresiones son verdaderas. Devuelve false cuando al menos una expresión es falsa. |
Ejemplo 1
Estos ejemplos comprueban si los valores booleanos especificados son todos verdaderos:
and(true, true)
and(false, true)
and(false, false)
Y devuelve estos resultados:
- Primer ejemplo: ambas expresiones son verdaderas, por lo que devuelve
true
. - Segundo ejemplo: una expresión es falsa, por lo que devuelve
false
. - Tercer ejemplo: ambas expresiones son falsas, por lo que devuelve
false
.
Ejemplo 2
Estos ejemplos comprueban si las expresiones especificadas son todas verdaderas:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
Y devuelve estos resultados:
- Primer ejemplo: ambas expresiones son verdaderas, por lo que devuelve
true
. - Segundo ejemplo: una expresión es falsa, por lo que devuelve
false
. - Tercer ejemplo: ambas expresiones son falsas, por lo que devuelve
false
.
array
Devuelve una matriz a partir de una única entrada especificada. Para varias entradas, consulte createArray().
array('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena para la creación de una matriz |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<value>] | Array | Matriz que contiene la única entrada especificada |
Ejemplo
Este ejemplo crea una matriz a partir de la cadena "hello":
array('hello')
Y devuelve este resultado: ["hello"]
B
base64
Devuelve la versión de una cadena codificada en base64.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Codificación y descodificación en Base64.
base64('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena de entrada |
Valor devuelto | Tipo | Descripción |
---|---|---|
<cadena-en-base64> | String | Versión codificada en base64 de la cadena de entrada |
Ejemplo
Este ejemplo convierte la cadena "hello" en una cadena codificada en base64:
base64('hello')
Y devuelve este resultado: "aGVsbG8="
base64ToBinary
Devuelve la versión binaria de una cadena codificada en base64.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Codificación y descodificación en Base64.
base64ToBinary('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con codificación base64 que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<binario-de-cadena-en-base64> | String | Versión binaria de la cadena con codificación base64 |
Ejemplo
Este ejemplo convierte la cadena "aGVsbG8 =" codificada en base64 en una cadena binaria:
base64ToBinary('aGVsbG8=')
Por ejemplo, supongamos que usa una acción HTTP para enviar una solicitud. Puede usar base64ToBinary()
para convertir una cadena codificada en base64 en datos binarios y enviar los datos mediante el tipo de contenido application/octet-stream
de la solicitud.
base64ToString
Devuelve la versión de cadena de una cadena codificada en base64, decodificando dicha cadena en base64. Use esta función en lugar de decodeBase64(), que está en desuso.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Codificación y descodificación en Base64.
base64ToString('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con codificación base64 que se va a decodificar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<cadena-base64-decodificada> | String | Versión de cadena de una cadena codificada en base64 |
Ejemplo
Este ejemplo convierte la cadena "aGVsbG8 =" codificada en base64 en una cadena:
base64ToString('aGVsbG8=')
Y devuelve este resultado: "hello"
binary
Devuelve la versión binaria codificada en Base64 de una cadena.
binary('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<binario-del-valor-de-entrada> | String | La versión binaria codificada en Base64 de la cadena especificada |
Ejemplo
Por ejemplo, usa una acción HTTP que devuelve una imagen o un archivo de vídeo. Puede usar binary()
para convertir el valor en un modelo de sobre de contenido codificado en Base 64. A continuación, puede reutilizar el sobre de contenido en otras acciones, como Compose
.
Puede usar esta expresión de función para enviar los bytes de cadena con el tipo de contenido application/octet-stream
en la solicitud.
body
Devuelve la salida en tiempo de ejecución del elemento body
de una acción. Abreviatura de actions('<actionName>').outputs.body
. Consulte actions().
body('<actionName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Nombre de la acción cuya salida del elemento body desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-del-elemento-body-de-la-acción> | String | Salida del elemento body de la acción especificada |
Ejemplo
En este ejemplo se obtiene la body
salida de la Get user
acción X:
body('Get_user')
Y devuelve este resultado:
"body": {
"FullName": "Contoso Corporation",
"Location": "Generic Town, USA",
"Id": 283541717,
"UserName": "ContosoInc",
"FollowersCount": 172,
"Description": "Leading the way in transforming the digital workplace.",
"StatusesCount": 93,
"FriendsCount": 126,
"FavouritesCount": 46,
"ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}
bool
Devuelve la versión booleana de un valor.
bool(<value>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Any | Valor para convertir en booleano. |
Si está utilizando bool()
con un objeto, el valor del objeto debe ser una cadena o un entero que se pueda convertir en un valor booleano.
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false |
Boolean | Versión booleana del valor especificado. |
Salidas
En estos ejemplos se muestran los diferentes tipos de entrada admitidos para bool()
:
Valor de entrada | Tipo | Valor devuelto |
---|---|---|
bool(1) |
Entero | true |
bool(0) |
Entero | false |
bool(-1) |
Entero | true |
bool('true') |
String | true |
bool('false') |
String | false |
C
fragmento
Divide una cadena o matriz en fragmentos de igual longitud.
chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena o matriz | Colección que se va a dividir |
<longitud> | Sí | La longitud de cada fragmento |
Valor devuelto | Tipo | Descripción |
---|---|---|
<colección> | Array | Matriz de fragmentos con la longitud especificada |
Ejemplo 1
En este ejemplo se divide una cadena en fragmentos de longitud de 10:
chunk('abcdefghijklmnopqrstuvwxyz', 10)
Y devuelve este resultado: ['abcdefghij', 'klmnopqrst', 'uvwxyz']
Ejemplo 2
En este ejemplo se divide una matriz en fragmentos de longitud de 5.
chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)
Y devuelve este resultado: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]
coalesce
Devuelve el primer valor distinto de null de uno o más parámetros. Las cadenas vacías, las matrices vacías y los objetos vacíos no son nulos.
coalesce(<object_1>, <object_2>, ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<object_1>, <object_2>, ... | Sí | Cualquiera, se pueden mezclar tipos | Uno o más elementos para comprobar si hay valores NULL |
Valor devuelto | Tipo | Descripción |
---|---|---|
<primer-elemento-no-NULL> | Any | Primer elemento o valor que no sea NULL. Si todos los parámetros son NULL, esta función devuelve NULL. |
Ejemplo
Estos ejemplos devuelven el primer valor distinto de NULL de los valores especificados o NULL cuando todos los valores son NULL:
coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)
Y devuelve estos resultados:
- Primer ejemplo:
true
- Segundo ejemplo:
"hello"
- Tercer ejemplo:
null
concat
Combina dos o más cadenas y devuelve la cadena combinada.
concat('<text1>', '<text2>', ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<text1>, <text2>, ... | Sí | String | Al menos dos cadenas para combinar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<texto1texto2...> | String | Cadena que se crea a partir de las cadenas de entrada combinadas. Nota: La longitud del resultado no debe superar 104 857 600 caracteres. |
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente cuando use la función concat()
con los datos que necesitan codificación y descodificación:
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
Sin embargo, si usa esta función en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de la función y no a su efecto a menos que se modifiquen los valores de los parámetros de la función, lo que quita la función y su efecto del código. Para obtener más información, consulte Codificación y descodificación en Base64.
Ejemplo
Este ejemplo combina las cadenas "Hello" y "World":
concat('Hello', 'World')
Y devuelve este resultado: "HelloWorld"
contains
Comprueba si una colección contiene un elemento específico. Devuelve true cuando se encuentra el elemento o devuelve false cuando no se encuentra. Esta función distingue mayúsculas de minúsculas.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
En concreto, esta función funciona en estos tipos de colección:
- Una cadena para buscar una subcadena
- Una matriz para buscar un valor
- Un diccionario para buscar una clave
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena, matriz o diccionario | Colección que se va a comprobar |
<value> | Sí | Cadena, matriz o diccionario, respectivamente | Elemento que se va a buscar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando se encuentra el elemento. Devuelve false si no se encuentra. |
Ejemplo 1
Este ejemplo comprueba la cadena "hello world" para buscar la subcadena "world" y devuelve true:
contains('hello world', 'world')
Ejemplo 2
Este ejemplo comprueba la cadena "hello world" para buscar la subcadena "universe" y devuelve false:
contains('hello world', 'universe')
convertFromUtc
Convierte una marca de tiempo del formato Hora Universal Coordinada (UTC) a la zona horaria de destino.
convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<zona_horaria_de_destino> | Sí | String | Nombre de la zona horaria de destino. Para ver los nombres de las zonas horarias, revise Zonas horarias predeterminadas de Microsoft Windows. |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-convertida> | String | Marca de tiempo convertida en la zona horaria de destino sin la diferencia horaria con UTC de la zona horaria. |
Ejemplo 1
Este ejemplo convierte una marca de tiempo a la zona horaria especificada:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')
Y devuelve este resultado: "2018-01-01T00:00:00.0000000"
Ejemplo 2
Este ejemplo convierte una marca de tiempo a la zona horaria y el formato especificados:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')
Y devuelve este resultado: "Monday, January 1, 2018"
convertTimeZone
Convierte una marca de tiempo de la zona horaria de origen a la zona horaria de destino.
convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<zona_horaria_de_origen> | Sí | String | Nombre de la zona horaria de origen. Para los nombres de zonas horarias, consulte Zonas horarias predeterminadas de Microsoft Windows, pero es posible que tenga que quitar los signos de puntuación del nombre de zona horaria. |
<zona_horaria_de_destino> | Sí | String | Nombre de la zona horaria de destino. Para los nombres de zonas horarias, consulte Zonas horarias predeterminadas de Microsoft Windows, pero es posible que tenga que quitar los signos de puntuación del nombre de zona horaria. |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-convertida> | String | Marca de tiempo convertida a la zona horaria de destino |
Ejemplo 1
Este ejemplo convierte la zona horaria de origen a la zona horaria de destino:
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')
Y devuelve este resultado: "2018-01-01T00:00:00.0000000"
Ejemplo 2
Este ejemplo convierte una zona horaria a la zona horaria y el formato especificados:
convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')
Y devuelve este resultado: "Monday, January 1, 2018"
convertToUtc
Convierte una marca de tiempo de la zona horaria de origen al formato Hora Universal Coordinada (UTC).
convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<zona_horaria_de_origen> | Sí | String | Nombre de la zona horaria de origen. Para los nombres de zonas horarias, consulte Zonas horarias predeterminadas de Microsoft Windows, pero es posible que tenga que quitar los signos de puntuación del nombre de zona horaria. |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-convertida> | String | Marca de tiempo convertida a formato UTC |
Ejemplo 1
Este ejemplo convierte una marca de tiempo a formato UTC:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')
Y devuelve este resultado: "2018-01-01T08:00:00.0000000Z"
Ejemplo 2
Este ejemplo convierte una marca de tiempo a formato UTC:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')
Y devuelve este resultado: "Monday, January 1, 2018"
createArray
Devuelve una matriz a partir de varias entradas. Para matrices de una sola entrada, consulte array().
createArray('<object1>', '<object2>', ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<object1>, <object2>, ... | Sí | Cualquiera, pero no mixtos | Al menos dos elementos para crear la matriz |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<object1>, <object2>, ...] | Array | Matriz creada a partir de todos los elementos de entrada |
Ejemplo
Este ejemplo crea una matriz a partir de estas entradas:
createArray('h', 'e', 'l', 'l', 'o')
Y devuelve este resultado: ["h", "e", "l", "l", "o"]
D
dataUri
Devuelve un identificador uniforme de recursos (URI) de datos de una cadena.
dataUri('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<uri-de-datos> | String | Identificador URI de datos de la cadena de entrada |
Ejemplo
Este ejemplo crea un identificador URI de datos a partir de la cadena "hello":
dataUri('hello')
Y devuelve este resultado: "data:text/plain;charset=utf-8;base64,aGVsbG8="
dataUriToBinary
Devuelve la versión binaria de un identificador uniforme de recursos (URI) de datos.
Use esta función en lugar de decodeDataUri().
Aunque ambas funciones funcionan del mismo modo, dataUriBinary()
es preferible.
dataUriToBinary('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Identificador URI de datos que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<binario-de-uri-de-datos> | String | Versión binaria del identificador URI de datos |
Ejemplo
Este ejemplo crea una versión binaria de este identificador URI de datos:
dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Y devuelve este resultado:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
dataUriToString
Devuelve la versión de cadena de un identificador uniforme de recursos (URI) de datos.
dataUriToString('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Identificador URI de datos que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<cadena-de-uri-de-datos> | String | Versión de cadena del identificador URI de datos |
Ejemplo
Este ejemplo crea una cadena a partir de este identificador URI de datos:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Y devuelve este resultado: "hello"
dateDifference
Devuelve la diferencia entre dos marcas de tiempo como un intervalo de tiempo. Esta función resta startDate
de endDate
, y devuelve el resultado como marca de tiempo en formato de cadena.
dateDifference('<startDate>', '<endDate>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<startDate> | Sí | String | Cadena que contiene una marca de tiempo |
<endDate> | Sí | String | Cadena que contiene una marca de tiempo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<timespan> | String | La diferencia entre las dos marcas de tiempo, que es una marca de tiempo en formato de cadena. Si startDate es más reciente que endDate , el resultado es un valor negativo. |
Ejemplo
Este ejemplo resta el primer número del segundo número:
dateDifference('2015-02-08', '2018-07-30')
Y devuelve este resultado: "1268.00:00:00"
dayOfMonth
Devuelve el día del mes de una marca de tiempo.
dayOfMonth('<timestamp>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<día-del-mes> | Entero | Día del mes de la marca de tiempo especificada |
Ejemplo
Este ejemplo devuelve el número del día del mes de esta marca de tiempo:
dayOfMonth('2018-03-15T13:27:36Z')
Y devuelve este resultado: 15
dayOfWeek
Devuelve el día de la semana de una marca de tiempo.
dayOfWeek('<timestamp>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<día-de-la-semana> | Entero | Día de la semana de la marca de tiempo especificada, donde el domingo es 0, el lunes es 1, etc. |
Ejemplo
Este ejemplo devuelve el número del día de la semana de esta marca de tiempo:
dayOfWeek('2018-03-15T13:27:36Z')
Y devuelve este resultado: 4
dayOfYear
Devuelve el día del año de una marca de tiempo.
dayOfYear('<timestamp>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<día-del-año> | Entero | Día del año de la marca de tiempo especificada |
Ejemplo
Este ejemplo devuelve el número del día del año de esta marca de tiempo:
dayOfYear('2018-03-15T13:27:36Z')
Y devuelve este resultado: 74
Decimal
Devuelve un número decimal en una cadena como número decimal. Puede usar esta función cuando trabaje con datos que requieren precisión decimal y también como entrada para funciones de comparación lógica y funciones matemáticas. Para capturar y conservar la precisión cuando use el resultado de la función decimal(), ajuste cualquier salida decimal con la función de cadena. Este uso se muestra en los ejemplos siguientes, donde puede perder precisión si usa el resultado decimal como número.
Nota:
La precisión decimal que se describe en el contexto de esta función y el tiempo de ejecución de Azure Logic Apps es la misma que la precisión decimal de .NET.
decimal('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Número decimal en una cadena |
Valor devuelto | Tipo | Descripción |
---|---|---|
<decimal> | Decimal Number | Número decimal para la cadena de entrada |
Ejemplo 1
En este ejemplo se crea un decimal que se usa como número:
decimal('1.2345678912312131') // Returns 1.234567891231213.
Ejemplo 2
En este ejemplo se crea un decimal y, luego, el resultado se convierte en una cadena para conservar la precisión:
string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".
Ejemplo 3
En este ejemplo se usa una función matemática en dos números decimales, y el resultado se usa como número:
add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.
Ejemplo 4
En este ejemplo usa una función matemática en dos números decimales y, luego, el resultado se convierte en una cadena para conservar la precisión:
string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".
decodeBase64 (en desuso)
Está función está en desuso, así que use base64ToString() en su lugar.
decodeDataUri
Devuelve la versión binaria de un identificador uniforme de recursos (URI) de datos. Considere el uso de dataUriToBinary() en lugar de decodeDataUri()
. Aunque ambas funciones funcionan del mismo modo, dataUriToBinary()
es preferible.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Codificación y descodificación en Base64.
decodeDataUri('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena URI de datos que se va a decodificar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<binario-de-uri-de-datos> | String | Versión binaria de una cadena URI de datos |
Ejemplo
Este ejemplo devuelve la versión binaria de este identificador URI de datos:
decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Y devuelve este resultado:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
decodeUriComponent
Devuelve una cadena que reemplaza los caracteres de escape por versiones descodificadas.
decodeUriComponent('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con caracteres de escape que se va a decodificar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<uri-decodificado> | String | Cadena actualizada con los caracteres de escape decodificados |
Ejemplo
Este ejemplo reemplaza los caracteres de escape de esta cadena por versiones decodificadas:
decodeUriComponent('https%3A%2F%2Fcontoso.com')
Y devuelve este resultado: "https://contoso.com"
div
Devuelve el resultado de dividir dos números. Para obtener el resultado del resto, consulte mod().
div(<dividend>, <divisor>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<dividend> | Sí | Integer o Float | Número que se va a dividir entre el divisor. |
<divisor> | Sí | Integer o Float | Número que divide el dividendo, pero no puede ser cero |
Valor devuelto | Tipo | Descripción |
---|---|---|
<resultado-cociente> | Integer o Float | Resultado de dividir el primer número entre el segundo número. Si el dividendo o el divisor es de tipo float, el resultado será de tipo float. Nota: Para convertir el resultado de valor flotante en un entero, pruebe a crear y llamar a una función de Azure desde la aplicación lógica. |
Ejemplo 1
Ambos ejemplos devuelven este valor con el tipo integer: 2
div(10,5)
div(11,5)
Ejemplo 2
Ambos ejemplos devuelven este valor con el tipo float: 2.2
div(11,5.0)
div(11.0,5)
E
encodeUriComponent
Devuelve una versión codificada de un identificador uniforme de recursos (URI) de una cadena reemplazando los caracteres no seguros de la dirección URL por caracteres de escape. Considere el uso de uriComponent() en lugar de encodeUriComponent()
. Aunque ambas funciones funcionan del mismo modo, uriComponent()
es preferible.
Nota
Azure Logic Apps realiza de forma automática o implícita la codificación y descodificación Base64, por lo que no tiene que realizar estas conversiones manualmente mediante las funciones de codificación y descodificación. Sin embargo, si usa estas funciones en el diseñador, puede experimentar comportamientos de representación inesperados en el diseñador. Estos comportamientos solo afectan a la visibilidad de las funciones y no a su efecto a menos que se modifiquen los valores de los parámetros de las funciones, lo que quita las funciones y sus efectos del código. Para obtener más información, consulte Codificación y descodificación en Base64.
encodeUriComponent('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena que se va a convertir en formato codificado de URI |
Valor devuelto | Tipo | Descripción |
---|---|---|
<uri-codificado> | String | Cadena codificada en formato URI con caracteres de escape |
Ejemplo
Este ejemplo crea una versión codificada en formato URI de esta cadena:
encodeUriComponent('https://contoso.com')
Y devuelve este resultado: "https%3A%2F%2Fcontoso.com"
empty
Comprueba si una colección está vacía. Devuelve true cuando la colección está vacía o devuelve false cuando no está vacía.
empty('<collection>')
empty([<collection>])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena, matriz u objeto | Colección que se va a comprobar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando la colección está vacía. Devuelve false si no está vacía. |
Ejemplo
Estos ejemplos comprueban si las colecciones especificadas están vacías:
empty('')
empty('abc')
Y devuelve estos resultados:
- Primer ejemplo: pasa una cadena vacía, por lo que la función devuelve
true
. - Segundo ejemplo: pasa la cadena "abc", por lo que la función devuelve
false
.
endsWith
Comprueba si una cadena termina con una subcadena especificada. Devuelve true cuando se encuentra la subcadena o devuelve false cuando no se encuentra. Esta función no distingue mayúsculas de minúsculas.
endsWith('<text>', '<searchText>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que se va a comprobar |
<texto_a_buscar> | Sí | String | Subcadena final que se va a buscar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando se encuentra la subcadena final. Devuelve false si no se encuentra. |
Ejemplo 1
Este ejemplo comprueba si la cadena "hello world" termina con la cadena "world":
endsWith('hello world', 'world')
Y devuelve este resultado: true
Ejemplo 2
Este ejemplo comprueba si la cadena "hello world" termina con la cadena "universe":
endsWith('hello world', 'universe')
Y devuelve este resultado: false
equals
Comprueba si los valores, expresiones u objetos son equivalentes. Devuelve true cuando ambos son equivalentes o devuelve false cuando no son equivalentes.
equals('<object1>', '<object2>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<object1>, <object2> | Sí | Varios | Valores, expresiones u objetos que se van a comparar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando ambos son equivalentes. Devuelve false cuando no son equivalentes. |
Ejemplo
Estos ejemplos comprueban si las entradas especificadas son equivalentes.
equals(true, 1)
equals('abc', 'abcd')
Y devuelve estos resultados:
- Primer ejemplo: ambos valores son equivalentes, por lo que la función devuelve
true
. - Segundo ejemplo: ambos valores no son equivalentes, por lo que la función devuelve
false
.
F
first
Devuelve el primer elemento de una cadena o una matriz.
first('<collection>')
first([<collection>])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena o matriz | Colección en la que buscar el primer elemento |
Valor devuelto | Tipo | Descripción |
---|---|---|
<primer-elemento-de-la-colección> | Any | Primer elemento de la colección |
Ejemplo
Estos ejemplos buscan el primer elemento de estas colecciones:
first('hello')
first(createArray(0, 1, 2))
Asimismo, devuelven estos resultados:
- Primer ejemplo:
"h"
- Segundo ejemplo:
0
FLOAT
Convierte una versión de cadena de un número de punto flotante a un número de punto flotante real. Solo puede usar esta función al pasar parámetros personalizados a una aplicación, por ejemplo, una aplicación lógica de flujo de trabajo o un flujo de Power Automate. Para convertir cadenas de punto flotante representadas en formatos específicos de la configuración regional, puede especificar opcionalmente un código de configuración regional RFC 4646.
float('<value>', '<locale>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena que contiene un número de punto flotante válido que se va a convertir. Los valores mínimo y máximo son los mismos que los límites del tipo de datos float. |
<locale> | No | String | Código de configuración regional RFC 4646 que se va a usar. Si no se especifica, se usa la configuración regional predeterminada. Si la configuración regional no es un valor válido, se genera un error que indica que la configuración regional proporcionada no es válida o no tiene una configuración regional asociada. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-tipo-float> | Float | Número de punto flotante a partir de la cadena especificada. Los valores mínimo y máximo son los mismos que los límites del tipo de datos float. |
Ejemplo 1
Este ejemplo crea una versión de cadena para este número de punto flotante:
float('10,000.333')
Y devuelve este resultado: 10000.333
Ejemplo 2
Este ejemplo crea una versión de cadena para este número de punto flotante de estilo alemán:
float('10.000,333', 'de-DE')
Y devuelve este resultado: 10000.333
formatDateTime
Devuelve una marca de tiempo en el formato especificado.
formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. |
<locale> | No | String | Configuración regional que se va a usar. Si no se especifica, el valor es en-us . Si locale no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-con-nuevo-formato> | String | Marca de tiempo actualizada en el formato y la configuración regional especificados, si se especifica. |
Ejemplos
formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.
formDataMultiValues
Devuelve una matriz con valores que coinciden con un nombre de clave de la salidas form-data o form-encoded de una acción.
formDataMultiValues('<actionName>', '<key>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Acción cuya salida tiene el valor de una clave que busca |
<clave> | Sí | String | Nombre de la clave cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<array-with-key-values>] | Array | Matriz con todos los valores que coinciden con la clave especificada |
Ejemplo
Este ejemplo crea una matriz a partir del valor de la clave "Subject" de la salidas form-data o form-encoded de la acción especificada:
formDataMultiValues('Send_an_email', 'Subject')
Y devuelve el texto del asunto en una matriz, por ejemplo: ["Hello world"]
formDataValue
Devuelve un valor único que coincide con un nombre de clave en las salidas form-data o form-encoded de una acción. Si la función encuentra más de una coincidencia, la función produce un error.
formDataValue('<actionName>', '<key>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Acción cuya salida tiene el valor de una clave que busca |
<clave> | Sí | String | Nombre de la clave cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<key-value> | String | Valor de la clave especificada |
Ejemplo
Este ejemplo crea una cadena a partir del valor de la clave "Subject" de la salidas form-data o form-encoded de la acción especificada:
formDataValue('Send_an_email', 'Subject')
Y devuelve el texto del asunto como una cadena, por ejemplo: "Hello world"
formatNumber
Devuelve un número como una cadena que se basa en el formato especificado.
formatNumber(<number>, <format>, <locale>?)
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<number> | Sí | Entero o doble | Valor al que se desea dar formato. |
<formato> | Sí | String | Cadena de formato compuesto que especifica el formato que se quiere usar. Para ver las cadenas de formato numérico admitidas, consulte Cadenas con formato numérico estándar, que son compatibles con number.ToString(<format>, <locale>) . |
<locale> | No | String | Configuración regional que se va a usar como compatible con number.ToString(<format>, <locale>) . Si no se especifica, el valor es en-us . Si locale no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<formatted-number> | String | El número especificado como una cadena en el formato especificado. Puede convertir este valor devuelto en un valor int o float . |
Ejemplo 1
Supongamos que quiere dar formato al número 1234567890
. En este ejemplo se aplica formato a ese número como una cadena "1.234.567.890,00".
formatNumber(1234567890, '0,0.00', 'en-us')
*Ejemplo 2"
Supongamos que quiere dar formato al número 1234567890
. En este ejemplo se aplica formato al número como una cadena "1.234.567.890,00".
formatNumber(1234567890, '0,0.00', 'is-is')
Ejemplo 3
Supongamos que quiere dar formato al número 17.35
. En este ejemplo se aplica formato al número como una cadena "$17.35".
formatNumber(17.35, 'C2')
Ejemplo 4
Supongamos que quiere dar formato al número 17.35
. En este ejemplo se aplica formato al número como una cadena "17,35 KR".
formatNumber(17.35, 'C2', 'is-is')
G
getFutureTime
Devuelve la marca de tiempo actual más las unidades de tiempo especificadas.
getFutureTime(<interval>, <timeUnit>, <format>?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<intervalo> | Sí | Entero | Número de unidades de tiempo que se va a agregar |
<unidad_de_tiempo> | Sí | String | La unidad de tiempo que se usará con intervalo: "Segundo", "Minuto", "Hora", "Día", "Semana", "Mes", "Año" |
<formato> | No | String | Puede ser un especificador de formato sencillo o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se genera un error que indica que el formato proporcionado no es válido y debe ser una cadena con formato numérico. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo actual más el número de unidades de tiempo especificado |
Ejemplo 1
Imagine que la marca de tiempo actual es "2018-03-01T00:00:00.0000000Z". Este ejemplo agrega cinco días a esa marca de tiempo:
getFutureTime(5, 'Day')
Y devuelve este resultado: "2018-03-06T00:00:00.0000000Z"
Ejemplo 2
Imagine que la marca de tiempo actual es "2018-03-01T00:00:00.0000000Z". Este ejemplo agrega cinco días y convierte el resultado al formato "D":
getFutureTime(5, 'Day', 'D')
Y devuelve este resultado: "Tuesday, March 6, 2018"
getPastTime
Devuelve la marca de tiempo actual menos las unidades de tiempo especificadas.
getPastTime(<interval>, <timeUnit>, <format>?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<intervalo> | Sí | Entero | Número de unidades de tiempo especificadas que se va a sustraer |
<unidad_de_tiempo> | Sí | String | La unidad de tiempo que se usará con intervalo: "Segundo", "Minuto", "Hora", "Día", "Semana", "Mes", "Año" |
<formato> | No | String | Puede ser un especificador de formato sencillo o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se genera un error que indica que el formato proporcionado no es válido y debe ser una cadena con formato numérico. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo actual menos el número de unidades de tiempo especificado |
Ejemplo 1
Imagine que la marca de tiempo actual es "2018-02-01T00:00:00.0000000Z". Este ejemplo resta cinco días a esa marca de tiempo:
getPastTime(5, 'Day')
Y devuelve este resultado: "2018-01-27T00:00:00.0000000Z"
Ejemplo 2
Imagine que la marca de tiempo actual es "2018-02-01T00:00:00.0000000Z". Este ejemplo resta cinco días y convierte el resultado al formato "D":
getPastTime(5, 'Day', 'D')
Y devuelve este resultado: "Saturday, January 27, 2018"
greater
Comprueba si el primer valor es mayor que el segundo. Devuelve true cuando el primer valor es mayor o devuelve false cuando es menor.
greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Integer, Float o String | Primer valor para comprobar si es mayor que el segundo valor |
<compareTo> | Sí | Integer, Float o String, respectivamente | Valor de comparación |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true si el primer valor es mayor que el segundo. Devuelve false si el primer valor es igual o menor que el segundo. |
Ejemplo
Estos ejemplos comprueban si el primer valor es mayor que el segundo:
greater(10, 5)
greater('apple', 'banana')
Asimismo, devuelven estos resultados:
- Primer ejemplo:
true
- Segundo ejemplo:
false
greaterOrEquals
Comprueba si el primer valor es mayor o igual que el segundo. Devuelve true cuando el primer valor es mayor o igual o devuelve false cuando el primer valor es menor.
greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Integer, Float o String | Primer valor para comprobar si es mayor o igual que el segundo valor |
<compareTo> | Sí | Integer, Float o String, respectivamente | Valor de comparación |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true si el primer valor es mayor o igual que el segundo. Devuelve false si el primer valor es menor que el segundo. |
Ejemplo
Estos ejemplos comprueban si el primer valor es mayor o igual que el segundo:
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
Asimismo, devuelven estos resultados:
- Primer ejemplo:
true
- Segundo ejemplo:
false
guid
Genera un identificador único global (GUID) como una cadena, por ejemplo, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":
guid()
Además, es posible especificar un formato diferente del GUID que no sea el formato predeterminado, "D", que es 32 dígitos separados por guiones.
guid('<format>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<formato> | No | String | Un único especificador de formato para el GUID devuelto. De forma predeterminada, el formato es "D", pero puede usar "N", "D", "B", "P" o "X". |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-GUID> | String | GUID generado aleatoriamente |
Ejemplo
Este ejemplo genera el mismo GUID, pero como 32 dígitos separados por guiones y entre paréntesis:
guid('P')
Y devuelve este resultado: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"
I
if
Comprueba si una expresión es true o false. En función del resultado, devuelve un valor especificado. Los parámetros se evalúan de izquierda a derecha.
if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<expression> | Sí | Boolean | Expresión que se va a evaluar |
<valor_si_es_true> | Sí | Any | Valor que se devuelve cuando la expresión es verdadera |
<valor_si_es_false> | Sí | Any | Valor que se devuelve cuando la expresión es falsa |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-a-devolver-especificado> | Any | Valor especificado que se devuelve en función de si la expresión es true o false |
Ejemplo
Este ejemplo devuelve "yes"
porque la expresión especificada devuelve true.
En caso contrario, el ejemplo devuelve "no"
:
if(equals(1, 1), 'yes', 'no')
indexOf
Devuelve la posición de inicio o valor de índice de una subcadena. Esta función no distingue mayúsculas de minúsculas y los índices comienzan por el número 0.
indexOf('<text>', '<searchText>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene la subcadena que se va a buscar |
<texto_a_buscar> | Sí | String | Subcadena que se va a buscar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-índice> | Entero | Posición de inicio o valor de índice de la subcadena especificada. Si no se encuentra la cadena, devuelve el número -1. |
Ejemplo
Este ejemplo busca el valor de índice inicial de la subcadena "world" en la cadena "hello world":
indexOf('hello world', 'world')
Y devuelve este resultado: 6
int
Convierta la versión de cadena de un entero en un número entero real.
int('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Versión de cadena para el entero que se convertirá. Los valores mínimo y máximo son los mismos que los límites del tipo de datos entero. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<resultado-de-número-entero> | Entero | Versión como número entero de la cadena especificada. Los valores mínimo y máximo son los mismos que los límites del tipo de datos entero. |
Ejemplo
Este ejemplo crea una versión como número entero de la cadena "10":
int('10')
Y devuelve este resultado: 10
isFloat
Devuelve un valor booleano que indica si una cadena es un número de punto flotante. De forma predeterminada, esta función usa la referencia cultural invariable para el formato de punto flotante. Para identificar números de punto flotante representadas en formatos específicos que no son de la configuración regional, puede especificar opcionalmente un código de configuración regional RFC 4646.
isFloat('<string>', '<locale>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | La cadena que se va a examinar. |
<locale> | No | String | Código de configuración regional RFC 4646 que se va a usar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<boolean-result> | Boolean | Un valor booleano que indica si la cadena es un número de punto flotante |
Ejemplo 1
En este ejemplo se comprueba si una cadena es un número de punto flotante en la referencia cultural invariable:
isFloat('10,000.00')
Y devuelve este resultado: true
Ejemplo 2
En este ejemplo se comprueba si una cadena es un número de punto flotante en la configuración regional alemana:
isFloat('10.000,00', 'de-DE')
Y devuelve este resultado: true
isInt
Devuelve un valor booleano que indica si una cadena es un entero.
isInt('<string>')
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<string> | Sí | String | La cadena que se va a examinar. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<boolean-result> | Boolean | Un valor booleano que indica si la cadena es un entero |
Ejemplo
En este ejemplo se comprueba si una cadena es un entero:
isInt('10')
Y devuelve este resultado: true
item
Cuando se usa dentro de una acción de repetición sobre una matriz, devuelve el elemento actual de la matriz durante la iteración actual de la acción. También puede obtener los valores de las propiedades de ese elemento.
item()
Valor devuelto | Tipo | Descripción |
---|---|---|
<elemento-de-la-matriz-actual> | Any | Elemento actual de la matriz para la iteración actual de la acción |
Ejemplo
Este ejemplo obtiene el elemento body
del mensaje actual para la acción "Send_an_email" dentro de la iteración actual de un bucle for-each:
item().body
items
Devuelve el elemento actual de cada ciclo de un bucle for-each. Utilice esta función dentro del bucle for-each.
items('<loopName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_del_bucle> | Sí | String | Nombre del bucle for-each |
Valor devuelto | Tipo | Descripción |
---|---|---|
<elemento> | Any | Elemento del ciclo actual del bucle for-each especificado |
Ejemplo
Este ejemplo obtiene el elemento actual del bucle for-each especificado:
items('myForEachLoopName')
iterationIndexes
Se devuelve el valor de índice de la iteración actual dentro de un bucle Until. Puede usar esta función dentro de bucles Until anidados.
iterationIndexes('<loopName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_del_bucle> | Sí | String | El nombre del bucle Until |
Valor devuelto | Tipo | Descripción |
---|---|---|
<índice> | Entero | El valor de índice de la iteración actual dentro del bucle Until especificado |
Ejemplo
Este ejemplo crea una variable de contador y la incrementa en uno durante cada iteración en un bucle Until hasta que el valor del contador llega a cinco. El ejemplo también crea una variable que realiza un seguimiento del índice actual para cada iteración. Durante cada iteración del bucle Until, el ejemplo incrementa el valor del contador y luego lo asigna al valor de índice actual; a continuación, incrementa el valor del contador. En el bucle, este ejemplo hace referencia al índice de iteración actual mediante la función iterationIndexes
:
iterationIndexes('Until_Max_Increment')
{
"actions": {
"Create_counter_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myCounter",
"type": "Integer",
"value": 0
}
]
},
"runAfter": {}
},
"Create_current_index_variable": {
"type": "InitializeVariable",
"inputs": {
"variables": [
{
"name": "myCurrentLoopIndex",
"type": "Integer",
"value": 0
}
]
},
"runAfter": {
"Create_counter_variable": [ "Succeeded" ]
}
},
"Until_Max_Increment": {
"type": "Until",
"actions": {
"Assign_current_index_to_counter": {
"type": "SetVariable",
"inputs": {
"name": "myCurrentLoopIndex",
"value": "@variables('myCounter')"
},
"runAfter": {
"Increment_variable": [ "Succeeded" ]
}
},
"Compose": {
"inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
"runAfter": {
"Assign_current_index_to_counter": [
"Succeeded"
]
},
"type": "Compose"
},
"Increment_variable": {
"type": "IncrementVariable",
"inputs": {
"name": "myCounter",
"value": 1
},
"runAfter": {}
}
},
"expression": "@equals(variables('myCounter'), 5)",
"limit": {
"count": 60,
"timeout": "PT1H"
},
"runAfter": {
"Create_current_index_variable": [ "Succeeded" ]
}
}
}
}
J
json
Devuelve la matriz de objetos, el objeto o el valor de tipo Notación de objetos JavaScript (JSON) para una cadena o XML.
json('<value>')
json(xml('value'))
Importante
Sin un esquema XML que define la estructura de la salida, la función puede devolver resultados en los que la estructura difiere significativamente del formato esperado, dependiendo de la entrada.
Este comportamiento hace que esta función no sea adecuada para los escenarios en los que la salida debe cumplir un contrato bien definido, por ejemplo, en soluciones o sistemas empresariales críticos.
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String o XML | Cadena o XML que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<resultado-JSON> | Matriz, objeto o tipo nativo de JSON | La matriz de objetos, el objeto o el valor de tipo nativo de JSON de la cadena de entrada o XML. - Si pasa XML que tiene un único elemento secundario en el elemento raíz, la función devuelve un único objeto JSON para ese elemento secundario. - Si pasa XML que tiene varios elementos secundarios en el elemento raíz, la función devuelve una matriz que contiene objetos JSON para esos elementos secundarios. - Si la cadena es NULL, la función devuelve un objeto vacío. |
Ejemplo 1
Este ejemplo convierte esta cadena en un valor JSON:
json('[1, 2, 3]')
Y devuelve este resultado: [1, 2, 3]
Ejemplo 2
Este ejemplo convierte esta cadena en JSON:
json('{"fullName": "Sophia Owen"}')
Y devuelve este resultado:
{
"fullName": "Sophia Owen"
}
Ejemplo 3
En este ejemplo se usan las funciones json()
y xml()
para convertir XML que tiene un único elemento secundario en el elemento raíz en un objeto JSON denominado person
para ese elemento secundario:
json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
Y devuelve este resultado:
{
"?xml": {
"@version": "1.0"
},
"root": {
"person": {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
}
}
}
Ejemplo 4
En este ejemplo se usan las funciones json()
y xml()
para convertir XML que tiene varios elementos secundarios en el elemento raíz en una matriz denominada person
que contiene objetos JSON para esos elementos secundarios:
json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> <person id="2"> <name>John Doe</name> <occupation>Engineer</occupation> </person> </root>'))
Y devuelve este resultado:
{
"?xml": {
"@version": "1.0"
},
"root": {
"person": [
{
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
},
{
"@id": "2",
"name": "John Doe",
"occupation": "Engineer"
}
]
}
}
intersección
Devuelve una colección que tiene solo los elementos comunes en las colecciones especificadas. Para que aparezca en el resultado, un elemento debe aparecer en todas las colecciones que se pasan a esta función. Si uno o más elementos tienen el mismo nombre, el último elemento con ese nombre aparece en el resultado.
intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<collection1>, <collection2>, ... | Sí | Matriz u objeto, pero no ambos | Colecciones de las que desea solo los elementos comunes |
Valor devuelto | Tipo | Descripción |
---|---|---|
<elementos-comunes> | Matriz u objeto, respectivamente | Colección que tiene solo los elementos comunes en las colecciones especificadas |
Ejemplo
Este ejemplo busca los elementos comunes en estas matrices:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
Y devuelve una matriz con solo estos elementos: [1, 2]
join
Devuelve una cadena que tiene todos los elementos de una matriz y tiene cada carácter separado por un delimitador.
join([<collection>], '<delimiter>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Array | Matriz que tiene los elementos que se van a unir |
<delimitador> | Sí | String | Separador que aparece entre cada carácter de la cadena resultante |
Valor devuelto | Tipo | Descripción |
---|---|---|
<char1><delimiter><char2><delimiter>... | String | Cadena resultante creada a partir de todos los elementos de la matriz especificada. Nota: La longitud del resultado no debe superar 104 857 600 caracteres. |
Ejemplo
Este ejemplo crea una cadena a partir de todos los elementos de esta matriz con el carácter especificado como delimitador:
join(createArray('a', 'b', 'c'), '.')
Y devuelve este resultado: "a.b.c"
L
last
Devuelve el último elemento de una colección.
last('<collection>')
last([<collection>])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena o matriz | Colección en la que buscar el último elemento |
Valor devuelto | Tipo | Descripción |
---|---|---|
<último-elemento-de-la-colección> | Cadena o matriz, respectivamente | Último elemento de la colección |
Ejemplo
Estos ejemplos buscan el último elemento de estas colecciones:
last('abcd')
last(createArray(0, 1, 2, 3))
Y devuelve estos resultados:
- Primer ejemplo:
"d"
- Segundo ejemplo:
3
lastIndexOf
Devuelve la posición inicial o el valor de índice de la última repetición de una subcadena. Esta función no distingue mayúsculas de minúsculas y los índices comienzan por el número 0.
lastIndexOf('<text>', '<searchText>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene la subcadena que se va a buscar |
<texto_a_buscar> | Sí | String | Subcadena que se va a buscar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-índice-final> | Entero | Posición inicial o valor de índice de la última repetición de la subcadena especificada. |
Si el valor de cadena o subcadena está vacío, se produce el comportamiento siguiente:
Si solo el valor de cadena está vacío, la función devuelve
-1
.Si los valores de cadena y subcadena están vacíos, la función devuelve
0
.Si solo el valor de la subcadena está vacío, la función devuelve la longitud de la cadena menos 1.
Ejemplos
En este ejemplo se busca el valor de índice inicial de la última aparición de la subcadena world
en la cadena hello world hello world
. El resultado devuelto es 18
:
lastIndexOf('hello world hello world', 'world')
En este ejemplo falta el parámetro de subcadena, y se devuelve un valor de 22
porque el valor de la cadena de entrada (23
) menos 1 es mayor que 0.
lastIndexOf('hello world hello world', '')
length
Devuelve el número de elementos de una colección.
length('<collection>')
length([<collection>])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena o matriz | Colección con los elementos que se van a contar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<length-or-count> | Entero | Número de elementos de la colección |
Ejemplo
Estos ejemplos cuentan el número de elementos de estas colecciones:
length('abcd')
length(createArray(0, 1, 2, 3))
Y devuelven este resultado: 4
less
Comprueba si el primer valor es menor que el segundo. Devuelve true cuando el primer valor es menor o devuelve false cuando el primer valor es mayor.
less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Integer, Float o String | Primer valor para comprobar si es menor que el segundo valor |
<compareTo> | Sí | Integer, Float o String, respectivamente | Elemento de comparación |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true si el primer valor es menor que el segundo valor. Devuelve false si el primer valor es igual o mayor que el segundo. |
Ejemplo
En estos ejemplos se comprueba si el primer valor es menor que el segundo valor.
less(5, 10)
less('banana', 'apple')
Asimismo, devuelven estos resultados:
- Primer ejemplo:
true
- Segundo ejemplo:
false
lessOrEquals
Compruebe si el primer valor es menor o igual que el segundo valor. Devuelve "true" cuando el primer valor es menor o igual, o bien devuelve "false" si el primer valor es mayor.
lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Integer, Float o String | Primer valor que se va a comprobar si es menor o igual que el segundo valor. |
<compareTo> | Sí | Integer, Float o String, respectivamente | Elemento de comparación |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true si el primer valor es menor o igual que el segundo. Devuelve false si el primer valor es mayor que el segundo. |
Ejemplo
Estos ejemplos comprueban si el primer valor es menor o igual que el segundo.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
Asimismo, devuelven estos resultados:
- Primer ejemplo:
true
- Segundo ejemplo:
false
listCallbackUrl
Devuelve la "dirección URL de devolución de llamada" que llama a un desencadenador o una acción. Esta función solo funciona con desencadenadores y acciones para los tipos de conector HttpWebhook y ApiConnectionWebhook, pero no para los tipos Manual, Recurrence, HTTP y APIConnection.
listCallbackUrl()
Valor devuelto | Tipo | Descripción |
---|---|---|
<Dirección-URL-de-devolución-de-llamada> | String | Dirección URL de devolución de llamada para un desencadenador o una acción |
Ejemplo
Este ejemplo muestra una dirección URL de devolución de llamada de ejemplo que podría devolver esta función:
"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"
M
max
Devuelve el valor más alto de una lista o matriz con números, incluyendo ambos extremos.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<number1>, <number2>, ... | Sí | Integer, Float o ambos | Conjunto de números del que se desea obtener el valor más alto |
[<number1>, <number2>, ...] | Sí | Matriz: Integer, Float o ambos | Matriz de números de la cual quiere obtener el valor más alto |
Valor devuelto | Tipo | Descripción |
---|---|---|
<max-value> | Integer o Float | Valor más alto en la matriz o conjunto de números especificados |
Ejemplo
Estos ejemplos obtienen el valor más alto del conjunto de números y la matriz:
max(1, 2, 3)
max(createArray(1, 2, 3))
Y devuelven este resultado: 3
Min
Devuelve el valor más bajo de un conjunto de números o una matriz.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<number1>, <number2>, ... | Sí | Integer, Float o ambos | Conjunto de números del que se desea obtener el valor más bajo |
[<number1>, <number2>, ...] | Sí | Matriz: Integer, Float o ambos | Matriz de números de la que se desea obtener el valor más bajo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<min-value> | Integer o Float | Valor más bajo de la matriz o conjunto de números especificados |
Ejemplo
Estos ejemplos obtienen el valor más bajo del conjunto de números y la matriz:
min(1, 2, 3)
min(createArray(1, 2, 3))
Y devuelven este resultado: 1
mod
Devuelve el resto de dividir dos números. Para obtener el resultado de número entero, consulte div().
mod(<dividend>, <divisor>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<dividend> | Sí | Integer o Float | Número que se va a dividir entre el divisor. |
<divisor> | Sí | Integer o Float | Número que divide el dividendo, pero no puede ser cero |
Valor devuelto | Tipo | Descripción |
---|---|---|
<modulo-result> | Integer o Float | Resto de dividir el primer número entre el segundo número |
Ejemplo 1
En este ejemplo se divide el primer número por el segundo número:
mod(3, 2)
Y devuelve este resultado: 1
Ejemplo 2
En este ejemplo se muestra que si uno o ambos valores son negativos, el resultado coincide con el signo del dividendo:
mod(-5, 2)
mod(4, -3)
El ejemplo devuelve estos resultados:
- Primer ejemplo:
-1
- Segundo ejemplo:
1
mul
Devuelve el producto de multiplicar dos números.
mul(<multiplicand1>, <multiplicand2>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<multiplicand1> | Sí | Integer o Float | Número que se va a multiplicar por el multiplicando2 |
<multiplicand2> | Sí | Integer o Float | Número que multiplica al multiplicando1 |
Valor devuelto | Tipo | Descripción |
---|---|---|
<product-result> | Integer o Float | Producto de multiplicar el primer número por el segundo número |
Ejemplo
Estos ejemplos multiplican el primer número por el segundo número:
mul(1, 2)
mul(1.5, 2)
Asimismo, devuelven estos resultados:
- Primer ejemplo:
2
- Segundo ejemplo:
3
multipartBody
Devuelve el elemento body de una parte específica de la salida de una acción que consta de varias partes.
multipartBody('<actionName>', <index>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Nombre de la acción cuya salida tiene varias partes |
<índice> | Sí | Entero | Valor de índice de la parte que se busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<elemento_body> | String | Elemento body de la parte especificada |
No
not
Comprueba si una expresión es false. Devuelve verdadero cuando la expresión es falsa o devuelve false cuando es verdadera.
not(<expression>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<expression> | Sí | Boolean | Expresión que se va a evaluar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando la expresión es falsa. Devuelve false cuando la expresión es verdadera. |
Ejemplo 1
Estos ejemplos comprueban si las expresiones especificadas son falsas:
not(false)
not(true)
Asimismo, devuelven estos resultados:
- Primer ejemplo: la expresión es falsa, por lo que la función devuelve
true
. - Segundo ejemplo: la expresión es verdadera, por lo que la función devuelve
false
.
Ejemplo 2
Estos ejemplos comprueban si las expresiones especificadas son falsas:
not(equals(1, 2))
not(equals(1, 1))
Asimismo, devuelven estos resultados:
- Primer ejemplo: la expresión es falsa, por lo que la función devuelve
true
. - Segundo ejemplo: la expresión es verdadera, por lo que la función devuelve
false
.
nthIndexOf
Devuelve la posición inicial o el valor de índice donde la enésima repetición de una subcadena aparece en una cadena.
nthIndexOf('<text>', '<searchText>', <occurrence>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene la subcadena que se va a buscar |
<texto_a_buscar> | Sí | String | Subcadena que se va a buscar |
<occurrence> | Sí | Entero | Número que especifica la enésima aparición de la subcadena que se va a buscar. Si occurrence es negativo, comienza a buscar desde el final. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-índice> | Entero | Posición inicial o valor de índice de la enésima repetición de la subcadena especificada. Si no se encuentra la subcadena o si existen menos de n repeticiones de la subcadena, devuelve -1 . |
Ejemplos
nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.
O
or
Comprueba si al menos una expresión es true. Devuelve true cuando al menos una expresión es verdadera o devuelve false cuanto todas son falsas.
or(<expression1>, <expression2>, ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<expression1>, <expression2>, ... | Sí | Boolean | Expresiones que se van a comprobar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando al menos una expresión es verdadera. Devuelve false si todas las expresiones son falsas. |
Ejemplo 1
Estos ejemplos comprueban si al menos una expresión es verdadera:
or(true, false)
or(false, false)
Asimismo, devuelven estos resultados:
- Primer ejemplo: al menos una expresión es verdadera, por lo que la función devuelve
true
. - Segundo ejemplo: ambas expresiones son falsas, por lo que la función devuelve
false
.
Ejemplo 2
Estos ejemplos comprueban si al menos una expresión es verdadera:
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
Asimismo, devuelven estos resultados:
- Primer ejemplo: al menos una expresión es verdadera, por lo que la función devuelve
true
. - Segundo ejemplo: ambas expresiones son falsas, por lo que la función devuelve
false
.
outputs
Devuelve las salidas de una acción en tiempo de ejecución.
outputs('<actionName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_la_acción> | Sí | String | Nombre de la acción cuya salida desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida> | String | Salida de la acción especificada |
Ejemplo
En este ejemplo se obtiene la salida de la acción Get user
X :
outputs('Get_user')
Y devuelve este resultado:
{
"statusCode": 200,
"headers": {
"Pragma": "no-cache",
"Vary": "Accept-Encoding",
"x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
"X-Content-Type-Options": "nosniff",
"Timing-Allow-Origin": "*",
"Cache-Control": "no-cache",
"Date": "Mon, 09 Apr 2018 18:47:12 GMT",
"Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Type": "application/json; charset=utf-8",
"Expires": "-1",
"Content-Length": "339"
},
"body": {
"FullName": "Contoso Corporation",
"Location": "Generic Town, USA",
"Id": 283541717,
"UserName": "ContosoInc",
"FollowersCount": 172,
"Description": "Leading the way in transforming the digital workplace.",
"StatusesCount": 93,
"FriendsCount": 126,
"FavouritesCount": 46,
"ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}
}
P
parámetros
Se devuelve el valor de un parámetro que se describe en la definición de flujo de trabajo.
parameters('<parameterName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_del_parámetro> | Sí | String | Nombre del parámetro cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-del-parámetro> | Any | Valor del parámetro especificado |
Ejemplo
Suponga que tiene este valor JSON:
{
"fullName": "Sophia Owen"
}
Este ejemplo obtiene el valor del parámetro especificado:
parameters('fullName')
Y devuelve este resultado: "Sophia Owen"
parseDateTime
Devuelve la marca de tiempo de una cadena que contiene una marca de tiempo.
parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<locale> | No | String | Configuración regional que se va a usar. Si no se especifica, la configuración regional predeterminada es en-us . Si locale no es un valor válido, se produce un error. |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si no se especifica el formato, se intenta analizar con varios formatos compatibles con la configuración regional proporcionada. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<parsed-timestamp> | String | La marca de tiempo analizada con formato "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple con la norma ISO 8601 y conserva la información de zona horaria. |
Ejemplos
parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.
R
rand
Devuelve un entero aleatorio de un intervalo especificado, que incluye solo el extremo inicial.
rand(<minValue>, <maxValue>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<valor_mínimo> | Sí | Entero | Entero más bajo del intervalo |
<valor_maximo> | Sí | Entero | Entero que sigue al entero más alto del intervalo que puede devolver la función |
Valor devuelto | Tipo | Descripción |
---|---|---|
<random-result> | Entero | Entero aleatorio devuelto del intervalo especificado |
Ejemplo
Este ejemplo obtiene un entero aleatorio del intervalo especificado, sin incluir el valor máximo:
rand(1, 5)
Y devuelve uno de estos números como resultado: 1
, 2
, 3
o 4
range
Devuelve una matriz de enteros que comienza en un entero especificado.
range(<startIndex>, <count>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<startIndex> | Sí | Entero | Valor entero que inicia la matriz como el primer elemento |
<recuento> | Sí | Entero | El número de enteros en la matriz. El valor del parámetro count debe ser un entero positivo que no supere los 100 000. Nota: La suma de los valores startIndex y count no debe superar 2 147 483 647. |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<range-result>] | Array | Matriz de enteros comenzando a partir del índice especificado |
Ejemplo
Este ejemplo crea una matriz de enteros que comienza en el índice especificado y tiene el número especificado de enteros:
range(1, 4)
Y devuelve este resultado: [1, 2, 3, 4]
removeProperty
Elimina una propiedad de un objeto y devuelve el objeto actualizado. Si la propiedad que intenta quitar no existe, la función devuelve el objeto original.
removeProperty(<object>, '<property>')
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON del que desea eliminar una propiedad |
<propiedad> | Sí | String | Nombre de la propiedad que se va a eliminar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<objeto-actualizado> | Object | Objeto JSON actualizado sin la propiedad especificada |
Para quitar una propiedad secundaria de una propiedad existente, use esta sintaxis:
removeProperty(<object>['<parent-property>'], '<child-property>')
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON cuya propiedad desea quitar |
<parent-property> | Sí | String | Nombre de la propiedad primaria con la propiedad secundaria que desea quitar |
<child-property> | Sí | String | Nombre de la propiedad secundaria que se va a quitar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<objeto-actualizado> | Object | Objeto JSON actualizado cuya propiedad secundaria ha quitado. |
Ejemplo 1
En este ejemplo se quita la propiedad middleName
de un objeto JSON, que se convierte de cadena a JSON con la función JSON() y devuelve el objeto actualizado:
removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')
Este es el objeto JSON actual:
{
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
Este es el objeto JSON actualizado:
{
"firstName": "Sophia",
"surName": "Owen"
}
Ejemplo 2
En este ejemplo se quita la propiedad secundaria middleName
de una propiedad primaria customerName
en un objeto JSON, que se convierte de cadena a JSON mediante la función JSON() y devuelve el objeto actualizado:
removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')
Este es el objeto JSON actual:
{
"customerName": {
"firstName": "Sophia",
"middleName": "Anne",
"surName": "Owen"
}
}
Este es el objeto JSON actualizado:
{
"customerName": {
"firstName": "Sophia",
"surName": "Owen"
}
}
replace
Reemplaza una subcadena por la cadena especificada y devuelve la cadena resultante. Esta función distingue mayúsculas de minúsculas.
replace('<text>', '<oldText>', '<newText>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene la subcadena que se va a reemplazar |
<oldText> | Sí | String | Subcadena que se va a reemplazar. |
<newText> | Sí | String | Cadena que se va a reemplazar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<updated-text> | String | Cadena actualizada después de reemplazar la subcadena Si no se encuentra la subcadena, devuelve la cadena original. |
Ejemplo
Este ejemplo busca la subcadena "old" en "the old string" y reemplaza "old" por "new":
replace('the old string', 'old', 'new')
Y devuelve este resultado: "the new string"
resultado
Devuelve los resultados de las acciones de nivel superior en la acción de ámbito especificada, como una acción For_each
, Until
o Scope
. La función result()
acepta un único parámetro, que es el nombre del ámbito, y devuelve una matriz que contiene información de las acciones de primer nivel de ese ámbito. Estos objetos de acción incluyen los mismos atributos que los devueltos por la función actions()
, como la hora de inicio, la hora de finalización, el estado, las entradas, los identificadores de correlación y las salidas de la acción.
Nota
Esta función devuelve información solo de las acciones de primer nivel en la acción de ámbito y no de acciones anidadas más profundas, como las acciones Switch o Condition.
Por ejemplo, puede usar esta función para obtener los resultados de acciones con errores para que pueda diagnosticar excepciones y controlarlas. Para obtener más información, vea Obtención del contexto y resultados de errores.
result('<scopedActionName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<scopedActionName> | Sí | String | Nombre de la acción con ámbito donde desea que se muestren las entradas y salidas de las acciones de nivel superior dentro de ese ámbito |
Valor devuelto | Tipo | Descripción |
---|---|---|
<array-object> | Objeto de matriz | Una matriz que contiene matrices de entradas y salidas de cada acción de nivel superior dentro del ámbito especificado |
Ejemplo
En este ejemplo se devuelven las entradas y salidas de cada iteración de una acción HTTP que está dentro de un bucle For_each
mediante la función result()
en la acción Compose
:
{
"actions": {
"Compose": {
"inputs": "@result('For_each')",
"runAfter": {
"For_each": [
"Succeeded"
]
},
"type": "compose"
},
"For_each": {
"actions": {
"HTTP": {
"inputs": {
"method": "GET",
"uri": "https://httpstat.us/200"
},
"runAfter": {},
"type": "Http"
}
},
"foreach": "@triggerBody()",
"runAfter": {},
"type": "Foreach"
}
}
}
Este es el aspecto que podría tener el ejemplo de matriz devuelta, donde el objeto outputs
externo contiene las entradas y salidas de cada iteración de las acciones dentro de la acción For_each
.
[
{
"name": "HTTP",
"outputs": [
{
"name": "HTTP",
"inputs": {
"uri": "https://httpstat.us/200",
"method": "GET"
},
"outputs": {
"statusCode": 200,
"headers": {
"X-AspNetMvc-Version": "5.1",
"Access-Control-Allow-Origin": "*",
"Cache-Control": "private",
"Date": "Tue, 20 Aug 2019 22:15:37 GMT",
"Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
"Server": "Microsoft-IIS/10.0",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Length": "0"
},
"startTime": "2019-08-20T22:15:37.6919631Z",
"endTime": "2019-08-20T22:15:37.95762Z",
"trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
"clientTrackingId": "085863526764.....",
"code": "OK",
"status": "Succeeded"
}
},
{
"name": "HTTP",
"inputs": {
"uri": "https://httpstat.us/200",
"method": "GET"
},
"outputs": {
"statusCode": 200,
"headers": {
"X-AspNetMvc-Version": "5.1",
"Access-Control-Allow-Origin": "*",
"Cache-Control": "private",
"Date": "Tue, 20 Aug 2019 22:15:37 GMT",
"Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
"Server": "Microsoft-IIS/10.0",
"X-AspNet-Version": "4.0.30319",
"X-Powered-By": "ASP.NET",
"Content-Length": "0"
},
"startTime": "2019-08-20T22:15:37.6919631Z",
"endTime": "2019-08-20T22:15:37.95762Z",
"trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
"clientTrackingId": "085863526764.....",
"code": "OK",
"status": "Succeeded"
}
}
]
}
]
reverse
Invierte el orden de los elementos de una colección. Al usar esta función con sort(), puede ordenar una colección en orden descendente.
reverse([<collection>])
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Array | La colección que se va a invertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<updated-collection>] | Array | Colección invertida |
Ejemplo
En este ejemplo se invierte una matriz de enteros:
reverse(createArray(0, 1, 2, 3))
Y devuelve esta matriz: [3,2,1,0]
S
setProperty
Establece el valor de propiedad de un objeto JSON y devuelve el objeto actualizado. Si la propiedad que intenta establecer no existe, la propiedad se agrega al objeto. Para agregar una nueva propiedad, utilice la función addProperty().
setProperty(<object>, '<property>', <value>)
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON cuya propiedad desea establecer |
<propiedad> | Sí | String | Nombre de la propiedad existente o nueva que se va a establecer |
<value> | Sí | Any | Valor que se va a establecer para la propiedad especificada |
Para establecer la propiedad secundaria en un objeto secundario, use una llamada setProperty()
anidada en su lugar. De lo contrario, la función devuelve solo el objeto secundario como salida.
setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parámetro | Obligatorio | Type | Description |
---|---|---|---|
<objeto> | Sí | Object | Objeto JSON cuya propiedad desea establecer |
<parent-property> | Sí | String | Nombre de la propiedad primaria con la propiedad secundaria que desea establecer |
<child-property> | Sí | String | Nombre de la propiedad secundaria que va a establecer |
<value> | Sí | Any | Valor que se va a establecer para la propiedad especificada |
Valor devuelto | Tipo | Descripción |
---|---|---|
<objeto-actualizado> | Object | Objeto JSON actualizado cuya propiedad se ha establecido |
Ejemplo 1
En este ejemplo se establece la propiedad surName
en un objeto JSON, que se convierte de cadena a JSON mediante la función JSON(). La función asigna el valor especificado a la propiedad y devuelve el objeto actualizado:
setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')
Este es el objeto JSON actual:
{
"firstName": "Sophia",
"surName": "Owen"
}
Este es el objeto JSON actualizado:
{
"firstName": "Sophia",
"surName": "Hartnett"
}
Ejemplo 2
En este ejemplo se establece la propiedad secundaria surName
para la propiedad primaria customerName
en un objeto JSON, que se convierte de cadena a JSON mediante la función JSON(). La función asigna el valor especificado a la propiedad y devuelve el objeto actualizado:
setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))
Este es el objeto JSON actual:
{
"customerName": {
"firstName": "Sophie",
"surName": "Owen"
}
}
Este es el objeto JSON actualizado:
{
"customerName": {
"firstName": "Sophie",
"surName": "Hartnett"
}
}
skip
Quita elementos del principio de una colección y devuelve todos los demás elementos.
skip([<collection>], <count>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Array | Colección cuyos elementos desea eliminar |
<recuento> | Sí | Entero | Entero positivo para el número de elementos a eliminar al principio |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<updated-collection>] | Array | Colección actualizada después de eliminar los elementos especificados |
Ejemplo
Este ejemplo elimina un elemento, el número 0, del principio de la matriz especificada:
skip(createArray(0, 1, 2, 3), 1)
Y devuelve esta matriz con los elementos restantes: [1,2,3]
slice
Devuelve una subcadena especificando el valor o la posición inicial y final. Consulte también subcadena().
slice('<text>', <startIndex>, <endIndex>?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene la subcadena que se va a buscar |
<startIndex> | Sí | Entero | Posición o valor inicial de base cero para dónde empezar a buscar la subcadena. - Si startIndex es mayor que la longitud de la cadena, devuelve una cadena vacía. - Si startIndex es negativo, se empieza a buscar en el valor del índice que es la suma de la longitud de la cadena y startIndex. |
<endIndex> | No | Entero | Valor o posición final de base cero que indica dónde finalizar la búsqueda de la subcadena. El carácter situado en el valor de índice final no se incluye en la búsqueda. - Si no se especifica endIndex o si es mayor que la longitud de la cadena, se busca hasta el final de la cadena. - Si endIndex es negativo, se finaliza la búsqueda en el valor del índice que es la suma de la longitud de la cadena y endIndex. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<slice-result> | String | Cadena nueva que contiene la subcadena encontrada |
Ejemplos
slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.
sort
Ordena elementos de una colección. Puede ordenar los objetos de colección mediante cualquier clave que contenga un tipo simple.
sort([<collection>], <sortBy>?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Array | Colección con los elementos que se van a ordenar |
<sortBy> | No | String | Clave que se va a usar para ordenar los objetos de colección |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<updated-collection>] | Array | Colecciones ordenadas |
Ejemplo 1
En este ejemplo se ordena una matriz de enteros:
sort(createArray(2, 1, 0, 3))
Y devuelve esta matriz: [0,1,2,3]
Ejemplo 2
En este ejemplo se ordena una matriz de objetos por clave:
sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')
Y devuelve esta matriz: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]
split
Devuelve una matriz que contiene subcadenas, separadas por comas, en función de un carácter delimitador especificado en la cadena original.
split('<text>', '<delimiter>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | La cadena para separar en subcadenas según el delimitador especificado en la cadena original |
<delimitador> | Sí | String | El carácter de la cadena original que se usará como delimitador |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<substring1>,<substring2>,...] | Array | Una matriz que contiene subcadenas de la cadena original, separadas por comas |
Ejemplo 1
En este ejemplo se crea una matriz con las subcadenas de la cadena especificada según el carácter especificado como delimitador:
split('a_b_c', '_')
Y devuelve esta matriz como resultado: ["a","b","c"]
Ejemplo 2
En este ejemplo se crea una matriz con un único elemento cuando no existe ningún delimitador en la cadena:
split('a_b_c', ' ')
Y devuelve esta matriz como resultado: ["a_b_c"]
startOfDay
Devuelve el inicio del día de una marca de tiempo.
startOfDay('<timestamp>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo especificada, pero a partir de la marca de hora cero del día |
Ejemplo
Este ejemplo busca el inicio del día de esta marca de tiempo:
startOfDay('2018-03-15T13:30:30Z')
Y devuelve este resultado: "2018-03-15T00:00:00.0000000Z"
startOfHour
Devuelve el inicio de la hora de una marca de tiempo.
startOfHour('<timestamp>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo especificada, pero a partir de la marca de minuto cero de la hora |
Ejemplo
Este ejemplo busca el inicio de la hora de esta marca de tiempo:
startOfHour('2018-03-15T13:30:30Z')
Y devuelve este resultado: "2018-03-15T13:00:00.0000000Z"
startOfMonth
Devuelve el inicio del mes de una marca de tiempo.
startOfMonth('<timestamp>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo especificada, pero a partir del primer día del mes en la marca de hora cero |
Ejemplo 1
Este ejemplo devuelve el inicio del mes de esta marca de tiempo:
startOfMonth('2018-03-15T13:30:30Z')
Y devuelve este resultado: "2018-03-01T00:00:00.0000000Z"
Ejemplo 2
En este ejemplo se devuelve el inicio del mes en el formato especificado para esta marca de tiempo:
startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')
Y devuelve este resultado: "2018-03-01"
startsWith
Comprueba si una cadena comienza con una subcadena especificada. Devuelve true cuando se encuentra la subcadena o devuelve false cuando no se encuentra. Esta función no distingue mayúsculas de minúsculas.
startsWith('<text>', '<searchText>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que se va a comprobar |
<texto_a_buscar> | Sí | String | Cadena inicial que se va a buscar |
Valor devuelto | Tipo | Descripción |
---|---|---|
true o false | Boolean | Devuelve true cuando se encuentra la subcadena inicial. Devuelve false si no se encuentra. |
Ejemplo 1
Este ejemplo comprueba si la cadena "hello world" comienza con la subcadena "hello":
startsWith('hello world', 'hello')
Y devuelve este resultado: true
Ejemplo 2
Este ejemplo comprueba si la cadena "hello world" comienza con la subcadena "greetings":
startsWith('hello world', 'greetings')
Y devuelve este resultado: false
string
Devuelve la versión de cadena de un valor.
string(<value>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | Any | Valor que se va a convertir. Si este valor es NULL o se evalúa como NULL, el valor se convierte en un valor de cadena vacía ("" ). Por ejemplo, si asigna una variable de cadena a una propiedad que no existe, a la que puede acceder con el operador ? , el valor NULL se convierte en una cadena vacía. Sin embargo, comparar un valor NULL no es lo mismo que comparar una cadena vacía. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-cadena> | String | Versión de cadena del valor especificado. Si el valor del parámetro value es NULL o se evalúa como NULL, este valor se devuelve como un valor de cadena vacía ("" ). |
Ejemplo 1
Este ejemplo crea la versión de cadena de este número:
string(10)
Y devuelve este resultado: "10"
Ejemplo 2
En este ejemplo se crea una cadena a partir del objeto JSON especificado y usa el carácter de barra diagonal inversa (\) como carácter de escape para la marca de comillas dobles (").
string( { "name": "Sophie Owen" } )
Y devuelve este resultado: "{ \\"name\\": \\"Sophie Owen\\" }"
sub
Devuelve el resultado de restar el segundo número del primero.
sub(<minuend>, <subtrahend>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<minuendo> | Sí | Integer o Float | Número del que se resta el sustraendo |
<sustraendo> | Sí | Integer o Float | Número que se resta del minuendo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<resultado> | Integer o Float | Resultado de restar el segundo número del primero |
Ejemplo
Este ejemplo resta el segundo número del primer número:
sub(10.3, .3)
Y devuelve este resultado: 10
substring
Devuelve caracteres de una cadena a partir de la posición especificada o índice. Los valores de índice comienzan desde el número 0. Consulte también segmento().
substring('<text>', <startIndex>, <length>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena cuyos caracteres se toman |
<startIndex> | Sí | Entero | Un número positivo igual o mayor que 0 que desea utilizar como el valor de índice o la posición inicial |
<longitud> | No | Entero | Número positivo de caracteres que desea incluir en la subcadena |
Nota
Asegúrese de que la suma de agregar los valores de parámetro startIndex y length sea menor que la longitud de la cadena que se proporciona para el parámetro text. De lo contrario, recibirá un error, a diferencia de funciones similares en otros lenguajes, donde el resultado es la subcadena de startIndex al final de la cadena. El parámetro length es opcional y, si no se proporciona, la función substring() toma todos los caracteres comprendidos entre startIndex y el final de la cadena.
Valor devuelto | Tipo | Descripción |
---|---|---|
<subcadena-resultante> | String | Subcadena con el número especificado de caracteres, empezando en la posición de índice especificada de la cadena de origen |
Ejemplo
Este ejemplo crea una subcadena de cinco caracteres a partir de la cadena especificada, empezando en el valor de índice 6:
substring('hello world', 6, 5)
Y devuelve este resultado: "world"
subtractFromTime
Resta un número de unidades de tiempo de una marca de tiempo. Consulte también getPastTime.
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena que contiene la marca de tiempo |
<intervalo> | Sí | Entero | Número de unidades de tiempo especificadas que se va a sustraer |
<unidad_de_tiempo> | Sí | String | La unidad de tiempo que se usará con intervalo: "Segundo", "Minuto", "Hora", "Día", "Semana", "Mes", "Año" |
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actualizada> | String | Marca de tiempo menos el número de unidades de tiempo especificado |
Ejemplo 1
Este ejemplo resta un día de esta marca de tiempo:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')
Y devuelve este resultado: "2018-01-01T00:00:00.0000000Z"
Ejemplo 2
Este ejemplo resta un día de esta marca de tiempo:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')
Y devuelve el resultado con el formato "D" opcional: "Monday, January, 1, 2018"
T
take
Devuelve elementos del principio de una colección.
take('<collection>', <count>)
take([<collection>], <count>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<colección> | Sí | Cadena o matriz | Colección cuyos elementos desea tomar |
<recuento> | Sí | Entero | Entero positivo para el número de elementos a tomar desde el principio |
Valor devuelto | Tipo | Descripción |
---|---|---|
<subset> o [<subset>] | Cadena o matriz, respectivamente | Cadena o matriz que tiene el número especificado de elementos tomados desde el principio de la colección original |
Ejemplo
Estos ejemplos obtienen el número especificado de elementos desde el principio de estas colecciones:
take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)
Asimismo, devuelven estos resultados:
- Primer ejemplo:
"abc"
- Segundo ejemplo:
[0, 1, 2]
ticks
Devuelve el número de pasos, que son intervalos de 100 nanosegundos, desde el 1 de enero de 0001 a las 12:00:00 de la noche (o DateTime.Ticks en C#) hasta la marca de tiempo especificada. Para más información, consulte este tema: Propiedad DateTime.Ticks (sistema).
ticks('<timestamp>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<marca_de_tiempo> | Sí | String | Cadena de una marca de tiempo |
Valor devuelto | Tipo | Descripción |
---|---|---|
<número-de-ticks> | Entero | Número de ticks desde la marca de tiempo especificada |
toLower
Devuelve una cadena en formato de minúsculas. Si un carácter de la cadena no tiene un equivalente en minúsculas, se incluye sin cambios en la cadena devuelta.
toLower('<text>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que se devuelve en formato de minúsculas |
Valor devuelto | Tipo | Descripción |
---|---|---|
<texto-en-minúsculas> | String | Cadena original en minúsculas |
Ejemplo
Este ejemplo convierte esta cadena a minúsculas:
toLower('Hello World')
Y devuelve este resultado: "hello world"
toUpper
Devuelve una cadena en formato de mayúsculas. Si un carácter de la cadena no tiene un equivalente en mayúsculas, se incluye sin cambios en la cadena devuelta.
toUpper('<text>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que se devuelve en formato de mayúsculas |
Valor devuelto | Tipo | Descripción |
---|---|---|
<texto-en-mayúsculas> | String | Cadena original en mayúsculas |
Ejemplo
Este ejemplo convierte esta cadena a mayúsculas:
toUpper('Hello World')
Y devuelve este resultado: "HELLO WORLD"
desencadenador
Devuelve la salida en tiempo de ejecución de un desencadenador o los valores de otros pares de nombre y valor JSON, que puede asignar a una expresión.
Dentro de las entradas del desencadenador, la función devuelve la salida de la ejecución anterior.
Dentro de la condición del desencadenador, la función devuelve la salida de la ejecución actual.
De forma predeterminada, la función hace referencia al objeto del desencadenador entero, pero también puede especificar una propiedad cuyo valor desee obtener. Además, esta función tiene versiones abreviadas disponibles, consulte triggerOutputs() y triggerBody().
trigger()
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-del-desencadenador> | String | Salida de un desencadenador en tiempo de ejecución |
triggerBody
Devuelve la salida body
de un desencadenador en tiempo de ejecución. Abreviatura de trigger().outputs.body
. Consulte trigger().
triggerBody()
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-del-elemento-body-del-desencadenador> | String | Salida del elemento body del desencadenador |
triggerFormDataMultiValues
Devuelve una matriz con valores que coinciden con un nombre de clave de la salidas form-data o form-encoded de un desencadenador.
triggerFormDataMultiValues('<key>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<clave> | Sí | String | Nombre de la clave cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
[<array-with-key-values>] | Array | Matriz con todos los valores que coinciden con la clave especificada |
Ejemplo
Este ejemplo crea una matriz a partir del valor de la clave "feedUrl" de la salidas form-data o form-encoded de un desencadenador de RSS:
triggerFormDataMultiValues('feedUrl')
Y devuelve esta matriz como un resultado de ejemplo: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]
triggerFormDataValue
Devuelve una cadena con un valor único que coincide con un nombre de clave en las salidas form-data o form-encoded de un desencadenador. Si la función encuentra más de una coincidencia, la función produce un error.
triggerFormDataValue('<key>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<clave> | Sí | String | Nombre de la clave cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<key-value> | String | Valor de la clave especificada |
Ejemplo
Este ejemplo crea una cadena a partir del valor de la clave "feedUrl" de la salidas form-data o form-encoded de un desencadenador de RSS:
triggerFormDataValue('feedUrl')
Y devuelve esta cadena como un resultado de ejemplo: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"
triggerMultipartBody
Devuelve el elemento body de una parte específica de la salida de un desencadenador que consta de varias partes.
triggerMultipartBody(<index>)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<índice> | Sí | Entero | Valor de índice de la parte que se busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<elemento_body> | String | Elemento body de una parte específica de la salida de varias partes de un desencadenador |
triggerOutputs
Devuelve la salida de un desencadenador en tiempo de ejecución o valores de otros pares de nombre y valor JSON. Abreviatura de trigger().outputs
. Consulte trigger().
triggerOutputs()
Valor devuelto | Tipo | Descripción |
---|---|---|
<salida-del-desencadenador> | String | Salida de un desencadenador en tiempo de ejecución |
trim
Quita el espacio en blanco inicial y final de una cadena y devuelve la cadena actualizada.
trim('<text>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<texto> | Sí | String | Cadena que contiene los espacios en blanco iniciales y finales que se van a eliminar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<texto_actualizado> | String | Versión actualizada de la cadena original sin espacios en blanco iniciales o finales |
Ejemplo
En este ejemplo se quita el espacio en blanco inicial y final de la cadena " Hello World ":
trim(' Hello World ')
Y devuelve este resultado: "Hello World"
U
union
Devuelve una colección que tiene todos los elementos de las colecciones especificadas. Para que aparezca en el resultado, un elemento debe aparecer en alguna de las colecciones que se pasan a esta función. Si uno o más elementos tienen el mismo nombre, el último elemento con ese nombre aparece en el resultado.
union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<collection1>, <collection2>, ... | Sí | Matriz u objeto, pero no ambos | Colecciones de las que desean todos los elementos |
Valor devuelto | Tipo | Descripción |
---|---|---|
<colección_actualizada> | Matriz u objeto, respectivamente | Colección con todos los elementos de las colecciones especificadas, sin duplicados. |
Ejemplo
Este ejemplo obtiene todos los elementos de estas colecciones:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
Y devuelve este resultado: [1, 2, 3, 10, 101]
uriComponent
Devuelve una versión codificada de un identificador uniforme de recursos (URI) de una cadena reemplazando los caracteres no seguros de la dirección URL por caracteres de escape. Use esta función en lugar de encodeUriComponent(). Aunque ambas funciones funcionan del mismo modo, uriComponent()
es preferible.
uriComponent('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena que se va a convertir en formato codificado de URI |
Valor devuelto | Tipo | Descripción |
---|---|---|
<uri-codificado> | String | Cadena codificada en formato URI con caracteres de escape |
Ejemplo
Este ejemplo crea una versión codificada en formato URI de esta cadena:
uriComponent('https://contoso.com')
Y devuelve este resultado: "https%3A%2F%2Fcontoso.com"
uriComponentToBinary
Devuelve la versión binaria de un componente de un identificador uniforme de recursos (URI).
uriComponentToBinary('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con codificación URI que se va a convertir |
Valor devuelto | Tipo | Descripción |
---|---|---|
<binario-de-codificado-uri> | String | Versión binaria de la cadena con codificación URI. El contenido binario está codificado en base64 y representado por $content . |
Ejemplo
Este ejemplo crea la versión binaria de esta cadena con codificación URI:
uriComponentToBinary('https%3A%2F%2Fcontoso.com')
Y devuelve este resultado:
"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"
uriComponentToString
Devuelve la versión de cadena de una cadena codificada en formato de identificador uniforme de recursos (URI), decodificando dicha cadena.
uriComponentToString('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con codificación URI que se va a decodificar |
Valor devuelto | Tipo | Descripción |
---|---|---|
<uri-decodificado> | String | Versión decodificada de la cadena con codificación URI |
Ejemplo
Este ejemplo crea la versión de cadena decodificada de esta cadena con codificación URI:
uriComponentToString('https%3A%2F%2Fcontoso.com')
Y devuelve este resultado: "https://contoso.com"
uriHost
Devuelve el valor host
de un identificador uniforme de recursos (URI).
uriHost('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyo valor host desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-host> | String | Valor host del identificador URI especificado. |
Ejemplo
Este ejemplo busca el valor host
de este identificador URI:
uriHost('https://www.localhost.com:8080')
Y devuelve este resultado: "www.localhost.com"
uriPath
Devuelve el valor path
de un identificador uniforme de recursos (URI).
uriPath('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyo valor path desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-path> | String | Valor path del identificador URI especificado. Si path no tiene un valor, se devuelve el carácter "/". |
Ejemplo
Este ejemplo busca el valor path
de este identificador URI:
uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')
Y devuelve este resultado: "/catalog/shownew.htm"
uriPathAndQuery
Devuelve los valores path
y query
de un identificador uniforme de recursos (URI).
uriPathAndQuery('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyos valores path y query desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valores-path-y-query> | String | Valores path y query del identificador URI especificado. Si path no tiene un valor, se devuelve el carácter "/". |
Ejemplo
Este ejemplo busca los valores path
y query
de este identificador URI:
uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')
Y devuelve este resultado: "/catalog/shownew.htm?date=today"
uriPort
Devuelve el valor port
de un identificador uniforme de recursos (URI).
uriPort('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyo valor port desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-port> | Entero | Valor port del identificador URI especificado. Si port no especifica un valor, devuelve el puerto predeterminado del protocolo. |
Ejemplo
Este ejemplo devuelve el valor port
de este identificador URI:
uriPort('https://www.localhost:8080')
Y devuelve este resultado: 8080
uriQuery
Devuelve el valor query
de un identificador uniforme de recursos (URI).
uriQuery('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyo valor query desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-query> | String | Valor query del identificador URI especificado. |
Ejemplo
Este ejemplo devuelve el valor query
de este identificador URI:
uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')
Y devuelve este resultado: "?date=today"
UriScheme
Devuelve el valor scheme
de un identificador uniforme de recursos (URI).
uriScheme('<uri>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<uri> | Sí | String | Identificador URI cuyo valor scheme desea |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-scheme> | String | Valor scheme del identificador URI especificado. |
Ejemplo
Este ejemplo devuelve el valor scheme
de este identificador URI:
uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')
Y devuelve este resultado: "http"
utcNow
Devuelve la marca de tiempo actual.
utcNow('<format>')
De forma opcional, puede especificar otro formato con el parámetro <format>.
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<formato> | No | String | Cadena de formato numérico que es un especificador de formato único o un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que cumple la norma ISO 8601 y conserva la información de zona horaria. Si el formato no es un valor válido, se produce un error. |
Valor devuelto | Tipo | Descripción |
---|---|---|
<marca-de-tiempo-actual> | String | Fecha y hora actuales |
Ejemplo 1
Imagine que hoy es 15 de abril de 2018 a las 1:00:00 P.M. Este ejemplo obtiene la marca de tiempo actual:
utcNow()
Y devuelve este resultado: "2018-04-15T13:00:00.0000000Z"
Ejemplo 2
Imagine que hoy es 15 de abril de 2018 a las 1:00:00 P.M. Este ejemplo obtiene la marca de tiempo actual con el formato "D" opcional:
utcNow('D')
Y devuelve este resultado: "Sunday, April 15, 2018"
V
variables
Devuelve el valor de una variable especificada.
variables('<variableName>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<nombre_de_variable> | Sí | String | Nombre de la variable cuyo valor busca |
Valor devuelto | Tipo | Descripción |
---|---|---|
<valor-de-variable> | Any | Valor de la variable especificada |
Ejemplo
Suponga que el valor actual de la variable "numItems" es 20. Este ejemplo obtiene el valor entero de esta variable:
variables('numItems')
Y devuelve este resultado: 20
W
flujo de trabajo
Devuelve todos los detalles sobre el propio flujo de trabajo durante el tiempo de ejecución.
workflow().<property>
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<propiedad> | No | Cadena | Nombre de la propiedad de flujo de trabajo cuyo valor desea De manera predeterminada, un objeto de flujo de trabajo tiene estas propiedades: name , type , id , location , run y tags . - El run valor de propiedad es un objeto JSON que incluye estas propiedades: name , type y id . - La propiedad tags es un objeto JSON que incluye etiquetas que están asociadas a la aplicación lógica en Azure Logic Apps o fluyen en Power Automate y los valores de esas etiquetas. Para obtener más información acerca de las etiquetas de los recursos de Azure, revise los recursos de etiqueta, los grupos de recursos y las suscripciones de la organización lógica en Azure. Nota: de manera predeterminada, una aplicación lógica no tiene etiquetas, pero un flujo de Power Automate tiene las etiquetas flowDisplayName y environmentName . |
Ejemplo 1
Este ejemplo devuelve el nombre de la ejecución actual de un flujo de trabajo:
workflow().run.name
Ejemplo 2
Si usa Power Automate puede crear una expresión @workflow()
que use la propiedad de salida tags
para obtener los valores del flujo flowDisplayName
o la propiedad environmentName
.
Por ejemplo, puede enviar notificaciones de correo electrónico personalizadas desde el flujo que vuelve a vincular al flujo. Estas notificaciones pueden incluir un vínculo HTML que contiene el nombre para mostrar del flujo en el título del correo electrónico y sigue esta sintaxis:
<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>
x
Xml
Devuelve la versión XML de una cadena que contiene un objeto JSON.
xml('<value>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<value> | Sí | String | Cadena con el objeto JSON que se va a convertir El objeto JSON debe tener solo una propiedad raíz, que no puede ser una matriz. Use el carácter de barra diagonal inversa (\) como carácter de escape para la marca de comillas dobles ("). |
Valor devuelto | Tipo | Descripción |
---|---|---|
<versión-xml> | Object | XML codificado de la cadena u objeto JSON especificados |
Ejemplo 1
Este ejemplo convierte la cadena en XML:
xml('<name>Sophia Owen</name>')
Y devuelve este código XML resultante:
<name>Sophia Owen</name>
Ejemplo 2
Este ejemplo crea la versión XML de esta cadena, que contiene un objeto JSON:
xml(json('{ "name": "Sophia Owen" }'))
Y devuelve este código XML resultante:
<name>Sophia Owen</name>
Ejemplo 3
Suponga que tiene este objeto JSON:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
Este ejemplo crea código XML de una cadena que contiene este objeto JSON:
xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))
Y devuelve este código XML resultante:
<person>
<name>Sophia Owen</name>
<city>Seattle</city>
<person>
xpath
Comprueba el código XML de los nodos o valores que coinciden con una expresión XPath (XML Path Language) y devuelve los nodos o valores coincidentes. Una expresión XPath o simplemente "XPath", le ayuda a recorrer una estructura de documento XML para que pueda seleccionar nodos o valores de proceso del contenido XML.
Nota
En Consumo y aplicaciones lógicas estándar, todas las expresiones de función usan la biblioteca XPath de .NET. Las expresiones XPath son compatibles con la biblioteca .NET subyacente y solo admiten la expresión que admite la biblioteca .NET subyacente.
xpath('<xml>', '<xpath>')
Parámetro | Obligatorio | Type | Descripción |
---|---|---|---|
<xml> | Sí | Any | Cadena XML en la que buscar nodos o valores que coincidan con un valor de la expresión XPath |
<xpath> | Sí | Any | Expresión XPath utilizada para buscar nodos XML o valores coincidentes |
Valor devuelto | Tipo | Descripción |
---|---|---|
<nodo-xml> | XML | Nodo XML si solo un nodo coincide con la expresión XPath especificada |
<value> | Any | Valor de un nodo XML si solo un valor coincide con la expresión XPath especificada |
[<xml-node1>, <xml-node2>, ...] -o- [<value1>, <value2>, ...] | Array | Matriz con los nodos XML o valores que coinciden con la expresión XPath especificada |
Ejemplo 1
Suponga que tiene este valor string XML 'items'
:
<?xml version="1.0"?>
<produce>
<item>
<name>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
En este ejemplo se pasa la expresión XPath ('/produce/item/name/text()'
) para buscar los nodos que coinciden con el nodo <name></name>
de la string XML 'items'
y se devuelve una matriz con los siguientes valores de nodo:
xpath(xml(parameters('items')), '/produce/item/name/text()')
El ejemplo también usa la función parameters() para obtener la string XML de 'items'
y convertir la string a formato XML mediante la función xml().
Esta es la matriz de resultados rellenada con valores de los nodos que coinciden con <name></name>
:
[ Gala, Honeycrisp ]
Ejemplo 2
Para continuar el Ejemplo 1, en este ejemplo se pasa la expresión XPath ('/produce/item/name[1]'
) para buscar el primer elemento name
, que es el elemento secundario de item
.
xpath(xml(parameters('items')), '/produce/item/name[1]')
Este es el resultado: Gala
Ejemplo 3
Para continuar el Ejemplo 1, en este ejemplo se pasa la expresión XPath ('/produce/item/name[last()]'
) para buscar el último elemento name
, que es el elemento secundario de item
.
xpath(xml(parameters('items')), '/produce/item/name[last()]')
Este es el resultado: Honeycrisp
Ejemplo 4
En este ejemplo, supongamos que la string XML items
contiene también los atributos expired='true'
y expired='false'
:
<?xml version="1.0"?>
<produce>
<item>
<name expired='true'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name expired='false'>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
En este ejemplo se pasa la expresión XPath ('//name[@expired]'
) para buscar todos los elementos name
que tienen el atributo expired
:
xpath(xml(parameters('items')), '//name[@expired]')
Este es el resultado: [ Gala, Honeycrisp ]
Ejemplo 5
En este ejemplo, supongamos que la string XML items
contiene solo este atributo,expired = 'true'
:
<?xml version="1.0"?>
<produce>
<item>
<name expired='true'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
En este ejemplo se pasa la expresión XPath ('//name[@expired = 'true']'
) para buscar todos los elementos name
que tienen el atributo expired = 'true'
:
xpath(xml(parameters('items')), '//name[@expired = 'true']')
Este es el resultado: [ Gala ]
Ejemplo 6
En este ejemplo, supongamos que la string XML items
contiene también estos atributos:
expired='true' price='12'
expired='false' price='40'
<?xml version="1.0"?>
<produce>
<item>
<name expired='true' price='12'>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name expired='false' price='40'>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
En este ejemplo se pasa la expresión XPath ('//name[@price>35]'
) para buscar todos los elementos name
que tienen price > 35
:
xpath(xml(parameters('items')), '//name[@price>35]')
Este es el resultado: Honeycrisp
Ejemplo 7
En este ejemplo, supongamos que la string XML items
es la misma que en el Ejemplo 1:
<?xml version="1.0"?>
<produce>
<item>
<name>Gala</name>
<type>apple</type>
<count>20</count>
</item>
<item>
<name>Honeycrisp</name>
<type>apple</type>
<count>10</count>
</item>
</produce>
Este ejemplo busca nodos que coincidan con el nodo <count></count>
y agrega los valores de esos nodos con la función sum()
:
xpath(xml(parameters('items')), 'sum(/produce/item/count)')
Este es el resultado: 30
Ejemplo 8
En este ejemplo, supongamos que tiene esta string XML, que incluye el espacio de nombres del documento XML xmlns="https://contoso.com"
:
<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>
Estas expresiones usan alguna de las expresiones XPath (/*[name()="file"]/*[name()="location"]
o /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]
) para buscar los nodos que coinciden con el nodo <location></location>
. En estos ejemplos se muestra la sintaxis que se usa en el diseñador o en el editor de expresiones:
xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')
Este es el nodo de resultados que coincide con el nodo <location></location>
:
<location xmlns="https://contoso.com">Paris</location>
Importante
Si trabaja con la vista de código, use el carácter de barra diagonal inversa (\) para escapar la comilla doble ("). Por ejemplo, debe usar caracteres de escape al serializar una expresión como una cadena JSON. Sin embargo, si trabaja en el diseñador o en el editor de expresiones, no es necesario escapar las comillas dobles porque el carácter de barra diagonal inversa se agrega automáticamente a la definición subyacente, por ejemplo:
Vista de código:
xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Editor de expresiones:
xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
Ejemplo 9
Para continuar el Ejemplo 8, en este ejemplo se usa la expresión XPath 'string(/*[name()="file"]/*[name()="location"])'
para buscar el valor en el nodo <location></location>
:
xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')
Este es el resultado: Paris
Pasos siguientes
Más información sobre el Lenguaje de definición de flujo de trabajo.