Compartilhar via


Guia de referência para funções de expressão do fluxo de trabalho nos Aplicativos Lógicos do Azure e Power Automate

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

Para as definições de fluxo de trabalho nos Aplicativos Lógicos do Azure e no Power Automate, algumas expressões obtêm os respectivos valores das ações de runtime que poderão ainda não existir quando o fluxo de trabalho começar a ser executado. Para referenciar ou processar os valores nessas expressões, use as funções de expressão fornecidas pela Linguagem de Definição de Fluxo de Trabalho.

Observação

Essa página de referência se aplica aos Aplicativos Lógicos do Azure e ao Power Automate, mas aparece na documentação dos Aplicativos Lógicos do Azure. Embora essa página se refira especificamente a fluxos de trabalho de aplicativos lógicos, as funções se aplicam aos fluxos e aos aplicativos lógicos. Para obter mais informações sobre as funções e as expressões do Power Automate, revise Usar expressões em condições.

Por exemplo, você pode calcular valores usando funções matemáticas, como a função add(), quando deseja obter a soma de inteiros ou floats. Veja outros exemplos de tarefas que podem ser executadas com funções:

Tarefa Sintaxe da função Resultado
Retornar uma cadeia de caracteres em letras minúsculas. toLower('<texto>')

Por exemplo: toLower('Hello')
"Olá"
Retornar um GUID (identificador global exclusivo). guid() "C2ECC88D-88C8-4096-912C-D6F2E2B138CE"

Para encontrar funções com base no uso geral, examine 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 demonstra como é possível obter o valor do customerName parâmetro e atribuir esse valor à propriedade accountName usando a função parameters() em uma expressão:

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

Estas são algumas outras maneiras de usar funções em expressões:

Tarefa Sintaxe da função em uma expressão
Executar o trabalho com um item passando esse item para uma função. "@<nomedafunção>(<item>)"
1. Obter o valor de parameterName usando a função parameters() aninhada.
2. Executar o trabalho com o resultado passando esse valor para functionName.
"@<functionName>(parameters('<parameterName>'))"
1. Obter o resultado da função interna aninhada functionName.
2. Passar o resultado para a função externa functionName2.
"@<functionName2>(<functionName>(<item>))"
1. Obter o resultado de functionName.
2. Dado que o resultado é um objeto com a propriedade propertyName, obter o valor dessa propriedade.
"@<functionName>(<item>).<propertyName>"

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

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

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

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

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

Considerações ao usar funções

  • O designer não avalia expressões de runtime que são usadas como parâmetros de função no tempo de design. O designer requer que todas as expressões possam ser totalmente avaliadas no tempo de design.

  • Os parâmetros de função são avaliados da esquerda para a direita.

  • Na sintaxe das definições de parâmetro, um ponto de interrogação (?) exibido após um parâmetro significa que ele é opcional. Por exemplo, consulte getFutureTime().

  • As expressões de função que aparecem embutidas com texto sem formatação exigem chaves de circunscrição ({}) para usar o formato interpolado da expressão. Esse formato ajuda a evitar a análise de problemas. Se sua expressão de função não aparecer embutida em texto sem formatação, nenhuma chave será necessária.

    O seguinte exemplo 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 as funções com base no uso geral ou então, você pode procurá-las em ordem alfabética.

Funções de cadeia de caracteres

Para trabalhar com cadeias de caracteres, você pode usar essas funções de cadeia de caracteres e algumas funções de coleta. Funções de cadeia de caracteres só funcionam com cadeias de caracteres.

Função de cadeia de caracteres Tarefa
pedaço Dividir uma cadeia de caracteres ou uma coleção em partes de comprimento igual.
concat Combinar duas ou mais cadeias de caracteres e retornar a cadeia de caracteres combinada.
endswith Verificar se uma cadeia de caracteres termina com a subcadeia de caracteres especificada.
número de formato Retorna um número como uma cadeia de caracteres com base no formato especificado
Guid Gerar um GUID (identificador global exclusivo) como uma cadeia de caracteres.
indexOf Retornar a posição inicial de uma subcadeia de caracteres.
isFloat Retornar um booliano que indica se uma cadeia de caracteres é um número de ponto flutuante.
isInt Retornar um booliano que indica se uma cadeia de caracteres é um inteiro.
lastIndexOf Retorna a posição inicial da última ocorrência de uma subcadeia de caracteres.
comprimento Retornar o número de itens em uma cadeia de caracteres ou matriz.
nthIndexOf Retorna a posição inicial ou o valor de índice em que a n-ésima ocorrência de uma subcadeia de caracteres aparece em uma cadeia de caracteres.
substitui Substituir uma subcadeia de caracteres pela cadeia de caracteres especificada e retornar a cadeia de caracteres atualizada.
fatia Retorna uma subcadeia de caracteres especificando a posição inicial e final ou o valor. Consulte também substring.
dividir Retorna uma matriz contendo subcadeias de caracteres, separadas por vírgulas, de uma cadeia de caracteres maior baseada em um caractere delimitador especificado na cadeia de caracteres original.
startswith Verificar se uma cadeia de caracteres começa com uma subcadeia de caracteres específica.
Subsequência Retornar caracteres de uma cadeia de caracteres, começando na posição especificada. Consulte também slice.
toLower Retornar uma cadeia de caracteres em letras minúsculas.
toUpper Retornar uma cadeia de caracteres em letras maiúsculas.
cortar Remover espaços em branco à esquerda e à direita de uma cadeia de caracteres e retornar a cadeia de caracteres atualizada.

Funções de coleção

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

Função de coleção Tarefa
pedaço Dividir uma cadeia de caracteres ou uma coleção em partes de comprimento igual.
Contém Verificar se uma coleção tem um item específico.
vazio Verifique se uma coleção está vazia.
primeiro Retornar o primeiro item de uma coleção.
cruzamento Retornar uma coleção que tem somente os itens comuns entre as coleções especificadas.
item Se essa função aparece dentro de uma ação repetida em uma matriz, retornará o item atual na matriz durante a iteração atual da ação.
associar Retornar 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.
comprimento Retornar o número de itens em uma cadeia de caracteres ou matriz.
inverter Inverter a ordem dos itens em uma matriz.
saltitar Remover itens do início de uma coleção e retornar todos os outros itens.
ordenar Classificar itens de uma coleção.
tomar Retornar itens do início de uma coleção.
união Retornar uma coleção que tem 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, é possível usar essas funções de comparação lógica. Para a referência completa sobre cada função, consulte a lista alfabética.

Observação

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

Função de comparação lógica Tarefa
e Verificar se todas as expressões são verdadeiras.
é igual a Verificar se os dois valores são equivalentes.
maior Verificar se o primeiro valor é maior que o segundo valor.
greaterOrEquals Verificar se o primeiro valor é superior ou igual ao segundo.
se Verificar se uma expressão é verdadeira ou falsa. Com base no resultado, retornar um valor especificado.
isFloat Retornar um booliano que indica se uma cadeia de caracteres é um número de ponto flutuante.
isInt Retornar um booliano que indica se uma cadeia de caracteres é um inteiro.
menos Verificar se o primeiro valor é menor que o segundo valor.
lessOrEquals Verificar se o primeiro valor é inferior ou igual ao segundo valor.
não Verificar se uma expressão é falsa.
ou Verificar se pelo menos uma expressão é verdadeira.

Funções de conversão

Para alterar o tipo ou o formato de um valor, você pode usar estas funções de conversão. Por exemplo, é possível alterar um valor de booliano para inteiro. Para obter mais informações sobre como os Aplicativos Lógicos do Azure tratam os tipos de conteúdo durante a conversão, confira Tratar tipos de conteúdo. Para a referência completa sobre cada função, consulte a lista alfabética.

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Conversões implícitas de tipos de dados.

Função de conversão Tarefa
matriz Retornar uma matriz de uma única entrada especificada. Para várias entradas, confira createArray.
base64 Retornar a versão codificada em Base64 de uma cadeia de caracteres.
base64ParaBinário Retornar a versão binária de uma cadeia de caracteres codificada em Base64.
base64ToString Retornar a versão de cadeia de caracteres de uma cadeia de caracteres codificada em Base64.
binário Retornar a versão binária de um valor de entrada.
bool Retornar a versão booliana de um valor de entrada.
createArray Retornar uma matriz de várias entradas.
dataUri Retornar o URI de dados de um valor de entrada.
dataUriToBinary Retornar a versão binária de um URI de dados.
dataUriToString Retornar a versão de cadeia de caracteres de um URI de dados.
decimal Retornar o número decimal de uma cadeia de caracteres decimal.
decodificar Base64 Retornar a versão de cadeia de caracteres de uma cadeia de caracteres codificada em Base64.
decodeDataUri Retornar a versão binária de um URI de dados.
decodeUriComponent Retornar uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.
encodeUriComponent Retornar uma cadeia de caracteres que substitui caracteres não seguros para URL por caracteres de escape.
flutuar Retornar um número de ponto flutuante correspondente a um valor de entrada.
int Retornar a versão em inteiros de uma cadeia de caracteres.
json Retornar o objeto ou valor de tipo JSON (JavaScript Object Notation) correspondente a uma cadeia de caracteres ou XML.
cadeia de caracteres Retornar a versão de cadeia de caracteres de um valor de entrada.
uriComponent Retornar a versão codificada para URI correspondente a um valor de entrada substituindo caracteres não seguros para URL por caracteres de escape.
uriComponentToBinary Retornar a versão binária de uma cadeia de caracteres codificada como URI.
uriComponentToString Retornar a versão de cadeia de caracteres correspondente a uma cadeia de caracteres codificada como URI.
XML Retornar a versão XML de uma cadeia de caracteres.

Conversões implícitas de tipo de dados

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

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

triggerBody()?['123']

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

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

Codificação e decodificação Base64

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação ou a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções correspondentes:

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

Observação

Se você adicionar uma dessas funções manualmente com o designer, seja diretamente para um gatilho ou ação ou usando o editor de expressão, saia e retorne novamente ao designer. A função terá desaparecido dele, deixando apenas os valores de parâmetro. Esse comportamento também ocorrerá se você selecionar um gatilho ou uma ação que usa essa função sem editar os valores de parâmetro da função. Esse resultado afeta apenas a visibilidade da função e não o efeito. Na exibiçã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 exibição de código, deixando apenas os valores de parâmetro da função.

Funções matemáticas

Para trabalhar com números inteiros e floats, você pode usar estas funções matemáticas. Para a referência completa sobre cada função, consulte a lista alfabética.

Função matemática Tarefa
adicionar Retornar o resultado da adição de dois números.
Div Retornar o resultado da divisão de dois números.
máximo Retornar o valor mais alto de um conjunto de números em uma matriz.
mínimo Retornar o valor mais baixo de um conjunto de números ou de uma matriz.
Mod Retornar o resto da divisão de dois números.
mul Retornar o produto da multiplicação de dois números.
rand Retornar um número inteiro aleatório de um intervalo especificado.
intervalo Retornar uma matriz de inteiros que começa em um inteiro especificado.
sub Retornar o resultado da subtração do segundo número do primeiro.

Funções de data e hora

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

