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

Artigo
07/31/2024

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

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.

Nota

Esta página de referência aplica-se às Aplicações Lógicas do Azure e ao Power Automate, mas aparece na documentação das Aplicações Lógicas do Azure. Embora esta página se refira especificamente a fluxos de trabalho de aplicativos lógicos, essas funções funcionam para fluxos e fluxos de trabalho de aplicativos lógicos. 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á')	"Olá"
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.	"@<functionName>(<item).<>propertyName>"

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

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

Função da cadeia de carateres	Task
chunk	Divida uma cadeia de caracteres ou coleção em partes de igual comprimento.
concat	Combine duas ou mais cadeias de caracteres e retorne a cadeia combinada.
termina com	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 global exclusivo (GUID) como uma cadeia de caracteres.
indexOf	Retornar a posição inicial de uma 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.
começaCom	Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica.
substring	Retorna caracteres de uma cadeia de caracteres, começando a partir da posição especificada. Ver também fatia.
paraMais baixo	Retornar uma cadeia de caracteres em formato minúsculo.
toUpper	Retornar uma cadeia de caracteres em formato maiúsculo.
guarnição	Remova o espaço em branco à esquerda e à direita de uma cadeia de caracteres e retorne a cadeia de caracteres 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.
contém:	Verifique se uma coleção tem um item específico.
empty	Verifique se uma coleção está vazia.
primeiro	Retornar o primeiro item de uma coleção.
intersecção	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.
aderir	Retorna uma cadeia de caracteres que tem todos os itens de uma matriz, separados pelo caractere especificado.
último	Retornar 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.
pular	Remova itens da frente de uma coleção e devolva todos os outros itens.
sort	Classificar itens em uma coleção.
tomar	Devolver itens da frente de uma coleção.
União	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.

Nota

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.
igual a	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.
se	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.
lessOrEquals	Verifique se o primeiro valor é menor ou igual ao segundo valor.
não	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.

Nota

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
matriz	Retornar uma matriz de uma única entrada especificada. Para várias entradas, consulte createArray.
base64	Retorne a versão codificada em base64 para uma cadeia de caracteres.
base64ToBinary	Retorne a versão binária para uma cadeia de caracteres codificada em base64.
base64ToString	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64.
binário	Retornar a versão binária para um valor de entrada.
Bool	Retorne a versão booleana para um valor de entrada.
createArray	Retornar uma matriz de várias entradas.
dataUri	Retornar o URI de dados para um valor de entrada.
dataUriToBinary	Retornar a versão binária para um URI de dados.
dataUriToString	Retornar a versão da cadeia de caracteres para 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 versão binária para 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.
flutuar	Retorna um número de ponto flutuante para um valor de entrada.
Int	Retorne a versão inteira para uma cadeia de caracteres.
Json	Retorne o valor ou objeto do tipo JSON (JavaScript Object Notation) para uma cadeia de caracteres ou XML.
string	Retorne a versão da cadeia de caracteres para um valor de entrada.
uriComponent	Retorne a versão codificada por URI para um valor de entrada substituindo caracteres não seguros de URL por caracteres de escape.
uriComponentToBinary	Retorne a versão binária para 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 para uma cadeia de caracteres.

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

