Guia de referência para funções em expressões para fluxos de trabalho nas Aplicações Lógicas do Azure e no Power Automate

Aplica-se a: Azure Logic Apps (Consumo e Standard)

Para definições de fluxo de trabalho nos Aplicativos Lógicos do Azure e no Power Automate, algumas expressões obtêm seus valores de ações de tempo de execução que podem ainda não existir quando o fluxo de trabalho começar a ser executado. Para fazer referência ou processar os valores nessas expressões, você pode usar funções de expressão fornecidas pela Linguagem de Definição de Fluxo de Trabalho.

Note

Este guia de referência aplica-se às Aplicações Lógicas do Azure e ao Power Automate, mas existe na documentação das Aplicações Lógicas do Azure. Embora o guia se refira especificamente a fluxos de trabalho de aplicativos lógicos, essas funções funcionam tanto para fluxos de trabalho no Power Automate quanto para fluxos de trabalho em Aplicativos Lógicos do Azure. Para obter mais informações sobre funções e expressões no Power Automate, consulte Usar expressões em condições.

Por exemplo, você pode calcular valores usando funções matemáticas, como a função add(), quando quiser a soma de inteiros ou floats. Aqui estão outros exemplos de tarefas que você pode executar com funções:

Task	Sintaxe da função	Result
Retornar uma cadeia de caracteres em formato minúsculo.	toLower('<texto>') Por exemplo: toLower('Olá')	"hello"
Retornar um identificador global exclusivo (GUID).	guid()	"c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Para encontrar funções com base em sua finalidade geral, revise as tabelas a seguir. Ou, para obter informações detalhadas sobre cada função, consulte a lista alfabética.

Funções em expressões

Para mostrar como usar uma função em uma expressão, este exemplo mostra como você pode obter o customerName valor do parâmetro e atribuir esse valor à accountName propriedade usando a função parameters() em uma expressão:

"accountName": "@parameters('customerName')"

Aqui estão algumas outras maneiras gerais de usar funções em expressões:

Task	Sintaxe da função em uma expressão
Execute o trabalho com um item passando esse item para uma função.	"@<nomedafunção>(<item>)"
1. Obtenha o valor do parameterName usando a função aninhada `parameters()` . 2. Execute o trabalho com o resultado passando esse valor para functionName.	"@<functionName>(parâmetros('<parameterName>'))"
1. Obtenha o resultado da função interna aninhada functionName. 2. Passe o resultado para a função externa functionName2.	"@<functionName2>(<nomedafunção>(<item>))"
1. Obtenha o resultado de functionName. 2. Dado que o resultado é um objeto com propertyName, obtenha o valor dessa propriedade.	"@<funçãoNome>(<item>).<Nome da >propriedade"

Por exemplo, a concat() função pode tomar dois ou mais valores de cadeia de caracteres como parâmetros. Esta função combina essas cadeias de caracteres em uma cadeia de caracteres. Você pode passar literais de cordas, por exemplo, "Sophia" e "Owen" para obter uma string combinada, "SophiaOwen":

"customerName": "@concat('Sophia', 'Owen')"

Ou, você pode obter valores de cadeia de caracteres de parâmetros. Este exemplo usa a parameters() função em cada concat() parâmetro e os firstName parâmetros e lastName . Em seguida, você passa as cadeias de caracteres resultantes para a concat() função para obter uma cadeia combinada, por exemplo, "SophiaOwen":

"customerName": "@concat(parameters('firstName'), parameters('lastName'))"

De qualquer forma, ambos os exemplos atribuem o resultado à customerName propriedade.

Considerações sobre o uso de funções

O designer não avalia expressões de tempo de execução que são usadas como parâmetros de função em tempo de design. O designer requer que todas as expressões possam ser totalmente avaliadas no momento do design.
Os parâmetros de função são avaliados da esquerda para a direita.
Na sintaxe para definições de parâmetro, um ponto de interrogação (?) que aparece após um parâmetro significa que o parâmetro é opcional. Por exemplo, consulte getFutureTime().
As expressões de função que aparecem embutidas com texto sem formatação exigem a inclusão de chaves ({}) para usar o formato interpolado da expressão. Este formato ajuda a evitar problemas de análise. Se a expressão da função não aparecer alinhada com texto sem formatação, não serão necessárias chaves.

O exemplo a seguir mostra a sintaxe correta e incorreta:

Correto: "<text>/@{<function-name>('<parameter-name>')}/<text>"

Incorreto: "<text>/@<function-name>('<parameter-name>')/<text>"

Está bem: "@<function-name>('<parameter-name>')"

As seções a seguir organizam funções com base em sua finalidade geral, ou você pode navegar por essas funções em ordem alfabética.

Funções de cadeia de caracteres

Para trabalhar com cadeias de caracteres, você pode usar essas funções de cadeia de caracteres e também algumas funções de coleta de . As funções de cadeia de caracteres funcionam apenas em cadeias de caracteres.

Função String	Task
chunk	Divida uma cadeia de caracteres ou coleção em partes de igual comprimento.
concat	Combine duas ou mais cadeias de caracteres e devolva a cadeia de caracteres combinada.
endsWith	Verifique se uma cadeia de caracteres termina com a subcadeia especificada.
formatNumber	Retornar um número como uma cadeia de caracteres com base no formato especificado
guid	Gere um identificador globalmente único (GUID) como uma cadeia de caracteres.
indexOf	Retorne a posição inicial da substring.
isFloat	Retorna um booleano que indica se uma cadeia de caracteres é um número de vírgula flutuante.
isInt	Retorna um booleano que indica se uma cadeia de caracteres é um inteiro.
lastIndexOf	Retorne a posição inicial para a última ocorrência de uma substring.
length	Retornar o número de itens em uma cadeia de caracteres ou matriz.
nthIndexOf	Retornar a posição inicial ou o valor do índice onde a nésima ocorrência de uma substring aparece em uma cadeia de caracteres.
replace	Substitua uma substring pela string especificada e retorne a string atualizada.
slice	Retorna uma substring especificando a posição inicial e final ou o valor. Consulte também substring.
split	Retorna uma matriz que contém substrings, separadas por vírgulas, de uma cadeia de caracteres maior com base em um caractere delimitador especificado na cadeia de caracteres original.
startsWith	Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica.
substring	Retorne os caracteres de uma cadeia de texto, começando da posição especificada. Ver também fatia.
toLower	Retornar uma cadeia de caracteres em formato minúsculo.
toUpper	Retornar uma cadeia de caracteres em formato maiúsculo.
trim	Remova os espaços em branco no início e no final de uma cadeia de caracteres e devolva a cadeia atualizada.

Funções de recolha

Para trabalhar com coleções, geralmente matrizes, cadeias de caracteres e, às vezes, dicionários, você pode usar essas funções de coleção.

Função de recolha	Task
chunk	Divida uma cadeia de caracteres ou coleção em partes de igual comprimento.
contains	Verifique se uma coleção contém um item específico.
empty	Verifique se uma coleção está vazia.
first	Retorne o primeiro item de uma coleção.
intersection	Retornar uma coleção que tenha apenas os itens comuns nas coleções especificadas.
item	Se essa função aparecer dentro de uma ação de repetição sobre uma matriz, retorne o item atual na matriz durante a iteração atual da ação.
join	Retorna uma cadeia de caracteres que contém todos os itens de um array, separados pelo caractere especificado.
last	Devolver o último item de uma coleção.
length	Retornar o número de itens em uma cadeia de caracteres ou matriz.
reverse	Inverter a ordem dos itens em uma matriz.
skip	Remova itens da frente de uma coleção e devolva todos os outros itens.
sort	Classificar itens em uma coleção.
take	Devolver itens da parte inicial de uma coleção.
union	Retornar uma coleção que tenha todos os itens das coleções especificadas.

Funções de comparação lógica

Para trabalhar com condições, comparar valores e resultados de expressão ou avaliar vários tipos de lógica, você pode usar essas funções de comparação lógica. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Note

Se você usar funções ou condições lógicas para comparar valores, os valores nulos serão convertidos em valores de cadeia de caracteres vazia (""). O comportamento das condições difere quando você compara com uma cadeia de caracteres vazia em vez de um valor nulo. Para obter mais informações, consulte a função string().

Função de comparação lógica	Task
and	Verifique se todas as expressões são verdadeiras.
equals	Verifique se ambos os valores são equivalentes.
greater	Verifique se o primeiro valor é maior que o segundo.
greaterOrEquals	Verifique se o primeiro valor é maior ou igual ao segundo valor.
if	Verifique se uma expressão é verdadeira ou falsa. Com base no resultado, retorne um valor especificado.
isFloat	Retorna um booleano que indica se uma cadeia de caracteres é um número de vírgula flutuante.
isInt	Retorna um booleano que indica se uma cadeia de caracteres é um inteiro.
less	Verifique se o primeiro valor é menor que o segundo valor.
lessOrEquals	Verifique se o primeiro valor é menor ou igual ao segundo valor.
not	Verifique se uma expressão é falsa.
or	Verifique se pelo menos uma expressão é verdadeira.

Funções de conversão

Para alterar o tipo ou formato de um valor, você pode usar essas funções de conversão. Por exemplo, você pode alterar um valor de um booleano para um inteiro. Para obter mais informações sobre como os Aplicativos Lógicos do Azure lidam com tipos de conteúdo durante a conversão, consulte Manipular tipos de conteúdo. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Note

Os Aplicativos Lógicos do Azure executam automaticamente ou implicitamente a codificação e a decodificação base64, para que você não precise executar manualmente essas conversões usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer maneira no designer, poderá enfrentar comportamentos de renderização inesperados no designer. Esses comportamentos afetam apenas a visibilidade das funções e não seu efeito, a menos que você edite os valores de parâmetro das funções, o que remove as funções e seus efeitos do seu código. Para obter mais informações, consulte Conversões implícitas de tipo de dados.

Função de conversão	Task
array	Retornar um array a partir de uma única entrada especificada. Para várias entradas, consulte createArray.
base64	Devolve a versão codificada em base64 de uma string.
base64ToBinary	Devolver a versão binária de uma string codificada em base64.
base64ToString	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64.
binary	Retornar a versão binária para um valor de entrada.
bool	Retorne a versão booleana para um valor fornecido.
createArray	Retornar uma matriz de várias entradas.
dataUri	Retornar o URI de dados para um valor de entrada.
dataUriToBinary	Retornar a forma binária de um URI de dados.
dataUriToString	Retornar a versão em string de um URI de dados.
decimal	Retorna o número decimal de uma cadeia decimal.
decodeBase64	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64.
decodeDataUri	Retornar a forma binária de um URI de dados.
decodeUriComponent	Retorna uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.
encodeUriComponent	Retorna uma cadeia de caracteres que substitui caracteres não seguros de URL por caracteres de escape.
float	Retorna um número de ponto flutuante para um valor de entrada.
int	Retorne a versão inteira de uma string.
json	Retorne o valor ou objeto do tipo JSON (JavaScript Object Notation) para uma cadeia de caracteres ou XML.
string	Devolva a representação em forma de cadeia de caracteres de um valor de entrada.
uriComponent	Retorne a versão codificada por URI de um valor de entrada, substituindo os caracteres não seguros para URL por caracteres de escape.
uriComponentToBinary	Retorne a versão binária de uma cadeia de caracteres codificada por URI.
uriComponentToString	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada por URI.
xml	Retornar a versão XML de uma string.

Conversões de tipo de dados implícitas

Os Aplicativos Lógicos do Azure convertem automática ou implicitamente entre alguns tipos de dados, para que você não precise executar manualmente essas conversões. Por exemplo, se você usar valores que não sejam de cadeia de caracteres em que as cadeias de caracteres são esperadas como entradas, os Aplicativos Lógicos do Azure converterão automaticamente os valores que não sejam de cadeia de caracteres em cadeias de caracteres.

Por exemplo, suponha que um gatilho retorna um valor numérico como saída:

triggerBody()?['123']

Se você usar essa saída numérica onde a entrada de cadeia de caracteres é esperada, como uma URL, os Aplicativos Lógicos do Azure convertem automaticamente o valor em uma cadeia de caracteres usando a notação de chaves ({}):

@{triggerBody()?['123']}

Codificação e descodificação Base64

Os Aplicativos Lógicos do Azure executam automaticamente ou implicitamente a codificação ou decodificação base64, para que você não precise executar manualmente essas conversões usando as funções correspondentes:

base64(<value>)
base64ToBinary(<value>)
base64ToString(<value>)
base64(decodeDataUri(<value>))
concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))
decodeDataUri(<value>)

Note

Se você adicionar manualmente qualquer uma dessas funções ao usar o designer, diretamente a um gatilho ou ação ou usando o editor de expressão, navegue para longe do designer e, em seguida, retorne ao designer, a função desaparece do designer, deixando para trás apenas os valores dos parâmetros. Esse comportamento também acontece se você selecionar um gatilho ou ação que usa essa função sem editar os valores de parâmetro da função. Este resultado afeta apenas a visibilidade da função e não o efeito. Na visualização de código, a função não é afetada. No entanto, se você editar os valores de parâmetro da função, a função e seu efeito serão removidos da visualização de código, deixando para trás apenas os valores de parâmetro da função.

Funções matemáticas

Para trabalhar com inteiros e flutuadores, você pode usar essas funções matemáticas. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função matemática	Task
add	Retornar o resultado da adição de dois números.
div	Retornar o resultado da divisão de dois números.
max	Retornar o valor mais alto de um conjunto de números ou de uma matriz.
min	Retorna o valor mais baixo de um conjunto de números ou de uma matriz.
mod	Devolver o resto da divisão de dois números.
mul	Retornar o produto da multiplicação de dois números.
rand	Retornar um inteiro aleatório de um intervalo especificado.
range	Retornar uma matriz inteira que começa a partir de um inteiro especificado.
sub	Retorne o resultado de subtrair o segundo número do primeiro número.

Funções de data e hora

Para trabalhar com datas e horas, você pode usar essas funções de data e hora. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de data ou hora	Task
addDays	Adicione dias a um carimbo de data/hora.
addHours	Adicione horas a um carimbo de data/hora.
addMinutes	Adicione minutos a um carimbo de data/hora.
addSeconds	Adicione segundos a um carimbo de data/hora.
addToTime	Adicione unidades de tempo especificadas a um carimbo de data/hora. Consulte também o comando getFutureTime.
convertFromUtc	Converta uma marca temporal do Tempo Universal Coordenado (UTC) para o fuso horário de destino.
convertTimeZone	Converta uma marca temporal do fuso horário de origem para o fuso horário de destino.
convertToUtc	Converta um carimbo de data/hora do fuso horário de origem em Universal Time Coordinated (UTC).
dateDifference	Retorne a diferença entre duas datas como um intervalo de tempo.
dayOfMonth	Retorne o componente do dia do mês de um timestamp.
dayOfWeek	Obter o componente dia da semana de um timestamp.
dayOfYear	Devolver o componente do dia do ano de um carimbo de data/hora.
formatDateTime	Retornar a data de um carimbo de data/hora.
getFutureTime	Retornar a marca temporal atual somada às unidades de tempo especificadas. Consulte também addToTime.
getPastTime	Devolva o timestamp atual subtraindo das unidades de tempo especificadas. Consulte também subtractFromTime.
parseDateTime	Retornar o carimbo de data/hora de uma cadeia de caracteres que contém um carimbo de data/hora.
startOfDay	Retorne o início do dia para um carimbo de data/hora.
startOfHour	Devolver o início da hora para um carimbo de data/hora.
startOfMonth	Devolver o início do mês para um carimbo de data/hora.
subtractFromTime	Subtraia um número de unidades de tempo de uma data/hora. Consulte também getPastTime.
ticks	Retorne o valor da propriedade `ticks` para um carimbo de data/hora especificado.
utcNow	Retorne o carimbo de data/hora atual como uma cadeia de caracteres.