Função de data ou hora Tarefa
addDays Adicionar dias a um carimbo de data/hora.
addHours Adicionar horas a um carimbo de data/hora.
Adicionar Atas Adicionar minutos a um carimbo de data/hora.
Segundos de adição Adicionar segundos a um carimbo de data/hora.
addToTime Adicionar unidades de tempo especificadas a um carimbo de data/hora. Confira também getFutureTime.
convertFromUtc Converter um carimbo de data/hora de UTC (Tempo Universal Coordenado) no fuso horário de destino.
convertTimeZone Converter um carimbo de data/hora do fuso horário de origem no fuso horário de destino.
convertToUtc Converter um carimbo de data/hora do fuso horário de origem em UTC (Tempo Universal Coordenado).
diferença de data Retornar a diferença entre duas datas como um período de tempo.
diaDoMês Retornar o componente de dia do mês de um carimbo de data/hora.
diaDeSemana Retornar o componente de dia da semana de um carimbo de data/hora.
diaDoAno Retornar o componente de dia do ano de um carimbo de data/hora.
formatoData/Hora Retornar a data de um carimbo de data/hora.
getFutureTime Retornar o carimbo de data/hora atual mais as unidades de tempo especificadas. Confira também addToTime.
getPastTime Retornar o carimbo de data/hora atual menos as unidades de tempo especificadas. Confira também subtractFromTime.
parseDataHora Retorna o carimbo de data/hora de uma cadeia de caracteres que contenha um carimbo de hora.
início do dia Retornar o início do dia de um carimbo de data/hora.
início de hora Retornar o início da hora de um carimbo de data/hora.
inícioDeMês Retornar o início do mês de um carimbo de data/hora.
subtractFromTime Subtrair um número de unidades de tempo de um carimbo de data/hora. Confira também getPastTime.
Carrapatos Retornar o valor de propriedade ticks de um carimbo de data/hora especificado.
utcNow Retornar o carimbo de data/hora atual como uma cadeia de caracteres.

Funções de fluxo de trabalho

Essas funções de fluxo de trabalho podem ajudar você a:

  • Obter detalhes sobre uma instância de fluxo de trabalho em tempo de execução.
  • Trabalhar com as entradas usadas para criar uma instância de aplicativos lógicos ou fluxos.
  • Referenciar as saídas de gatilhos e ações.

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

Função de fluxo de trabalho Tarefa
ação Retornar a saída da ação atual em runtime ou os valores de outros pares de nome e valor JSON. Confira também actions.
Ações Retornar a saída de uma ação em runtime ou os valores de outros pares de nome e valor JSON. Confira também action.
corpo Retornar a saída body de uma ação em runtime.
formDataMultiValues Criar uma matriz com os valores correspondentes a um nome de chave nas saídas da ação form-data ou form-encoded.
formDataValue Retornar um único valor correspondente a um nome de chave na saída form-data ou form-encoded de uma ação.
item Se essa função aparece dentro de uma ação repetida em uma matriz, retornará o item atual na matriz durante a iteração atual da ação.
Itens Se essa função aparecer dentro de um loop Until ou Foreach, retornará o item atual do loop especificado.
iterationIndexes Se essa função aparecer dentro de um loop Until, retornará o valor de índice da iteração atual. Você pode usar essa função dentro de loops Until aninhados.
listCallbackUrl Retornar a "URL de retorno de chamada" que chama um gatilho ou uma ação.
corpo multipartos Retornar o corpo de uma parte específica na saída de uma ação que tem várias partes.
saídas Retornar a saída de uma ação em runtime.
Parâmetros Retorna o valor de um parâmetro descrito na definição de fluxo de trabalho.
resultado Retorna as entradas e as saídas das ações primárias que estão dentro da ação no escopo especificada, como For_each, Until e Scope.
gatilho Retornar a saída de um gatilho em runtime ou de outros pares de nome e valor JSON. Confira também triggerOutputs e triggerBody.
Corpo do gatilho Retornar a saída body de um gatilho em runtime. Confira trigger.
triggerFormDataValue Retornar um único valor correspondente a um nome de chave nas saídas dos gatilhos form-data ou form-encoded.
triggerMultipartBody Retornar o corpo de uma parte específica na saída de várias partes de um gatilho.
triggerFormDataMultiValues Criar uma matriz com valores correspondentes a um nome de chave nas saídas de gatilho form-data ou form-encoded.
triggerOutputs Retornar a saída de um gatilho em runtime ou os valores de outros pares de nome e valor JSON. Confira trigger.
variáveis Retornar o valor de uma variável especificada.
Fluxo de trabalho Retornar todos os detalhes sobre o próprio fluxo de trabalho durante o tempo de execução.

Funções de análise de URI

Para trabalhar com URIs (Uniform Resource Identifier) e obter vários valores das propriedades desses URIs, você pode usar estas funções de análise de URI. Para a referência completa sobre cada função, consulte a lista alfabética.

Função de análise de URI Tarefa
uriHost Retornar o valor host de um URI (Uniform Resource Identifier).
Caminho do uri Retornar o valor path de um URI (Uniform Resource Identifier).
uriPathAndQuery Retornar os valores path e query de um URI (Uniform Resource Identifier).
Porta de uri Retornar o valor port de um URI (Uniform Resource Identifier).
uriConsulta Retornar o valor query de um URI (Uniform Resource Identifier).
uriEsquema Retornar o valor scheme de um URI (Uniform Resource Identifier).

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

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

Função de manipulação Tarefa
Propriedade addProperty Adicionar uma propriedade e seu valor, ou par nome-valor, a um objeto JSON e retornar o objeto atualizado.
coalescer Retornar o primeiro valor não nulo de um ou mais parâmetros.
remover propriedade Remover uma propriedade de um objeto JSON e retornar o objeto atualizado.
Propriedade do conjunto Definir o valor da propriedade de um objeto JSON e retornar o objeto atualizado.
xpath Verificar o XML em busca de nós ou valores correspondentes a uma expressão XPath (Linguagem XPath) e retornar esses nós ou valores.

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

Todas as funções – lista alfabética

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

Um

ação

Retorne a saída da ação atual em runtime ou os valores de outros pares de nome e valor JSON, que podem ser atribuídos a uma expressão. Por padrão, essa função referencia todo o objeto de ação, mas você pode especificar uma propriedade cujo valor você deseja. Consulte também actions().

É possível usar a função action() apenas nestes lugares:

  • A propriedade unsubscribe de uma ação de webhook para que você possa acessar o resultado da solicitação subscribe original
  • A propriedade trackedProperties de uma ação
  • A condição de loop do-until de uma ação
action()
action().outputs.body.<property>
Parâmetro Obrigatório Tipo Descrição
< propriedade> Não fio O nome da propriedade do objeto de ação cuo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, é possível localizar essas propriedades revisando os detalhes de um histórico de execuções específico. Para obter mias informações, consulte REST API – Workflow Run Actions (API REST – Ações de execução de fluxo de trabalho).
Valor retornado Tipo Descrição
< saída de ação> fio A saída da ação ou da propriedade atual

Ações

Retornar a saída da ação em runtime ou os valores de outros pares de nome e valor JSON, que podem ser atribuídos a uma expressão. Por padrão, a função referencia todo o objeto de ação, mas você pode especificar uma propriedade cujo valor você deseja. Quanto às versões abreviadas, consulte corpo(). Para a ação atual, consulte action().

Dica

A função actions() retorna a saída como uma cadeia de caracteres. Se você precisar trabalhar com um valor retornado como um objeto JSON, será necessário primeiro 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.

Observação

Anteriormente, era possível usar a função actions() ou o elemento conditions 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 é necessário usar a propriedade runAfter da ação dependente. Para saber mais sobre a propriedade runAfter, confira Detectar e lidar com falhas com a propriedade runAfter.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio O nome do objeto de ação cuja saída você deseja
< propriedade> Não fio O nome da propriedade do objeto de ação cuo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, é possível localizar essas propriedades revisando os detalhes de um histórico de execuções específico. Para obter mias informações, consulte REST API – Workflow Run Actions (API REST – Ações de execução de fluxo de trabalho).
Valor retornado Tipo Descrição
< saída de ação> fio A saída da ação ou propriedade especificada

Exemplo

Esse exemplo obtém o valor da propriedade status da ação X Get user no runtime:

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

E retorna este resultado: "Succeeded"

adicionar

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

add(<summand_1>, <summand_2>)
Parâmetro Obrigatório Tipo Descrição
< summand_1>, <summand_2> Sim Integer, Float ou misto Os números a serem adicionados
Valor retornado Tipo Descrição
< resultado-soma> Integer ou Float O resultado da adição dos números especificados

Exemplo

Esse exemplo adiciona os números especificados:

add(1, 1.5)

E retorna este resultado: 2.5

addDays

Adicionar dias a um carimbo de data/hora.