Nota

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
adicionar	Retornar o resultado da adição de dois números.
div	Retornar o resultado da divisão de dois números.
máx.	Retornar o valor mais alto de um conjunto de números ou de uma matriz.
min	Retornar o menor valor de um conjunto de números ou de uma matriz.
Mod	Retorne o restante da divisão de dois números.
Mul	Devolva o produto multiplicando 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	Retornar o resultado subtraindo 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
addDias	Adicione dias a um carimbo de data/hora.
addHours	Adicione horas a um carimbo de data/hora.
adicionarMinutos	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 getFutureTime.
convertFromUtc	Converta um carimbo de data/hora de Universal Time Coordinated (UTC) para o fuso horário de destino.
convertTimeZone	Converta um carimbo de data/hora 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.
diadeMês	Retornar o componente dia do mês de um carimbo de data/hora.
diadesemana	Retornar o componente dia da semana de um carimbo de data/hora.
diadeano	Retornar o componente dia do ano de um carimbo de data/hora.
formatDateTime	Retornar a data de um carimbo de data/hora.
getFutureTime	Retorne o carimbo de data/hora atual mais as unidades de tempo especificadas. Consulte também addToTime.
getPastTime	Retorne o carimbo de data/hora atual menos as 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.
inícioOfDay	Retorne o início do dia para um carimbo de data/hora.
iníciodehora	Retorne o início da hora para um carimbo de data/hora.
iníciodemês	Retorne o início do mês para um carimbo de data/hora.
subtrairFromTime	Subtraia várias unidades de tempo de um carimbo de data/hora. Consulte também getPastTime.
carrapatos	Retornar o valor da propriedade para um carimbo `ticks` de data/hora especificado.
utcAgora	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.
ações	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.
corpo	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ção codificadas 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.
itens	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.
saídas	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.
Resultado	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`.
gatilho	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.
triggerSaídas	Retorna a saída de um gatilho em tempo de execução ou valores de outros pares de nome e valor JSON. Veja gatilho.
variáveis	Retornar o valor de uma variável especificada.
fluxo de trabalho	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).
uriPorto	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.
setPropriedade	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

action

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>

Parâmetro	Necessário	Type	Description
<propriedade>	Não	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 devolvido	Tipo	Description
<ação-saída>	String	A saída da ação ou propriedade atual

ações

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().

Gorjeta

A actions() função retorna a saída como uma cadeia de caracteres. Se você precisar trabalhar com um valor retornado como um objeto JSON, primeiro precisará converter o valor da cadeia de caracteres. Você pode transformar o valor da cadeia de caracteres em um objeto JSON usando a ação Analisar JSON.

Nota

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>

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	O nome do objeto de ação cuja saída você deseja
<propriedade>	Não	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 devolvido	Tipo	Description
<ação-saída>	String	A saída da ação ou propriedade especificada

Exemplo

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"

adicionar

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

add(<summand_1>, <summand_2>)

Parâmetro	Necessário	Type	Description
<summand_1>, <summand_2>	Sim	Inteiro, Flutuante ou misto	Os números a adicionar

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

Exemplo

Este exemplo adiciona os números especificados:

add(1, 1.5)

E devolve este resultado: 2.5

addDias

Adicione dias a um carimbo de data/hora.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<Dias>	Sim	Número inteiro	O número positivo ou negativo de dias a adicionar
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora mais o número especificado de dias

Exemplo 1

Este exemplo adiciona 10 dias ao carimbo de data/hora 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>'?)

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<hours>	Sim	Número inteiro	O número positivo ou negativo de horas a adicionar
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora 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"

adicionarMinutos

Adicione minutos a um carimbo de data/hora.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<minutes>	Sim	Número inteiro	O número positivo ou negativo de minutos a adicionar
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora mais o número especificado de minutos

Exemplo 1

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

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 carimbo de data/hora 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>)

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON onde você deseja adicionar uma propriedade
<propriedade>	Sim	String	O nome da propriedade a ser adicionada
<valor>	Sim	Qualquer	O valor da propriedade

Valor devolvido	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>)

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON onde você deseja adicionar uma propriedade
<Propriedade-mãe>	Sim	String	O nome da propriedade pai onde você deseja adicionar a propriedade filho
<Propriedade para crianças>	Sim	String	O nome da propriedade filho a ser adicionada
<valor>	Sim	Qualquer	O valor a ser definido para a propriedade especificada

Valor devolvido	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>'?)

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<segundos>	Sim	Número inteiro	O número positivo ou negativo de segundos a adicionar
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora 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 para o carimbo de data/hora 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>'?)

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<interval>	Sim	Número inteiro	O número de unidades de tempo especificadas a serem adicionadas
<timeUnit>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora mais o número especificado de unidades de tempo

Exemplo 1

Este exemplo adiciona um dia ao carimbo de data/hora 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 carimbo de data/hora especificado:

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

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

e

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>, ...)

Parâmetro	Necessário	Type	Description
<expressão1>, <expressão2>, ...	Sim	Boolean	As expressões a verificar

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando todas as expressões forem verdadeiras. Retorne false quando pelo menos uma expressão for false.

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 uma matriz de uma única entrada especificada. Para várias entradas, consulte createArray().

array('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres para criar uma matriz

Valor devolvido	Tipo	Description
[<valor>]	Matriz	Uma matriz que contém a única entrada especificada

Exemplo

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

array('hello')

E devolve este resultado: ["hello"]

N

base64

Retorne a versão codificada em base64 para uma cadeia de caracteres.

Nota

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres de entrada

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

Exemplo

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

base64('hello')

E devolve este resultado: "aGVsbG8="

base64ToBinary

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

Nota

base64ToBinary('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres codificada em base64 para converter

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

Exemplo

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.

Nota

base64ToString('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres codificada em base64 para decodificar

Valor devolvido	Tipo	Description
<decodificado-base64-string>	String	A versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64

Exemplo

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres a ser convertida

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

Exemplo

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.

corpo

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

body('<actionName>')

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	O nome da saída da `body` ação que você deseja

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

Exemplo

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

booleano

Retornar a versão booleana de um valor.

bool(<value>)

Parâmetro	Necessário	Type	Description
<valor>	Sim	Qualquer	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 devolvido	Tipo	Description
`true` ou `false`	Boolean	A versão booleana do valor especificado.

Saídas

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

Valor de entrada	Type	Valor devolvido
`bool(1)`	Número inteiro	`true`
`bool(0)`	Número inteiro	`false`
`bool(-1)`	Número inteiro	`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>')

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String ou matriz	A coleção a dividir
<length>	Sim	O comprimento de cada pedaço