Funções de fluxo de trabalho

Estas funções de fluxo de trabalho podem ajudá-lo a:

Obtenha detalhes sobre uma instância de fluxo de trabalho em tempo de execução.
Trabalhe com as entradas usadas para instanciar aplicativos lógicos ou fluxos.
Faça referência às saídas de gatilhos e ações.

Por exemplo, você pode fazer referência às saídas de uma ação e usar esses dados em uma ação posterior. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de fluxo de trabalho	Task
action	Retorne a saída da ação atual em tempo de execução ou valores de outros pares de nome e valor JSON. Ver também ações.
actions	Retorna a saída de uma ação em tempo de execução ou valores de outros pares de nome e valor JSON. Ver também ação.
body	Retornar a saída de `body` uma ação em tempo de execução.
formDataMultiValues	Crie uma matriz com os valores que correspondem a um nome de chave em saídas de açãocodificadas ou dados de formulário .
formDataValue	Retorna um único valor que corresponde a um nome de chave na saída de dados de formulário ou codificada de formulário de uma ação.
item	Se essa função aparecer dentro de uma ação de repetição sobre uma matriz, retorne o item atual na matriz durante a iteração atual da ação.
items	Se essa função aparecer dentro de um loop Foreach ou Till, retorne o item atual do loop especificado.
iterationIndexes	Se essa função aparecer dentro de um loop Ent, retorne o valor de índice para a iteração atual. Você pode usar essa função dentro de loops Until aninhados.
listCallbackUrl	Retorne a "URL de retorno de chamada" que chama um gatilho ou ação.
multipartBody	Retornar o corpo de uma parte específica na saída de uma ação que tenha várias partes.
outputs	Retornar a saída de uma ação em tempo de execução.
parameters	Retornar o valor de um parâmetro descrito na definição do fluxo de trabalho.
result	Retornar as entradas e saídas das ações de nível superior dentro da ação de escopo especificada, como `For_each`, `Until`e `Scope`.
trigger	Retorna a saída de um gatilho em tempo de execução ou de outros pares de nome e valor JSON. Consulte também triggerOutputs e triggerBody.
triggerBody	Retornar a saída de um gatilho `body` em tempo de execução. Veja gatilho.
triggerFormDataValue	Retorna um único valor correspondente a um nome de chave em saídas de gatilho codificadas por dados ou formulários.
triggerMultipartBody	Retornar o corpo de uma parte específica na saída de várias partes de um gatilho.
triggerFormDataMultiValues	Crie uma matriz cujos valores correspondam a um nome de chave em saídas de gatilho codificadas por dados de formulário ou formulário.
triggerOutputs	Retorna a saída de um gatilho em tempo de execução ou valores de outros pares de nome e valor JSON. Veja gatilho.
variables	Retornar o valor de uma variável especificada.
workflow	Retornar todos os detalhes sobre o fluxo de trabalho em si durante o tempo de execução.

Funções de análise de URI

Para trabalhar com identificadores de recursos uniformes (URIs) e obter vários valores de propriedade para esses URIs, você pode usar essas funções de análise de URI. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de análise de URI	Task
uriHost	Retornar o `host` valor de um URI (identificador uniforme de recurso).
uriPath	Retornar o `path` valor de um URI (identificador uniforme de recurso).
uriPathAndQuery	Retorne os `path` valores e `query` para um URI (identificador uniforme de recurso).
uriPort	Retornar o `port` valor de um URI (identificador uniforme de recurso).
uriQuery	Retornar o `query` valor de um URI (identificador uniforme de recurso).
uriScheme	Retornar o `scheme` valor de um URI (identificador uniforme de recurso).

Funções de manipulação: JSON & XML

Para trabalhar com objetos JSON e nós XML, você pode usar essas funções de manipulação. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de manipulação	Task
addProperty	Adicione uma propriedade e seu valor, ou par nome-valor, a um objeto JSON e retorne o objeto atualizado.
coalesce	Retorna o primeiro valor não nulo de um ou mais parâmetros.
removeProperty	Remova uma propriedade de um objeto JSON e retorne o objeto atualizado.
setProperty	Defina o valor para a propriedade de um objeto JSON e retorne o objeto atualizado.
xpath	Verifique se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e retorne os nós ou valores correspondentes.

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

Todas as funções - lista alfabética

Esta seção lista todas as funções disponíveis em ordem alfabética.

A

ação

Retorne a saída da ação atual em tempo de execução ou valores de outros pares de nome e valor JSON, que você pode atribuir a uma expressão. Por padrão, essa função faz referência a todo o objeto action, mas você pode, opcionalmente, especificar uma propriedade cujo valor você deseja. Ver também ações().

Você pode usar a action() função somente nestes locais:

A unsubscribe propriedade para uma ação de webhook para que você possa acessar o resultado da solicitação original subscribe
A trackedProperties propriedade para uma ação
A do-until condição de loop para uma ação

action()
action().outputs.body.<property>

Parameter	Required	Tipo	Description
< propriedade>	No	String	O nome da propriedade do objeto de ação cujo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, você pode encontrar essas propriedades examinando os detalhes de um histórico de execução específico. Para obter mais informações, consulte API REST - Workflow Run Actions.

Valor de retorno	Tipo	Description
< ação-saída>	Object	A saída do objeto JSON da ação ou propriedade atual

actions

Retorna a saída de uma ação em tempo de execução ou valores de outros pares de nome e valor JSON, que você pode atribuir a uma expressão. Por padrão, a função faz referência a todo o objeto action, mas você pode, opcionalmente, especificar uma propriedade cujo valor você deseja. Para versões taquigráficas, consulte body(). Para a ação atual, consulte action().

Note

Anteriormente, você podia usar a actions() função ou o conditions elemento ao especificar que uma ação foi executada com base na saída de outra ação. No entanto, para declarar explicitamente dependências entre ações, agora você deve usar a propriedade da runAfter ação dependente. Para saber mais sobre a runAfter propriedade, consulte Capturar e manipular falhas com a propriedade runAfter.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>

Parameter	Required	Tipo	Description
< actionName>	Yes	String	O nome do objeto de ação cuja saída você deseja
< propriedade>	No	String	O nome da propriedade do objeto de ação cujo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, você pode encontrar essas propriedades examinando os detalhes de um histórico de execução específico. Para obter mais informações, consulte API REST - Workflow Run Actions.

Valor de retorno	Tipo	Description
< ação-saída>	Object	A saída do objeto JSON da ação ou propriedade especificada

Example

Este exemplo obtém o status valor da propriedade da ação Get user X em tempo de execução:

actions('Get_user').outputs.body.status

E devolve este resultado: "Succeeded"

add

Retornar o resultado da adição de dois números.

add(<summand_1>, <summand_2>)

Parameter	Required	Tipo	Description
< summand_1>, <summand_2>	Yes	Inteiro, Flutuante ou misto	Os números a adicionar

Valor de retorno	Tipo	Description
< soma dos resultados>	Inteiro ou flutuador	O resultado da adição dos números especificados

Example

Este exemplo adiciona os números especificados:

add(1, 1.5)

E devolve este resultado: 2.5

addDays

Adicione dias a um carimbo de data/hora.