addDays('<timestamp>', <days>, '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma 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 ser adicionado
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora mais o número de dias especificado

Exemplo 1

Esse exemplo adiciona 10 dias ao carimbo de data/hora especificado:

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

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

Exemplo 2

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

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

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

addHours

Adicionar horas a um carimbo de data/hora.

addHours('<timestamp>', <hours>, '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< Horas> Sim Número Inteiro O número positivo ou negativo de horas a ser adicionado
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora mais o número de horas especificado

Exemplo 1

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

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

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

Exemplo 2

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

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

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

Adicionar Atas

Adicionar minutos a um carimbo de data/hora.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< ata> Sim Número Inteiro O número positivo ou negativo de minutos a ser adicionado
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora mais o número de minutos especificado

Exemplo 1

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

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

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

Exemplo 2

Esse exemplo subtrai cinco minutos do carimbo de data/hora especificado:

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

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

Propriedade addProperty

Adicionar uma propriedade e seu valor, ou par nome-valor, a um objeto JSON e retornar o objeto atualizado. Se a propriedade já existir em runtime, a função falhará e gerará um erro.

addProperty(<object>, '<property>', <value>)
Parâmetro Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON em que você deseja adicionar uma propriedade
< propriedade> Sim fio O nome da propriedade a ser adicionada
< valor> Sim Qualquer O valor da propriedade
Valor retornado Tipo Descrição
< objeto atualizado> Objeto O objeto JSON atualizado com a propriedade especificada

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

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parâmetro Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON em que você deseja adicionar uma propriedade
< propriedade pai> Sim fio O nome da propriedade pai à qual você deseja adicionar a propriedade filho
< propriedade infantil> Sim fio O nome da propriedade filho a ser adicionada
< valor> Sim Qualquer O valor a ser definido para a propriedade especificada
Valor retornado Tipo Descrição
< objeto atualizado> Objeto O objeto JSON atualizado cuja propriedade você define

Exemplo 1

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

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

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

Exemplo 2

Este exemplo adiciona a propriedade filho middleName à propriedade customerName existente em um objeto JSON, que é convertido de uma cadeia de caracteres em JSON por meio da 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'))

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

Segundos de adição

Adicionar segundos a um carimbo de data/hora.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma 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 ser adicionado
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora mais o número de segundos especificado

Exemplo 1

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

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

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

Exemplo 2

Esse exemplo subtrai cinco segundos ao carimbo de data/hora especificado:

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

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

addToTime

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

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< intervalo> Sim Número Inteiro O número de unidades de tempo especificadas a ser adicionado
< unidade de tempo> Sim fio Unidade de tempo a ser usado com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora mais o número de unidades de tempo especificado

Exemplo 1

Este exemplo adiciona um dia ao carimbo de data/hora especificado:

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

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

Verificar se todas as expressões são verdadeiras. Retornará true quando todas as expressões forem true ou retornar false quando pelo menos uma expressão é false.

and(<expression1>, <expression2>, ...)
Parâmetro Obrigatório Tipo Descrição
< expressão1>, <expressão2>, ... Sim Booliano As expressões a serem verificadas
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando todas as expressões forem true. Retornará false quando pelo menos uma expressão for false.

Exemplo 1

Esses exemplos verificam se os valores boolianos são todos true:

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

E retorna estes resultados:

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

Exemplo 2

Esses exemplos verificam se as expressões especificadas são todas true:

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

E retorna estes resultados:

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

matriz

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

array('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres para criar uma matriz
Valor retornado Tipo Descrição
[<valor>] Matriz Uma matriz que contém a única entrada especificada

Exemplo

Esse exemplo cria uma matriz da cadeia de caracteres "hello":

array('hello')

E retorna este resultado: ["hello"]

B

base64

Retornar a versão codificada em Base64 de uma cadeia de caracteres.

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

base64('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres de entrada
Valor retornado Tipo Descrição
< em base64 cordas> fio A versão codificada em Base64 da cadeia de caracteres de entrada

Exemplo

Esse exemplo converte a cadeia de caracteres "hello" em uma cadeia de caracteres codificada em Base64:

base64('hello')

E retorna este resultado: "aGVsbG8="

base64ParaBinário

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

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

base64ToBinary('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres codificada em Base64 a ser convertida
Valor retornado Tipo Descrição
< binário para base64 strings> fio A versão binária da cadeia de caracteres codificada em Base64

Exemplo

Esse exemplo converte a cadeia de caracteres codificada em Base64 "aGVsbG8=" em uma cadeia de caracteres 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 base 64 em dados binários e enviar esses dados usando o tipo de conteúdo application/octet-stream na solicitação.

base64ToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em Base64, decodificando com eficiência a cadeia de caracteres Base64. Use essa função em vez de decodeBase64(), que foi preterida.

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

base64ToString('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres codificada em Base64 a ser decodificada
Valor retornado Tipo Descrição
< base64 strings decodificadas> fio A versão da cadeia de caracteres de uma cadeia de caracteres codificada em Base64

Exemplo

Esse exemplo converte a cadeia de caracteres codificada em Base64 "aGVsbG8=" em apenas uma cadeia de caracteres:

base64ToString('aGVsbG8=')

E retorna este resultado: "hello"

binário

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

binary('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres a ser convertida
Valor retornado Tipo Descrição
< binário para valor de entrada> fio A versão binária codificada em Base64 da cadeia de caracteres especificada

Exemplo

Por exemplo, você está usando uma ação HTTP que retorna um arquivo de imagem ou de vídeo. Você pode usar binary() para converter o valor em um modelo de envelope de conteúdo codificado em Base64. Em seguida, 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 tipo de conteúdo application/octet-stream na solicitação.

corpo

Retornar a saída body de uma ação em runtime. Abreviação de actions('<actionName>').outputs.body. Consulte actions().

body('<actionName>')
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio O nome da saída body da ação desejada
Valor retornado Tipo Descrição
< ação-corpo-saída> fio A saída body da ação especificada

Exemplo

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

body('Get_user')

E retorna este resultado:

"body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
}

Bool

Retornar a versão booliana de um valor.

bool(<value>)
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Qualquer O valor a ser convertido em booliano.

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

Valor retornado Tipo Descrição
true ou false Booliano A versão booliana do valor especificado.

Saídas

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

Valor de entrada Tipo Valor retornado
bool(1) Número Inteiro true
bool(0) Número Inteiro false
bool(-1) Número Inteiro true
bool('true') fio true
bool('false') fio false

C

parte

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

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String ou Array A coleção a ser dividida
< comprimento> Sim O comprimento de cada parte
Valor retornado Tipo Descrição
< coleção> Matriz Uma matriz de partes com o comprimento especificado

Exemplo 1

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

chunk('abcdefghijklmnopqrstuvwxyz', 10)

E retorna 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 retorna este resultado: [ [1,2,3,4,5], [6,7,8,9,10], [11,12] ]

coalescer

Retornar 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 Obrigatório Tipo Descrição
< objeto_1>, <objeto_2>, ... Sim Qualquer um, pode misturar tipos Um ou mais itens para verificar se são nulos
Valor retornado Tipo Descrição
< primeiro item não nulo> Qualquer O primeiro item ou valor que não seja nulo. Se todos os parâmetros forem nulos, essa função retornará null.

Exemplo

Esses exemplos retornarão o primeiro valor não nulo dos valores especificados ou null quando todos os valores forem nulos:

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

E retorna estes resultados:

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

concat

Combinar duas ou mais cadeias de caracteres e retornar a cadeia de caracteres combinada.

concat('<text1>', '<text2>', ...)
Parâmetro Obrigatório Tipo Descrição
< texto1>, <texto2>, ... Sim fio Pelo menos duas cadeias de caracteres a serem combinadas
Valor retornado Tipo Descrição
< texto1texto2...> fio A cadeia de caracteres criada das cadeias de caracteres de entrada combinadas.



Observação: o tamanho do resultado não deve exceder 104.857.600 caracteres.

Observação

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

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

No entanto, se usar essa função de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

Exemplo

Esse exemplo combina as cadeias de caracteres "Olá" e "Mundo":

concat('Hello', 'World')

E retorna este resultado: "HelloWorld"

contém

Verificar se uma coleção tem um item específico. Retornará true quando o item for localizado ou false quando não for localizado. Essa 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 subcadeia de caracteres
  • Uma matriz para localizar um valor
  • Um dicionário para localizar uma chave
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String, Array ou Dictionary A coleção a ser verificada
< valor> Sim String, Array ou Dictionary, respectivamente O item a ser localizado
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando o item for localizado. Retorna false quando não localizada.

Exemplo 1

Esse exemplo verifica se há a subcadeia de caracteres "mundo" na cadeia de caracteres "olá, mundo" e retorna true:

contains('hello world', 'world')

Exemplo 2

Esse exemplo verifica se há a subcadeia de caracteres "universo" na cadeia de caracteres "olá, mundo" e retorna false:

contains('hello world', 'universe')

convertFromUtc

Converter um carimbo de data/hora de UTC (Tempo Universal Coordenado) no fuso horário de destino.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< destinoFuso horário> Sim fio O nome do fuso horário de destino. Para obter nomes de fuso horário, examine Fusos horários padrão do Microsoft Windows.
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora convertido> fio O carimbo de data/hora convertido no fuso horário de destino sem a diferença UTC do fuso horário.

Exemplo 1

Esse exemplo converte um carimbo de data/hora no fuso horário especificado:

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

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

Exemplo 2

Esse exemplo converte um carimbo de data/hora no fuso horário e no formato especificado:

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

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

convertTimeZone

Converter um carimbo de data/hora do fuso horário de origem no fuso horário de destino.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< sourceTimeZone> Sim fio O nome do fuso horário de origem. Para obter nomes de fuso horário, confira Fusos horários padrão do Microsoft Windows. Talvez seja necessário remover alguma pontuação do nome do fuso horário.
< destinoFuso horário> Sim fio O nome do fuso horário de destino. Para obter nomes de fuso horário, confira Fusos horários padrão do Microsoft Windows. Talvez seja necessário remover alguma pontuação do nome do fuso horário.
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora convertido> fio O carimbo de data/hora convertido na região do fuso horário

Exemplo 1

Esse 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 retorna este resultado: "2018-01-01T00:00:00.0000000"

Exemplo 2

Esse exemplo converte um fuso horário no fuso horário e no formato especificado:

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

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

convertToUtc

Converter um carimbo de data/hora do fuso horário de origem em UTC (Tempo Universal Coordenado).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< sourceTimeZone> Sim fio O nome do fuso horário de origem. Para obter nomes de fuso horário, confira Fusos horários padrão do Microsoft Windows. Talvez seja necessário remover alguma pontuação do nome do fuso horário.
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora convertido> fio O carimbo de data/hora convertido no UTC

Exemplo 1

Esse exemplo converte um carimbo de data/hora em UTC:

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

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

Exemplo 2

Esse exemplo converte um carimbo de data/hora em UTC:

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

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

criar matriz

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

createArray('<object1>', '<object2>', ...)
Parâmetro Obrigatório Tipo Descrição
< objeto1>, <objeto2>, ... Sim Qualquer um, mas não misto Pelo menos dois itens para criar a matriz
Valor retornado Tipo Descrição
[<objeto1>, <objeto2>, ...] Matriz A matriz criada com base em todos os itens de entrada

Exemplo

Esse exemplo cria uma matriz com base nestas entradas:

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

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

D

dataUri

Retornar um URI (Uniform Resource Identifier) de dados para uma cadeia de caracteres.

dataUri('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres a ser convertida
Valor retornado Tipo Descrição
< URI de dados> fio O URI dos dados da cadeia de caracteres de entrada

Exemplo

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

dataUri('hello')

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

dataUriToBinary

Retorne a versão binária de um URI (Uniform Resource Identifier) de dados. Use esta função em vez de decodeDataUri(). Embora as funções funcionem da mesma forma, dataUriBinary() é preferencial.

dataUriToBinary('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio O URI de dados a ser convertido
Valor retornado Tipo Descrição
< binário para uri de dados> fio A versão binária do URI de dados

Exemplo

Esse exemplo cria uma versão binária para esse URI de dados:

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

E retorna este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retornar a versão de cadeia de caracteres de um URI (Uniform Resource Identifier) de dados.

dataUriToString('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio O URI de dados a ser convertido
Valor retornado Tipo Descrição
< cadeia de caracteres para uri de dados> fio A versão de cadeia de caracteres do URI de dados

Exemplo

Esse exemplo cria uma cadeia de caracteres para esse URI de dados:

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

E retorna este resultado: "hello"

diferença de data

Retornar a diferença entre dois carimbos de data/hora como um período de tempo. Essa função subtrai startDate de endDate e retorna o resultado como carimbo de data/hora no formato de cadeia de caracteres.

dateDifference('<startDate>', '<endDate>')
Parâmetro Obrigatório Tipo Descrição
< data inicial> Sim fio Uma cadeia de caracteres que contém um carimbo de data/hora
< data final> Sim fio Uma cadeia de caracteres que contém um carimbo de data/hora
Valor retornado Tipo Descrição
< timespan> fio A diferença entre os dois carimbos de data/hora, que é um carimbo de data/hora no formato de cadeia de caracteres. Se startDate for mais recente do que endDate, o resultado será um valor negativo.

Exemplo

Esse exemplo subtrai o primeiro valor do segundo:

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

E retorna este resultado: "1268.00:00:00"

diaDoMês

Retorna o dia do mês de um carimbo de data/hora.

dayOfMonth('<timestamp>')
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
Valor retornado Tipo Descrição
< dia do mês> Número Inteiro O dia do mês do carimbo de data/hora especificado

Exemplo

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

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

E retorna este resultado: 15

diaDeSemana

Retornar o dia da semana de um carimbo de data/hora.

dayOfWeek('<timestamp>')
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
Valor retornado Tipo Descrição
< dia da semana> Número Inteiro O dia da semana do carimbo de data/hora especificado em que domingo é 0, segunda-feira é 1 e assim por diante

Exemplo

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

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

E retorna este resultado: 4

dayOfYear

Retorna o dia do ano de um carimbo de data/hora.

dayOfYear('<timestamp>')
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
Valor retornado Tipo Descrição
< dia do ano> Número Inteiro O dia do ano do carimbo de data/hora especificado

Exemplo

Esse exemplo retorna o número do dia do ano desse carimbo de data/hora:

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

E retorna este resultado: 74

decimal

Retorna um número decimal em uma cadeia de caracteres como um número decimal. Você poderá 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(), encapsule qualquer saída decimal com a função de cadeia de caracteres. Esse uso aparece nos exemplos a seguir, nos quais você poderá perder a precisão se usar o resultado decimal como um número.

Observação

A precisão decimal discutida no contexto para essa função e no runtime dos Aplicativos Lógicos do Azure é igual à precisão decimal do .NET.

decimal('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio O número decimal em uma cadeia de caracteres
Valor retornado Tipo Descrição
< decimal> Número Decimal O número decimal para uma cadeia de caracteres de entrada

Exemplo 1

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

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exemplo 2

Este exemplo cria um decimal e 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)

Essa função está preterida, então, use base64ToString().

decodeDataUri

Retorne a versão binária de um URI (Uniform Resource Identifier) de dados. Considere usar dataUriToBinary(), em vez de decodeDataUri(). Embora as funções funcionem da mesma forma, dataUriToBinary() é preferencial.

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

decodeDataUri('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres do URI de dados a ser decodificada
Valor retornado Tipo Descrição
< binário para uri de dados> fio A versão binária de uma cadeia de caracteres do URI de dados

Exemplo

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

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

E retorna este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres com os caracteres de escape a ser decodificada
Valor retornado Tipo Descrição
< uri decodificado> fio A cadeia de caracteres atualizada com os caracteres de escape decodificados

Exemplo

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

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

E retorna 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 Obrigatório Tipo Descrição
< dividendo> Sim Integer ou Float O número a ser dividido pelo divisor
< divisor> Sim Integer ou Float O número que divide o dividendo, mas não pode ser zero
Valor retornado Tipo Descrição
< quociente-resultado> Integer ou Float O resultado da divisão do primeiro número pelo segundo. Se o dividendo ou o divisor tiver um tipo Float, o resultado terá o tipo Float.



Observação: para converter o resultado float em um número inteiro, tente criar e chamar uma função no Azure pelo aplicativo lógico.

Exemplo 1

Os dois exemplos retornam este valor com o tipo Integer: 2

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

Exemplo 2

Os dois exemplos retornam este valor com o tipo Float: 2.2

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

E

encodeUriComponent

Retornar uma versão codificada para URI (Uniform Resource Identifier) para uma cadeia de caracteres substituindo caracteres desprotegidos de URL por caracteres de escape. Considere usar uriComponent(), em vez de encodeUriComponent(). Embora as funções funcionem da mesma forma, uriComponent() é preferencial.

Observação

Os Aplicativos Lógicos do Azure executam automática ou implicitamente a codificação e a decodificação base64, de modo que você não precisa executar essas conversões manualmente usando as funções de codificação e decodificação. No entanto, se você usar essas funções de qualquer forma no designer, poderá experimentar 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 código. Para obter mais informações, confira Codificação e decodificação de Base64.

encodeUriComponent('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres a ser convertida em um formato codificado para URI
Valor retornado Tipo Descrição
< URI codificado> fio A cadeia de caracteres codificada para URI com caracteres de escape

Exemplo

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

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

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

vazio

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

empty('<collection>')
empty([<collection>])
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String, Array ou Object A coleção a ser verificada
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando a coleção estiver vazia. Retornará false quando não estiver vazia.

Exemplo

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

empty('')
empty('abc')

E retorna estes resultados:

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

terminaCom

Verificar se uma cadeia de caracteres termina com uma subcadeia de caracteres específica. Retornará true quando a subcadeia de caracteres for localizada ou retornará false quando não for localizada. Essa função não diferencia maiúsculas de minúsculas.

endsWith('<text>', '<searchText>')
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres a ser verificada
< textoDepesquisa> Sim fio A subcadeia de caracteres final a ser localizada
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando a subcadeia de caracteres final for localizada. Retorna false quando não localizada.

Exemplo 1

Esse exemplo verifica se a cadeia de caracteres "olá, mundo" termina com a cadeia de caracteres "mundo":

endsWith('hello world', 'world')

E retorna este resultado: true

Exemplo 2

Esse exemplo verifica se a cadeia de caracteres "olá, mundo" termina com a cadeia de caracteres "universo":

endsWith('hello world', 'universe')

E retorna este resultado: false

igual

Verificar se os valores, expressões ou objetos são equivalentes. Retornará true quando ambos forem equivalentes ou retornará false quando não forem equivalentes.

equals('<object1>', '<object2>')
Parâmetro Obrigatório Tipo Descrição
< objeto1>, <objeto2> Sim Vários Os valores, expressões ou objetos a serem comparados
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando ambos forem equivalentes. Retornará false quando não forem equivalentes.

Exemplo

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

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

E retorna estes resultados:

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

F

primeiro

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

first('<collection>')
first([<collection>])
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String ou Array A coleção na qual localizar o primeiro item
Valor retornado Tipo Descrição
< primeiro item de coleção> Qualquer O primeiro item na coleção

Exemplo

Esses exemplos localizam o primeiro item nestas coleções:

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

E retornam estes resultados:

  • Primeiro exemplo: "h"
  • Segundo exemplo: 0

FLOAT

Converter uma versão de cadeia de caracteres para um número de ponto flutuante em um número de ponto flutuante real. Use essa função apenas ao passar parâmetros personalizados para um aplicativo, por exemplo, um fluxo de trabalho de aplicativo lógico ou um fluxo do Power Automate. 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 Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres que tem um número de ponto flutuante válido a ser convertido. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados float.
< localidade> Não fio O código de localidade RFC 4646 a ser usado.

Se esta opção não for especificada, o local padrão será usado.

Se a localidade não for um valor válido, será gerado um erro de que a localidade fornecida não é válida ou não tem uma localidade associada.
Valor retornado Tipo Descrição
< valor flutuante> Flutuar O número de ponto 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

Esse exemplo cria uma versão de cadeia de caracteres para este número de ponto flutuante:

float('10,000.333')

E retorna este resultado: 10000.333

Exemplo 2

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

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

E retorna este resultado: 10000.333

formatoData/Hora

Retornar um carimbo de data/hora no formato especificado.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.
< localidade> Não fio A localidade a ser usada. Se não especificado, o valor será en-us. Se a localidade não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora reformatado> fio O carimbo de data/hora atualizado no formato e localidade especificados, se tiver sido 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

Retornar uma matriz com valores correspondentes a um nome de chave na saída de dados de formulário ou codificada para formulário de uma ação.

formDataMultiValues('<actionName>', '<key>')
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio A ação cuja saída tem o valor de chave desejado
< chave> Sim fio O nome da chave cujo valor você deseja
Valor retornado Tipo Descrição
[<<array-with-key-values>>] Matriz Uma matriz com todos os valores correspondentes à chave especificada

Exemplo

Esse exemplo cria uma matriz do valor da chave "Assunto" na saída de dados de formulário ou codificada para formulário de uma ação:

formDataMultiValues('Send_an_email', 'Subject')

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

formDataValue

Retornar um único valor correspondente a um nome de chave na saída form-data ou form-encoded de uma ação. Se a função localizar mais de uma correspondência, a função gerará um erro.

formDataValue('<actionName>', '<key>')
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio A ação cuja saída tem o valor de chave desejado
< chave> Sim fio O nome da chave cujo valor você deseja
Valor retornado Tipo Descrição
< Valor-chave> fio O valor na chave especificada

Exemplo

Esse exemplo cria uma cadeia de caracteres do valor da chave "Assunto" na saída de dados de formulário ou codificada para formulário de uma ação:

formDataValue('Send_an_email', 'Subject')

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

número de formato

Retorna um número como uma cadeia de caracteres com base no formato especificado.

formatNumber(<number>, <format>, <locale>?)
Parâmetro Obrigatório Tipo Descrição
< número> Sim Inteiro ou duplo O valor que você deseja formatar.
< formato> Sim fio 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 compatíveis, confira Cadeias de caracteres de formato numérico padrão, que são compatíveis com number.ToString(<format>, <locale>).
< localidade> Não fio A localidade a ser usada compatível com o number.ToString(<format>, <locale>). Se não especificado, o valor será en-us. Se a localidade não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< número formatado> fio O número especificado como uma cadeia de caracteres no formato que você especificou. Converta esse valor retornado em um int ou float.

Exemplo 1

Suponha que você deseje 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ê deseje formatar o número 1234567890. Este exemplo formata o número como a cadeia de caracteres "1.234.567.890,00".

formatNumber(1234567890, '0,0.00', 'is-is')

Exemplo 3

Suponha que você deseje formatar o número 17.35. Este exemplo formata o número como a cadeia de caracteres "US$ 17,35".

formatNumber(17.35, 'C2')

Exemplo 4

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

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

G

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)
Parâmetro Obrigatório Tipo Descrição
< intervalo> Sim Número Inteiro O número de unidades de tempo a serem adicionadas
< unidade de tempo> Sim fio Unidade de tempo a ser usado com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato> Não fio Um especificador de formato único ou um padrão de formato personalizado. O formato padrão do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva 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 retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora atual mais o número de unidades de tempo especificado

Exemplo 1

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

getFutureTime(5, 'Day')

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

Exemplo 2

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

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

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

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)
Parâmetro Obrigatório Tipo Descrição
< intervalo> Sim Número Inteiro O número de unidades de tempo especificadas a serem subtraídas
< unidade de tempo> Sim fio Unidade de tempo a ser usado com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato> Não fio Um especificador de formato único ou um padrão de formato personalizado. O formato padrão do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva 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 retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora atual menos o número de unidades de tempo especificado

Exemplo 1

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

getPastTime(5, 'Day')

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

Exemplo 2

Suponha que o carimbo de data/hora é "2018-02-01T00:00:00.0000000Z". Esse exemplo subtrai cinco dias e converte o resultado no formato "D":

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

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

maior

Verificar se o primeiro valor é maior que o segundo valor. Retornará true quando o primeiro valor for maior ou false quando for menor.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Integer, Float ou String O primeiro valor para verificar se é maior do que o segundo
< comparar> Sim Integer, Float ou String, respectivamente O valor de comparação
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando o primeiro valor for maior que o segundo. Retornará false quando o primeiro valor for igual ou menor que o segundo.

Exemplo

Esses exemplos verificam se o primeiro valor é maior que o segundo:

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

E retornam estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

greaterOrEquals

Verificar se o primeiro valor é superior ou igual ao segundo. Retornará true quando o primeiro valor for superior ou igual ou retornará false quando o primeiro valor for inferior.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Integer, Float ou String O primeiro valor para verificar se é superior ou igual ao segundo
< comparar> Sim Integer, Float ou String, respectivamente O valor de comparação
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando o primeiro valor for superior ou igual ao segundo. Retornará false quando o primeiro valor for menor que o segundo.

Exemplo

Esses exemplos verificam se o primeiro valor é superior ou igual ao segundo:

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

E retornam estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

Guid

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

guid()

Além disso, é possível especificar um formato diferente para o GUID que não seja o formato padrão, "D", que é de 32 dígitos separados por hifens.

guid('<format>')
Parâmetro Obrigatório Tipo Descrição
< formato> Não fio Um único especificador de formato para o GUID retornado. Por padrão, o formato é "D", mas é possível usar "N", "D", "B", "P" ou "X".
Valor retornado Tipo Descrição
< Valor GUID> fio Um GUID gerado aleatoriamente

Exemplo

Esse exemplo gera o mesmo GUID, mas como 32 dígitos, separado por hifens e entre parênteses:

guid('P')

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

Eu

se

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

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parâmetro Obrigatório Tipo Descrição
< expressão> Sim Booliano A expressão a ser verificada
< valueIfTrue> Sim Qualquer O valor a ser retornado quando a expressão for verdadeira
< valueIfFalse> Sim Qualquer O valor a ser retornado quando a expressão for falsa
Valor retornado Tipo Descrição
< valor de retorno especificado> Qualquer O valor especificado retornado dependendo se a expressão é verdadeira ou falsa

Exemplo

Esse 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 o valor de índice ou a posição inicial para uma subcadeia de caracteres. 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 Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que tem a subcadeia de caracteres a ser localizada
< textoDepesquisa> Sim fio A subcadeia de caracteres a ser localizada
Valor retornado Tipo Descrição
< valor do índice> Número Inteiro O valor de índice ou a posição inicial da subcadeia de caracteres especificada.

Se a cadeia de caracteres não for localizada, retornará o número -1.

Exemplo

Esse exemplo localiza o valor de índice inicial para a subcadeia de caracteres "mundo" na cadeia de caracteres "olá, mundo":

indexOf('hello world', 'world')

E retorna este resultado: 6

INT

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

int('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio 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 Integer.
Valor retornado Tipo Descrição
< resultado inteiro> Número Inteiro A versão em inteiros da cadeia de caracteres especificada. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados Integer.

Exemplo

Esse exemplo cria uma versão em inteiros da cadeia de caracteres "10":

int('10')

E retorna este resultado: 10

isFloat

Retornar um booliano que indica se uma cadeia de caracteres é um número de ponto flutuante. Por padrão, essa função usa a cultura invariável para o formato de ponto flutuante. Para identificar números de ponto 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 Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres a examinar
< localidade> Não fio O código de localidade RFC 4646 a ser usado
Valor retornado Tipo Descrição
< resultado booleano> Booliano Um booliano que indica se uma cadeia de caracteres é um número de ponto flutuante

Exemplo 1

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

isFloat('10,000.00')

E retorna este resultado: true

Exemplo 2

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

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

E retorna este resultado: true

isInt

Retornar um booliano que indica se uma cadeia de caracteres é um inteiro.

isInt('<string>')
Parâmetro Obrigatório Tipo Descrição
< cadeia de caracteres> Sim fio A cadeia de caracteres a examinar
Valor retornado Tipo Descrição
< resultado booleano> Booliano Um booliano que indica se uma cadeia de caracteres é um inteiro

Exemplo

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

isInt('10')

E retorna este resultado: true

objeto

Quando usado dentro de uma ação repetida em uma matriz, retornar o item atual na matriz durante a iteração atual da ação. Também é possível obter os valores das propriedades desse item.

item()
Valor retornado Tipo Descrição
< item-de-matriz-atual> Qualquer O item atual na matriz da iteração atual da ação

Exemplo

Esse exemplo obtém o elemento body da mensagem atual para a ação "Enviar_um_email" dentro de uma iteração atual do loop for-each:

item().body

itens

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

items('<loopName>')
Parâmetro Obrigatório Tipo Descrição
< nome do loop> Sim fio O nome do loop for-each
Valor retornado Tipo Descrição
< item> Qualquer O item do ciclo atual no loop for-each especificado

Exemplo

Esse exemplo obtém o item atual do loop for-each especificado:

items('myForEachLoopName')

iterationIndexes

Retorna o valor de índice da iteração atual dentro de um loop Until. Você pode usar essa função dentro de loops Until aninhados.

iterationIndexes('<loopName>')
Parâmetro Obrigatório Tipo Descrição
< nome do loop> Sim fio O nome do loop Until
Valor retornado Tipo Descrição
< índice> Número Inteiro O valor de índice da 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 acompanha o índice atual em cada iteração. Durante cada iteração no loop Until, o exemplo incrementa o valor do contador, depois atribui o valor do contador ao valor do índice atual e, em seguida, incrementa o valor do contador. No loop, este exemplo referencia o índice de iteração atual usando a função iterationIndexes:

iterationIndexes('Until_Max_Increment')

{
   "actions": {
      "Create_counter_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [ 
               {
                  "name": "myCounter",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {}
      },
      "Create_current_index_variable": {
         "type": "InitializeVariable",
         "inputs": {
            "variables": [
               {
                  "name": "myCurrentLoopIndex",
                  "type": "Integer",
                  "value": 0
               }
            ]
         },
         "runAfter": {
            "Create_counter_variable": [ "Succeeded" ]
         }
      },
      "Until_Max_Increment": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "Compose": {
               "inputs": "'Current index: ' @{iterationIndexes('Until_Max_Increment')}",
               "runAfter": {
                  "Assign_current_index_to_counter": [
                     "Succeeded"
                    ]
                },
                "type": "Compose"
            },           
            "Increment_variable": {
               "type": "IncrementVariable",
               "inputs": {
                  "name": "myCounter",
                  "value": 1
               },
               "runAfter": {}
            }
         },
         "expression": "@equals(variables('myCounter'), 5)",
         "limit": {
            "count": 60,
            "timeout": "PT1H"
         },
         "runAfter": {
            "Create_current_index_variable": [ "Succeeded" ]
         }
      }
   }
}

J

json

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

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

Importante

Sem um esquema XML que define a estrutura da saída, a função pode retornar resultados em que 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 definido, por exemplo, em sistemas de negócios ou soluções críticos.

Parâmetro Obrigatório Tipo Descrição
< valor> Sim String ou XML A cadeia de caracteres ou XML a ser convertido
Valor retornado Tipo Descrição
< Resultado JSON> Tipo nativo JSON, objeto ou matriz O valor do tipo nativo JSON, o objeto ou a matriz de objetos da cadeia de caracteres de entrada ou XML.



– Se você passar o XML que tem um único elemento filho no elemento raiz, a função retornará um único objeto JSON para esse elemento filho.

– Se você passar o XML que tem vários elementos filho no elemento raiz, a função retornará uma matriz que contém objetos JSON para esses elementos filho.

– Se a cadeia de caracteres for nula, 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 retorna este resultado: [1, 2, 3]

Exemplo 2

Este exemplo converte essa cadeia de caracteres em JSON:

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

E retorna este resultado:

{
  "fullName": "Sophia Owen"
}

Exemplo 3

Este exemplo usa as funções json() e xml() para converter XML que tem um único elemento filho no elemento raiz em um objeto JSON chamado 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 retorna este resultado:

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

Exemplo 4

Este exemplo usa as funções json() 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 retorna este resultado:

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

interseção

Retornar uma coleção que tem somente os itens comuns entre as coleções especificadas. Para aparecer no resultado, um item deve ser exibido em todas as coleções passadas para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com o nome será exibido neste resultado.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parâmetro Obrigatório Tipo Descrição
< colleção1>, <colleção2>, ... Sim Matriz ou objeto, mas não ambos As coleções da qual você deseja somente os itens comuns
Valor retornado Tipo Descrição
< itens comuns> Array ou Object, respectivamente Uma coleção que tem somente os itens comuns entre as coleções especificadas

Exemplo

Esse exemplo localiza os itens comuns entre estas 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]

participar

Retornar 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 Obrigatório Tipo Descrição
< coleção> Sim Matriz A matriz que tem os itens a serem ingressados
< delimitador> Sim fio O separador exibido entre cada caractere na cadeia de caracteres resultante
Valor retornado Tipo Descrição
< caractere1><delimitador><caractere2><delimitador>... fio A cadeia de caracteres resultante criada com base em todos os itens na matriz especificada.



Observação: o tamanho do resultado não deve exceder 104.857.600 caracteres.

Exemplo

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

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

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

L

último

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

last('<collection>')
last([<collection>])
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String ou Array A coleção na qual localizar o último item
Valor retornado Tipo Descrição
< último item de coleção> String ou Array, respectivamente O último item na coleção

Exemplo

Esses exemplos localizam o último item nestas coleções:

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

E retorna estes resultados:

  • Primeiro exemplo: "d"
  • Segundo exemplo: 3

lastIndexOf

Retorna a posição inicial ou valor de índice para a última ocorrência de uma subcadeia de caracteres. 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 Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que tem a subcadeia de caracteres a ser localizada
< textoDepesquisa> Sim fio A subcadeia de caracteres a ser localizada
Valor retornado Tipo Descrição
< valor do índice final> Número Inteiro A posição inicial ou valor de índice da última ocorrência da subcadeia de caracteres especificada.

Se o valor da cadeia de caracteres ou de 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 da cadeia de caracteres e de substring estiverem vazios, a função retornará 0.

  • Se apenas o valor de substring estiver vazio, a função retornará o comprimento da cadeia de caracteres menos 1.

Exemplos

Este exemplo encontra o valor de índice inicial para a última ocorrência de substring world substring na cadeia de caracteres hello world hello world. O resultado retornado é 18:

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

Este exemplo não tem o parâmetro de substring e retorna um valor de 22 porque o valor da cadeia de caracteres de entrada (23) menos 1 é maior que 0.

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

comprimento

Retornar o número de itens em uma coleção.

length('<collection>')
length([<collection>])
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String ou Array A coleção com os itens a serem contados
Valor retornado Tipo Descrição
< comprimento ou contagem> Número Inteiro O número de itens na coleção

Exemplo

Esses exemplos contam o número de itens nestas coleções:

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

E retornam este resultado: 4

menos

Verificar se o primeiro valor é menor que o segundo valor. Retornará true quando o primeiro valor for menor ou retornará false quando o primeiro valor for maior.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Integer, Float ou String O primeiro valor para verificar se é menor do que o segundo
< comparar> Sim Integer, Float ou String, respectivamente O item de comparação
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando o primeiro valor for menor que o segundo. Retornará false quando o primeiro valor for igual ou maior que o segundo.

Exemplo

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

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

E retornam estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

lessOrEquals

Verificar se o primeiro valor é inferior ou igual ao segundo valor. Retornará true quando o primeiro valor for inferior ou igual ou retornará false quando o primeiro valor for superior.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Integer, Float ou String O primeiro valor para verificar se é inferior ou igual ao segundo
< comparar> Sim Integer, Float ou String, respectivamente O item de comparação
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando o primeiro valor for inferior ou igual ao segundo valor. Retornará false quando o primeiro valor for maior que o segundo.

Exemplo

Esses exemplos verificam se o primeiro valor é inferior ou igual ao segundo.

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

E retornam estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

listCallbackUrl

Retornar a "URL de retorno de chamada" que chama um gatilho ou uma ação. Essa função funciona somente 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 retornado Tipo Descrição
< URL de retorno de chamada> fio A URL de retorno de chamada para um gatilho ou uma ação

Exemplo

Esse exemplo mostra um exemplo de URL de retorno de chamada que esta função pode retornar:

"https://prod-01.westus.logic.azure.com:443/workflows/<*workflow-ID*>/triggers/manual/run?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*signature-ID*>"

M

máximo

Retornar o maior valor de uma lista ou matriz com números inclusivos em ambas as extremidades.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parâmetro Obrigatório Tipo Descrição
< número1>, <número2>, ... Sim Integer, Float ou ambos O conjunto de números do qual você deseja o valor mais alto
[<número1>, <número2>, ...] Sim Array – Integer, Float ou ambos A matriz de números da qual você deseja o valor mais alto
Valor retornado Tipo Descrição
< valor máximo> Integer ou Float O valor mais alto na matriz ou conjunto de números especificado

Exemplo

Esses 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 retornam este resultado: 3

Min

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parâmetro Obrigatório Tipo Descrição
< número1>, <número2>, ... Sim Integer, Float ou ambos O conjunto de números do qual você deseja o valor mais baixo
[<número1>, <número2>, ...] Sim Array – Integer, Float ou ambos A matriz de números da qual você deseja o valor mais baixo
Valor retornado Tipo Descrição
< valor mínimo> Integer ou Float O valor mais baixo no conjunto de números ou matriz especificado

Exemplo

Esses exemplos obtêm o valor mais baixo no conjunto de números e na matriz:

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

E retornam este resultado: 1

Mod

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

mod(<dividend>, <divisor>)
Parâmetro Obrigatório Tipo Descrição
< dividendo> Sim Integer ou Float O número a ser dividido pelo divisor
< divisor> Sim Integer ou Float O número que divide o dividendo, mas não pode ser zero
Valor retornado Tipo Descrição
< módulo-resultado> Integer ou Float O resto da divisão do primeiro número pelo segundo

Exemplo 1

O exemplo divide o primeiro número pelo segundo:

mod(3, 2)

E retorna este resultado: 1

Exemplo 2

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

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

O exemplo retorna estes resultados:

  • Primeiro exemplo: -1
  • Segundo exemplo: 1

mul

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

mul(<multiplicand1>, <multiplicand2>)
Parâmetro Obrigatório Tipo Descrição
< multiplicando1> Sim Integer ou Float O número a ser multiplicado por multiplicand2
< multiplicando2> Sim Integer ou Float O número que multiplica multiplicand1
Valor retornado Tipo Descrição
< produto-resultado> Integer ou Float O produto da multiplicação do primeiro número pelo segundo

Exemplo

Esses exemplos multiplicam o primeiro número pelo segundo:

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

E retornam estes resultados:

  • Primeiro exemplo: 2
  • Segundo exemplo 3

corpo multipartos

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

multipartBody('<actionName>', <index>)
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio O nome da ação que tem saída com várias partes
< índice> Sim Número Inteiro O valor de índice da parte desejada
Valor retornado Tipo Descrição
< corpo> fio O corpo da parte especificada

N

não

Verificar se uma expressão é falsa. Retornará true quando a expressão for falsa ou retornará false quando for verdadeira.

not(<expression>)
Parâmetro Obrigatório Tipo Descrição
< expressão> Sim Booliano A expressão a ser verificada
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando a expressão for falsa. Retornará false quando a expressão for verdadeira.

Exemplo 1

Esses exemplos verificam se as expressões especificadas são false:

not(false)
not(true)

E retornam estes resultados:

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

Exemplo 2

Esses exemplos verificam se as expressões especificadas são false:

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

E retornam estes resultados:

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

nthIndexOf

Retorna a posição inicial ou o valor de índice em que a n-ésima ocorrência de uma subcadeia de caracteres aparece em uma cadeia de caracteres.

nthIndexOf('<text>', '<searchText>', <occurrence>)
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que contém a subcadeia de caracteres a ser localizada
< textoDepesquisa> Sim fio A subcadeia de caracteres a ser localizada
< ocorrência> Sim Número Inteiro Um número que especifica a n-ésima ocorrência da substring a ser encontrada. Se a ocorrência for negativa, inicie a pesquisa a partir do final.
Valor retornado Tipo Descrição
< valor do índice> Número Inteiro A posição inicial ou valor de índice da n-ésima ocorrência da subcadeia de caracteres especificada. Se a subcadeia de caracteres não for encontrada ou menos de n ocorrências da subcadeia de caracteres existirem, retornará -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

Verificar se pelo menos uma expressão é verdadeira. Retornará true quando pelo menos uma expressão for verdadeira ou false quando todas forem falsas.

or(<expression1>, <expression2>, ...)
Parâmetro Obrigatório Tipo Descrição
< expressão1>, <expressão2>, ... Sim Booliano As expressões a serem verificadas
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando pelo menos uma expressão for verdadeira. Retornará false quando todas as expressões forem falsas.

Exemplo 1

Esses exemplos verificam se pelo menos uma expressão é true:

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

E retornam estes resultados:

  • Primeiro exemplo: No mínimo, uma expressão é true, então a função retorna true.
  • Segundo exemplo: Ambas as expressões são false, então a função retorna false.

Exemplo 2

Esses exemplos verificam se pelo menos uma expressão é true:

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

E retornam estes resultados:

  • Primeiro exemplo: No mínimo, uma expressão é true, então a função retorna true.
  • Segundo exemplo: Ambas as expressões são false, então a função retorna false.

saídas

Retorna as saídas de uma ação em runtime.

outputs('<actionName>')
Parâmetro Obrigatório Tipo Descrição
< actionName> Sim fio O nome da saída da ação desejada
Valor retornado Tipo Descrição
< saída> fio A saída da ação especificada

Exemplo

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

outputs('Get_user')

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

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

parameters('<parameterName>')
Parâmetro Obrigatório Tipo Descrição
< nome_parâmetro> Sim fio O nome do parâmetro cujo valor você deseja
Valor retornado Tipo Descrição
< valor do parâmetro> Qualquer O valor do parâmetro especificado

Exemplo

Suponha que você tenha este valor JSON:

{
  "fullName": "Sophia Owen"
}

Esse exemplo obtém o valor do parâmetro especificado:

parameters('fullName')

E retorna este resultado: "Sophia Owen"

parseDataHora

Retorna o carimbo de data/hora de uma cadeia de caracteres que contenha um carimbo de hora.

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< localidade> Não fio A localidade a ser usada.

Se não for especificada, a localidade padrão será en-us.

Se a localidade não for um valor válido, um erro será gerado.
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva 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 retornado Tipo Descrição
< carimbo de data/hora analisado> fio O carimbo de data/hora analisado no formato "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva 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('20190521', 'fr-fr', 'yyyyMMdd') // Returns '2019-05-21T00:00:00.0000000'.
parseDateTime('10/20/2014 15h', 'en-US', 'MM/dd/yyyy HH\h') // Returns '2014-10-20T15:00:00.0000000'.

R

rand

Retornar um inteiro aleatório de um intervalo especificado, inclusivo apenas na extremidade inicial.

rand(<minValue>, <maxValue>)
Parâmetro Obrigatório Tipo Descrição
< minValue> Sim Número Inteiro O menor inteiro no intervalo
< maxValue> Sim Número Inteiro O inteiro que segue o inteiro mais alto no intervalo que a função pode retornar
Valor retornado Tipo Descrição
< resultado aleatório> Número Inteiro O inteiro aleatório retornado do intervalo especificado

Exemplo

Esse 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 o resultado: 1, 2, 3 ou 4

gama

Retornar uma matriz de inteiros que começa em um inteiro especificado.

range(<startIndex>, <count>)
Parâmetro Obrigatório Tipo Descrição
< Índice inicial> Sim Número Inteiro Um número inteiro que inicia a matriz como o primeiro item
< contagem> Sim Número Inteiro O número de inteiros na matriz. O valor de parâmetro count deve ser um inteiro positivo que não exceda 100.000.



Observação: a soma dos valores startIndex e count não deve exceder 2.147.483.647.
Valor retornado Tipo Descrição
[<intervalo-de-resultados>] Matriz A matriz com inteiros que começa no índice especificado

Exemplo

Esse exemplo cria uma matriz de inteiros que começa no índice especificado e tem o número de inteiros especificado:

range(1, 4)

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

remover propriedade

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

removeProperty(<object>, '<property>')
Parâmetro Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON do qual você deseja remover uma propriedade
< propriedade> Sim fio O nome da propriedade a ser removida
Valor retornado Tipo Descrição
< objeto atualizado> Objeto 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 Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON cuja propriedade você deseja remover
< propriedade pai> Sim fio O nome da propriedade pai com a propriedade filho que você deseja remover
< propriedade infantil> Sim fio O nome da propriedade filho a ser removida
Valor retornado Tipo Descrição
< objeto atualizado> Objeto O objeto JSON atualizado cuja propriedade filho você removeu

Exemplo 1

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

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

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

Exemplo 2

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

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

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

substituir

Substituir uma subcadeia de caracteres pela cadeia de caracteres especificada e retornar a cadeia de caracteres resultante. Essa função diferencia maiúsculas de minúsculas.

replace('<text>', '<oldText>', '<newText>')
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que tem a subcadeia de caracteres a ser substituída
< texto antigo> Sim fio A subcadeia de caracteres a ser substituída
< novoTexto> Sim fio A cadeia de caracteres de substituição
Valor retornado Tipo Descrição
< texto atualizado> fio A cadeia de caracteres atualizada após substituir a subcadeia de caracteres

Se a subcadeia de caracteres não for localizada, retorne a cadeia de caracteres original.

Exemplo

Esse exemplo localiza a subcadeia de caracteres "antiga" em "a antiga cadeia de caracteres" e substitui "antiga" por "nova":

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

E retorna este resultado: "the new string"

resultado

Retorna os resultados das ações primárias na ação com escopo especificada, como uma ação For_each, Until ou Scope. A função result() 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 pela função actions(), como hora de início, hora de término, status, entradas, IDs de correlação e saídas da ação.

Observação

Essa função retorna informações apenas 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 poder diagnosticar e tratar exceções. Para obter mais informações, confira Obter o contexto e os resultados de falhas.

result('<scopedActionName>')
Parâmetro Obrigatório Tipo Descrição
< scopedActionName> Sim fio O nome da ação com escopo em cujo escopo você deseja que estejam as entradas e saídas das ações primárias
Valor retornado Tipo Descrição
< objeto de matriz> Objeto Array Uma matriz que contém matrizes de entradas e saídas de cada ação primária dentro do escopo especificado

Exemplo

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

{
   "actions": {
      "Compose": {
         "inputs": "@result('For_each')",
         "runAfter": {
            "For_each": [
               "Succeeded"
            ]
         },
         "type": "compose"
      },
      "For_each": {
         "actions": {
            "HTTP": {
               "inputs": {
                  "method": "GET",
                  "uri": "https://httpstat.us/200"
               },
               "runAfter": {},
               "type": "Http"
            }
         },
         "foreach": "@triggerBody()",
         "runAfter": {},
         "type": "Foreach"
      }
   }
}

Veja a seguir a possível aparência do exemplo de matriz retornado, em que o objeto outputs externo contém as entradas e as saídas de cada iteração das ações dentro da ação For_each.

[
   {
      "name": "HTTP",
      "outputs": [
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
               "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "6bad3015-0444-4ccd-a971-cbb0c99a7.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         },
         {
            "name": "HTTP",
            "inputs": {
               "uri": "https://httpstat.us/200",
               "method": "GET"
            },
            "outputs": {
            "statusCode": 200,
               "headers": {
                   "X-AspNetMvc-Version": "5.1",
                   "Access-Control-Allow-Origin": "*",
                   "Cache-Control": "private",
                   "Date": "Tue, 20 Aug 2019 22:15:37 GMT",
                   "Set-Cookie": "ARRAffinity=0285cfbea9f2ee7",
                   "Server": "Microsoft-IIS/10.0",
                   "X-AspNet-Version": "4.0.30319",
                   "X-Powered-By": "ASP.NET",
                   "Content-Length": "0"
               },
               "startTime": "2019-08-20T22:15:37.6919631Z",
               "endTime": "2019-08-20T22:15:37.95762Z",
               "trackingId": "9987e889-981b-41c5-aa27-f3e0e59bf69.....",
               "clientTrackingId": "085863526764.....",
               "code": "OK",
               "status": "Succeeded"
            }
         }
      ]
   }
]

inverter

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 Obrigatório Tipo Descrição
< coleção> Sim Matriz A coleção a ser invertida
Valor retornado Tipo Descrição
[<coleção-atualizada>] Matriz A coleção invertida

Exemplo

Este exemplo inverte uma matriz de inteiros:

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

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

S

Propriedade do conjunto

Define o valor da propriedade do objeto JSON e retorna o objeto atualizado. Se a propriedade que você tentar 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 Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON cuja propriedade você deseja definir
< propriedade> Sim fio O nome da propriedade nova ou existente 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 setProperty() aninhada. Caso contrário, a função retornará apenas o objeto filho como a saída.

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parâmetro Obrigatório Tipo Descrição
< objeto> Sim Objeto O objeto JSON cuja propriedade você deseja definir
< propriedade pai> Sim fio O nome da propriedade pai com a propriedade filho que você deseja definir
< propriedade infantil> Sim fio O nome da propriedade filho a ser definida
< valor> Sim Qualquer O valor a ser definido para a propriedade especificada
Valor retornado Tipo Descrição
< objeto atualizado> Objeto O objeto JSON atualizado cuja propriedade você define

Exemplo 1

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

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

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

Exemplo 2

Este exemplo define a propriedade filho surName para a propriedade pai customerName em um objeto JSON, que é convertido de uma cadeia de caracteres em JSON por meio da 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'))

Este é o objeto JSON atual:

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

Este é o objeto JSON atualizado:

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

pular

Remover itens do início de uma coleção e retornar todos os outros itens.

skip([<collection>], <count>)
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim Matriz A coleção cujos itens você deseja remover
< contagem> Sim Número Inteiro Um inteiro positivo para o número de itens a ser removido no início
Valor retornado Tipo Descrição
[<coleção-atualizada>] Matriz A coleção atualizada depois de remover os itens especificados

Exemplo

Esse exemplo remove um item, o número 0, do início da matriz especificada:

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

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

fatia

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

slice('<text>', <startIndex>, <endIndex>?)
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que contém a subcadeia de caracteres a ser localizada
< Índice inicial> Sim Número Inteiro A posição inicial baseada em zero ou o valor por onde começar a pesquisar a subcadeia de caracteres

– Se startIndex for maior que o comprimento da cadeia de caracteres, retornará uma cadeia de caracteres vazia.

– Se startIndex for negativo, comece a pesquisar no valor do índice que é a soma do comprimento da cadeia de caracteres com o startIndex.
< Índice final> Não Número Inteiro A posição final baseada em zero ou o valor por onde terminar a pesquisar a subcadeia de caracteres. O caractere localizado no valor do índice final não está incluído na pesquisa.

– Se endIndex não for especificado ou for maior que o comprimento da cadeia de caracteres, pesquise até o final da cadeia de caracteres.

– Se endIndex for negativo, termine a pesquisa no valor de índice que corresponde à soma do comprimento da cadeia de caracteres com o endIndex.
Valor retornado Tipo Descrição
< fatia-resultado> fio Uma nova cadeia de caracteres que contém a subcadeia de caracteres 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 ''.

ordenar

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

sort([<collection>], <sortBy>?)
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim Matriz A coleção com os itens a serem classificados
< sortBy> Não fio A chave a ser usada para classificar os objetos de coleção
Valor retornado Tipo Descrição
[<coleção-atualizada>] Matriz A coleção classificada

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" }')]

divisão

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 Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres para separar em subcadeias de caracteres com base no delimitador especificado na cadeia de caracteres original
< delimitador> Sim fio O caractere na cadeia de caracteres original para usar como delimitador
Valor retornado Tipo Descrição
[<subcadeia-de-caracteres1>,<subcadeia-de-caracteres2>,...] Matriz Uma matriz contendo subcadeias de caracteres da cadeia de caracteres original, separadas por vírgulas

Exemplo 1

Este exemplo cria uma matriz com subcadeias de caractere da cadeia de caracteres especificada com base no caractere especificado como o 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 um delimitador na cadeia de caracteres:

split('a_b_c', ' ')

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

início do dia

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

startOfDay('<timestamp>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora especificado, mas começando na marca de zero hora para o dia

Exemplo

Esse exemplo localiza o início do dia para esse carimbo de data/hora:

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

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

início de hora

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

startOfHour('<timestamp>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora especificado, mas começando na marca de zero minuto para a hora

Exemplo

Esse exemplo localiza o início da hora para esse carimbo de data/hora:

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

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

inícioDeMês

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

startOfMonth('<timestamp>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora especificado, mas começando no primeiro dia do mês na marca de zero hora

Exemplo 1

Esse exemplo retorna o início do mês para este carimbo de data/hora:

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

E retorna 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 retorna este resultado: "2018-03-01"

começaCom

Verificar se uma cadeia de caracteres começa com uma subcadeia de caracteres específica. Retornará true quando a subcadeia de caracteres for localizada ou retornará false quando não for localizada. Essa função não diferencia maiúsculas de minúsculas.

startsWith('<text>', '<searchText>')
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres a ser verificada
< textoDepesquisa> Sim fio A cadeia de caracteres inicial a ser localizada
Valor retornado Tipo Descrição
true ou false Booliano Retornará true quando a subcadeia de caracteres inicial for localizada. Retorna false quando não localizada.

Exemplo 1

Esse exemplo verifica se a cadeia de caracteres "olá, mundo" começa com a subcadeia de caracteres "olá":

startsWith('hello world', 'hello')

E retorna este resultado: true

Exemplo 2

Esse exemplo verifica se a cadeia de caracteres "olá, mundo" começa com a subcadeia de caracteres "saudações":

startsWith('hello world', 'greetings')

E retorna este resultado: false

corda

Retornar a versão de cadeia de caracteres para um valor.

string(<value>)
Parâmetro Obrigatório Tipo Descrição
< valor> Sim Qualquer O valor a ser convertido. 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 não existente, que pode ser acessada 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 retornado Tipo Descrição
< valor da cadeia de caracteres> fio A versão de cadeia de caracteres do valor especificado. Se o parâmetro de valor for nulo ou for avaliado como nulo, esse valor será retornado como um valor de cadeia de caracteres ("") vazia.

Exemplo 1

Esse exemplo cria uma versão de cadeia para este número:

string(10)

E retorna este resultado: "10"

Exemplo 2

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

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

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

Substituto

Retornar o resultado da subtração do segundo número do primeiro.

sub(<minuend>, <subtrahend>)
Parâmetro Obrigatório Tipo Descrição
< Minuend> Sim Integer ou Float O número do qual subtrair o subtraendo
< Subtrahend> Sim Integer ou Float O número a ser subtraído do minuendo
Valor retornado Tipo Descrição
< resultado> Integer ou Float O resultado da subtração do segundo número do primeiro

Exemplo

Esse exemplo subtrai o segundo número do primeiro:

sub(10.3, .3)

E retorna este resultado: 10

Subsequência

Retornar caracteres de uma cadeia de caracteres, começando na posição especificada, ou índice. Os valores de índice começam com o número 0. Consulte também slice().

substring('<text>', <startIndex>, <length>)
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres cujos caracteres você deseja
< Índice inicial> Sim Número Inteiro Um número positivo igual ou superior a 0 que você deseja usar como a posição inicial ou o valor do índice
< comprimento> Não Número Inteiro Um número positivo de caracteres que você deseja na subcadeia de caracteres

Observação

Certifique-se de que a soma de adicionar os valores de parâmetro startIndex e length seja menor do que o comprimento da cadeia de caracteres que você fornecerá para o parâmetro text. Caso contrário, você receberá um erro, diferentemente de funções semelhantes em outras linguagens em que o resultado é a substring de startIndex para o final da cadeia de caracteres. O parâmetro length é opcional e se não for fornecido, a função substring () usa todos os caracteres desde startIndex até o final da cadeia de caracteres.

Valor retornado Tipo Descrição
< resultado da substring> fio Uma subcadeia de caracteres com o número de caracteres especificado, começando na posição de índice especificada na cadeia de caracteres de origem

Exemplo

Esse exemplo cria uma subcadeia de caracteres de cinco caracteres com base na cadeia de caracteres especificada, começando no valor de índice 6:

substring('hello world', 6, 5)

E retorna este resultado: "world"

subtractFromTime

Subtrair um número de unidades de tempo de um carimbo de data/hora. Confira também getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio Uma cadeia de caracteres que contém o carimbo de data/hora
< intervalo> Sim Número Inteiro O número de unidades de tempo especificadas a serem subtraídas
< unidade de tempo> Sim fio Unidade de tempo a ser usado com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atualizado> fio O carimbo de data/hora menos o número de unidades de tempo especificado

Exemplo 1

Esse exemplo subtrai um dia desse carimbo de data/hora:

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

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

Exemplo 2

Esse exemplo subtrai um dia desse carimbo de data/hora:

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

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

T

tomar

Retornar itens do início de uma coleção.

take('<collection>', <count>)
take([<collection>], <count>)
Parâmetro Obrigatório Tipo Descrição
< coleção> Sim String ou Array A coleção cujos itens você deseja
< contagem> Sim Número Inteiro Um inteiro positivo para o número de itens que você deseja no início
Valor retornado Tipo Descrição
< subconjunto> ou [<subconjunto>] String ou Array, respectivamente Uma cadeia de caracteres ou matriz que tem o número de itens especificado extraído do início da coleção original

Exemplo

Esses exemplos obtêm o número de itens especificado no início destas coleções:

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

E retornam estes resultados:

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

Carrapatos

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

ticks('<timestamp>')
Parâmetro Obrigatório Tipo Descrição
< timestamp> Sim fio A cadeia de caracteres de um carimbo de data/hora
Valor retornado Tipo Descrição
< número de tiques> Número Inteiro O número de tiques desde o carimbo de data/hora especificado

para Mais baixo

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

toLower('<text>')
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres a ser retornada no formato em minúsculas
Valor retornado Tipo Descrição
< texto minúsculo> fio A cadeia de caracteres original no formato em minúsculas

Exemplo

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

toLower('Hello World')

E retorna este resultado: "hello world"

para Superior

Retornar uma cadeia de caracteres em letras maiúsculas. 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 Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres a ser retornada no formato em maiúsculas
Valor retornado Tipo Descrição
< texto maiúsculo> fio A cadeia de caracteres original no formato em maiúsculas

Exemplo

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

toUpper('Hello World')

E retorna este resultado: "HELLO WORLD"

gatilho

Retornar a saída de um gatilho em runtime ou os valores de outros pares de nome e valor JSON, que podem ser atribuídos 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 referencia todo o objeto de gatilho, mas é possível especificar uma propriedade cujo valor você deseja. Além disso, essa função tem versões abreviadas disponíveis, consulte triggerOutputs() e triggerBody().

trigger()
Valor retornado Tipo Descrição
< saída de gatilho> fio A saída de um gatilho em runtime

Corpo do gatilho

Retornar a saída body de um gatilho em runtime. Abreviação de trigger().outputs.body. Consulte trigger().

triggerBody()
Valor retornado Tipo Descrição
< saída do corpo do gatilho> fio A saída body do gatilho

triggerFormDataMultiValues

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

triggerFormDataMultiValues('<key>')
Parâmetro Obrigatório Tipo Descrição
< chave> Sim fio O nome da chave cujo valor você deseja
Valor retornado Tipo Descrição
[<<array-with-key-values>>] Matriz Uma matriz com todos os valores correspondentes à chave especificada

Exemplo

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

triggerFormDataMultiValues('feedUrl')

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

triggerFormDataValue

Retornar 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 para formulário de um gatilho. Se a função localizar mais de uma correspondência, a função gerará um erro.

triggerFormDataValue('<key>')
Parâmetro Obrigatório Tipo Descrição
< chave> Sim fio O nome da chave cujo valor você deseja
Valor retornado Tipo Descrição
< Valor-chave> fio O valor na chave especificada

Exemplo

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

triggerFormDataValue('feedUrl')

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

triggerMultipartBody

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

triggerMultipartBody(<index>)
Parâmetro Obrigatório Tipo Descrição
< índice> Sim Número Inteiro O valor de índice da parte desejada
Valor retornado Tipo Descrição
< corpo> fio O corpo da parte especificada na saída de várias partes de um gatilho

triggerOutputs

Retornar a saída de um gatilho em runtime ou os valores de outros pares de nome e valor JSON. Abreviação de trigger().outputs. Consulte trigger().

triggerOutputs()
Valor retornado Tipo Descrição
< saída de gatilho> fio A saída de um gatilho em runtime

cortar

Remover espaços em branco à esquerda e à direita de uma cadeia de caracteres e retornar a cadeia de caracteres atualizada.

trim('<text>')
Parâmetro Obrigatório Tipo Descrição
< Texto> Sim fio A cadeia de caracteres que tem o espaço em branco à esquerda e à direita a ser removida
Valor retornado Tipo Descrição
< texto atualizado> fio Uma versão atualizada da 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 "Olá, Mundo":

trim(' Hello World  ')

E retorna este resultado: "Hello World"

U

união

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

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parâmetro Obrigatório Tipo Descrição
< colleção1>, <colleção2>, ... Sim Matriz ou objeto, mas não ambos As coleções das quais você deseja todos os itens
Valor retornado Tipo Descrição
< updatedCollection> Array ou Object, respectivamente Uma coleção com todos os itens das coleções especificadas – sem duplicatas

Exemplo

Esse exemplo obtém todos os itens destas coleções:

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

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

uriComponente

Retornar uma versão codificada para URI (Uniform Resource Identifier) para uma cadeia de caracteres substituindo caracteres desprotegidos de URL por caracteres de escape. Use esta função em vez de encodeUriComponent(). Embora as funções funcionem da mesma forma, uriComponent() é preferencial.

uriComponent('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres a ser convertida em um formato codificado para URI
Valor retornado Tipo Descrição
< URI codificado> fio A cadeia de caracteres codificada para URI com caracteres de escape

Exemplo

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

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

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

uriComponentToBinary

Retornar a versão binária de um componente URI (Uniform Resource Identifier).

uriComponentToBinary('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres codificada para URI a ser convertida
Valor retornado Tipo Descrição
< binário para uri codificado> fio A versão binária da cadeia de caracteres codificada para URI. O conteúdo binário é codificado em Base64 e representado por $content.

Exemplo

Esse exemplo cria a versão binária para esta cadeia de caracteres codificada para URI:

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

E retorna este resultado:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retornar a versão de cadeia de caracteres para uma cadeia de caracteres codificada para URI (Uniform Resource Identifier), decodificando com eficácia a cadeia de caracteres codificada para URI.

uriComponentToString('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres codificada para URI a ser decodificada
Valor retornado Tipo Descrição
< uri decodificado> fio A versão decodificada para a cadeia de caracteres codificada para URI

Exemplo

Esse exemplo cria a versão de cadeia de caracteres decodificada para esta cadeia de caracteres codificada para URI:

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

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

uriHost

Retornar o valor host de um URI (Uniform Resource Identifier).

uriHost('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujo valor host você deseja
Valor retornado Tipo Descrição
< valor do host> fio O valor host do URI especificado

Exemplo

Esse exemplo localiza o valor host para este URI:

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

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

Caminho do uri

Retornar o valor path de um URI (Uniform Resource Identifier).

uriPath('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujo valor path você deseja
Valor retornado Tipo Descrição
< valor do caminho> fio O valor path do URI especificado. Se path não tiver um valor, retorne o caractere "/".

Exemplo

Esse exemplo localiza o valor path para este URI:

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

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

uriPathAndQuery

Retornar os valores path e query de um URI (Uniform Resource Identifier).

uriPathAndQuery('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujos valores path e query você deseja
Valor retornado Tipo Descrição
< valor da consulta de caminho> fio Os valores path e query para o URI especificado. Se path não especificar um valor, retorne o caractere "/".

Exemplo

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

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

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

Porta de uri

Retornar o valor port de um URI (Uniform Resource Identifier).

uriPort('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujo valor port você deseja
Valor retornado Tipo Descrição
< valor da porta> Número Inteiro O valor port do URI especificado. Se port não especificar um valor, retorne a porta padrão do protocolo.

Exemplo

Esse exemplo retorna o valor port deste URI:

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

E retorna este resultado: 8080

uriConsulta

Retornar o valor query de um URI (Uniform Resource Identifier).

uriQuery('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujo valor query você deseja
Valor retornado Tipo Descrição
< valor da consulta> fio O valor query do URI especificado

Exemplo

Esse exemplo retorna o valor query deste URI:

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

E retorna este resultado: "?date=today"

uriEsquema

Retornar o valor scheme de um URI (Uniform Resource Identifier).

uriScheme('<uri>')
Parâmetro Obrigatório Tipo Descrição
< URI> Sim fio O URI cujo valor scheme você deseja
Valor retornado Tipo Descrição
< valor do esquema> fio O valor scheme do URI especificado

Exemplo

Esse exemplo retorna o valor scheme deste URI:

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

E retorna este resultado: "http"

utcNow

Retornar o carimbo de data/hora atual.

utcNow('<format>')

Opcionalmente, é possível especificar um formato diferente com o parâmetro <formato>.

Parâmetro Obrigatório Tipo Descrição
< formato> Não fio 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 do carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), compatível com a ISO 8601 e que preserva informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor retornado Tipo Descrição
< carimbo de data/hora atual> fio A data e hora atual

Exemplo 1

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

utcNow()

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

Exemplo 2

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

utcNow('D')

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

V

variáveis

Retornar o valor de uma variável especificada.

variables('<variableName>')
Parâmetro Obrigatório Tipo Descrição
< nome_da_variável> Sim fio O nome da variável cujo valor você deseja
Valor retornado Tipo Descrição
< valor variável> Qualquer O valor da variável especificada

Exemplo

Suponha que o valor atual para uma variável "numItems" seja 20. Esse exemplo obtém o valor inteiro para esta variável:

variables('numItems')

E retorna este resultado: 20

W

fluxo de trabalho

Retornar todos os detalhes sobre o próprio fluxo de trabalho durante o tempo de execução.

workflow().<property>
Parâmetro Obrigatório Tipo Descrição
< propriedade> Não fio 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 valor da propriedade run é um objeto JSON que inclui estas propriedades: name, type e id.



– A propriedade tags é um objeto JSON que inclui marcas associadas ao aplicativo lógico nos Aplicativos Lógicos do Azure ou ao fluxo no Power Automate e os valores para essas marcas. Para obter mais informações sobre marcas nos recursos do Azure, veja Recursos de marca, grupos de recursos e assinaturas para a organização lógica no Azure.



Observação: por padrão, um aplicativo lógico não tem marcas, mas um fluxo do Power Automate tem as marcas flowDisplayName e environmentName.

Exemplo 1

Esse 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 expressão @workflow() que usa a propriedade de saída tags para obter os valores da propriedade flowDisplayName ou environmentName do fluxo.

Por exemplo, você pode enviar notificações de email personalizadas do próprio fluxo que se vinculam ao fluxo. Essas notificações podem incluir um link HTML que contém o nome de exibição do fluxo no título do email 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 de uma cadeia de caracteres que contém um objeto JSON.

xml('<value>')
Parâmetro Obrigatório Tipo Descrição
< valor> Sim fio A cadeia de caracteres com o objeto JSON a ser convertido

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 aspas duplas (").
Valor retornado Tipo Descrição
< versão xml> Objeto O XML codificado para a cadeia de caracteres ou objeto JSON especificado

Exemplo 1

Esse exemplo converte a cadeia de caracteres em XML:

xml('<name>Sophia Owen</name>')

E retorna este XML de resultado:

<name>Sophia Owen</name>

Exemplo 2

Esse exemplo cria a versão XML desta cadeia de caracteres, que contém um objeto JSON:

xml(json('{ "name": "Sophia Owen" }'))

E retorna este XML de resultado:

<name>Sophia Owen</name>

Exemplo 3

Suponha que você tem este objeto JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Esse exemplo cria o XML para uma cadeia de caracteres que contém este objeto JSON:

xml(json('{"person": {"name": "Sophia Owen", "city": "Seattle"}}'))

E retorna este XML de resultado:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

Verificar o XML em busca de nós ou valores correspondentes a uma expressão XPath (Linguagem XPath) e retornar esses nós ou valores. Uma expressão XPath, ou apenas "XPath", ajuda você a navegar por uma estrutura de documento XML para poder selecionar nós ou calcular valores no conteúdo XML.

Observação

Nos aplicativos lógicos de Consumo e Standard, todas as expressões de função usam a biblioteca XPath do .NET. As expressões XPath são compatíveis com a biblioteca .NET subjacente e são compatíveis apenas com a expressão que a biblioteca .NET subjacente é compatível.

xpath('<xml>', '<xpath>')
Parâmetro Obrigatório Tipo Descrição
< XML> Sim Qualquer A cadeia de caracteres XML na qual pesquisar nós ou valores correspondentes a um valor de expressão XPath
< xpath> Sim Qualquer A expressão XPath usada para localizar valores ou nós XML correspondentes
Valor retornado Tipo Descrição
< nó xml> XML Um nó XML quando 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
[<nó-xml1>, <nó-xml2>, ...] -ou- [<valor1>, <valor2>, ...] Matriz Uma matriz com valores ou nós XML correspondentes à expressão XPath especificada

Exemplo 1

Suponha que você tem esta cadeia de caracteres XML 'items':

<?xml version="1.0"?>
<produce>
  <item>
    <name>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Este exemplo passa a expressão XPath, '/produce/item/name/text()', para localizar os nós que correspondem ao nó <name></name> na cadeia de caracteres XML 'items' 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 caracteres XML de 'items' converter a cadeia de caracteres em formato XML usando a função xml().

Aqui está a matriz de resultados preenchida com valores dos nós que correspondem a <name></name>:

[ Gala, Honeycrisp ]

Exemplo 2

Seguindo o exemplo 1, este exemplo passa a expressão XPath, '/produce/item/name[1]', para localizar o primeiro elemento name que é o filho do elemento item.

xpath(xml(parameters('items')), '/produce/item/name[1]')

Eis o resultado: Gala

Exemplo 3

Seguindo o exemplo 1, este exemplo passa a expressão XPath, '/produce/item/name[last()]', para localizar o último elemento name que é o filho do elemento item.

xpath(xml(parameters('items')), '/produce/item/name[last()]')

Eis o resultado: Honeycrisp

Exemplo 4

Neste exemplo, suponha que a cadeia de caracteres XML items também contém 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 elementos name que têm o atributo expired:

xpath(xml(parameters('items')), '//name[@expired]')

Eis o resultado: [ Gala, Honeycrisp ]

Exemplo 5

Neste exemplo, suponha que a cadeia de caracteres XML items contém somente o 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 a expressão XPath, '//name[@expired = 'true']', para localizar todos os elementos name que têm o atributo expired = 'true':

xpath(xml(parameters('items')), '//name[@expired = 'true']')

Eis o resultado: [ Gala ]

Exemplo 6

Neste exemplo, suponha que a cadeia de caracteres XML items também contém 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 a expressão XPath, '//name[@price>35]', para localizar todos os elementos name que têm price > 35:

xpath(xml(parameters('items')), '//name[@price>35]')

Eis o resultado: Honeycrisp

Exemplo 7

Neste exemplo, suponha que a cadeia de caracteres XML items 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 correspondentes ao nó <count></count> e adiciona esses valores de nó com a função sum():

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Eis o resultado: 30

Exemplo 8

Neste exemplo, suponha que você tem esta 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 XPath, /*[name()="file"]/*[name()="location"] ou /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], para localizar nós que correspondam ao nó <location></location>. 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"]')

Veja o nó de resultado correspondente ao nó <location></location>:

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

Importante

Se você estiver trabalhando na exibição de código, faça escape das aspas duplas (") usando o caractere de barra invertida (\). Por exemplo, você precisará usar caracteres de escape ao serializar uma expressão como uma cadeia de caracteres JSON. No entanto, se estiver trabalhando no Designer ou no editor de expressão, não precisará fazer escape das aspas duplas, porque o caractere de barra invertida será adicionado automaticamente à definição subjacente, por exemplo:

  • Exibição de código: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

  • Editor de expressão: xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')

Exemplo 9

Seguindo o Exemplo 8, este exemplo usa a expressão XPath, 'string(/*[name()="file"]/*[name()="location"])', para localizar o valor no nó <location></location>:

xpath(xml(body('Http')), 'string(/*[name()="file"]/*[name()="location"])')

Eis o resultado: Paris

Próximas etapas

Saiba mais sobre a Linguagem de Definição de Fluxo de Trabalho