Valor devolvido	Tipo	Description
<Coleção>	Matriz	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] ]

coalesce

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>, ...)

Parâmetro	Necessário	Type	Description
<object_1>, <object_2>, ...	Sim	Qualquer um pode misturar tipos	Um ou mais itens para verificar se há nulo

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

Exemplo

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 retorne a cadeia combinada.

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

Parâmetro	Necessário	Type	Description
<texto1>, <texto2>, ...	Sim	String	Pelo menos duas cadeias de caracteres para combinar

Valor devolvido	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.

Nota

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.

Exemplo

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

concat('Hello', 'World')

E devolve este resultado: "HelloWorld"

contém

Verifique se uma coleção tem 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 localizar uma substring
Uma matriz para encontrar um valor
Um dicionário para encontrar uma chave

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String, matriz ou dicionário	A coleção a verificar
<valor>	Sim	String, Array ou Dictionary, respectivamente	O item a ser encontrado

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando o item for encontrado. Retornar false 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 um carimbo de data/hora de Universal Time Coordinated (UTC) para o fuso horário de destino.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<destinationTimeZone>	Sim	String	O nome do fuso horário de destino. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows.
<format>	Não	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 a 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 devolvido	Tipo	Description
<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 no 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 no 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 um carimbo de data/hora do fuso horário de origem para o fuso horário de destino.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<sourceTimeZone>	Sim	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.
<destinationTimeZone>	Sim	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.
<format>	Não	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 a 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 devolvido	Tipo	Description
<Carimbo de data/hora convertido>	String	O carimbo de data/hora 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>'?)

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<sourceTimeZone>	Sim	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.
<format>	Não	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 a 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 devolvido	Tipo	Description
<Carimbo de data/hora convertido>	String	O carimbo de data/hora convertido em UTC

Exemplo 1

Este exemplo converte um carimbo de data/hora em 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/hora em 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>', ...)

Parâmetro	Necessário	Type	Description
<object1>, <object2>, ...	Sim	Qualquer, mas não misturado	Pelo menos dois itens para criar a matriz

Valor devolvido	Tipo	Description
[<object1>, <object2>, ...]	Matriz	A matriz criada a partir de todos os itens de entrada

Exemplo

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

Retorna um URI (identificador uniforme de recurso) de dados para uma cadeia de caracteres.