addDays('<timestamp>', <days>, '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< dias>	Yes	Integer	O número positivo ou negativo de dias a adicionar
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A data e hora mais o número especificado de dias

Exemplo 1

Este exemplo adiciona 10 dias ao timestamp especificado:

addDays('2018-03-15T00:00:00Z', 10)

E devolve este resultado: "2018-03-25T00:00:00.0000000Z"

Exemplo 2

Este exemplo subtrai cinco dias do carimbo de data/hora especificado:

addDays('2018-03-15T00:00:00Z', -5)

E devolve este resultado: "2018-03-10T00:00:00.0000000Z"

addHours

Adicione horas a um carimbo de data/hora.

addHours('<timestamp>', <hours>, '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< horas>	Yes	Integer	O número positivo ou negativo de horas a adicionar
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A marca temporal mais o número especificado de horas

Exemplo 1

Este exemplo adiciona 10 horas ao carimbo de data/hora especificado:

addHours('2018-03-15T00:00:00Z', 10)

E devolve este resultado: "2018-03-15T10:00:00.0000000Z"

Exemplo 2

Este exemplo subtrai cinco horas do carimbo de data/hora especificado:

addHours('2018-03-15T15:00:00Z', -5)

E devolve este resultado: "2018-03-15T10:00:00.0000000Z"

addMinutes

Adicione minutos a um carimbo de data/hora.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< minutos>	Yes	Integer	O número positivo ou negativo de minutos a adicionar
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A marca temporal mais o número especificado de minutos

Exemplo 1

Este exemplo adiciona 10 minutos à marca temporal especificada.

addMinutes('2018-03-15T00:10:00Z', 10)

E devolve este resultado: "2018-03-15T00:20:00.0000000Z"

Exemplo 2

Este exemplo subtrai cinco minutos do timestamp especificado.

addMinutes('2018-03-15T00:20:00Z', -5)

E devolve este resultado: "2018-03-15T00:15:00.0000000Z"

addProperty

Adicione uma propriedade e seu valor, ou par nome-valor, a um objeto JSON e retorne o objeto atualizado. Se a propriedade já existir em tempo de execução, a função falhará e lançará um erro.

addProperty(<object>, '<property>', <value>)

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON onde você deseja adicionar uma propriedade
< propriedade>	Yes	String	O nome da propriedade a ser adicionada
< valor>	Yes	Any	O valor da propriedade

Valor de retorno	Tipo	Description
< atualizado-objeto>	Object	O objeto JSON atualizado com a propriedade especificada

Para adicionar uma propriedade pai a uma propriedade existente, use a setProperty() função, não a addProperty() função. Caso contrário, a função retorna apenas o objeto filho como saída.

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON onde você deseja adicionar uma propriedade
< Propriedade-mãe>	Yes	String	O nome da propriedade pai onde você deseja adicionar a propriedade filho
< Propriedade para crianças>	Yes	String	O nome da propriedade filho a ser adicionada
< valor>	Yes	Any	O valor a ser definido para a propriedade especificada

Valor de retorno	Tipo	Description
< atualizado-objeto>	Object	O objeto JSON atualizado cuja propriedade você definiu

Exemplo 1

Este exemplo adiciona a middleName propriedade a um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON( ). O objeto já inclui as firstName propriedades e surName . A função atribui o valor especificado à nova propriedade e retorna o objeto atualizado:

addProperty(json('{ "firstName": "Sophia", "lastName": "Owen" }'), 'middleName', 'Anne')

Aqui está o objeto JSON atual:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Aqui está o objeto JSON atualizado:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Exemplo 2

Este exemplo adiciona a middleName propriedade filho à propriedade existente customerName em um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON( ). A função atribui o valor especificado à nova propriedade e retorna o objeto atualizado:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', addProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'middleName', 'Anne'))

Aqui está o objeto JSON atual:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

Aqui está o objeto JSON atualizado:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

addSeconds

Adicione segundos a um carimbo de data/hora.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< segundos>	Yes	Integer	O número positivo ou negativo de segundos a adicionar
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A marca temporal mais o número especificado de segundos

Exemplo 1

Este exemplo adiciona 10 segundos ao carimbo de data/hora especificado:

addSeconds('2018-03-15T00:00:00Z', 10)

E devolve este resultado: "2018-03-15T00:00:10.0000000Z"

Exemplo 2

Este exemplo subtrai cinco segundos do timestamp especificado:

addSeconds('2018-03-15T00:00:30Z', -5)

E devolve este resultado: "2018-03-15T00:00:25.0000000Z"

addToTime

Adicione as unidades de tempo especificadas a um carimbo de data/hora. Consulte também getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< intervalo>	Yes	Integer	O número de unidades de tempo especificadas a serem adicionadas
< unidade de tempo>	Yes	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A data/hora somada ao número especificado de unidades de tempo

Exemplo 1

Este exemplo adiciona um dia ao timestamp especificado:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

E devolve este resultado: "2018-01-02T00:00:00.0000000Z"

Exemplo 2

Este exemplo adiciona um dia ao timestamp especificado:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

E retorna o resultado usando o formato "D" opcional: "Tuesday, January 2, 2018"

and

Verifique se todas as expressões são verdadeiras. Retorne true quando todas as expressões forem verdadeiras ou retorne false quando pelo menos uma expressão for false.

and(<expression1>, <expression2>, ...)

Parameter	Required	Tipo	Description
< expressão1>, <expressão2>, ...	Yes	booleano	As expressões a verificar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne true quando todas as expressões forem verdadeiras. Devolva falso quando pelo menos uma expressão esteja falsa.

Exemplo 1

Estes exemplos verificam se os valores booleanos especificados são todos verdadeiros:

and(true, true)
and(false, true)
and(false, false)

E devolve estes resultados:

Primeiro exemplo: Ambas as expressões são verdadeiras, portanto, retorna true.
Segundo exemplo: Uma expressão é falsa, portanto retorna false.
Terceiro exemplo: Ambas as expressões são falsas, portanto, retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são todas verdadeiras:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

E devolve estes resultados:

Primeiro exemplo: Ambas as expressões são verdadeiras, portanto, retorna true.
Segundo exemplo: Uma expressão é falsa, portanto retorna false.
Terceiro exemplo: Ambas as expressões são falsas, portanto, retorna false.

matriz

Retornar um array a partir de uma única entrada especificada. Para várias entradas, consulte createArray().

array('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres para criar uma matriz

Valor de retorno	Tipo	Description
[<valor>]	Array	Uma matriz que contém a única entrada especificada

Example

Este exemplo cria uma matriz a partir da cadeia de caracteres "hello":

array('hello')

E devolve este resultado: ["hello"]

B

base64

Devolve a versão codificada em base64 de uma string.

Note

Os Aplicativos Lógicos do Azure executam automaticamente ou implicitamente a codificação e a decodificação base64, para que você não precise executar manualmente essas conversões usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer maneira, poderá enfrentar comportamentos de renderização inesperados no designer. Esses comportamentos afetam apenas a visibilidade das funções e não seu efeito, a menos que você edite os valores de parâmetro das funções, o que remove as funções e seus efeitos do seu código. Para obter mais informações, consulte Codificação e decodificação Base64.

base64('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres de entrada

Valor de retorno	Tipo	Description
< > string base64	String	A versão codificada em base64 para a cadeia de caracteres de entrada

Example

Este exemplo converte a string "hello" em uma string codificada em base64:

base64('hello')

E devolve este resultado: "aGVsbG8="

base64ToBinary

Devolver a versão binária de uma string codificada em base64.

Note

base64ToBinary('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres codificada em base64 para converter

Valor de retorno	Tipo	Description
< > binário-para-cadeia-base64	String	A versão binária para a cadeia de caracteres codificada em base64

Example

Este exemplo converte a cadeia de caracteres codificada em "aGVsbG8=" base64 em uma cadeia binária:

base64ToBinary('aGVsbG8=')

Por exemplo, suponha que você esteja usando uma ação HTTP para enviar uma solicitação. Você pode usar base64ToBinary() para converter uma cadeia de caracteres codificada em base64 em dados binários e enviar esses dados usando o application/octet-stream tipo de conteúdo na solicitação.

base64ToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64, decodificando efetivamente a cadeia de caracteres base64. Use essa função em vez de decodeBase64(), que foi preterido.

Note

base64ToString('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres codificada em base64 para descodificar

Valor de retorno	Tipo	Description
< cadeia decodificada base64>	String	A versão de string para uma sequência codificada em base64

Example

Este exemplo converte a string codificada em "aGVsbG8=" base64 em apenas uma string:

base64ToString('aGVsbG8=')

E devolve este resultado: "hello"

binário

Retornar a versão binária codificada em base64 de uma cadeia de caracteres.

binary('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres a ser convertida

Valor de retorno	Tipo	Description
< binário para valor de entrada>	String	A versão binária codificada em base64 para a cadeia de caracteres especificada

Example

Por exemplo, você está usando uma ação HTTP que retorna um arquivo de imagem ou vídeo. Você pode usar binary() para converter o valor em um modelo de envelope de conteúdo codificado em base 64. Em seguida, você pode reutilizar o envelope de conteúdo em outras ações, como Compose. Você pode usar essa expressão de função para enviar os bytes de cadeia de caracteres com o application/octet-stream tipo de conteúdo na solicitação.

body

Retornar a saída de body uma ação em tempo de execução. Taquigrafia de actions('<actionName>').outputs.body. Ver actions().

body('<actionName>')

Parameter	Required	Tipo	Description
< actionName>	Yes	String	O nome da saída da `body` ação que você deseja

Valor de retorno	Tipo	Description
< ação-corpo-saída>	String	A `body` saída da ação especificada

Example

Este exemplo obtém a body saída da Get user ação X:

body('Get_user')

E devolve 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

Retornar a versão booleana de um valor.

bool(<value>)

Parameter	Required	Tipo	Description
< valor>	Yes	Any	O valor a converter para Booleano.

Se você estiver usando bool() com um objeto, o valor do objeto deve ser uma cadeia de caracteres ou um inteiro que possa ser convertido em booleano.

Valor de retorno	Tipo	Description
`true` ou `false`	booleano	A versão booleana do valor especificado.

Outputs

Estes exemplos mostram os diferentes tipos de entrada suportados para bool():

Valor de entrada	Tipo	Valor de retorno
`bool(1)`	Integer	`true`
`bool(0)`	Integer	`false`
`bool(-1)`	Integer	`true`
`bool('true')`	String	`true`
`bool('false')`	String	`false`

C

chunk

Divida uma cadeia de caracteres ou matriz em partes de comprimento igual.

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')

Parameter	Required	Tipo	Description
< coleção>	Yes	String ou matriz	A coleção a dividir
< comprimento>	Yes	O comprimento de cada pedaço

Valor de retorno	Tipo	Description
< coleção>	Array	Uma matriz de blocos com o comprimento especificado

Exemplo 1

Este exemplo divide uma cadeia de caracteres em partes de comprimento 10:

chunk('abcdefghijklmnopqrstuvwxyz', 10)

E devolve este resultado: ['abcdefghij', 'klmnopqrst', 'uvwxyz']

Exemplo 2

Este exemplo divide uma matriz em partes de comprimento 5.

chunk(createArray(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), 5)

E devolve este resultado: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

unir

Retorna o primeiro valor não nulo de um ou mais parâmetros. Cadeias de caracteres vazias, matrizes vazias e objetos vazios não são nulos.

coalesce(<object_1>, <object_2>, ...)

Parameter	Required	Tipo	Description
< object_1>, <object_2>, ...	Yes	Qualquer um pode misturar tipos	Um ou mais itens para verificar se são nulos

Valor de retorno	Tipo	Description
< primeiro-item-não-nulo>	Any	O primeiro item ou valor que não é nulo. Se todos os parâmetros forem nulos, essa função retornará null.

Example

Estes exemplos retornam o primeiro valor não nulo dos valores especificados ou null quando todos os valores são nulos:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

E devolve estes resultados:

Primeiro exemplo: true
Segundo exemplo: "hello"
Terceiro exemplo: null

concat

Combine duas ou mais cadeias de caracteres e devolva a cadeia de caracteres combinada.

concat('<text1>', '<text2>', ...)

Parameter	Required	Tipo	Description
< texto1>, <texto2>, ...	Yes	String	Pelo menos duas cadeias de caracteres para combinar

Valor de retorno	Tipo	Description
< texto1texto2...>	String	A cadeia de caracteres criada a partir das cadeias de caracteres de entrada combinadas. Nota: O comprimento do resultado não deve exceder 104.857.600 caracteres.

Note

Os Aplicativos Lógicos do Azure executam automaticamente ou implicitamente a codificação e a decodificação base64, portanto, você não precisa executar manualmente essas conversões quando usa a concat() função com dados que precisam de codificação ou decodificação:

concat('data:;base64,',<value>)
concat('data:,',encodeUriComponent(<value>))

No entanto, se você usar essa função de qualquer maneira no designer, poderá enfrentar comportamentos de renderização inesperados no designer. Esses comportamentos afetam apenas a visibilidade da função e não o efeito, a menos que você edite os valores de parâmetro da função, o que remove a função e o efeito do seu código. Para obter mais informações, consulte a codificação e decodificação Base64.

Example

Este exemplo combina as cadeias de caracteres "Hello" e "World":

concat('Hello', 'World')

E devolve este resultado: "HelloWorld"

contains

Verifique se uma coleção contém um item específico. Retorne true quando o item for encontrado ou retorne false quando não for encontrado. Esta função diferencia maiúsculas de minúsculas.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Especificamente, essa função funciona nestes tipos de coleção:

Uma cadeia de caracteres para encontrar uma subcadeia de
Uma matriz para encontrar um valor
Um dicionário para encontrar uma chave

Parameter	Required	Tipo	Description
< coleção>	Yes	String, matriz ou dicionário	A coleção a verificar
< valor>	Yes	String, Array ou Dictionary, respectivamente	O item a ser encontrado

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne verdadeiro quando o item for encontrado. Devolver falso quando não encontrado.

Exemplo 1

Este exemplo verifica a string "hello world" para a substring "world" e retorna true:

contains('hello world', 'world')

Exemplo 2

Este exemplo verifica a string "hello world" para a substring "universe" e retorna false:

contains('hello world', 'universe')

convertFromUtc

Converta uma marca temporal do Tempo Universal Coordenado (UTC) para o fuso horário de destino.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< fusoHorárioDestino>	Yes	String	O nome do fuso horário de destino. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows.
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< > de carimbo de data/hora convertido	String	O carimbo de data/hora convertido para o fuso horário de destino sem o deslocamento UTC de fuso horário.

Exemplo 1

Este exemplo converte um carimbo de data/hora para o fuso horário especificado:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

E devolve este resultado: "2018-01-01T00:00:00.0000000"

Exemplo 2

Este exemplo converte um carimbo de data/hora para o fuso horário e formato especificados.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

E devolve este resultado: "Monday, January 1, 2018"

convertTimeZone

Converta uma marca temporal do fuso horário de origem para o fuso horário de destino.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< fuso horário de origem>	Yes	String	O nome do fuso horário de origem. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< fusoHorárioDestino>	Yes	String	O nome do fuso horário de destino. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< > de carimbo de data/hora convertido	String	O carimbo de tempo convertido para o fuso horário de destino

Exemplo 1

Este exemplo converte o fuso horário de origem no fuso horário de destino:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

E devolve este resultado: "2018-01-01T00:00:00.0000000"

Exemplo 2

Este exemplo converte um fuso horário para o fuso horário e formato especificados:

convertTimeZone('2018-01-01T80:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

E devolve este resultado: "Monday, January 1, 2018"

convertToUtc

Converta um carimbo de data/hora do fuso horário de origem em Universal Time Coordinated (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< fuso horário de origem>	Yes	String	O nome do fuso horário de origem. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< > de carimbo de data/hora convertido	String	O carimbo de data/hora convertido em UTC

Exemplo 1

Este exemplo converte um carimbo de data e hora para UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

E devolve este resultado: "2018-01-01T08:00:00.0000000Z"

Exemplo 2

Este exemplo converte um carimbo de data e hora para UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

E devolve este resultado: "Monday, January 1, 2018"

createArray

Retornar uma matriz de várias entradas. Para matrizes de entrada única, consulte array().

createArray('<object1>', '<object2>', ...)

Parameter	Required	Tipo	Description
< objeto1>, <objeto2>, ...	Yes	Qualquer, mas não misturado	Pelo menos dois itens para criar a matriz

Valor de retorno	Tipo	Description
[<objeto1>, <objeto2>, ...]	Array	A matriz criada a partir de todos os itens de entrada

Example

Este exemplo cria uma matriz a partir destas entradas:

createArray('h', 'e', 'l', 'l', 'o')

E devolve este resultado: ["h", "e", "l", "l", "o"]

D

dataUri

Retorne um identificador uniforme de recursos (URI) de dados a partir de uma cadeia de caracteres.

dataUri('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres a ser convertida

Valor de retorno	Tipo	Description
< URI-DADOS>	String	O URI de dados para a cadeia de caracteres de entrada

Example

Este exemplo cria um URI de dados para a cadeia de caracteres "hello":

dataUri('hello')

E devolve este resultado: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retornar a versão binária para um URI (identificador de recurso uniforme de dados). Use esta função em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriBinary() é preferível.

dataUriToBinary('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	O URI dos dados a converter

Valor de retorno	Tipo	Description
< binário para uri de dados>	String	A versão binária para o URI de dados

Example

Este exemplo cria uma versão binária para este URI de dados:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E devolve este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retornar a versão da cadeia de caracteres para um URI (identificador de recurso uniforme de dados).

dataUriToString('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	O URI dos dados a converter

Valor de retorno	Tipo	Description
< string-para-data-uri>	String	A versão da cadeia de caracteres para o URI de dados

Example

Este exemplo cria uma cadeia de caracteres para este URI de dados:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E devolve este resultado: "hello"

dateDifference

Retorne a diferença entre dois carimbos de data/hora como um intervalo de tempo. Esta função subtrai de startDate e retorna o resultado como carimbo de data/hora no formato de cadeia de endDatecaracteres.

dateDifference('<startDate>', '<endDate>')

Parameter	Required	Tipo	Description
< data de início>	Yes	String	Uma cadeia de caracteres que contém um carimbo de data/hora
< Data de fim>	Yes	String	Uma cadeia de caracteres que contém um carimbo de data/hora

Valor de retorno	Tipo	Description
< Período de tempo>	String	A diferença entre os dois carimbos de data/hora, que é um carimbo de data/hora em formato de cadeia de caracteres. Se `startDate` for mais recente que `endDate`, o resultado é um valor negativo.

Example

Este exemplo subtrai o primeiro valor do segundo valor:

dateDifference('2015-02-08', '2018-07-30')

E devolve este resultado: "1268.00:00:00"

dayOfMonth

Retorne o dia do mês a partir de uma data e hora.

dayOfMonth('<timestamp>')

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor de retorno	Tipo	Description
< dia do mês>	Integer	O dia do mês a partir do timestamp especificado

Example

Este exemplo retorna o número do dia do mês deste timestamp:

dayOfMonth('2018-03-15T13:27:36Z')

E devolve este resultado: 15

dayOfWeek

Devolva o dia da semana a partir de um timestamp.

dayOfWeek('<timestamp>')

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor de retorno	Tipo	Description
< dia da semana>	Integer	O dia da semana a partir do timestamp especificado, onde domingo é 0, segunda-feira é 1 e assim por diante

Example

Este exemplo retorna o número correspondente ao dia da semana a partir desta marca temporal:

dayOfWeek('2018-03-15T13:27:36Z')

E devolve este resultado: 4

dayOfYear

Obtenha o dia do ano a partir de um timestamp.

dayOfYear('<timestamp>')

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor de retorno	Tipo	Description
< dia do ano>	Integer	O dia do ano a partir do timestamp especificado

Example

Este exemplo retorna o número do dia do ano a partir deste carimbo de data/hora.

dayOfYear('2018-03-15T13:27:36Z')

E devolve este resultado: 74

decimal

Retorna um número decimal em uma cadeia de caracteres como um número decimal. Você pode usar essa função quando estiver trabalhando com dados que exigem precisão decimal e também como entrada para funções de comparação lógica e funções matemáticas. Para capturar e preservar a precisão ao usar o resultado da função decimal(), envolva qualquer saída decimal com a função string. Esse uso é mostrado nos exemplos a seguir abaixo, onde você pode perder a precisão se usar o resultado decimal como um número.

Note

A precisão decimal discutida no contexto dessa função e do tempo de execução dos Aplicativos Lógicos do Azure é a mesma que a precisão decimal do .NET.

decimal('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	O número decimal em uma cadeia de caracteres

Valor de retorno	Tipo	Description
< decimais>	Número Decimal	O número decimal para a cadeia de caracteres de entrada

Exemplo 1

Este exemplo cria um decimal que é usado como um número:

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exemplo 2

Este exemplo cria um decimal e, em seguida, converte o resultado em uma cadeia de caracteres para preservação de precisão:

string(decimal('1.2345678912312131')) // Returns "1.2345678912312131".

Exemplo 3

Este exemplo usa uma função matemática em dois números decimais e usa o resultado como um número:

add(decimal('1.2345678912312131'), decimal('1.2345678912312131')) // Returns 2.469135782462426.

Exemplo 4

Este exemplo usa uma função matemática em dois números decimais e converte o resultado em uma cadeia de caracteres para preservação de precisão:

string(add(decimal('1.2345678912312131'), decimal('1.2345678912312131'))) // Returns "2.4691357824624262".

decodeBase64 (preterido)

Esta função foi preterida, portanto, use base64ToString() em vez disso.

decodeDataUri

Retornar a versão binária para um URI (identificador de recurso uniforme de dados). Considere usar dataUriToBinary(), em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriToBinary() é preferível.

Note

decodeDataUri('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres de URI de dados a ser decodificada

Valor de retorno	Tipo	Description
< binário para uri de dados>	String	A versão binária de uma string URI de dados

Example

Este exemplo retorna a versão binária para este URI de dados:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

E devolve este resultado: "hello"

decodeUriComponent

Retorna uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.

decodeUriComponent('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres com os caracteres de escape para decodificar

Valor de retorno	Tipo	Description
< > decodificado-uri	String	A cadeia de caracteres atualizada com os caracteres de escape decodificados

Example

Este exemplo substitui os caracteres de escape nesta cadeia de caracteres por versões decodificadas:

decodeUriComponent('https%3A%2F%2Fcontoso.com')

E devolve este resultado: "https://contoso.com"

div

Retornar o resultado da divisão de dois números. Para obter o resultado restante, consulte mod().

div(<dividend>, <divisor>)

Parameter	Required	Tipo	Description
< dividendos>	Yes	Inteiro ou flutuador	O número que será dividido pelo divisor
< divisor>	Yes	Inteiro ou flutuador	O número que divide o dividendo, mas não pode ser zero

Valor de retorno	Tipo	Description
< resultado do quociente>	Inteiro ou flutuador	O resultado da divisão do primeiro número pelo segundo número. Se o dividendo ou divisor tiver o tipo Float, o resultado terá o tipo Float. Observação: para converter o resultado flutuante em um inteiro, tente criar e chamar uma função no Azure a partir do seu aplicativo lógico.

Exemplo 1

Ambos os exemplos retornam esse valor com o tipo Integer: 2

div(10,5)
div(11,5)

Exemplo 2

Ambos os exemplos retornam esse valor com o tipo Float: 2.2

div(11,5.0)
div(11.0,5)

E

encodeUriComponent

Retorna uma versão codificada de URI (identificador de recurso uniforme) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Considere usar uriComponent(), em vez de encodeUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

Note

encodeUriComponent('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor de retorno	Tipo	Description
< uri codificado>	String	A cadeia de caracteres codificada por URI com caracteres de escape

Example

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

encodeUriComponent('https://contoso.com')

E devolve este resultado: "https%3A%2F%2Fcontoso.com"

empty

Verifique se uma coleção está vazia. Retorne true quando a coleção estiver vazia ou retorne false quando não estiver vazio.

empty('<collection>')
empty([<collection>])

Parameter	Required	Tipo	Description
< coleção>	Yes	String, matriz ou objeto	A coleção a verificar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne true quando a coleção estiver vazia. Retornar false quando não estiver vazio.

Example

Estes exemplos verificam se as coleções especificadas estão vazias:

empty('')
empty('abc')

E devolve estes resultados:

Primeiro exemplo: Passa uma cadeia de caracteres vazia, para que a função retorne true.
Segundo exemplo: Passa a string "abc", para que a função retorne false.

endsWith

Verifique se uma cadeia de caracteres termina com uma subcadeia específica. Retorne verdadeiro quando a substring for encontrada ou retorne falso quando não for encontrada. Esta função não diferencia maiúsculas de minúsculas.

endsWith('<text>', '<searchText>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres a ser verificada
< texto de pesquisa>	Yes	String	A subsequência final para encontrar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne verdadeiro quando a substring final for encontrada. Devolver falso quando não encontrado.

Exemplo 1

Este exemplo verifica se a cadeia de caracteres "hello world" termina com a string "world":

endsWith('hello world', 'world')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a string "hello world" termina com a string "universe":

endsWith('hello world', 'universe')

E devolve este resultado: false

equals

Verifique se ambos os valores, expressões ou objetos são equivalentes. Retorne true quando ambos forem equivalentes, ou retorne false quando não forem equivalentes.

equals('<object1>', '<object2>')

Parameter	Required	Tipo	Description
< objeto1>, <objeto2>	Yes	Various	Os valores, expressões ou objetos a serem comparados

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne verdadeiro quando ambos forem equivalentes. Devolver falso quando não for equivalente.

Example

Estes exemplos verificam se as entradas especificadas são equivalentes.

equals(true, 1)
equals('abc', 'abcd')

E devolve estes resultados:

Primeiro exemplo: Ambos os valores são equivalentes, portanto, a função retorna true.
Segundo exemplo: Ambos os valores não são equivalentes, portanto, a função retorna false.

F

first

Retornar o primeiro item de uma cadeia de caracteres ou matriz.

first('<collection>')
first([<collection>])

Parameter	Required	Tipo	Description
< coleção>	Yes	String ou matriz	A coleção onde encontrar o primeiro item

Valor de retorno	Tipo	Description
< primeiro-item-de-coleção>	Any	O primeiro item da coleção

Example

Estes exemplos encontram o primeiro item destas coleções:

first('hello')
first(createArray(0, 1, 2))

Então devolva estes resultados:

Primeiro exemplo: "h"
Segundo exemplo: 0

float

Converter uma versão de cadeia de caracteres para um número de ponto flutuante em um número de ponto flutuante real. Você pode usar essa função somente ao passar parâmetros personalizados para um aplicativo, por exemplo, um fluxo de trabalho de aplicativo lógico ou fluxo do Power Automatic. Para converter cadeias de caracteres de ponto flutuante representadas em formatos específicos de localidade, você pode, opcionalmente, especificar um código de localidade RFC 4646.

float('<value>', '<locale>'?)

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres que tem um número de ponto flutuante válido para converter. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados float.
< localidade>	No	String	O código de localidade RFC 4646 a ser usado. Se não for especificado, a localidade padrão será usada. Se a localidade não for um valor válido, será gerado um erro informando que a localidade fornecida não é válida ou não tem uma localidade associada.

Valor de retorno	Tipo	Description
< de valor flutuante>	Float	O número de vírgula flutuante para a cadeia de caracteres especificada. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados float.

Exemplo 1

Este exemplo cria uma versão de cadeia de caracteres para esse número de vírgula flutuante:

float('10,000.333')

E devolve este resultado: 10000.333

Exemplo 2

Este exemplo cria uma versão de cadeia de caracteres para esse número de ponto flutuante no estilo alemão:

float('10.000,333', 'de-DE')

E devolve este resultado: 10000.333

Exemplo 3

Exemplos de entradas inesperadamente válidas:

float('12,3,4,5678')  //Returns   12345678
float('1234567,8+')   //Returns   12345678
float('12345,6,78,-') //Returns  -12345678
float('-12,345,678,') //Returns  -12345678
float('12345678.-')   //Returns  -12345678
float('.12345678')    //Returns 0.12345678

formatDateTime

Retornar um carimbo de data/hora no formato especificado.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.
< localidade>	No	String	A localidade a ser usada. Se não for especificado, o valor é `en-us`. Se a localidade não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora reformatado>	String	O carimbo de data/hora atualizado no formato e localidade especificados, se especificado.

Examples

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

Retorna uma matriz com valores que correspondem a um nome de chave na saída de dados de formulário ou codificada de formulário de uma ação.

formDataMultiValues('<actionName>', '<key>')

Parameter	Required	Tipo	Description
< actionName>	Yes	String	A ação cuja saída tem o valor de chave desejado
< chave>	Yes	String	O nome da chave cujo valor você deseja

Valor de retorno	Tipo	Description
[<matriz-com-valores-chave>]	Array	Uma matriz com todos os valores que correspondem à chave especificada

Example

Este exemplo cria uma matriz a partir do valor da chave "Subject" na saída form-data ou coded de formulário da ação especificada:

formDataMultiValues('Send_an_email', 'Subject')

E retorna o texto do assunto em uma matriz, por exemplo: ["Hello world"]

formDataValue

Retorna um único valor que corresponde a um nome de chave na saída de dados de formulário ou codificada de formulário de uma ação. Se a função encontrar mais de uma correspondência, a função lançará um erro.

formDataValue('<actionName>', '<key>')

Parameter	Required	Tipo	Description
< actionName>	Yes	String	A ação cuja saída tem o valor de chave desejado
< chave>	Yes	String	O nome da chave cujo valor você deseja

Valor de retorno	Tipo	Description
< valor-chave>	String	O valor na chave especificada

Example

Este exemplo cria uma cadeia de caracteres a partir do valor da chave "Subject" na saída form-data ou coded de formulário da ação especificada:

formDataValue('Send_an_email', 'Subject')

E retorna o texto do assunto como uma cadeia de caracteres, por exemplo: "Hello world"

formatNumber

Retornar um número como uma cadeia de caracteres baseada no formato especificado.

formatNumber(<number>, <format>, <locale>?)

Parameter	Required	Tipo	Description
< número>	Yes	Inteiro ou Duplo	O valor que você deseja formatar.
< formato>	Yes	String	Uma cadeia de caracteres de formato composto que especifica o formato que você deseja usar. Para obter as cadeias de caracteres de formato numérico suportadas, consulte Cadeias de caracteres de formato numérico padrão, que são suportadas pelo `number.ToString(<format>, <locale>)`.
< localidade>	No	String	A localidade a ser usada conforme suportado pelo `number.ToString(<format>, <locale>)`. Se não for especificado, o valor é `en-us`. Se a localidade não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< número formatado>	String	O número especificado como uma cadeia de caracteres no formato que você especificou. Você pode converter esse valor de retorno para um `int` ou `float`.

Exemplo 1

Suponha que você queira formatar o número 1234567890. Este exemplo formata esse número como a cadeia de caracteres "1,234,567,890.00".

formatNumber(1234567890, '#,##0.00', 'en-US')

*Exemplo 2"

Suponha que você queira formatar o número 1234567890. Este exemplo formata o número para a cadeia de caracteres "1.234.567.890,00".

formatNumber(1234567890, '#,##0.00', 'is-IS')

Exemplo 3

Suponha que você queira formatar o número 17.35. Este exemplo formata o número para a cadeia de caracteres "$17.35".

formatNumber(17.35, 'C2')

Exemplo 4

Suponha que você queira formatar o número 17.35. Este exemplo formata o número para a cadeia de caracteres "17,35 kr".

formatNumber(17.35, 'C2', 'is-IS')

G

getFutureTime

Retornar a marca temporal atual somada às unidades de tempo especificadas.

getFutureTime(<interval>, <timeUnit>, <format>?)

Parameter	Required	Tipo	Description
< intervalo>	Yes	Integer	O número de unidades de tempo a adicionar
< unidade de tempo>	Yes	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	No	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, será gerado um erro informando que o formato fornecido não é válido e deve ser uma cadeia de caracteres de formato numérico.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A data e hora atuais mais o número especificado de unidades de tempo

Exemplo 1

Suponha que o carimbo de data/hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias a esse carimbo de data/hora:

getFutureTime(5, 'Day')

E devolve este resultado: "2018-03-06T00:00:00.0000000Z"

Exemplo 2

Suponha que o carimbo de data/hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias e converte o resultado para o formato "D":

getFutureTime(5, 'Day', 'D')

E devolve este resultado: "Tuesday, March 6, 2018"

getPastTime

Devolva o timestamp atual subtraindo das unidades de tempo especificadas.

getPastTime(<interval>, <timeUnit>, <format>?)

Parameter	Required	Tipo	Description
< intervalo>	Yes	Integer	O número de unidades de tempo especificadas para subtrair
< unidade de tempo>	Yes	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	No	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, será gerado um erro informando que o formato fornecido não é válido e deve ser uma cadeia de caracteres de formato numérico.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	A data/hora atual menos o número especificado de unidades de tempo

Exemplo 1

Suponha que a data/hora corrente seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias desse timestamp.

getPastTime(5, 'Day')

E devolve este resultado: "2018-01-27T00:00:00.0000000Z"

Exemplo 2

Suponha que a data/hora corrente seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias e converte o resultado para o formato "D":

getPastTime(5, 'Day', 'D')

E devolve este resultado: "Saturday, January 27, 2018"

greater

Verifique se o primeiro valor é maior que o segundo. Retorne true quando o primeiro valor for mais ou retorne false quando for menor.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parameter	Required	Tipo	Description
< valor>	Yes	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se é maior que o segundo valor
< compararCom>	Yes	Inteiro, Ponto Flutuante ou String, respectivamente	O valor de comparação

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne true quando o primeiro valor for maior que o segundo. Retorne false quando o primeiro valor for igual ou menor que o segundo valor.

Example

Estes exemplos verificam se o primeiro valor é maior do que o segundo:

greater(10, 5)
greater('apple', 'banana')

Então devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

greaterOrEquals

Verifique se o primeiro valor é maior ou igual ao segundo valor. Retorne true quando o primeiro valor for maior ou igual, ou retorne false quando o primeiro valor for menor.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parameter	Required	Tipo	Description
< valor>	Yes	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se maior ou igual ao segundo valor
< compararCom>	Yes	Inteiro, Ponto Flutuante ou String, respectivamente	O valor de comparação

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorna true quando o primeiro valor é maior ou igual ao segundo valor. Retorna false quando o primeiro valor é menor que o segundo valor.

Example

Estes exemplos verificam se o primeiro valor é maior ou igual ao segundo valor:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Então devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

guid

Gere um identificador global exclusivo (GUID) como uma cadeia de caracteres, por exemplo, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Além disso, você pode especificar um formato diferente para o GUID diferente do formato padrão, "D", que é de 32 dígitos separados por hífenes.

guid('<format>')

Parameter	Required	Tipo	Description
< formato>	No	String	Um único especificador de formato para o GUID retornado. Por padrão, o formato é "D", mas você pode usar "N", "D", "B", "P" ou "X".

Valor de retorno	Tipo	Description
< > valor GUID	String	Um GUID gerado aleatoriamente

Example

Este exemplo gera o mesmo GUID, mas como 32 dígitos, separados por hífenes e entre parênteses:

guid('P')

E devolve este resultado: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

I

if

Verifique se uma expressão é verdadeira ou falsa. Com base no resultado, retorne um valor especificado. Os parâmetros são avaliados da esquerda para a direita.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parameter	Required	Tipo	Description
< expressão>	Yes	booleano	A expressão a verificar
< valorSeVerdadeiro>	Yes	Any	O valor a ser retornado quando a expressão for verdadeira
< valorSeFalso>	Yes	Any	O valor a retornar quando a expressão for falsa

Valor de retorno	Tipo	Description
< valor de retorno especificado>	Any	O valor especificado que retorna com base em se a expressão é true ou false

Example

Este exemplo retorna "yes" porque a expressão especificada retorna true. Caso contrário, o exemplo retorna "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Retornar a posição inicial ou o valor do índice para uma substring. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

indexOf('<text>', '<searchText>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres que tem a substring para localizar
< texto de pesquisa>	Yes	String	A substring a ser localizada

Valor de retorno	Tipo	Description
< valor de índice>	Integer	A posição inicial ou o valor do índice para a subcadeia de caracteres especificada. Se a cadeia de caracteres não for encontrada, retorne o número -1.

Example

Este exemplo localiza o valor de índice inicial para a substring "world" na string "hello world":

indexOf('hello world', 'world')

E devolve este resultado: 6

int

Converta a versão da cadeia de caracteres de um inteiro em um número inteiro real.

int('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A versão da cadeia de caracteres para o inteiro a ser convertido. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados inteiro.

Valor de retorno	Tipo	Description
< resultado inteiro>	Integer	A versão inteira para a cadeia de caracteres especificada. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados inteiro.

Example

Este exemplo cria uma versão inteira para a cadeia de caracteres "10":

int('10')

E devolve este resultado: 10

isFloat

Retorna um booleano indicando se uma cadeia de caracteres é um número de vírgula flutuante. Por padrão, essa função usa a cultura invariante para o formato de ponto flutuante. Para identificar números de vírgula flutuante representados em outros formatos específicos de localidade, você pode, opcionalmente, especificar um código de localidade RFC 4646.

isFloat('<string>', '<locale>'?)

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres a ser examinada
< localidade>	No	String	O código de localidade RFC 4646 a ser usado

Valor de retorno	Tipo	Description
< resultado booleano>	booleano	Um booleano que indica se a cadeia de caracteres é um número de vírgula flutuante

Exemplo 1

Este exemplo verifica se uma cadeia de caracteres é um número de ponto flutuante na cultura invariante:

isFloat('10,000.00')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se uma cadeia de caracteres é um número de vírgula flutuante na localidade alemã:

isFloat('10.000,00', 'de-DE')

E devolve este resultado: true

isInt

Retorna um booleano que indica se uma cadeia de caracteres é um inteiro.

isInt('<string>')

Parameter	Required	Tipo	Description
< Corda>	Yes	String	A cadeia de caracteres a ser examinada

Valor de retorno	Tipo	Description
< resultado booleano>	booleano	Um booleano que indica se a cadeia de caracteres é um inteiro

Example

Este exemplo verifica se uma cadeia de caracteres é um inteiro:

isInt('10')

E devolve este resultado: true

item

Quando usado dentro de uma ação de repetição sobre uma matriz, retorne o item atual na matriz durante a iteração atual da ação. Você também pode obter os valores das propriedades desse item.

item()

Valor de retorno	Tipo	Description
< item-matriz-corrente>	Any	O item atual na matriz para a iteração atual da ação

Example

Este exemplo obtém o body elemento da mensagem atual para a ação "Send_an_email" dentro da iteração atual de um loop para cada um:

item().body

items

Retorne o item atual de cada ciclo em um loop para cada um. Use esta função dentro do loop for-each.

items('<loopName>')

Parameter	Required	Tipo	Description
< Nome do loop>	Yes	String	O nome do loop for-each

Valor de retorno	Tipo	Description
< Item>	Any	O item do ciclo atual no loop especificado para cada

Example

Este exemplo obtém o item atual do loop especificado para cada um:

items('myForEachLoopName')

iterationIndexes

Retorne o valor de índice para a iteração atual dentro de um loop TUntil . Você pode usar essa função dentro de loops Until aninhados.

iterationIndexes('<loopName>')

Parameter	Required	Tipo	Description
< Nome do loop>	Yes	String	O nome do loop Until

Valor de retorno	Tipo	Description
< índice>	Integer	O valor de índice para a iteração atual dentro do loop Until especificado

Example

Este exemplo cria uma variável de contador e incrementa essa variável em um durante cada iteração em um loop Until até que o valor do contador atinja cinco. O exemplo também cria uma variável que rastreia o índice atual para cada iteração. Durante cada iteração no loop Till, o exemplo incrementa o valor do contador e, em seguida, atribui o valor do contador ao valor do índice atual e, em seguida, incrementa o valor do contador. Enquanto estiver no loop, este exemplo faz referência ao índice de iteração atual usando a iterationIndexes função:

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

Retornar o valor do tipo JSON (JavaScript Object Notation), objeto ou matriz de objetos para uma cadeia de caracteres ou XML.

json('<value>')
json(xml('value'))

Important

Sem um esquema XML que defina a estrutura da saída, a função pode retornar resultados onde a estrutura difere muito do formato esperado, dependendo da entrada.

Esse comportamento torna essa função inadequada para cenários em que a saída deve estar em conformidade com um contrato bem definido, por exemplo, em sistemas ou soluções de negócios críticos.

Parameter	Required	Tipo	Description
< valor>	Yes	String ou XML	A cadeia de caracteres ou XML a ser convertido

Valor de retorno	Tipo	Description
< resultado JSON>	Tipo, objeto ou matriz nativo JSON	O valor do tipo nativo JSON, objeto ou matriz de objetos da cadeia de caracteres de entrada ou XML. - Se você passar XML que tenha um único elemento filho no elemento raiz, a função retornará um único objeto JSON para esse elemento filho. - Se você passar XML que tenha vários elementos filho no elemento raiz, a função retornará uma matriz que contém objetos JSON para esses elementos filho. - Se a string for null, a função retornará um objeto vazio.

Exemplo 1

Este exemplo converte essa cadeia de caracteres em um valor JSON:

json('[1, 2, 3]')

E devolve este resultado: [1, 2, 3]

Exemplo 2

Este exemplo converte essa cadeia de caracteres em JSON:

json('{"fullName": "Sophia Owen"}')

E devolve este resultado:

{
  "fullName": "Sophia Owen"
}

Exemplo 3

Este exemplo usa as json() funções e xml() para converter XML que tem um único elemento filho no elemento raiz em um objeto JSON nomeado person para esse elemento filho:

json(xml('<?xml version="1.0"?> <root> <person id="1"> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

E devolve este resultado:

{
   "?xml": { 
      "@version": "1.0" 
   },
   "root": {
      "person": {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      }
   }
}

Exemplo 4

Este exemplo usa as json() funções e xml() para converter XML que tem vários elementos filho no elemento raiz em uma matriz chamada person que contém objetos JSON para esses elementos filho:

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>'))

E devolve este resultado:

{
   "?xml": {
      "@version": "1.0"
   },
   "root": {
      "person": [
         {
            "@id": "1",
            "name": "Sophia Owen",
            "occupation": "Engineer"
         },
         {
            "@id": "2",
            "name": "John Doe",
            "occupation": "Engineer"
         }
      ]
   }
}

intersection

Retornar uma coleção que tenha apenas os itens comuns nas coleções especificadas. Para aparecer no resultado, um item deve aparecer em todas as coleções passadas para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparecerá no resultado.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parameter	Required	Tipo	Description
< coleção1>, <coleção2>, ...	Yes	Array ou Object, mas não ambos	As coleções das quais desejas apenas os itens comuns

Valor de retorno	Tipo	Description
< itens comuns>	Array ou Objeto, respectivamente	Uma coleção que tem apenas os itens comuns nas coleções especificadas

Example

Este exemplo localiza os itens comuns nessas matrizes:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

E retorna uma matriz com apenas estes itens: [1, 2]

aderir

Retorna uma cadeia de caracteres que tem todos os itens de uma matriz e tem cada caractere separado por um delimitador de .

join([<collection>], '<delimiter>')

Parameter	Required	Tipo	Description
< coleção>	Yes	Array	A matriz que tem os itens para unir
< delimitador>	Yes	String	O separador que aparece entre cada caractere na cadeia de caracteres resultante

Valor de retorno	Tipo	Description
< char1><delimitador><char2><delimitador>...	String	A cadeia de caracteres resultante criada a partir de todos os itens na matriz especificada. Nota: O comprimento do resultado não deve exceder 104.857.600 caracteres.

Example

Este exemplo cria uma cadeia de caracteres de todos os itens nessa matriz com o caractere especificado como delimitador:

join(createArray('a', 'b', 'c'), '.')

E devolve este resultado: "a.b.c"

L

last

Devolver o último item de uma coleção.

last('<collection>')
last([<collection>])

Parameter	Required	Tipo	Description
< coleção>	Yes	String ou matriz	A coleção onde encontrar o último item

Valor de retorno	Tipo	Description
< > do último item de coleção	String ou Array, respectivamente	O último item da coleção

Example

Estes exemplos encontram o último item destas coleções:

last('abcd')
last(createArray(0, 1, 2, 3))

E devolve estes resultados:

Primeiro exemplo: "d"
Segundo exemplo: 3

lastIndexOf

Retornar a posição inicial ou o valor do índice para a última ocorrência de uma determinada substring. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

lastIndexOf('<text>', '<searchText>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres que tem a substring para localizar
< texto de pesquisa>	Yes	String	A substring a ser localizada

Valor de retorno	Tipo	Description
< valor de índice final>	Integer	A posição inicial ou o valor do índice para a última ocorrência da substring especificada.

Se o valor de cadeia de caracteres ou substring estiver vazio, ocorrerá o seguinte comportamento:

Se apenas o valor da cadeia de caracteres estiver vazio, a função retornará -1.
Se os valores de string e substring estiverem vazios, a função retornará 0.
Se apenas o valor da substring estiver vazio, a função retornará o comprimento da cadeia de caracteres menos 1.

Examples

Este exemplo localiza o valor do índice inicial para a última ocorrência da substring substring world na string hello world hello world. O resultado retornado é 18:

lastIndexOf('hello world hello world', 'world')

Este exemplo está faltando o parâmetro substring e retorna um valor de porque o valor da string de 22 entrada (23) menos 1 é maior que 0.

lastIndexOf('hello world hello world', '')

length

Retornar o número de itens numa coleção.

length('<collection>')
length([<collection>])

Parameter	Required	Tipo	Description
< coleção>	Yes	String ou matriz	A coleção com os itens a contar

Valor de retorno	Tipo	Description
< número ou comprimento>	Integer	O número de itens na coleção

Example

Estes exemplos contam o número de itens nessas coleções:

length('abcd')
length(createArray(0, 1, 2, 3))

E devolva este resultado: 4

less

Verifique se o primeiro valor é menor que o segundo valor. Retorne true quando o primeiro valor for menor ou retorne false quando o primeiro valor for mais.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parameter	Required	Tipo	Description
< valor>	Yes	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se é menor que o segundo valor
< compararCom>	Yes	Inteiro, Ponto Flutuante ou String, respectivamente	O item de comparação

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne true quando o primeiro valor for menor que o segundo. Devolver falso quando o primeiro valor for igual ou maior que o segundo valor.

Example

Estes exemplos verificam se o primeiro valor é menor que o segundo.

less(5, 10)
less('banana', 'apple')

Então devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

lessOrEquals

Verifique se o primeiro valor é menor ou igual ao segundo valor. Retorne true quando o primeiro valor for menor ou igual, ou retorne false quando o primeiro valor for mais.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parameter	Required	Tipo	Description
< valor>	Yes	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se menor ou igual ao segundo valor
< compararCom>	Yes	Inteiro, Ponto Flutuante ou String, respectivamente	O item de comparação

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Devolva verdadeiro quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo.

Example

Estes exemplos verificam se o primeiro valor é menor ou igual ao segundo valor.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Então devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

listCallbackUrl

Retorne a "URL de retorno de chamada" que chama um gatilho ou ação. Essa função funciona apenas com gatilhos e ações para os tipos de conector HttpWebhook e ApiConnectionWebhook , mas não os tipos Manual, Recurrence, HTTP e APIConnection .

listCallbackUrl()

Valor de retorno	Tipo	Description
< callback-URL>	String	A URL de retorno de chamada para um gatilho ou ação

Example

Este exemplo mostra um exemplo de URL de retorno de chamada que essa função pode retornar:

"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

Retornar o valor mais alto de uma lista ou matriz com números que são inclusivos em ambas as extremidades.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parameter	Required	Tipo	Description
< número1>, <número2>, ...	Yes	Inteiro, Ponto flutuante ou ambos	O conjunto de números do qual você deseja o valor mais alto
[<número1>, <número2>, ...]	Yes	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o valor mais alto

Valor de retorno	Tipo	Description
< valor máximo>	Inteiro ou flutuador	O valor mais alto na matriz ou conjunto de números especificado

Example

Estes exemplos obtêm o valor mais alto do conjunto de números e da matriz:

max(1, 2, 3)
max(createArray(1, 2, 3))

E devolva este resultado: 3

min

Retorna o valor mais baixo de um conjunto de números ou de uma matriz.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parameter	Required	Tipo	Description
< número1>, <número2>, ...	Yes	Inteiro, Ponto flutuante ou ambos	O conjunto de números do qual você deseja o menor valor
[<número1>, <número2>, ...]	Yes	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o menor valor

Valor de retorno	Tipo	Description
< valor mínimo>	Inteiro ou flutuador	O valor mais baixo no conjunto especificado de números ou matriz especificada

Example

Estes exemplos obtêm o menor valor no conjunto de números e na matriz:

min(1, 2, 3)
min(createArray(1, 2, 3))

E devolva este resultado: 1

mod

Devolver o resto da divisão de dois números. Para obter o resultado inteiro, consulte div().

mod(<dividend>, <divisor>)

Parameter	Required	Tipo	Description
< dividendos>	Yes	Inteiro ou flutuador	O número que será dividido pelo divisor
< divisor>	Yes	Inteiro ou flutuador	O número que divide o dividendo, mas não pode ser zero

Valor de retorno	Tipo	Description
< resultado do módulo>	Inteiro ou flutuador	O restante da divisão do primeiro número pelo segundo número

Exemplo 1

Este exemplo divide o primeiro número pelo segundo número:

mod(3, 2)

E devolve este resultado: 1

Exemplo 2

Este exemplo mostra que, se um ou ambos os valores forem negativos, o resultado corresponde ao sinal do dividendo:

mod(-5, 2)
mod(4, -3)

O exemplo retorna estes resultados:

Primeiro exemplo: -1
Segundo exemplo: 1

mul

Retornar o produto da multiplicação de dois números.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Required	Tipo	Description
< multiplicando1>	Yes	Inteiro ou flutuador	O número a multiplicar por multiplicand2
< multiplicando2>	Yes	Inteiro ou flutuador	O número que multiplica multiplicand1

Valor de retorno	Tipo	Description
< produto-resultado>	Inteiro ou flutuador	O produto da multiplicação do primeiro número pelo segundo número

Example

Estes exemplos multiplicam o primeiro número pelo segundo número:

mul(1, 2)
mul(1.5, 2)

Então devolva estes resultados:

Primeiro exemplo: 2
Segundo exemplo 3

multipartBody

Retornar o corpo de uma parte específica na saída de uma ação que tenha várias partes.

multipartBody('<actionName>', <index>)

Parameter	Required	Tipo	Description
< actionName>	Yes	String	O nome da ação que tem saída com várias partes
< índice>	Yes	Integer	O valor de índice para a parte que você deseja

Valor de retorno	Tipo	Description
< corpo>	String	O corpo da parte especificada

N

not

Verifique se uma expressão é falsa. Retorne verdadeiro quando a expressão for falsa, ou retorne falso quando for verdadeira.

not(<expression>)

Parameter	Required	Tipo	Description
< expressão>	Yes	booleano	A expressão a verificar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne verdadeiro quando a expressão for falsa. Devolva falso quando a expressão for verdadeira.

Exemplo 1

Estes exemplos verificam se as expressões especificadas são falsas:

not(false)
not(true)

Então devolva estes resultados:

Primeiro exemplo: A expressão é false, portanto, a função retorna true.
Segundo exemplo: A expressão é true, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são falsas:

not(equals(1, 2))
not(equals(1, 1))

Então devolva estes resultados:

Primeiro exemplo: A expressão é false, portanto, a função retorna true.
Segundo exemplo: A expressão é true, portanto, a função retorna false.

nthIndexOf

Retornar a posição inicial ou o valor do índice onde a nésima ocorrência de uma substring aparece em uma cadeia de caracteres.

nthIndexOf('<text>', '<searchText>', <occurrence>)

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres que contém a substring para localizar
< texto de pesquisa>	Yes	String	A substring a ser localizada
< ocorrência>	Yes	Integer	Um número que especifica a nésima ocorrência da substring a ser localizada. Se a ocorrência for negativa, comece a pesquisar a partir do final.

Valor de retorno	Tipo	Description
< valor de índice>	Integer	A posição inicial ou o valor do índice para a nésima ocorrência da subcadeia especificada. Se a substring não for encontrada ou existirem menos de n ocorrências da substring, retorne `-1`.

Examples

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

Verifique se pelo menos uma expressão é verdadeira. Retorne true quando pelo menos uma expressão for verdadeira, ou retorne false quando todas forem falsas.

or(<expression1>, <expression2>, ...)

Parameter	Required	Tipo	Description
< expressão1>, <expressão2>, ...	Yes	booleano	As expressões a verificar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Devolve verdadeiro quando pelo menos uma expressão for verdadeira. Retorne false quando todas as expressões forem falsas.

Exemplo 1

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

or(true, false)
or(false, false)

Então devolva estes resultados:

Primeiro exemplo: Pelo menos uma expressão é verdadeira, portanto, a função retorna true.
Segundo exemplo: Ambas as expressões são falsas, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Então devolva estes resultados:

Primeiro exemplo: Pelo menos uma expressão é verdadeira, portanto, a função retorna true.
Segundo exemplo: Ambas as expressões são falsas, portanto, a função retorna false.

outputs

Retornar as saídas de uma ação em tempo de execução.

outputs('<actionName>')

Parameter	Required	Tipo	Description
< actionName>	Yes	String	O nome da saída da ação que você deseja

Valor de retorno	Tipo	Description
< Saída>	String	A saída da ação especificada

Example

Este exemplo obtém a saída da ação Get userX :

outputs('Get_user')

E devolve 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

parameters

Retornar o valor de um parâmetro descrito na definição do fluxo de trabalho.

parameters('<parameterName>')

Parameter	Required	Tipo	Description
< nome_parâmetro>	Yes	String	O nome do parâmetro cujo valor você deseja

Valor de retorno	Tipo	Description
< valor-parâmetro>	Any	O valor para o parâmetro especificado

Example

Suponha que você tenha esse valor JSON:

{
  "fullName": "Sophia Owen"
}

Este exemplo obtém o valor para o parâmetro especificado:

parameters('fullName')

E devolve este resultado: "Sophia Owen"

parseDateTime

Retornar o carimbo de data/hora de uma cadeia de caracteres que contém um carimbo de data/hora.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< localidade>	No	String	A localidade a ser usada. Se não for especificado, a localidade padrão será `en-us`. Se a localidade não for um valor válido, um erro será gerado.
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for especificado, tente analisar com vários formatos compatíveis com a localidade fornecida. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora analisado>	String	O carimbo de data/hora analisado no formato "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Examples

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('20190521', 'fr-fr', 'yyyyMMdd') // 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

Retorna um inteiro aleatório de um intervalo especificado, que é inclusivo apenas na extremidade inicial.

rand(<minValue>, <maxValue>)

Parameter	Required	Tipo	Description
< valorMínimo>	Yes	Integer	O número inteiro mais baixo do intervalo
< maxValor>	Yes	Integer	O inteiro que segue o número inteiro mais alto no intervalo que a função pode retornar

Valor de retorno	Tipo	Description
< resultado aleatório>	Integer	O inteiro aleatório retornado a partir do intervalo especificado

Example

Este exemplo obtém um inteiro aleatório do intervalo especificado, excluindo o valor máximo:

rand(1, 5)

E retorna um destes números como resultado: 1, 2, 3ou 4

intervalo

Retornar uma matriz inteira que começa a partir de um inteiro especificado.

range(<startIndex>, <count>)

Parameter	Required	Tipo	Description
< startIndex>	Yes	Integer	Um valor inteiro que inicia a matriz como o primeiro item
< contagem>	Yes	Integer	O número de inteiros na matriz. O `count` valor do parâmetro deve ser um inteiro positivo que não exceda 100.000. Nota: A soma dos `startIndex` valores e `count` não deve exceder 2.147.483.647.

Valor de retorno	Tipo	Description
[<intervalo-resultado>]	Array	A matriz com inteiros a partir do índice especificado

Example

Este exemplo cria uma matriz inteira que começa a partir do índice especificado e tem o número especificado de inteiros:

range(1, 4)

E devolve este resultado: [1, 2, 3, 4]

removeProperty

Remova uma propriedade de um objeto e retorne o objeto atualizado. Se a propriedade que você tenta remover não existir, a função retornará o objeto original.

removeProperty(<object>, '<property>')

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON de onde você deseja remover uma propriedade
< propriedade>	Yes	String	O nome da propriedade a ser removida

Valor de retorno	Tipo	Description
< atualizado-objeto>	Object	O objeto JSON atualizado sem a propriedade especificada

Para remover uma propriedade filho de uma propriedade existente, use esta sintaxe:

removeProperty(<object>['<parent-property>'], '<child-property>')

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON cuja propriedade você deseja remover
< Propriedade-mãe>	Yes	String	O nome da propriedade pai com a propriedade filho que você deseja remover
< Propriedade para crianças>	Yes	String	O nome da propriedade filho a ser removida

Valor de retorno	Tipo	Description
< atualizado-objeto>	Object	O objeto JSON atualizado cuja propriedade filho você removeu

Exemplo 1

Este exemplo remove a middleName propriedade de um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON(), e retorna o objeto atualizado:

removeProperty(json('{ "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" }'), 'middleName')

Aqui está o objeto JSON atual:

{
   "firstName": "Sophia",
   "middleName": "Anne",
   "surName": "Owen"
}

Aqui está o objeto JSON atualizado:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Exemplo 2

Este exemplo remove a middleName propriedade filho de uma customerName propriedade pai em um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON() e retorna o objeto atualizado:

removeProperty(json('{ "customerName": { "firstName": "Sophia", "middleName": "Anne", "surName": "Owen" } }')['customerName'], 'middleName')

Aqui está o objeto JSON atual:

{
   "customerName": {
      "firstName": "Sophia",
      "middleName": "Anne",
      "surName": "Owen"
   }
}

Aqui está o objeto JSON atualizado:

{
   "customerName": {
      "firstName": "Sophia",
      "surName": "Owen"
   }
}

substituir

Substitua uma substring pela string especificada e retorne a string de resultado. Esta função diferencia maiúsculas de minúsculas.

replace('<text>', '<oldText>', '<newText>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres que tem a substring para substituir
< texto antigo>	Yes	String	A substring a substituir
< novoTexto>	Yes	String	A cadeia de caracteres de substituição

Valor de retorno	Tipo	Description
< texto atualizado>	String	A cadeia de caracteres atualizada após a substituição da substring Se a substring não for encontrada, retorne a cadeia de caracteres original.

Example

Este exemplo localiza a substring "old" em "the old string" e substitui "old" por "new":

replace('the old string', 'old', 'new')

E devolve este resultado: "the new string"

result

Retornar os resultados das ações de nível superior na ação de escopo especificada, como uma For_eachação , Untilou Scope . A result() função aceita um único parâmetro, que é o nome do escopo, e retorna uma matriz que contém informações das ações de primeiro nível nesse escopo. Esses objetos de ação incluem os mesmos atributos que os atributos retornados actions() pela função, como a hora de início, a hora de término, o status, as entradas, as IDs de correlação e as saídas da ação.

Note

Essa função retorna informações somente das ações de primeiro nível na ação com escopo e não de ações aninhadas mais profundas, como ações de alternância ou condição.

Por exemplo, você pode usar essa função para obter os resultados de ações com falha para que você possa diagnosticar e lidar com exceções. Para obter mais informações, consulte Obter contexto e resultados para falhas.

result('<scopedActionName>')

Parameter	Required	Tipo	Description
< scopedActionName>	Yes	String	O nome da ação com escopo onde você deseja as entradas e saídas das ações de nível superior dentro desse escopo

Valor de retorno	Tipo	Description
< matriz-objeto>	Objeto de matriz	Uma matriz que contém matrizes de entradas e saídas de cada ação de nível superior dentro do escopo especificado

Example

Este exemplo retorna as entradas e saídas de cada iteração de uma ação HTTP dentro que está em um For_each loop usando a result() função na Compose ação:

{
   "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"
      }
   }
}

Veja como a matriz retornada de exemplo pode parecer onde o objeto externo outputs contém as entradas e saídas de cada iteração das ações dentro da For_each ação.

[
   {
      "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

Inverter a ordem dos itens em uma coleção. Ao usar essa função com sort(), você pode classificar uma coleção em ordem decrescente.

reverse([<collection>])

Parameter	Required	Tipo	Description
< coleção>	Yes	Array	A cobrança para reverter

Valor de retorno	Tipo	Description
[<coleção atualizada>]	Array	A cobrança invertida

Example

Este exemplo inverte uma matriz de inteiros:

reverse(createArray(0, 1, 2, 3))

E retorna esta matriz: [3,2,1,0]

S

setProperty

Defina o valor para a propriedade do objeto JSON e retorne o objeto atualizado. Se a propriedade que você tenta definir não existir, a propriedade será adicionada ao objeto. Para adicionar uma nova propriedade, use a função addProperty().

setProperty(<object>, '<property>', <value>)

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON cuja propriedade você deseja definir
< propriedade>	Yes	String	O nome da propriedade existente ou nova a ser definida
< valor>	Yes	Any	O valor a ser definido para a propriedade especificada

Para definir a propriedade filho em um objeto filho, use uma chamada aninhada setProperty() . Caso contrário, a função retorna apenas o objeto filho como saída.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))

Parameter	Required	Tipo	Description
< objeto>	Yes	Object	O objeto JSON cuja propriedade você deseja definir
< Propriedade-mãe>	Yes	String	O nome da propriedade pai com a propriedade filho que você deseja definir
< Propriedade para crianças>	Yes	String	O nome da propriedade filho a ser definida
< valor>	Yes	Any	O valor a ser definido para a propriedade especificada

Valor de retorno	Tipo	Description
< atualizado-objeto>	Object	O objeto JSON atualizado cuja propriedade você definiu

Exemplo 1

Este exemplo define a surName propriedade em um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON( ). A função atribui o valor especificado à propriedade e retorna o objeto atualizado:

setProperty(json('{ "firstName": "Sophia", "surName": "Owen" }'), 'surName', 'Hartnett')

Aqui está o objeto JSON atual:

{
   "firstName": "Sophia",
   "surName": "Owen"
}

Aqui está o objeto JSON atualizado:

{
   "firstName": "Sophia",
   "surName": "Hartnett"
}

Exemplo 2

Este exemplo define a surName propriedade filho para a customerName propriedade pai em um objeto JSON, que é convertido de uma cadeia de caracteres para JSON usando a função JSON( ). A função atribui o valor especificado à propriedade e retorna o objeto atualizado:

setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }'), 'customerName', setProperty(json('{ "customerName": { "firstName": "Sophia", "surName": "Owen" } }')['customerName'], 'surName', 'Hartnett'))

Aqui está o objeto JSON atual:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Owen"
   }
}

Aqui está o objeto JSON atualizado:

{
   "customerName": {
      "firstName": "Sophie",
      "surName": "Hartnett"
   }
}

ignorar

Remova itens da frente de uma coleção e devolva todos os outros itens.

skip([<collection>], <count>)

Parameter	Required	Tipo	Description
< coleção>	Yes	Array	A coleção cujos itens você deseja remover
< contagem>	Yes	Integer	Um número inteiro positivo para o número de itens a remover na frente

Valor de retorno	Tipo	Description
[<coleção atualizada>]	Array	A coleção atualizada depois de remover os itens especificados

Example

Este exemplo remove um item, o número 0, da frente da matriz especificada:

skip(createArray(0, 1, 2, 3), 1)

E retorna essa matriz com os itens restantes: [1,2,3]

setor

Retorna uma substring especificando a posição inicial e final ou o valor. Consulte também substring().

slice('<text>', <startIndex>, <endIndex>?)

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres que contém a substring para localizar
< startIndex>	Yes	Integer	A posição inicial baseada em zero ou o valor por onde começar a procurar a substring - Se startIndex for maior que o comprimento da cadeia de caracteres, retorne uma cadeia de caracteres vazia. - Se startIndex for negativo, comece a pesquisar no valor do índice que é a soma do comprimento da string e startIndex.
< endIndex>	No	Integer	A posição ou valor final baseado em zero para onde terminar a pesquisa da substring. O caractere localizado no valor do índice final não é incluído na pesquisa. - Se endIndex não for especificado ou maior que o comprimento da string, pesquise até o final da string. - Se endIndex for negativo, termine a pesquisa no valor do índice que a soma do comprimento da string e endIndex.

Valor de retorno	Tipo	Description
< fatia-resultado>	String	Uma nova cadeia de caracteres que contém a substring encontrada

Examples

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 ''.

ordenar

Classificar itens em uma coleção. Pode ordenar os objetos da coleção usando qualquer chave que contenha um tipo de dado primitivo suportado pela Workflow Definition Language, como int, float, string ou bool.

sort([<collection>], <sortBy>?)

Parameter	Required	Tipo	Description
< coleção>	Yes	Array	A coleção com os itens para classificar
< ordenarPor>	No	String	A chave a ser usada para classificar os objetos de coleção

Valor de retorno	Tipo	Description
[<coleção atualizada>]	Array	A coleção ordenada

Exemplo 1

Este exemplo classifica uma matriz de inteiros:

sort(createArray(2, 1, 0, 3))

E retorna esta matriz: [0,1,2,3]

Exemplo 2

Este exemplo classifica uma matriz de objetos por chave:

sort(createArray(json('{ "first": "Amalie", "last": "Rose" }'), json('{ "first": "Elise", "last": "Renee" }')), 'last')

E retorna esta matriz: [{ "first": "Elise", "last": "Renee" }, {"first": "Amalie", "last": "Rose" }')]

dividir

Retorna uma matriz que contém substrings, separadas por vírgulas, com base no caractere delimitador especificado na cadeia de caracteres original.

split('<text>', '<delimiter>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres a ser separada em substrings com base no delimitador especificado na string original
< delimitador>	Yes	String	O caractere na cadeia de caracteres original a ser usado como delimitador

Valor de retorno	Tipo	Description
[<substring1,substring2><>,...]	Array	Uma matriz que contém subcadeias da cadeia de caracteres original, separadas por vírgulas

Exemplo 1

Este exemplo cria uma matriz com substrings da cadeia de caracteres especificada com base no caractere especificado como delimitador:

split('a_b_c', '_')

E retorna essa matriz como resultado: ["a","b","c"]

Exemplo 2

Este exemplo cria uma matriz com um único elemento quando não existe nenhum delimitador na cadeia de caracteres:

split('a_b_c', ' ')

E retorna essa matriz como resultado: ["a_b_c"]

startOfDay

Retorne o início do dia para um carimbo de data/hora.

startOfDay('<timestamp>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	O carimbo de data/hora especificado, mas começando na marca de zero hora para o dia

Example

Este exemplo encontra o início do dia para este marca temporal:

startOfDay('2018-03-15T13:30:30Z')

E devolve este resultado: "2018-03-15T00:00:00.0000000Z"

startOfHour

Devolver o início da hora para um carimbo de data/hora.

startOfHour('<timestamp>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	O carimbo de data/hora especificado, mas começando no minuto zero para a hora

Example

Este exemplo localiza o início da hora para este timestamp.

startOfHour('2018-03-15T13:30:30Z')

E devolve este resultado: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Devolver o início do mês para um carimbo de data/hora.

startOfMonth('<timestamp>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	O carimbo de data/hora especificado, mas começando no primeiro dia do mês na marca de zero hora

Exemplo 1

Este exemplo devolve o início do mês para esta data e hora.

startOfMonth('2018-03-15T13:30:30Z')

E devolve este resultado: "2018-03-01T00:00:00.0000000Z"

Exemplo 2

Este exemplo retorna o início do mês no formato especificado para este carimbo de data/hora:

startOfMonth('2018-03-15T13:30:30Z', 'yyyy-MM-dd')

E devolve este resultado: "2018-03-01"

startsWith

Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica. Retorne verdadeiro quando a substring for encontrada ou retorne falso quando não for encontrada. Esta função não diferencia maiúsculas de minúsculas.

startsWith('<text>', '<searchText>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres a ser verificada
< texto de pesquisa>	Yes	String	A cadeia de caracteres inicial para localizar

Valor de retorno	Tipo	Description
verdadeiro ou falso	booleano	Retorne verdadeiro quando for encontrada a substring inicial. Devolver falso quando não encontrado.

Exemplo 1

Este exemplo verifica se a string "hello world" começa com a substring "hello":

startsWith('hello world', 'hello')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia de caracteres "hello world" começa com a substring "greetings":

startsWith('hello world', 'greetings')

E devolve este resultado: false

cadeia (de caracteres)

Devolva a versão em cadeia de caracteres de um valor.

string(<value>)

Parameter	Required	Tipo	Description
< valor>	Yes	Any	O valor a converter. Se esse valor for nulo ou for avaliado como nulo, o valor será convertido em um valor de cadeia de caracteres (`""`) vazia. Por exemplo, se você atribuir uma variável de cadeia de caracteres a uma propriedade inexistente, que você pode acessar com o `?` operador, o valor nulo será convertido em uma cadeia de caracteres vazia. No entanto, comparar um valor nulo não é o mesmo que comparar uma cadeia de caracteres vazia.

Valor de retorno	Tipo	Description
< valor de cadeia de caracteres>	String	A versão da cadeia de caracteres para o valor especificado. Se o parâmetro value for null ou for avaliado como null, esse valor será retornado como um valor de string (`""`) vazio.

Exemplo 1

Este exemplo cria a versão da cadeia de caracteres para esse número:

string(10)

E devolve este resultado: "10"

Exemplo 2

Este exemplo cria uma cadeia de caracteres para o objeto JSON especificado e usa o caractere de barra invertida (\) como um caractere de escape para as aspas duplas (").

string( { "name": "Sophie Owen" } )

E devolve este resultado: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Retorne o resultado de subtrair o segundo número do primeiro número.

sub(<minuend>, <subtrahend>)

Parameter	Required	Tipo	Description
< minuend>	Yes	Inteiro ou flutuador	O número do qual subtrair o subtrahend
< subtraendo>	Yes	Inteiro ou flutuador	O número a subtrair do minuend

Valor de retorno	Tipo	Description
< resultado>	Inteiro ou flutuador	O resultado da subtração do segundo número do primeiro número

Example

Este exemplo subtrai o segundo número do primeiro número:

sub(10.3, .3)

E devolve este resultado: 10

substring

Retorna caracteres de uma cadeia de caracteres, começando a partir da posição especificada ou índice. Os valores de índice começam com o número 0. Ver também fatia().

substring('<text>', <startIndex>, <length>)

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres cujos caracteres você deseja
< startIndex>	Yes	Integer	Um número positivo igual ou superior a 0 que pretende utilizar como posição inicial ou valor de índice
< comprimento>	No	Integer	Um número positivo de caracteres que você deseja na substring

Note

Verifique se a soma da adição dos valores dos parâmetros startIndex e length é menor do que o comprimento da cadeia de caracteres fornecida para o parâmetro text . Caso contrário, você receberá um erro, ao contrário de funções semelhantes em outros idiomas, onde o resultado é a substring do startIndex até o final da string. O parâmetro length é opcional e, se não for fornecido, a função substring() leva todos os caracteres começando de startIndex até o final da string.

Valor de retorno	Tipo	Description
< Resultado de substringas>	String	Uma substring com o número especificado de caracteres, começando na posição de índice especificada na cadeia de caracteres de origem

Example

Este exemplo cria uma substring de cinco caracteres a partir da cadeia de caracteres especificada, começando a partir do valor de índice 6:

substring('hello world', 6, 5)

E devolve este resultado: "world"

subtractFromTime

Subtraia um número de unidades de tempo de uma data/hora. Consulte também getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres que contém o carimbo de data/hora
< intervalo>	Yes	Integer	O número de unidades de tempo especificadas para subtrair
< unidade de tempo>	Yes	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< carimbo de data/hora atualizado>	String	O timestamp menos o número especificado de unidades de tempo

Exemplo 1

Este exemplo subtrai um dia deste timestamp:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

E devolve este resultado: "2018-01-01T00:00:00.0000000Z"

Exemplo 2

Este exemplo subtrai um dia deste timestamp:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

E retorna esse resultado usando o formato "D" opcional: "Monday, January, 1, 2018"

T

take

Devolver itens da parte inicial de uma coleção.

take('<collection>', <count>)
take([<collection>], <count>)

Parameter	Required	Tipo	Description
< coleção>	Yes	String ou matriz	A coleção cujos itens você deseja
< contagem>	Yes	Integer	Um número inteiro positivo referente ao número de itens que desejas desde o início.

Valor de retorno	Tipo	Description
< subconjunto> ou [<subconjunto>]	String ou Array, respectivamente	Uma cadeia de caracteres ou matriz que possui o número especificado de itens retirados do início da coleção original.

Example

Estes exemplos obtêm o número especificado de itens do início dessas coleções.

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Então devolva estes resultados:

Primeiro exemplo: "abc"
Segundo exemplo: [0, 1, 2]

ticks

Devolve o número de ticks, que são intervalos de 100 nanossegundos, desde 1 de janeiro de 0001 12:00:00 meia-noite (ou DateTime.Ticks em C#) até ao carimbo de data/hora especificado. Para obter mais informações, consulte este tópico: Propriedade DateTime.Ticks (System).

ticks('<timestamp>')

Parameter	Required	Tipo	Description
< carimbo de data/hora>	Yes	String	A cadeia de caracteres para um selo temporal

Valor de retorno	Tipo	Description
< número de ticks>	Integer	O número de ticks desde o carimbo de data/hora especificado

toLower

Retornar uma cadeia de caracteres em formato minúsculo. Se um caractere na cadeia de caracteres não tiver uma versão minúscula, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toLower('<text>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres a ser retornada em formato minúsculo

Valor de retorno	Tipo	Description
< texto minúsculo>	String	A cadeia de caracteres original em formato minúsculo

Example

Este exemplo converte essa cadeia de caracteres em minúsculas:

toLower('Hello World')

E devolve este resultado: "hello world"

toUpper

Retornar uma cadeia de caracteres em formato maiúsculo. Se um caractere na cadeia de caracteres não tiver uma versão em maiúsculas, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toUpper('<text>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres a ser retornada em formato maiúsculo

Valor de retorno	Tipo	Description
< texto em maiúsculas>	String	A cadeia de caracteres original em formato maiúsculo

Example

Este exemplo converte essa cadeia de caracteres em maiúsculas:

toUpper('Hello World')

E devolve este resultado: "HELLO WORLD"

accionador

Retorna a saída de um gatilho em tempo de execução ou valores de outros pares de nome e valor JSON, que você pode atribuir a uma expressão.

Dentro das entradas de um gatilho, essa função retorna a saída da execução anterior.
Dentro da condição de um gatilho, essa função retorna a saída da execução atual.

Por padrão, a função faz referência a todo o objeto trigger, mas você pode, opcionalmente, especificar uma propriedade cujo valor você deseja. Além disso, esta função tem versões abreviadas disponíveis, consulte triggerOutputs() e triggerBody().

trigger()

Valor de retorno	Tipo	Description
< Saída-gatilho>	String	A saída de um gatilho em tempo de execução

triggerBody

Retornar a saída de um gatilho body em tempo de execução. Taquigrafia de trigger().outputs.body. Ver trigger().

triggerBody()

Valor de retorno	Tipo	Description
< Saída-corpo-gatilho>	String	A `body` saída do gatilho

triggerFormDataMultiValues

Retorna uma matriz com valores que correspondem a um nome de chave na saída de dados de formulário ou codificada de formulário de um gatilho.

triggerFormDataMultiValues('<key>')

Parameter	Required	Tipo	Description
< chave>	Yes	String	O nome da chave cujo valor você deseja

Valor de retorno	Tipo	Description
[<matriz-com-valores-chave>]	Array	Uma matriz com todos os valores que correspondem à chave especificada

Example

Este exemplo cria uma matriz a partir do valor da chave "feedUrl" na saída de dados de formulário ou codificada de formulário de um gatilho RSS:

triggerFormDataMultiValues('feedUrl')

E retorna essa matriz como um resultado de exemplo: ["https://feeds.a.dj.com/rss/RSSMarketsMain.xml"]

triggerFormDataValue

Retorna uma cadeia de caracteres com um único valor que corresponde a um nome de chave na saída de dados de formulário ou codificada de formulário de um gatilho. Se a função encontrar mais de uma correspondência, a função lançará um erro.

triggerFormDataValue('<key>')

Parameter	Required	Tipo	Description
< chave>	Yes	String	O nome da chave cujo valor você deseja

Valor de retorno	Tipo	Description
< valor-chave>	String	O valor na chave especificada

Example

Este exemplo cria uma cadeia de caracteres a partir do valor da chave "feedUrl" na saída de dados de formulário ou codificada de formulário de um gatilho RSS:

triggerFormDataValue('feedUrl')

E retorna essa cadeia de caracteres como um resultado de exemplo: "https://feeds.a.dj.com/rss/RSSMarketsMain.xml"

triggerMultipartBody

Retorne o corpo de uma parte específica na saída de um gatilho que tenha várias partes.

triggerMultipartBody(<index>)

Parameter	Required	Tipo	Description
< índice>	Yes	Integer	O valor de índice para a parte que você deseja

Valor de retorno	Tipo	Description
< corpo>	String	O corpo da parte especificada na saída de várias partes de um gatilho

triggerOutputs

Retorna a saída de um gatilho em tempo de execução ou valores de outros pares de nome e valor JSON. Taquigrafia de trigger().outputs. Ver trigger().

triggerOutputs()

Valor de retorno	Tipo	Description
< Saída-gatilho>	String	A saída de um gatilho em tempo de execução

cortar

Remova os espaços em branco no início e no final de uma cadeia de caracteres e devolva a cadeia atualizada.

trim('<text>')

Parameter	Required	Tipo	Description
< texto>	Yes	String	A cadeia de caracteres da qual se devem remover os espaços em branco à esquerda e à direita.

Valor de retorno	Tipo	Description
< textoAtualizado>	String	Uma versão atualizada para a cadeia de caracteres original sem espaço em branco à esquerda ou à direita

Example

Este exemplo remove o espaço em branco à esquerda e à direita da cadeia de caracteres " Hello World ":

trim(' Hello World  ')

E devolve este resultado: "Hello World"

U

união

Retornar uma coleção que tenha todos os itens das coleções especificadas. Para aparecer no resultado, um item pode aparecer em qualquer coleção passada para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparecerá no resultado.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parameter	Required	Tipo	Description
< coleção1>, <coleção2>, ...	Yes	Array ou Object, mas não ambos	As coleções de onde você deseja todos os itens itens

Valor de retorno	Tipo	Description
< coleçãoAtualizada>	Array ou Objeto, respectivamente	Uma coleção com todos os itens das coleções especificadas - sem duplicatas

Example

Este exemplo obtém todos os itens de essas coleções:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

E devolve este resultado: [1, 2, 3, 10, 101]

uriComponent

Retorna uma versão codificada de URI (identificador de recurso uniforme) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Use esta função em vez de encodeUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

uriComponent('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor de retorno	Tipo	Description
< uri codificado>	String	A cadeia de caracteres codificada por URI com caracteres de escape

Example

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

uriComponent('https://contoso.com')

E devolve este resultado: "https%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retornar a versão binária de um componente de identificador de recurso uniforme (URI).

uriComponentToBinary('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres codificada por URI para converter

Valor de retorno	Tipo	Description
< binário para URI codificado>	String	A versão binária para a cadeia de caracteres codificada por URI. O conteúdo binário é codificado em base64 e representado por `$content`.

Example

Este exemplo cria a versão binária para essa cadeia de caracteres codificada por URI:

uriComponentToBinary('https%3A%2F%2Fcontoso.com')

E devolve este resultado: "aHR0cHM6Ly9jb250b3NvLmNvbQ=="

uriComponentToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada por URI (identificador de recurso uniforme), decodificando efetivamente a cadeia de caracteres codificada por URI.

uriComponentToString('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres codificada por URI a descodificar

Valor de retorno	Tipo	Description
< > decodificado-uri	String	A versão decodificada para a cadeia de caracteres codificada por URI

Example

Este exemplo cria a versão da cadeia de caracteres decodificada para essa cadeia de caracteres codificada por URI:

uriComponentToString('https%3A%2F%2Fcontoso.com')

E devolve este resultado: "https://contoso.com"

uriHost

Retornar o host valor de um URI (identificador uniforme de recurso).

uriHost('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujo `host` valor você deseja

Valor de retorno	Tipo	Description
< valor do host>	String	O `host` valor para o URI especificado

Example

Este exemplo localiza o host valor para este URI:

uriHost('https://www.localhost.com:8080')

E devolve este resultado: "www.localhost.com"

uriPath

Retornar o path valor de um URI (identificador uniforme de recurso).

uriPath('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujo `path` valor você deseja

Valor de retorno	Tipo	Description
< valor-caminho>	String	O `path` valor para o URI especificado. Se `path` não tiver um valor, retorne o caractere "/".

Example

Este exemplo localiza o path valor para este URI:

uriPath('https://www.contoso.com/catalog/shownew.htm?date=today')

E devolve este resultado: "/catalog/shownew.htm"

uriPathAndQuery

Retorne os path valores e query para um URI (identificador uniforme de recurso).

uriPathAndQuery('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujos `path` valores e `query` você deseja

Valor de retorno	Tipo	Description
< path-query-value>	String	Os `path` valores e `query` para o URI especificado. Se `path` não especificar um valor, retorne o caractere "/".

Example

Este exemplo localiza os path valores e query para este URI:

uriPathAndQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

E devolve este resultado: "/catalog/shownew.htm?date=today"

uriPort

Retornar o port valor de um URI (identificador uniforme de recurso).

uriPort('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujo `port` valor você deseja

Valor de retorno	Tipo	Description
< valor-porta>	Integer	O `port` valor para o URI especificado. Se `port` não especificar um valor, retorne a porta padrão para o protocolo.

Example

Este exemplo retorna o port valor para este URI:

uriPort('https://www.localhost:8080')

E devolve este resultado: 8080

uriQuery

Retornar o query valor de um URI (identificador uniforme de recurso).

uriQuery('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujo `query` valor você deseja

Valor de retorno	Tipo	Description
< valor-consulta>	String	O `query` valor para o URI especificado

Example

Este exemplo retorna o query valor para este URI:

uriQuery('https://www.contoso.com/catalog/shownew.htm?date=today')

E devolve este resultado: "?date=today"

uriScheme

Retornar o scheme valor de um URI (identificador uniforme de recurso).

uriScheme('<uri>')

Parameter	Required	Tipo	Description
< URI>	Yes	String	O URI cujo `scheme` valor você deseja

Valor de retorno	Tipo	Description
< Esquema-valor>	String	O `scheme` valor para o URI especificado

Example

Este exemplo retorna o scheme valor para este URI:

uriScheme('https://www.contoso.com/catalog/shownew.htm?date=today')

E devolve este resultado: "http"

utcNow

Retornar o carimbo de data/hora atual.

utcNow('<format>')

Opcionalmente, você pode especificar um formato diferente com o parâmetro de formato <>.

Parameter	Required	Tipo	Description
< formato>	No	String	Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário. Se o formato não for um valor válido, um erro será gerado.

Valor de retorno	Tipo	Description
< > carimbo de data/hora atual	String	A data e hora atuais

Examples

utcNow()                  // Returns 2025-09-25T05:18:31.3384797Z
utcNow('u')               // Returns 2025-09-25 05:18:31Z
utcNow('U')               // Returns Thursday, September 25, 2025 5:18:31 AM
utcNow('d')               // Returns 9/25/2025
utcNow('D')               // Returns Thursday, September 25, 2025
utcNow('t')               // Returns 5:18 AM
utcNow('T')               // Returns 5:18:31 AM
utcNow('y')               // Returns September 2025
utcNow('yyyy')            // Returns 2025
utcNow('ddd, d MMM yyyy') // Returns Thu, 25 Sep 2025

V

variables

Retornar o valor de uma variável especificada.

variables('<variableName>')

Parameter	Required	Tipo	Description
< nomevariável>	Yes	String	O nome da variável cujo valor você deseja

Valor de retorno	Tipo	Description
< valor-variável>	Any	O valor para a variável especificada

Example

Suponha que o valor atual de uma variável "numItems" seja 20. Este exemplo obtém o valor inteiro para esta variável:

variables('numItems')

E devolve este resultado: 20

W

fluxo de trabalho

Retornar todos os detalhes sobre o fluxo de trabalho em si durante o tempo de execução.

workflow().<property>

Parameter	Required	Tipo	Description
< propriedade>	No	String	O nome da propriedade de fluxo de trabalho cujo valor você deseja Por padrão, um objeto de fluxo de trabalho tem estas propriedades: `name`, `type`, `id`, `location`, `run`e `tags`. - O `run` valor da propriedade é um objeto JSON que inclui estas propriedades: `name`, `type`, e `id`. - A `tags` propriedade é um objeto JSON que inclui tags associadas ao seu aplicativo lógico nos Aplicativos Lógicos do Azure ou fluxo no Power Automate e os valores dessas tags. Para obter mais informações sobre marcas em recursos do Azure, revise Recursos de tags, grupos de recursos e assinaturas para organização lógica no Azure. Nota: Por predefinição, uma aplicação lógica não tem etiquetas, mas um fluxo Power Automate tem as `flowDisplayName` etiquetas e `environmentName` .

Exemplo 1

Este exemplo retorna o nome da execução atual de um fluxo de trabalho:

workflow().run.name

Exemplo 2

Se você usar o Power Automate, poderá criar uma @workflow() expressão que use a tags propriedade output para obter os valores da propriedade ou do fluxo flowDisplayNameenvironmentName .

Por exemplo, você pode enviar notificações por e-mail personalizadas do próprio fluxo que vinculam de volta ao seu fluxo. Essas notificações podem incluir um link HTML que contém o nome de exibição do fluxo no título do e-mail e segue esta sintaxe:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Retornar a versão XML para uma cadeia de caracteres que contém um objeto JSON.

xml('<value>')

Parameter	Required	Tipo	Description
< valor>	Yes	String	A cadeia de caracteres com o objeto JSON para converter O objeto JSON deve ter apenas uma propriedade raiz, que não pode ser uma matriz. Use o símbolo de barra invertida (\) como um símbolo de escape para as aspas duplas (").

Valor de retorno	Tipo	Description
< xml-versão>	Object	O XML codificado para a cadeia de caracteres especificada ou objeto JSON

Exemplo 1

Este exemplo converte a cadeia de caracteres em XML:

xml('<name>Sophia Owen</name>')

E retorna este resultado XML:

<name>Sophia Owen</name>

Exemplo 2

Este exemplo cria a versão XML para essa cadeia de caracteres, que contém um objeto JSON:

xml(json('{ "name": "Sophia Owen" }'))

E retorna este resultado XML:

<name>Sophia Owen</name>

Exemplo 3

Suponha que você tenha este objeto JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Este exemplo cria XML para uma cadeia de caracteres que contém esse objeto JSON:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

E retorna este resultado XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

Exemplo 4

A xml() função espera um objeto ou uma cadeia de caracteres contendo XML válido. A função não aceita uma matriz bruta como entrada.

Se seus dados forem uma cadeia de caracteres JSON, você poderá usar a json() função para converter a cadeia de caracteres em um objeto JSON antes de passar o resultado para a xml() função, por exemplo:

xml(
  json('{"root":{"array":[
    { "ID": 1, "Name": "James" },
    { "ID": 2, "Name": "John" },
    { "ID": 3, "Name": "Sam" }
  ]}}')
)

Se você tiver uma matriz JSON, como o exemplo a seguir, terá três opções.

[
  { "ID": 1, "Name": "James" },
  { "ID": 2, "Name": "John" },
  { "ID": 3, "Name": "Sam" }
]

Opção 1: Armazene a matriz JSON em uma ação Compose chamada Compose1. Em seguida, use a outputs() função para retornar um objeto JSON de Compose1.

{
  "root": { "array": @{outputs('Compose1')} }
}

Armazene o objeto JSON retornado em outra ação chamada Compose2. Em seguida, você pode usar as xml() funções e outputs() para criar XML a partir da saída do objeto JSON do Compose2, por exemplo:

xml(outputs('Compose2'))

Opção 2: Armazene a matriz JSON em uma ação de composição chamada Compose1. Em seguida, use as outputs()funções , concat(), json()e xml() para criar XML a partir da saída do objeto JSON, por exemplo:

xml(
  json(
    concat(
      '{"root":{"array":',
      outputs('Compose1'),
      '}}'
    )
  )
)

Opção 3: Armazene a matriz JSON em uma ação Compose chamada Compose1. Em seguida, você pode usar as outputs()funções , json(), addProperty()e para xml() criar XML a partir da saída do objeto JSON, por exemplo:

xml(
  addProperty(
    json('{}'),
    'root',
    addProperty(
      json('{}'),
      'array',
      outputs('Compose1')
    )
  )
)

Todos os exemplos, que incluem o exemplo de dados de cadeia de caracteres JSON e as opções 1 a 3, retornam o seguinte resultado XML:

<root>
  <array>
    <ID>1</ID>
    <Name>James</Name>
  </array>
  <array>
    <ID>2</ID>
    <Name>John</Name>
  </array>
  <array>
    <ID>3</ID>
    <Name>Sam</Name>
  </array>
</root>

xpath

Verifique se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e retorne os nós ou valores correspondentes. Uma expressão XPath, ou apenas "XPath", ajuda você a navegar por uma estrutura de documento XML para que você possa selecionar nós ou valores de computação no conteúdo XML.

Note

Em aplicativos lógicos de consumo e padrão, todas as expressões de função usam a biblioteca .NET XPath. As expressões XPath são compatíveis com a biblioteca .NET subjacente e suportam apenas a expressão suportada pela biblioteca .NET subjacente.

xpath('<xml>', '<xpath>')

Parameter	Required	Tipo	Description
< XML>	Yes	Any	A cadeia de caracteres XML para procurar nós ou valores que correspondam a um valor de expressão XPath
< > xpath	Yes	Any	A expressão XPath usada para localizar nós ou valores XML correspondentes

Valor de retorno	Tipo	Description
< nó xml>	XML	Um nó XML quando apenas um único nó corresponde à expressão XPath especificada
< valor>	Any	O valor de um nó XML quando só um valor corresponde à expressão XPath especificada
[<xml-node1>, <xml-node2>, ...] -ou- [<value1>, <value2>, ...]	Array	Uma matriz com nós XML ou valores que correspondem à expressão XPath especificada

Exemplo 1

Suponha que você tenha esta 'items' cadeia de caracteres XML:

<?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 exemplo passa a expressão XPath, '/produce/item/name/text()', para localizar os nós que correspondem ao <name></name> nó na 'items' cadeia de caracteres XML e retorna uma matriz com esses valores de nó:

xpath(xml(parameters('items')), '/produce/item/name/text()')

O exemplo também usa a função parameters() para obter a cadeia de 'items' caracteres XML e convertê-la no formato XML usando a função xml( ).

Aqui está a matriz de resultados preenchida com valores dos nós que correspondem <name></name>:

[ Gala, Honeycrisp ]

Exemplo 2

Seguindo no Exemplo 1, este exemplo passa na expressão XPath, '/produce/item/name[1]', para localizar o primeiro name elemento que é filho do item elemento.

xpath(xml(parameters('items')), '/produce/item/name[1]')

Eis o resultado: Gala

Exemplo 3

Seguindo no Exemplo 1, este exemplo passa na expressão XPath, '/produce/item/name[last()]', para localizar o último name elemento que é o filho do item elemento.

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Eis o resultado: Honeycrisp

Exemplo 4

Neste exemplo, suponha que sua items cadeia de caracteres XML também contenha os atributos expired='true' e 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>

Este exemplo passa a expressão XPath, '//name[@expired]', para localizar todos os name elementos que têm o expired atributo:

xpath(xml(parameters('items')), '//name[@expired]')

Eis o resultado: [ Gala, Honeycrisp ]

Exemplo 5

Neste exemplo, suponha que sua items cadeia de caracteres XML contenha apenas 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>

Este exemplo passa na expressão XPath, '//name[@expired = 'true']', para localizar todos os name elementos que têm o atributo, expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Eis o resultado: [ Gala ]

Exemplo 6

Neste exemplo, suponha que sua items cadeia de caracteres XML também contenha estes 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>

Este exemplo passa na expressão XPath, '//name[@price>35]', para localizar todos os name elementos que têm price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Eis o resultado: Honeycrisp

Exemplo 7

Neste exemplo, suponha que sua items cadeia de caracteres XML seja a mesma do Exemplo 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 exemplo localiza nós que correspondem ao <count></count> nó e adiciona esses valores de nó com a sum() função:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Eis o resultado: 30

Exemplo 8

Neste exemplo, suponha que você tenha essa cadeia de caracteres XML, que inclui o namespace do documento XML, xmlns="https://contoso.com":

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

Essas expressões usam a expressão /*[name()="file"]/*[name()="location"] XPath ou /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], para localizar nós que correspondem ao <location></location> nó. Estes exemplos mostram a sintaxe que você usa no designer ou no editor de expressão:

xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

Aqui está o nó de resultado que corresponde ao nó <location></location>:

<location xmlns="https://contoso.com">Paris</location>

Important

Se você trabalha na visualização de código, escape das aspas duplas (") usando o caractere de barra invertida (\). Por exemplo, você precisa usar caracteres de escape ao serializar uma expressão como uma cadeia de caracteres JSON. No entanto, se você estiver trabalhando no designer ou no editor de expressão, não precisará escapar das aspas duplas porque o caractere de barra invertida é adicionado automaticamente à definição subjacente, por exemplo:

Visualização de código: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Editor de expressões: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Exemplo 9

Seguindo no Exemplo 8, este exemplo usa a expressão XPath, 'string(/*[name()="file"]/*[name()="location"])', para localizar o <location></location> valor no nó:

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

Eis o resultado: Paris

Próximos passos

Saiba mais sobre a linguagem de definição de fluxo de trabalho

Comentários

Esta página foi útil?

Last updated on 2025-10-06

Partilhar via

Guia de referência para funções em expressões para fluxos de trabalho nas Aplicações Lógicas do Azure e no Power Automate

Funções em expressões

Considerações sobre o uso de funções

Funções de cadeia de caracteres

Funções de recolha

Funções de comparação lógica

Funções de conversão

Conversões de tipo de dados implícitas

Codificação e descodificação Base64

Funções matemáticas

Funções de data e hora

Funções de fluxo de trabalho

Funções de análise de URI

Funções de manipulação: JSON & XML

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

Todas as funções - lista alfabética

A

ação

actions

add

addDays

addHours

addMinutes

addProperty

addSeconds

addToTime

and

matriz

B

base64

base64ToBinary

base64ToString

binário

body

bool

C

chunk

unir

concat

contains

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dateDifference

dayOfMonth

dayOfWeek

dayOfYear

decimal

decodeBase64 (preterido)

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