Guía de referencia de las funciones de expresión de flujo de trabajo en Azure Logic Apps y Power Automate

Artículo
12/13/2023

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 original subscribe
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

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

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

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:

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

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 userX :

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.

Compartir vía

Guía de referencia de las funciones de expresión de flujo de trabajo en Azure Logic Apps y Power Automate

Funciones en expresiones

Consideraciones a la hora de usar funciones

Funciones de cadena

Funciones de colección

Funciones de comparación lógica

Funciones de conversión

Conversiones implícitas de tipos de datos

Codificación y descodificación Base64

Funciones matemáticas

Funciones de fecha y hora

Funciones de flujo de trabajo

Funciones de análisis de URI

Funciones de manipulación: JSON y XML

---------------------------------

Todas las funciones: lista alfabética

A

action

actions

add

addDays

addHours

addMinutes

addProperty

addSeconds

addToTime

y

array

B

base64

base64ToBinary

base64ToString

binary

body

bool

C

fragmento

coalesce

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dateDifference

dayOfMonth

dayOfWeek

dayOfYear

Decimal

decodeBase64 (en desuso)

decodeDataUri

decodeUriComponent

div

E

encodeUriComponent

empty

endsWith

equals

F

first

FLOAT

formatDateTime

formDataMultiValues

formDataValue

formatNumber

G

getFutureTime

getPastTime

greater

greaterOrEquals

guid

I

if

indexOf

int