dataUri('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres a ser convertida

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	O URI de dados a ser convertido

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	O URI de dados a ser convertido

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<startDate>	Sim	String	Uma cadeia de caracteres que contém um carimbo de data/hora
<endDate>	Sim	String	Uma cadeia de caracteres que contém um carimbo de data/hora

Valor devolvido	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.

Exemplo

Este exemplo subtrai o primeiro valor do segundo valor:

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

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

diadeMês

Retorne o dia do mês a partir de um carimbo de data/hora.

dayOfMonth('<timestamp>')

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor devolvido	Tipo	Description
<dia-do-mês>	Número inteiro	O dia do mês a partir do carimbo de data/hora especificado

Exemplo

Este exemplo retorna o número do dia do mês deste carimbo de data/hora:

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

E devolve este resultado: 15

diadesemana

Retorne o dia da semana a partir de um carimbo de data/hora.

dayOfWeek('<timestamp>')

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor devolvido	Tipo	Description
<dia-da-semana>	Número inteiro	O dia da semana a partir do carimbo de data/hora especificado, onde domingo é 0, segunda-feira é 1 e assim por diante

Exemplo

Este exemplo retorna o número do dia da semana deste carimbo de data/hora:

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

E devolve este resultado: 4

diadeano

Retorne o dia do ano a partir de um carimbo de data/hora.

dayOfYear('<timestamp>')

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora

Valor devolvido	Tipo	Description
<dia-do-ano>	Número inteiro	O dia do ano a partir do carimbo de data/hora especificado

Exemplo

Este exemplo retorna o número do dia do ano 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.

Nota

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	O número decimal em uma cadeia de caracteres

Valor devolvido	Tipo	Description
<decimal>	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 o uso de dataUriToBinary(), em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriToBinary() é preferível.

Nota

decodeDataUri('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres de URI de dados a ser decodificada

Valor devolvido	Tipo	Description
<binário-para-data-uri>	String	A versão binária para uma cadeia de caracteres URI de dados

Exemplo

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:

decodeUriComponent

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

decodeUriComponent('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres com os caracteres de escape para decodificar

Valor devolvido	Tipo	Description
<Decodificado-URI>	String	A cadeia de caracteres atualizada com os caracteres de escape decodificados

Exemplo

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

Parâmetro	Necessário	Type	Description
<dividendos>	Sim	Inteiro ou flutuador	O número a dividir pelo divisor
<divisor>	Sim	Inteiro ou flutuador	O número que divide o dividendo, mas não pode ser zero

Valor devolvido	Tipo	Description
<quociente-resultado>	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.

Nota

encodeUriComponent('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor devolvido	Tipo	Description
<encoded-uri>	String	A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String, matriz ou objeto	A coleção a verificar

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

Exemplo

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.

termina com

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

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres a ser verificada
<pesquisaTexto>	Sim	String	A substring final para localizar

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando a substring final for encontrada. Retornar false 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>')

Parâmetro	Necessário	Type	Description
<objeto1>, <objeto2>	Sim	Vários	Os valores, expressões ou objetos a serem comparados

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando ambos forem equivalentes. Retornar false quando não equivalente.

Exemplo

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

Primeiro

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

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String ou matriz	A coleção onde encontrar o primeiro item

Valor devolvido	Tipo	Description
<primeiro item de coleção>	Qualquer	O primeiro item da coleção

Exemplo

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

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

E devolva estes resultados:

Primeiro exemplo: "h"
Segundo exemplo: 0

flutuante

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	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.
<região>	Não	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 devolvido	Tipo	Description
<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

formatDateTime

Retornar um carimbo de data/hora no formato especificado.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<format>	Não	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 a ISO 8601 e preserva as informações de fuso horário.
<região>	Não	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 devolvido	Tipo	Description
<carimbo de data/hora reformatado>	String	O carimbo de data/hora atualizado no formato e localidade especificados, se especificado.

Exemplos

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

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	A ação cuja saída tem o valor de chave desejado
<key>	Sim	String	O nome da chave cujo valor você deseja

Valor devolvido	Tipo	Description
[<matriz-com-valores-chave>]	Matriz	Uma matriz com todos os valores que correspondem à chave especificada

Exemplo

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

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	A ação cuja saída tem o valor de chave desejado
<key>	Sim	String	O nome da chave cujo valor você deseja

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<número>	Sim	Inteiro ou Duplo	O valor que você deseja formatar.
<format>	Sim	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>)`.
<região>	Não	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 devolvido	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,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,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

Retorne o carimbo de data/hora atual mais as unidades de tempo especificadas.

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

Parâmetro	Necessário	Type	Description
<interval>	Sim	Número inteiro	O número de unidades de tempo a adicionar
<timeUnit>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora atual 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

Retorne o carimbo de data/hora atual menos as unidades de tempo especificadas.

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

Parâmetro	Necessário	Type	Description
<interval>	Sim	Número inteiro	O número de unidades de tempo especificadas para subtrair
<timeUnit>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora atual menos o número especificado de unidades de tempo

Exemplo 1

Suponha que o carimbo de data/hora atual seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias desse carimbo de data/hora:

getPastTime(5, 'Day')

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

Exemplo 2

Suponha que o carimbo de data/hora atual 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>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	Inteiro, Float ou String	O primeiro valor para verificar se é maior que o segundo valor
<compareTo>	Sim	Inteiro, Float ou String, respectivamente	O valor de comparação

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	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.

Exemplo

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

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

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	Inteiro, Float ou String	O primeiro valor para verificar se maior ou igual ao segundo valor
<compareTo>	Sim	Inteiro, Float ou String, respectivamente	O valor de comparação

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

Exemplo

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

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

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

Parâmetro	Necessário	Type	Description
<format>	Não	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 devolvido	Tipo	Description
<Valor GUID>	String	Um GUID gerado aleatoriamente

Exemplo

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

Parâmetro	Necessário	Type	Description
<expressão>	Sim	Boolean	A expressão a verificar
<valorSeVerdadeiro>	Sim	Qualquer	O valor a ser retornado quando a expressão for true
<valorSeFalso>	Sim	Qualquer	O valor a ser retornado quando a expressão for false

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

Exemplo

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que tem a substring para localizar
<pesquisaTexto>	Sim	String	A substring a ser localizada

Valor devolvido	Tipo	Description
<valor-índice>	Número inteiro	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.

Exemplo

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

número inteiro

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

int('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	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 devolvido	Tipo	Description
<resultado inteiro>	Número inteiro	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.

Exemplo

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres a ser examinada
<região>	Não	String	O código de localidade RFC 4646 a ser usado

Valor devolvido	Tipo	Description
<resultado booleano>	Boolean	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>')

Parâmetro	Necessário	Type	Description
<string>	Sim	String	A cadeia de caracteres a ser examinada

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

Exemplo

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 devolvido	Tipo	Description
<current-array-item>	Qualquer	O item atual na matriz para a iteração atual da ação

Exemplo

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

itens

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

items('<loopName>')

Parâmetro	Necessário	Type	Description
<Nome do loop>	Sim	String	O nome do loop for-each

Valor devolvido	Tipo	Descrição
<item>	Qualquer	O item do ciclo atual no loop especificado para cada

Exemplo

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

Parâmetro	Necessário	Type	Description
<Nome do loop>	Sim	String	O nome do loop Until

Valor devolvido	Tipo	Description
<índice>	Número inteiro	O valor de índice para a iteração atual dentro do loop Until especificado

Exemplo

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

Importante

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.

Parâmetro	Necessário	Type	Description
<valor>	Sim	String ou XML	A cadeia de caracteres ou XML a ser convertido

Valor devolvido	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"
         }
      ]
   }
}

intersecção

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

Parâmetro	Necessário	Type	Description
<coleção1>, <coleção2>, ...	Sim	Array ou Object, mas não ambos	As coleções de onde você deseja apenas os itens comuns

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

Exemplo

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]

join

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

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	Matriz	A matriz que tem os itens para unir
<delimitador>	Sim	String	O separador que aparece entre cada caractere na cadeia de caracteres resultante

Valor devolvido	Tipo	Description
<delimitador char1><delimitador><> char2...><	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.

Exemplo

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

Último

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

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String ou matriz	A coleção onde encontrar o último item

Valor devolvido	Tipo	Description
<último item-coleção>	String ou Array, respectivamente	O último item da coleção

Exemplo

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que tem a substring para localizar
<pesquisaTexto>	Sim	String	A substring a ser localizada

Valor devolvido	Tipo	Description
<valor-índice-final>	Número inteiro	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.

Exemplos

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 em uma coleção.

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String ou matriz	A coleção com os itens a contar

Valor devolvido	Tipo	Description
<comprimento-ou-contagem>	Número inteiro	O número de itens na coleção

Exemplo

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. Retorne true quando o primeiro valor for menor ou retorne false quando o primeiro valor for mais.

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	Inteiro, Float ou String	O primeiro valor para verificar se é menor que o segundo valor
<compareTo>	Sim	Inteiro, Float ou String, respectivamente	O item de comparação

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando o primeiro valor for menor que o segundo. Retornar false quando o primeiro valor for igual ou maior que o segundo valor.

Exemplo

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

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

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	Inteiro, Float ou String	O primeiro valor para verificar se menor ou igual ao segundo valor
<compareTo>	Sim	Inteiro, Float ou String, respectivamente	O item de comparação

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retornar true quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo.

Exemplo

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

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

E 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 devolvido	Tipo	Description
<callback-URL>	String	A URL de retorno de chamada para um gatilho ou ação

Exemplo

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*>"

Seg

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>, ...])

Parâmetro	Necessário	Type	Description
<número1>, <número2>, ...	Sim	Inteiro, Float ou ambos	O conjunto de números do qual você deseja o valor mais alto
[<número1>, <número2>, ...]	Sim	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o valor mais alto

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

Exemplo

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

Retornar o menor valor de um conjunto de números ou de uma matriz.

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

Parâmetro	Necessário	Type	Description
<número1>, <número2>, ...	Sim	Inteiro, Float ou ambos	O conjunto de números do qual você deseja o menor valor
[<número1>, <número2>, ...]	Sim	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o menor valor

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

Exemplo

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

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

mod(<dividend>, <divisor>)

Parâmetro	Necessário	Type	Description
<dividendos>	Sim	Inteiro ou flutuador	O número a dividir pelo divisor
<divisor>	Sim	Inteiro ou flutuador	O número que divide o dividendo, mas não pode ser zero

Valor devolvido	Tipo	Description
<modulo-resultado>	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

Devolva o produto multiplicando dois números.

mul(<multiplicand1>, <multiplicand2>)

Parâmetro	Necessário	Type	Description
<multiplicando1>	Sim	Inteiro ou flutuador	O número a multiplicar por multiplicand2
<multiplicando2>	Sim	Inteiro ou flutuador	O número que multiplica multiplicand1

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

Exemplo

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

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

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

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	O nome da ação que tem saída com várias partes
<índice>	Sim	Número inteiro	O valor de índice para a parte que você deseja

Valor devolvido	Tipo	Description
<corpo>	String	O corpo da parte especificada

N

not

Verifique se uma expressão é falsa. Retorne true quando a expressão for false, ou retorne false quando true.

not(<expression>)

Parâmetro	Necessário	Type	Description
<expressão>	Sim	Boolean	A expressão a verificar

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando a expressão for false. Retorne false quando a expressão for true.

Exemplo 1

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

not(false)
not(true)

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

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que contém a substring para localizar
<pesquisaTexto>	Sim	String	A substring a ser localizada
<ocorrência>	Sim	Número inteiro	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 devolvido	Tipo	Description
<valor-índice>	Número inteiro	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`.

Exemplos

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

ou

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>, ...)

Parâmetro	Necessário	Type	Description
<expressão1>, <expressão2>, ...	Sim	Boolean	As expressões a verificar

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true 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)

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

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

saídas

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

outputs('<actionName>')

Parâmetro	Necessário	Type	Description
<actionName>	Sim	String	O nome da saída da ação que você deseja

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

Exemplo

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

parâmetros

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

parameters('<parameterName>')

Parâmetro	Necessário	Type	Description
<nome_parâmetro>	Sim	String	O nome do parâmetro cujo valor você deseja

Valor devolvido	Tipo	Description
<valor-parâmetro>	Qualquer	O valor para o parâmetro especificado

Exemplo

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<região>	Não	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.
<format>	Não	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 a 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 devolvido	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.

Exemplos

parseDateTime('20/10/2014', 'fr-fr') // Returns '2014-10-20T00:00:00.0000000'.
parseDateTime('20 octobre 2010', 'fr-FR') // Returns '2010-10-20T00:00:00.0000000'.
parseDateTime('martes 20 octubre 2020', 'es-es') // Returns '2020-10-20T00:00:00.0000000'.
parseDateTime('21052019', 'fr-fr', 'ddMMyyyy') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

RAND

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

rand(<minValue>, <maxValue>)

Parâmetro	Necessário	Type	Description
<minValor>	Sim	Número inteiro	O número inteiro mais baixo do intervalo
<maxValor>	Sim	Número inteiro	O inteiro que segue o número inteiro mais alto no intervalo que a função pode retornar

Valor devolvido	Tipo	Description
<resultado aleatório>	Número inteiro	O inteiro aleatório retornado do intervalo especificado

Exemplo

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, 3, ou 4

range

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

range(<startIndex>, <count>)

Parâmetro	Necessário	Type	Description
<startIndex>	Sim	Número inteiro	Um valor inteiro que inicia a matriz como o primeiro item
<count>	Sim	Número inteiro	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 devolvido	Tipo	Description
[<intervalo-resultado>]	Matriz	A matriz com inteiros a partir do índice especificado

Exemplo

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

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON de onde você deseja remover uma propriedade
<propriedade>	Sim	String	O nome da propriedade a ser removida

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

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON cuja propriedade você deseja remover
<Propriedade-mãe>	Sim	String	O nome da propriedade pai com a propriedade filho que você deseja remover
<Propriedade para crianças>	Sim	String	O nome da propriedade filho a ser removida

Valor devolvido	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"
   }
}

replace

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que tem a substring para substituir
<texto antigo>	Sim	String	A substring a ser substituída
<newTexto>	Sim	String	A cadeia de caracteres de substituição

Valor devolvido	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.

Exemplo

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.

Nota

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

Parâmetro	Necessário	Type	Description
<scopedActionName>	Sim	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 devolvido	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

Exemplo

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	Matriz	A cobrança para reverter

Valor devolvido	Tipo	Description
[<coleção> atualizada]	Matriz	A cobrança invertida

Exemplo

Este exemplo inverte uma matriz de inteiros:

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

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

S

setPropriedade

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

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON cuja propriedade você deseja definir
<propriedade>	Sim	String	O nome da propriedade existente ou nova a ser definida
<valor>	Sim	Qualquer	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>))

Parâmetro	Necessário	Type	Description
<objeto>	Sim	Object	O objeto JSON cuja propriedade você deseja definir
<Propriedade-mãe>	Sim	String	O nome da propriedade pai com a propriedade filho que você deseja definir
<Propriedade para crianças>	Sim	String	O nome da propriedade filho a ser definida
<valor>	Sim	Qualquer	O valor a ser definido para a propriedade especificada

Valor devolvido	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"
   }
}

skip

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

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	Matriz	A coleção cujos itens você deseja remover
<count>	Sim	Número inteiro	Um número inteiro positivo para o número de itens a remover na frente

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

Exemplo

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]

slice

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

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que contém a substring para localizar
<startIndex>	Sim	Número inteiro	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>	Não	Número inteiro	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 devolvido	Tipo	Description
<fatia-resultado>	String	Uma nova cadeia de caracteres que contém a substring encontrada

Exemplos

slice('Hello World', 2) // Returns 'llo World'.
slice('Hello World', 30) // Returns ''.
slice('Hello World', 10, 2) // Returns ''.
slice('Hello World', 0) // Returns 'Hello World'.
slice('Hello World', 2, 5) // Returns 'llo'.
slice('Hello World', 6, 20) // Returns 'World'.
slice('Hello World', -2) // Returns 'ld'.
slice('Hello World', 3, -1) // Returns 'lo Worl'.
slice('Hello World', 3, 3) // Returns ''.

sort

Classificar itens em uma coleção. Você pode classificar os objetos de coleção usando qualquer chave que contenha um tipo simples.

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	Matriz	A coleção com os itens para classificar
<ordenarPor>	Não	String	A chave a ser usada para classificar os objetos de coleção

Valor devolvido	Tipo	Description
[<coleção> atualizada]	Matriz	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" }')]

split

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres a ser separada em substrings com base no delimitador especificado na string original
<delimitador>	Sim	String	O caractere na cadeia de caracteres original a ser usado como delimitador

Valor devolvido	Tipo	Description
[<substring1,substring2><>,...]	Matriz	Uma matriz que contém substrings 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"]

inícioOfDay

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

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<format>	Não	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 a 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 devolvido	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

Exemplo

Este exemplo localiza o início do dia para este carimbo de data/hora:

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

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

iníciodehora

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

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora especificado, mas começando na marca de zero minuto para a hora

Exemplo

Este exemplo localiza o início da hora para este carimbo de data/hora:

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

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

iníciodemês

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

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<format>	Não	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 a 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 devolvido	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 retorna o início do mês para este carimbo de data/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"

começaCom

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

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres a ser verificada
<pesquisaTexto>	Sim	String	A cadeia de caracteres inicial para localizar

Valor devolvido	Tipo	Description
verdadeiro ou falso	Boolean	Retorne true quando a substring inicial for encontrada. Retornar false 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

string

Retorne a versão da cadeia de caracteres para um valor.

string(<value>)

Parâmetro	Necessário	Type	Description
<valor>	Sim	Qualquer	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 devolvido	Tipo	Description
<valor da 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

Retornar o resultado subtraindo o segundo número do primeiro número.

sub(<minuend>, <subtrahend>)

Parâmetro	Necessário	Type	Description
<minuend>	Sim	Inteiro ou flutuador	O número do qual subtrair o subtrahend
<Subtrahend>	Sim	Inteiro ou flutuador	O número a subtrair do minuend

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

Exemplo

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres cujos caracteres você deseja
<startIndex>	Sim	Número inteiro	Um número positivo igual ou superior a 0 que pretende utilizar como posição inicial ou valor de índice
<length>	Não	Número inteiro	Um número positivo de caracteres que você deseja na substring

Nota

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 devolvido	Tipo	Description
<substring-result>	String	Uma substring com o número especificado de caracteres, começando na posição de índice especificada na cadeia de caracteres de origem

Exemplo

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"

subtrairFromTime

Subtraia várias unidades de tempo de um carimbo de data/hora. Consulte também getPastTime.

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres que contém o carimbo de data/hora
<interval>	Sim	Número inteiro	O número de unidades de tempo especificadas para subtrair
<timeUnit>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atualizado>	String	O carimbo de data/hora menos o número especificado de unidades de tempo

Exemplo 1

Este exemplo subtrai um dia deste carimbo de data/hora:

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 carimbo de data/hora:

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 frente de uma coleção.

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

Parâmetro	Necessário	Type	Description
<Coleção>	Sim	String ou matriz	A coleção cujos itens você deseja
<count>	Sim	Número inteiro	Um número inteiro positivo para o número de itens que você deseja da frente

Valor devolvido	Tipo	Description
<subconjunto> ou [<subconjunto>]	String ou Array, respectivamente	Uma cadeia de caracteres ou matriz que tem o número especificado de itens retirados da frente da coleção original

Exemplo

Estes exemplos obtêm o número especificado de itens da frente dessas coleções:

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

E devolva estes resultados:

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

carrapatos

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

Parâmetro	Necessário	Type	Description
<Carimbo de data/hora>	Sim	String	A cadeia de caracteres para um carimbo de data/hora

Valor devolvido	Tipo	Description
<número de ticks>	Número inteiro	O número de ticks desde o carimbo de data/hora especificado

paraMais baixo

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres a ser retornada em formato minúsculo

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

Exemplo

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

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres a ser retornada em formato maiúsculo

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

Exemplo

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

toUpper('Hello World')

E devolve este resultado: "HELLO WORLD"

gatilho

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

Parâmetro	Necessário	Type	Description
<key>	Sim	String	O nome da chave cujo valor você deseja

Valor devolvido	Tipo	Description
[<matriz-com-valores-chave>]	Matriz	Uma matriz com todos os valores que correspondem à chave especificada

Exemplo

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

Parâmetro	Necessário	Type	Description
<key>	Sim	String	O nome da chave cujo valor você deseja

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<índice>	Sim	Número inteiro	O valor de índice para a parte que você deseja

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

triggerSaídas

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 devolvido	Tipo	Description
<Saída-gatilho>	String	A saída de um gatilho em tempo de execução

guarnição

Remova o espaço em branco à esquerda e à direita de uma cadeia de caracteres e retorne a cadeia de caracteres atualizada.

trim('<text>')

Parâmetro	Necessário	Type	Descrição
<texto>	Sim	String	A cadeia de caracteres que tem o espaço em branco à esquerda e à direita para remover

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

Exemplo

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>], ...)

Parâmetro	Necessário	Type	Description
<coleção1>, <coleção2>, ...	Sim	Array ou Object, mas não ambos	As coleções de onde você deseja todos os itens

Valor devolvido	Tipo	Description
<updatedCollection>	Array ou Object, respectivamente	Uma coleção com todos os itens das coleções especificadas - sem duplicatas

Exemplo

Este exemplo obtém todos os itens dessas 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>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor devolvido	Tipo	Description
<encoded-uri>	String	A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

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 para um componente URI (identificador de recurso uniforme).

uriComponentToBinary('<value>')

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres codificada por URI para converter

Valor devolvido	Tipo	Description
<binário-para-encoded-uri>	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`.

Exemplo

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:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	String	A cadeia de caracteres codificada por URI para decodificar

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujo `host` valor você deseja

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujo `path` valor você deseja

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujos `path` valores e `query` você deseja

Valor devolvido	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 "/".

Exemplo

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"

uriPorto

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

uriPort('<uri>')

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujo `port` valor você deseja

Valor devolvido	Tipo	Description
<valor-porta>	Número inteiro	O `port` valor para o URI especificado. Se `port` não especificar um valor, retorne a porta padrão para o protocolo.

Exemplo

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

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujo `query` valor você deseja

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

Exemplo

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

Parâmetro	Necessário	Type	Description
<URI>	Sim	String	O URI cujo `scheme` valor você deseja

Valor devolvido	Tipo	Description
<Esquema-valor>	String	O `scheme` valor para o URI especificado

Exemplo

Este exemplo retorna o scheme valor para este URI:

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

E devolve este resultado: "http"

utcAgora

Retornar o carimbo de data/hora atual.

utcNow('<format>')

Opcionalmente, você pode especificar um formato diferente com o <parâmetro format>.

Parâmetro	Necessário	Type	Description
<format>	Não	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 a 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 devolvido	Tipo	Description
<carimbo de data/hora atual>	String	A data e hora atuais

Exemplo 1

Suponha que hoje é 15 de abril de 2018 às 13:00:00. Este exemplo obtém o carimbo de data/hora atual:

utcNow()

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

Exemplo 2

Suponha que hoje é 15 de abril de 2018 às 13:00:00. Este exemplo obtém o carimbo de data/hora atual usando o formato "D" opcional:

utcNow('D')

E devolve este resultado: "Sunday, April 15, 2018"

V

variáveis

Retornar o valor de uma variável especificada.

variables('<variableName>')

Parâmetro	Necessário	Type	Description
<nomevariável>	Sim	String	O nome da variável cujo valor você deseja

Valor devolvido	Tipo	Description
<valor-variável>	Qualquer	O valor para a variável especificada

Exemplo

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

Qua

fluxo de trabalho

Retornar todos os detalhes sobre o fluxo de trabalho em si durante o tempo de execução.

workflow().<property>

Parâmetro	Necessário	Type	Description
<propriedade>	Não	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 flowDisplayName environmentName .

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

Parâmetro	Necessário	Type	Description
<valor>	Sim	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 caractere de barra invertida (\) como um caractere de escape para as aspas duplas (").

Valor devolvido	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>

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.

Nota

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

Parâmetro	Necessário	Type	Description
<xml>	Sim	Qualquer	A cadeia de caracteres XML para procurar nós ou valores que correspondam a um valor de expressão XPath
<XPath>	Sim	Qualquer	A expressão XPath usada para localizar nós ou valores XML correspondentes

Valor devolvido	Tipo	Description
<nó xml>	XML	Um nó XML quando apenas um único nó corresponde à expressão XPath especificada
<valor>	Qualquer	O valor de um nó XML quando apenas um único valor corresponde à expressão XPath especificada
[<xml-node1>, <xml-node2>, ...] -ou- [<value1>, <value2>, ...]	Matriz	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 <location></location> nó:

<location xmlns="https://contoso.com">Paris</location>

Importante

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

Partilhar via

Guia de referência para funções de expressão de fluxo 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

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

action

ações

adicionar

addDias

addHours

adicionarMinutos

addProperty

addSeconds

addToTime

e

matriz

N

base64

base64ToBinary

base64ToString

binário

corpo

booleano

C

chunk

coalesce

concat

contém

convertFromUtc

convertTimeZone

convertToUtc

createArray

D

dataUri

dataUriToBinary

dataUriToString

dateDifference

diadeMês

diadesemana

diadeano

decimal

decodeBase64 (preterido)

decodeDataUri

decodeUriComponent

div

E

encodeUriComponent

empty

termina com

equals

F

Primeiro

flutuante

formatDateTime

formDataMultiValues

formDataValue

formatNumber

G

getFutureTime

getPastTime

greater

greaterOrEquals

guid

I

if

indexOf

número inteiro