Partilhar via


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

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

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

Nota

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

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

Task Sintaxe da função Result
Retornar uma cadeia de caracteres em formato minúsculo. toLower('<texto>')

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

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

Funções em expressões

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

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

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

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

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

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

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

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

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

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

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

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

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

  • As expressões de função que aparecem embutidas com texto sem formatação exigem a inclusão de chaves ({}) para usar o formato interpolado da expressão. Este formato ajuda a evitar problemas de análise. Se a expressão da função não aparecer alinhada com texto sem formatação, não serão necessárias chaves.

    O exemplo a seguir mostra a sintaxe correta e incorreta:

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

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

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

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

Funções de cadeia

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

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

Funções de recolha

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

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

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

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

Nota

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

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

Funções de conversão

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

Nota

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

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

Conversões de tipo de dados implícitas

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

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

triggerBody()?['123']

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

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

Codificação e descodificação Base64

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

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

Nota

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

Funções matemáticas

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

Função matemática Task
adicionar Retornar o resultado da adição de dois números.
div Retornar o resultado da divisão de dois números.
máx. Retornar o valor mais alto de um conjunto de números ou de uma matriz.
min Retornar o menor valor de um conjunto de números ou de uma matriz.
Mod Retorne o restante da divisão de dois números.
Mul Devolva o produto multiplicando dois números.
RAND Retornar um inteiro aleatório de um intervalo especificado.
range Retornar uma matriz inteira que começa a partir de um inteiro especificado.
sub Retornar o resultado subtraindo o segundo número do primeiro número.

Funções de data e hora

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

Função de data ou hora Task
addDias Adicione dias a um carimbo de data/hora.
addHours Adicione horas a um carimbo de data/hora.
adicionarMinutos Adicione minutos a um carimbo de data/hora.
addSeconds Adicione segundos a um carimbo de data/hora.
addToTime Adicione unidades de tempo especificadas a um carimbo de data/hora. Consulte também getFutureTime.
convertFromUtc Converta um carimbo de data/hora de Universal Time Coordinated (UTC) para o fuso horário de destino.
convertTimeZone Converta um carimbo de data/hora do fuso horário de origem para o fuso horário de destino.
convertToUtc Converta um carimbo de data/hora do fuso horário de origem em Universal Time Coordinated (UTC).
dateDifference Retorne a diferença entre duas datas como um intervalo de tempo.
diadeMês Retornar o componente dia do mês de um carimbo de data/hora.
diadesemana Retornar o componente dia da semana de um carimbo de data/hora.
diadeano Retornar o componente dia do ano de um carimbo de data/hora.
formatDateTime Retornar a data de um carimbo de data/hora.
getFutureTime Retorne o carimbo de data/hora atual mais as unidades de tempo especificadas. Consulte também addToTime.
getPastTime Retorne o carimbo de data/hora atual menos as unidades de tempo especificadas. Consulte também subtractFromTime.
parseDateTime Retornar o carimbo de data/hora de uma cadeia de caracteres que contém um carimbo de data/hora.
inícioOfDay Retorne o início do dia para um carimbo de data/hora.
iníciodehora Retorne o início da hora para um carimbo de data/hora.
iníciodemês Retorne o início do mês para um carimbo de data/hora.
subtrairFromTime Subtraia várias unidades de tempo de um carimbo de data/hora. Consulte também getPastTime.
carrapatos Retornar o valor da propriedade para um carimbo ticks de data/hora especificado.
utcAgora Retorne o carimbo de data/hora atual como uma cadeia de caracteres.

Funções de fluxo de trabalho

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

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

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

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

Funções de análise de URI

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

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

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

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

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

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

Todas as funções - lista alfabética

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

A

action

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

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

  • A unsubscribe propriedade para uma ação de webhook para que você possa acessar o resultado da solicitação original subscribe
  • A trackedProperties propriedade para uma ação
  • A do-until condição de loop para uma ação
action()
action().outputs.body.<property>
Parâmetro Necessário Type Description
<propriedade> Não String O nome da propriedade do objeto de ação cujo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, você pode encontrar essas propriedades examinando os detalhes de um histórico de execução específico. Para obter mais informações, consulte API REST - Workflow Run Actions.
Valor devolvido Tipo Description
<ação-saída> String A saída da ação ou propriedade atual

ações

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

Gorjeta

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

Nota

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

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
Parâmetro Necessário Type Description
<actionName> Sim String O nome do objeto de ação cuja saída você deseja
<propriedade> Não String O nome da propriedade do objeto de ação cujo valor você deseja: name, startTime, endTime, inputs, outputs, status, code, trackingId e clientTrackingId. No portal do Azure, você pode encontrar essas propriedades examinando os detalhes de um histórico de execução específico. Para obter mais informações, consulte API REST - Workflow Run Actions.
Valor devolvido Tipo Description
<ação-saída> String A saída da ação ou propriedade especificada

Exemplo

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

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

E devolve este resultado: "Succeeded"

adicionar

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

add(<summand_1>, <summand_2>)
Parâmetro Necessário Type Description
<summand_1>, <summand_2> Sim Inteiro, Flutuante ou misto Os números a adicionar
Valor devolvido Tipo Description
<soma-resultado> Inteiro ou flutuador O resultado da adição dos números especificados

Exemplo

Este exemplo adiciona os números especificados:

add(1, 1.5)

E devolve este resultado: 2.5

addDias

Adicione dias a um carimbo de data/hora.

addDays('<timestamp>', <days>, '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<Dias> Sim Número inteiro O número positivo ou negativo de dias a adicionar
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

addHours

Adicione horas a um carimbo de data/hora.

addHours('<timestamp>', <hours>, '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<hours> Sim Número inteiro O número positivo ou negativo de horas a adicionar
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

adicionarMinutos

Adicione minutos a um carimbo de data/hora.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<minutes> Sim Número inteiro O número positivo ou negativo de minutos a adicionar
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

addProperty

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

addProperty(<object>, '<property>', <value>)
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON onde você deseja adicionar uma propriedade
<propriedade> Sim String O nome da propriedade a ser adicionada
<valor> Sim Qualquer O valor da propriedade
Valor devolvido Tipo Description
<atualizado-objeto> Object O objeto JSON atualizado com a propriedade especificada

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

setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>)
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON onde você deseja adicionar uma propriedade
<Propriedade-mãe> Sim String O nome da propriedade pai onde você deseja adicionar a propriedade filho
<Propriedade para crianças> Sim String O nome da propriedade filho a ser adicionada
<valor> Sim Qualquer O valor a ser definido para a propriedade especificada
Valor devolvido Tipo Description
<atualizado-objeto> Object O objeto JSON atualizado cuja propriedade você definiu

Exemplo 1

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

Exemplo 2

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

addSeconds

Adicione segundos a um carimbo de data/hora.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<segundos> Sim Número inteiro O número positivo ou negativo de segundos a adicionar
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

Este exemplo subtrai cinco segundos para o carimbo de data/hora especificado:

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

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

addToTime

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

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<interval> Sim Número inteiro O número de unidades de tempo especificadas a serem adicionadas
<timeUnit> Sim String A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

e

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

and(<expression1>, <expression2>, ...)
Parâmetro Necessário Type Description
<expressão1>, <expressão2>, ... Sim Boolean As expressões a verificar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando todas as expressões forem verdadeiras. Retorne false quando pelo menos uma expressão for false.

Exemplo 1

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

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

E devolve estes resultados:

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

Exemplo 2

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

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

E devolve estes resultados:

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

matriz

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

array('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres para criar uma matriz
Valor devolvido Tipo Description
[<valor>] Matriz Uma matriz que contém a única entrada especificada

Exemplo

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

array('hello')

E devolve este resultado: ["hello"]

N

base64

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

Nota

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

base64('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres de entrada
Valor devolvido Tipo Description
<base64-string> String A versão codificada em base64 para a cadeia de caracteres de entrada

Exemplo

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

base64('hello')

E devolve este resultado: "aGVsbG8="

base64ToBinary

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

Nota

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

base64ToBinary('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres codificada em base64 para converter
Valor devolvido Tipo Description
<binário para base64-string> String A versão binária para a cadeia de caracteres codificada em base64

Exemplo

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

base64ToBinary('aGVsbG8=')

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

base64ToString

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

Nota

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

base64ToString('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres codificada em base64 para decodificar
Valor devolvido Tipo Description
<decodificado-base64-string> String A versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64

Exemplo

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

base64ToString('aGVsbG8=')

E devolve este resultado: "hello"

binário

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

binary('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres a ser convertida
Valor devolvido Tipo Description
<binário para valor de entrada> String A versão binária codificada em base64 para a cadeia de caracteres especificada

Exemplo

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

corpo

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

body('<actionName>')
Parâmetro Necessário Type Description
<actionName> Sim String O nome da saída da body ação que você deseja
Valor devolvido Tipo Description
<ação-corpo-saída> String A body saída da ação especificada

Exemplo

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

body('Get_user')

E devolve este resultado:

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

booleano

Retornar a versão booleana de um valor.

bool(<value>)
Parâmetro Necessário Type Description
<valor> Sim Qualquer O valor a converter para Booleano.

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

Valor devolvido Tipo Description
true ou false Boolean A versão booleana do valor especificado.

Saídas

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

Valor de entrada Type Valor devolvido
bool(1) Número inteiro true
bool(0) Número inteiro false
bool(-1) Número inteiro true
bool('true') String true
bool('false') String false

C

chunk

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

chunk('<collection>', '<length>')
chunk([<collection>], '<length>')
Parâmetro Necessário Type Description
<Coleção> Sim String ou matriz A coleção a dividir
<length> Sim O comprimento de cada pedaço
Valor devolvido Tipo Description
<Coleção> Matriz Uma matriz de blocos com o comprimento especificado

Exemplo 1

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

chunk('abcdefghijklmnopqrstuvwxyz', 10)

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

Exemplo 2

Este exemplo divide uma matriz em partes de comprimento 5.

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

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

coalesce

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

coalesce(<object_1>, <object_2>, ...)
Parâmetro Necessário Type Description
<object_1>, <object_2>, ... Sim Qualquer um pode misturar tipos Um ou mais itens para verificar se há nulo
Valor devolvido Tipo Description
<first-non-null-item> Qualquer O primeiro item ou valor que não é nulo. Se todos os parâmetros forem nulos, essa função retornará null.

Exemplo

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

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

E devolve estes resultados:

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

concat

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

concat('<text1>', '<text2>', ...)
Parâmetro Necessário Type Description
<texto1>, <texto2>, ... Sim String Pelo menos duas cadeias de caracteres para combinar
Valor devolvido Tipo Description
<texto1texto2...> String A cadeia de caracteres criada a partir das cadeias de caracteres de entrada combinadas.



Nota: O comprimento do resultado não deve exceder 104.857.600 caracteres.

Nota

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

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

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

Exemplo

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

concat('Hello', 'World')

E devolve este resultado: "HelloWorld"

contém

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

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

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

  • Uma cadeia de caracteres para localizar uma substring
  • Uma matriz para encontrar um valor
  • Um dicionário para encontrar uma chave
Parâmetro Necessário Type Description
<Coleção> Sim String, matriz ou dicionário A coleção a verificar
<valor> Sim String, Array ou Dictionary, respectivamente O item a ser encontrado
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando o item for encontrado. Retornar false quando não encontrado.

Exemplo 1

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

contains('hello world', 'world')

Exemplo 2

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

contains('hello world', 'universe')

convertFromUtc

Converta um carimbo de data/hora de Universal Time Coordinated (UTC) para o fuso horário de destino.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<destinationTimeZone> Sim String O nome do fuso horário de destino. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows.
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<Carimbo de data/hora convertido> String O carimbo de data/hora convertido para o fuso horário de destino sem o deslocamento UTC de fuso horário.

Exemplo 1

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

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

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

Exemplo 2

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

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

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

convertTimeZone

Converta um carimbo de data/hora do fuso horário de origem para o fuso horário de destino.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<sourceTimeZone> Sim String O nome do fuso horário de origem. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
<destinationTimeZone> Sim String O nome do fuso horário de destino. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<Carimbo de data/hora convertido> String O carimbo de data/hora convertido para o fuso horário de destino

Exemplo 1

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

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

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

Exemplo 2

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

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

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

convertToUtc

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

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<sourceTimeZone> Sim String O nome do fuso horário de origem. Para nomes de fuso horário, consulte Fuso horário padrão do Microsoft Windows, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<Carimbo de data/hora convertido> String O carimbo de data/hora convertido em UTC

Exemplo 1

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

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

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

Exemplo 2

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

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

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

createArray

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

createArray('<object1>', '<object2>', ...)
Parâmetro Necessário Type Description
<object1>, <object2>, ... Sim Qualquer, mas não misturado Pelo menos dois itens para criar a matriz
Valor devolvido Tipo Description
[<object1>, <object2>, ...] Matriz A matriz criada a partir de todos os itens de entrada

Exemplo

Este exemplo cria uma matriz a partir destas entradas:

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

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

D

dataUri

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

dataUri('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres a ser convertida
Valor devolvido Tipo Description
<URI-DADOS> String O URI de dados para a cadeia de caracteres de entrada

Exemplo

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

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')
Parâmetro Necessário Type Description
<valor> Sim String O URI de dados a ser convertido
Valor devolvido Tipo Description
<binário-para-data-uri> String A versão binária para o URI de dados

Exemplo

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

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

E devolve este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

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

dataUriToString('<value>')
Parâmetro Necessário Type Description
<valor> Sim String O URI de dados a ser convertido
Valor devolvido Tipo Description
<string-for-data-uri> String A versão da cadeia de caracteres para o URI de dados

Exemplo

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

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

E devolve este resultado: "hello"

dateDifference

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

dateDifference('<startDate>', '<endDate>')
Parâmetro Necessário Type Description
<startDate> Sim String Uma cadeia de caracteres que contém um carimbo de data/hora
<endDate> Sim String Uma cadeia de caracteres que contém um carimbo de data/hora
Valor devolvido Tipo Description
<Período de tempo> String A diferença entre os dois carimbos de data/hora, que é um carimbo de data/hora em formato de cadeia de caracteres. Se startDate for mais recente que endDate, o resultado é um valor negativo.

Exemplo

Este exemplo subtrai o primeiro valor do segundo valor:

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

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

diadeMês

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

dayOfMonth('<timestamp>')
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
Valor devolvido Tipo Description
<dia-do-mês> Número inteiro O dia do mês a partir do carimbo de data/hora especificado

Exemplo

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

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

E devolve este resultado: 15

diadesemana

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

dayOfWeek('<timestamp>')
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
Valor devolvido Tipo Description
<dia-da-semana> Número inteiro O dia da semana a partir do carimbo de data/hora especificado, onde domingo é 0, segunda-feira é 1 e assim por diante

Exemplo

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

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

E devolve este resultado: 4

diadeano

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

dayOfYear('<timestamp>')
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
Valor devolvido Tipo Description
<dia-do-ano> Número inteiro O dia do ano a partir do carimbo de data/hora especificado

Exemplo

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

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

E devolve este resultado: 74

decimal

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

Nota

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

decimal('<value>')
Parâmetro Necessário Type Description
<valor> Sim String O número decimal em uma cadeia de caracteres
Valor devolvido Tipo Description
<decimal> Número Decimal O número decimal para a cadeia de caracteres de entrada

Exemplo 1

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

decimal('1.2345678912312131') // Returns 1.234567891231213.

Exemplo 2

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

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

Exemplo 3

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

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

Exemplo 4

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

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

decodeBase64 (preterido)

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

decodeDataUri

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

Nota

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

decodeDataUri('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres de URI de dados a ser decodificada
Valor devolvido Tipo Description
<binário-para-data-uri> String A versão binária para uma cadeia de caracteres URI de dados

Exemplo

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

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

E devolve este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

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

decodeUriComponent('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres com os caracteres de escape para decodificar
Valor devolvido Tipo Description
<Decodificado-URI> String A cadeia de caracteres atualizada com os caracteres de escape decodificados

Exemplo

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

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

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

div

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

div(<dividend>, <divisor>)
Parâmetro Necessário Type Description
<dividendos> Sim Inteiro ou flutuador O número a dividir pelo divisor
<divisor> Sim Inteiro ou flutuador O número que divide o dividendo, mas não pode ser zero
Valor devolvido Tipo Description
<quociente-resultado> Inteiro ou flutuador O resultado da divisão do primeiro número pelo segundo número. Se o dividendo ou divisor tiver o tipo Float, o resultado terá o tipo Float.



Observação: para converter o resultado flutuante em um inteiro, tente criar e chamar uma função no Azure a partir do seu aplicativo lógico.

Exemplo 1

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

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

Exemplo 2

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

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

E

encodeUriComponent

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

Nota

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

encodeUriComponent('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres a ser convertida para o formato codificado por URI
Valor devolvido Tipo Description
<encoded-uri> String A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

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

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

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

empty

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

empty('<collection>')
empty([<collection>])
Parâmetro Necessário Type Description
<Coleção> Sim String, matriz ou objeto A coleção a verificar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando a coleção estiver vazia. Retornar false quando não estiver vazio.

Exemplo

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

empty('')
empty('abc')

E devolve estes resultados:

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

termina com

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

endsWith('<text>', '<searchText>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres a ser verificada
<pesquisaTexto> Sim String A substring final para localizar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando a substring final for encontrada. Retornar false quando não encontrado.

Exemplo 1

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

endsWith('hello world', 'world')

E devolve este resultado: true

Exemplo 2

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

endsWith('hello world', 'universe')

E devolve este resultado: false

equals

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

equals('<object1>', '<object2>')
Parâmetro Necessário Type Description
<objeto1>, <objeto2> Sim Vários Os valores, expressões ou objetos a serem comparados
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando ambos forem equivalentes. Retornar false quando não equivalente.

Exemplo

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

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

E devolve estes resultados:

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

F

Primeiro

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

first('<collection>')
first([<collection>])
Parâmetro Necessário Type Description
<Coleção> Sim String ou matriz A coleção onde encontrar o primeiro item
Valor devolvido Tipo Description
<primeiro item de coleção> Qualquer O primeiro item da coleção

Exemplo

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

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

E devolva estes resultados:

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

flutuante

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

float('<value>', '<locale>'?)
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres que tem um número de ponto flutuante válido para converter. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados float.
<região> Não String O código de localidade RFC 4646 a ser usado.

Se não for especificado, a localidade padrão será usada.

Se a localidade não for um valor válido, será gerado um erro informando que a localidade fornecida não é válida ou não tem uma localidade associada.
Valor devolvido Tipo Description
<valor flutuante> Float O número de vírgula flutuante para a cadeia de caracteres especificada. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados float.

Exemplo 1

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

float('10,000.333')

E devolve este resultado: 10000.333

Exemplo 2

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

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

E devolve este resultado: 10000.333

formatDateTime

Retornar um carimbo de data/hora no formato especificado.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.
<região> Não String A localidade a ser usada. Se não for especificado, o valor é en-us. Se a localidade não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<carimbo de data/hora reformatado> String O carimbo de data/hora atualizado no formato e localidade especificados, se especificado.

Exemplos

formatDateTime('03/15/2018') // Returns '2018-03-15T00:00:00.0000000'.
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss') // Returns '2018-03-15T12:00:00'.
formatDateTime('01/31/2016', 'dddd MMMM d') // Returns 'Sunday January 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-FR') // Returns 'dimanche janvier 31'.
formatDateTime('01/31/2016', 'dddd MMMM d', 'es-es') // Returns 'domingo enero 31'.

formDataMultiValues

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

formDataMultiValues('<actionName>', '<key>')
Parâmetro Necessário Type Description
<actionName> Sim String A ação cuja saída tem o valor de chave desejado
<key> Sim String O nome da chave cujo valor você deseja
Valor devolvido Tipo Description
[<matriz-com-valores-chave>] Matriz Uma matriz com todos os valores que correspondem à chave especificada

Exemplo

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

formDataMultiValues('Send_an_email', 'Subject')

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

formDataValue

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

formDataValue('<actionName>', '<key>')
Parâmetro Necessário Type Description
<actionName> Sim String A ação cuja saída tem o valor de chave desejado
<key> Sim String O nome da chave cujo valor você deseja
Valor devolvido Tipo Description
<valor-chave> String O valor na chave especificada

Exemplo

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

formDataValue('Send_an_email', 'Subject')

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

formatNumber

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

formatNumber(<number>, <format>, <locale>?)
Parâmetro Necessário Type Description
<número> Sim Inteiro ou Duplo O valor que você deseja formatar.
<format> Sim String Uma cadeia de caracteres de formato composto que especifica o formato que você deseja usar. Para obter as cadeias de caracteres de formato numérico suportadas, consulte Cadeias de caracteres de formato numérico padrão, que são suportadas pelo number.ToString(<format>, <locale>).
<região> Não String A localidade a ser usada conforme suportado pelo number.ToString(<format>, <locale>). Se não for especificado, o valor é en-us. Se a localidade não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<número formatado> String O número especificado como uma cadeia de caracteres no formato que você especificou. Você pode converter esse valor de retorno para um int ou float.

Exemplo 1

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

formatNumber(1234567890, '0,0.00', 'en-us')

*Exemplo 2"

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

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

Exemplo 3

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

formatNumber(17.35, 'C2')

Exemplo 4

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

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

G

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)
Parâmetro Necessário Type Description
<interval> Sim Número inteiro O número de unidades de tempo a adicionar
<timeUnit> Sim String A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format> Não String Um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, será gerado um erro informando que o formato fornecido não é válido e deve ser uma cadeia de caracteres de formato numérico.
Valor devolvido Tipo Description
<carimbo de data/hora atualizado> String O carimbo de data/hora atual mais o número especificado de unidades de tempo

Exemplo 1

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

getFutureTime(5, 'Day')

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

Exemplo 2

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

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

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

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)
Parâmetro Necessário Type Description
<interval> Sim Número inteiro O número de unidades de tempo especificadas para subtrair
<timeUnit> Sim String A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format> Não String Um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, será gerado um erro informando que o formato fornecido não é válido e deve ser uma cadeia de caracteres de formato numérico.
Valor devolvido Tipo Description
<carimbo de data/hora atualizado> String O carimbo de data/hora atual menos o número especificado de unidades de tempo

Exemplo 1

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

getPastTime(5, 'Day')

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

Exemplo 2

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

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

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

greater

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

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parâmetro Necessário Type Description
<valor> Sim Inteiro, Float ou String O primeiro valor para verificar se é maior que o segundo valor
<compareTo> Sim Inteiro, Float ou String, respectivamente O valor de comparação
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando o primeiro valor for maior que o segundo. Retorne false quando o primeiro valor for igual ou menor que o segundo valor.

Exemplo

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

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

E devolva estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

greaterOrEquals

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

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parâmetro Necessário Type Description
<valor> Sim Inteiro, Float ou String O primeiro valor para verificar se maior ou igual ao segundo valor
<compareTo> Sim Inteiro, Float ou String, respectivamente O valor de comparação
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorna true quando o primeiro valor é maior ou igual ao segundo valor. Retorna false quando o primeiro valor é menor que o segundo valor.

Exemplo

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

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

E devolva estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

guid

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

guid()

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

guid('<format>')
Parâmetro Necessário Type Description
<format> Não String Um único especificador de formato para o GUID retornado. Por padrão, o formato é "D", mas você pode usar "N", "D", "B", "P" ou "X".
Valor devolvido Tipo Description
<Valor GUID> String Um GUID gerado aleatoriamente

Exemplo

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

guid('P')

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

I

if

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

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parâmetro Necessário Type Description
<expressão> Sim Boolean A expressão a verificar
<valorSeVerdadeiro> Sim Qualquer O valor a ser retornado quando a expressão for true
<valorSeFalso> Sim Qualquer O valor a ser retornado quando a expressão for false
Valor devolvido Tipo Description
<valor de retorno especificado> Qualquer O valor especificado que retorna com base em se a expressão é true ou false

Exemplo

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

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

indexOf

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

indexOf('<text>', '<searchText>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que tem a substring para localizar
<pesquisaTexto> Sim String A substring a ser localizada
Valor devolvido Tipo Description
<valor-índice> Número inteiro A posição inicial ou o valor do índice para a subcadeia de caracteres especificada.

Se a cadeia de caracteres não for encontrada, retorne o número -1.

Exemplo

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

indexOf('hello world', 'world')

E devolve este resultado: 6

número inteiro

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

int('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A versão da cadeia de caracteres para o inteiro a ser convertido. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados inteiro.
Valor devolvido Tipo Description
<resultado inteiro> Número inteiro A versão inteira para a cadeia de caracteres especificada. Os valores mínimo e máximo são os mesmos que os limites para o tipo de dados inteiro.

Exemplo

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

int('10')

E devolve este resultado: 10

isFloat

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

isFloat('<string>', '<locale>'?)
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres a ser examinada
<região> Não String O código de localidade RFC 4646 a ser usado
Valor devolvido Tipo Description
<resultado booleano> Boolean Um booleano que indica se a cadeia de caracteres é um número de vírgula flutuante

Exemplo 1

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

isFloat('10,000.00')

E devolve este resultado: true

Exemplo 2

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

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

E devolve este resultado: true

isInt

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

isInt('<string>')
Parâmetro Necessário Type Description
<string> Sim String A cadeia de caracteres a ser examinada
Valor devolvido Tipo Description
<resultado booleano> Boolean Um booleano que indica se a cadeia de caracteres é um inteiro

Exemplo

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

isInt('10')

E devolve este resultado: true

item

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

item()
Valor devolvido Tipo Description
<current-array-item> Qualquer O item atual na matriz para a iteração atual da ação

Exemplo

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

item().body

itens

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

items('<loopName>')
Parâmetro Necessário Type Description
<Nome do loop> Sim String O nome do loop for-each
Valor devolvido Tipo Descrição
<item> Qualquer O item do ciclo atual no loop especificado para cada

Exemplo

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

items('myForEachLoopName')

iterationIndexes

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

iterationIndexes('<loopName>')
Parâmetro Necessário Type Description
<Nome do loop> Sim String O nome do loop Until
Valor devolvido Tipo Description
<índice> Número inteiro O valor de índice para a iteração atual dentro do loop Until especificado

Exemplo

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

iterationIndexes('Until_Max_Increment')

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

J

json

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

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

Importante

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

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

Parâmetro Necessário Type Description
<valor> Sim String ou XML A cadeia de caracteres ou XML a ser convertido
Valor devolvido Tipo Description
<Resultado JSON> Tipo, objeto ou matriz nativo JSON O valor do tipo nativo JSON, objeto ou matriz de objetos da cadeia de caracteres de entrada ou XML.



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

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

- Se a string for null, a função retornará um objeto vazio.

Exemplo 1

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

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

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

Exemplo 2

Este exemplo converte essa cadeia de caracteres em JSON:

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

E devolve este resultado:

{
  "fullName": "Sophia Owen"
}

Exemplo 3

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

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

E devolve este resultado:

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

Exemplo 4

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

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

E devolve este resultado:

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

intersecção

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

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parâmetro Necessário Type Description
<coleção1>, <coleção2>, ... Sim Array ou Object, mas não ambos As coleções de onde você deseja apenas os itens comuns
Valor devolvido Tipo Description
<itens comuns> Array ou Object, respectivamente Uma coleção que tem apenas os itens comuns nas coleções especificadas

Exemplo

Este exemplo localiza os itens comuns nessas matrizes:

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

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

join

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

join([<collection>], '<delimiter>')
Parâmetro Necessário Type Description
<Coleção> Sim Matriz A matriz que tem os itens para unir
<delimitador> Sim String O separador que aparece entre cada caractere na cadeia de caracteres resultante
Valor devolvido Tipo Description
<delimitador char1><delimitador><> char2...>< String A cadeia de caracteres resultante criada a partir de todos os itens na matriz especificada.



Nota: O comprimento do resultado não deve exceder 104.857.600 caracteres.

Exemplo

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

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

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

L

Último

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

last('<collection>')
last([<collection>])
Parâmetro Necessário Type Description
<Coleção> Sim String ou matriz A coleção onde encontrar o último item
Valor devolvido Tipo Description
<último item-coleção> String ou Array, respectivamente O último item da coleção

Exemplo

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

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

E devolve estes resultados:

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

lastIndexOf

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

lastIndexOf('<text>', '<searchText>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que tem a substring para localizar
<pesquisaTexto> Sim String A substring a ser localizada
Valor devolvido Tipo Description
<valor-índice-final> Número inteiro A posição inicial ou o valor do índice para a última ocorrência da substring especificada.

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

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

  • Se os valores de string e substring estiverem vazios, a função retornará 0.

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

Exemplos

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

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

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

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

length

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

length('<collection>')
length([<collection>])
Parâmetro Necessário Type Description
<Coleção> Sim String ou matriz A coleção com os itens a contar
Valor devolvido Tipo Description
<comprimento-ou-contagem> Número inteiro O número de itens na coleção

Exemplo

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

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

E devolva este resultado: 4

less

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

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parâmetro Necessário Type Description
<valor> Sim Inteiro, Float ou String O primeiro valor para verificar se é menor que o segundo valor
<compareTo> Sim Inteiro, Float ou String, respectivamente O item de comparação
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando o primeiro valor for menor que o segundo. Retornar false quando o primeiro valor for igual ou maior que o segundo valor.

Exemplo

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

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

E devolva estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

lessOrEquals

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

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parâmetro Necessário Type Description
<valor> Sim Inteiro, Float ou String O primeiro valor para verificar se menor ou igual ao segundo valor
<compareTo> Sim Inteiro, Float ou String, respectivamente O item de comparação
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retornar true quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo.

Exemplo

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

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

E devolva estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

listCallbackUrl

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

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

Exemplo

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

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

Seg

max

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

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parâmetro Necessário Type Description
<número1>, <número2>, ... Sim Inteiro, Float ou ambos O conjunto de números do qual você deseja o valor mais alto
[<número1>, <número2>, ...] Sim Array - Inteiro, Float ou ambos A matriz de números a partir da qual você deseja o valor mais alto
Valor devolvido Tipo Description
<valor-máx> Inteiro ou flutuador O valor mais alto na matriz ou conjunto de números especificado

Exemplo

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

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

E devolva este resultado: 3

min

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

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parâmetro Necessário Type Description
<número1>, <número2>, ... Sim Inteiro, Float ou ambos O conjunto de números do qual você deseja o menor valor
[<número1>, <número2>, ...] Sim Array - Inteiro, Float ou ambos A matriz de números a partir da qual você deseja o menor valor
Valor devolvido Tipo Description
<valor-mínimo> Inteiro ou flutuador O valor mais baixo no conjunto especificado de números ou matriz especificada

Exemplo

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

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

E devolva este resultado: 1

mod

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

mod(<dividend>, <divisor>)
Parâmetro Necessário Type Description
<dividendos> Sim Inteiro ou flutuador O número a dividir pelo divisor
<divisor> Sim Inteiro ou flutuador O número que divide o dividendo, mas não pode ser zero
Valor devolvido Tipo Description
<modulo-resultado> Inteiro ou flutuador O restante da divisão do primeiro número pelo segundo número

Exemplo 1

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

mod(3, 2)

E devolve este resultado: 1

Exemplo 2

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

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

O exemplo retorna estes resultados:

  • Primeiro exemplo: -1
  • Segundo exemplo: 1

Mul

Devolva o produto multiplicando dois números.

mul(<multiplicand1>, <multiplicand2>)
Parâmetro Necessário Type Description
<multiplicando1> Sim Inteiro ou flutuador O número a multiplicar por multiplicand2
<multiplicando2> Sim Inteiro ou flutuador O número que multiplica multiplicand1
Valor devolvido Tipo Description
<produto-resultado> Inteiro ou flutuador O produto da multiplicação do primeiro número pelo segundo número

Exemplo

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

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

E devolva estes resultados:

  • Primeiro exemplo: 2
  • Segundo exemplo 3

multipartBody

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

multipartBody('<actionName>', <index>)
Parâmetro Necessário Type Description
<actionName> Sim String O nome da ação que tem saída com várias partes
<índice> Sim Número inteiro O valor de índice para a parte que você deseja
Valor devolvido Tipo Description
<corpo> String O corpo da parte especificada

N

not

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

not(<expression>)
Parâmetro Necessário Type Description
<expressão> Sim Boolean A expressão a verificar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando a expressão for false. Retorne false quando a expressão for true.

Exemplo 1

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

not(false)
not(true)

E devolva estes resultados:

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

Exemplo 2

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

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

E devolva estes resultados:

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

nthIndexOf

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

nthIndexOf('<text>', '<searchText>', <occurrence>)
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que contém a substring para localizar
<pesquisaTexto> Sim String A substring a ser localizada
<ocorrência> Sim Número inteiro Um número que especifica a nésima ocorrência da substring a ser localizada. Se a ocorrência for negativa, comece a pesquisar a partir do final.
Valor devolvido Tipo Description
<valor-índice> Número inteiro A posição inicial ou o valor do índice para a nésima ocorrência da subcadeia especificada. Se a substring não for encontrada ou existirem menos de n ocorrências da substring, retorne -1.

Exemplos

nthIndexOf('123456789123465789', '1', 1) // Returns `0`.
nthIndexOf('123456789123465789', '1', 2) // Returns `9`.
nthIndexOf('123456789123465789', '12', 2) // Returns `9`.
nthIndexOf('123456789123465789', '6', 4) // Returns `-1`.

O

ou

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

or(<expression1>, <expression2>, ...)
Parâmetro Necessário Type Description
<expressão1>, <expressão2>, ... Sim Boolean As expressões a verificar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando pelo menos uma expressão for verdadeira. Retorne false quando todas as expressões forem falsas.

Exemplo 1

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

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

E devolva estes resultados:

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

Exemplo 2

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

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

E devolva estes resultados:

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

saídas

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

outputs('<actionName>')
Parâmetro Necessário Type Description
<actionName> Sim String O nome da saída da ação que você deseja
Valor devolvido Tipo Description
<Saída> String A saída da ação especificada

Exemplo

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

outputs('Get_user')

E devolve este resultado:

{
  "statusCode": 200,
  "headers": {
    "Pragma": "no-cache",
    "Vary": "Accept-Encoding",
    "x-ms-request-id": "a916ec8f52211265d98159adde2efe0b",
    "X-Content-Type-Options": "nosniff",
    "Timing-Allow-Origin": "*",
    "Cache-Control": "no-cache",
    "Date": "Mon, 09 Apr 2018 18:47:12 GMT",
    "Set-Cookie": "ARRAffinity=b9400932367ab5e3b6802e3d6158afffb12fcde8666715f5a5fbd4142d0f0b7d;Path=/;HttpOnly;Domain=twitter-wus.azconn-wus.p.azurewebsites.net",
    "X-AspNet-Version": "4.0.30319",
    "X-Powered-By": "ASP.NET",
    "Content-Type": "application/json; charset=utf-8",
    "Expires": "-1",
    "Content-Length": "339"
  },
  "body": {
    "FullName": "Contoso Corporation",
    "Location": "Generic Town, USA",
    "Id": 283541717,
    "UserName": "ContosoInc",
    "FollowersCount": 172,
    "Description": "Leading the way in transforming the digital workplace.",
    "StatusesCount": 93,
    "FriendsCount": 126,
    "FavouritesCount": 46,
    "ProfileImageUrl": "https://pbs.twimg.com/profile_images/908820389907722240/gG9zaHcd_400x400.jpg"
  }
}

P

parâmetros

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

parameters('<parameterName>')
Parâmetro Necessário Type Description
<nome_parâmetro> Sim String O nome do parâmetro cujo valor você deseja
Valor devolvido Tipo Description
<valor-parâmetro> Qualquer O valor para o parâmetro especificado

Exemplo

Suponha que você tenha esse valor JSON:

{
  "fullName": "Sophia Owen"
}

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

parameters('fullName')

E devolve este resultado: "Sophia Owen"

parseDateTime

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

parseDateTime('<timestamp>', '<locale>'?, '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<região> Não String A localidade a ser usada.

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

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

Exemplos

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

R

RAND

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

rand(<minValue>, <maxValue>)
Parâmetro Necessário Type Description
<minValor> Sim Número inteiro O número inteiro mais baixo do intervalo
<maxValor> Sim Número inteiro O inteiro que segue o número inteiro mais alto no intervalo que a função pode retornar
Valor devolvido Tipo Description
<resultado aleatório> Número inteiro O inteiro aleatório retornado do intervalo especificado

Exemplo

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

rand(1, 5)

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

range

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

range(<startIndex>, <count>)
Parâmetro Necessário Type Description
<startIndex> Sim Número inteiro Um valor inteiro que inicia a matriz como o primeiro item
<count> Sim Número inteiro O número de inteiros na matriz. O count valor do parâmetro deve ser um inteiro positivo que não exceda 100.000.



Nota: A soma dos startIndex valores e count não deve exceder 2.147.483.647.
Valor devolvido Tipo Description
[<intervalo-resultado>] Matriz A matriz com inteiros a partir do índice especificado

Exemplo

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

range(1, 4)

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

removeProperty

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

removeProperty(<object>, '<property>')
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON de onde você deseja remover uma propriedade
<propriedade> Sim String O nome da propriedade a ser removida
Valor devolvido Tipo Description
<atualizado-objeto> Object O objeto JSON atualizado sem a propriedade especificada

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

removeProperty(<object>['<parent-property>'], '<child-property>')
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON cuja propriedade você deseja remover
<Propriedade-mãe> Sim String O nome da propriedade pai com a propriedade filho que você deseja remover
<Propriedade para crianças> Sim String O nome da propriedade filho a ser removida
Valor devolvido Tipo Description
<atualizado-objeto> Object O objeto JSON atualizado cuja propriedade filho você removeu

Exemplo 1

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

Exemplo 2

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

replace

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

replace('<text>', '<oldText>', '<newText>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que tem a substring para substituir
<texto antigo> Sim String A substring a ser substituída
<newTexto> Sim String A cadeia de caracteres de substituição
Valor devolvido Tipo Description
<texto atualizado> String A cadeia de caracteres atualizada após a substituição da substring

Se a substring não for encontrada, retorne a cadeia de caracteres original.

Exemplo

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

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

E devolve este resultado: "the new string"

result

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

Nota

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

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

result('<scopedActionName>')
Parâmetro Necessário Type Description
<scopedActionName> Sim String O nome da ação com escopo onde você deseja as entradas e saídas das ações de nível superior dentro desse escopo
Valor devolvido Tipo Description
<matriz-objeto> Objeto de matriz Uma matriz que contém matrizes de entradas e saídas de cada ação de nível superior dentro do escopo especificado

Exemplo

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

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

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

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

reverse

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

reverse([<collection>])
Parâmetro Necessário Type Description
<Coleção> Sim Matriz A cobrança para reverter
Valor devolvido Tipo Description
[<coleção> atualizada] Matriz A cobrança invertida

Exemplo

Este exemplo inverte uma matriz de inteiros:

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

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

S

setPropriedade

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

setProperty(<object>, '<property>', <value>)
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON cuja propriedade você deseja definir
<propriedade> Sim String O nome da propriedade existente ou nova a ser definida
<valor> Sim Qualquer O valor a ser definido para a propriedade especificada

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

setProperty(<object>, '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
Parâmetro Necessário Type Description
<objeto> Sim Object O objeto JSON cuja propriedade você deseja definir
<Propriedade-mãe> Sim String O nome da propriedade pai com a propriedade filho que você deseja definir
<Propriedade para crianças> Sim String O nome da propriedade filho a ser definida
<valor> Sim Qualquer O valor a ser definido para a propriedade especificada
Valor devolvido Tipo Description
<atualizado-objeto> Object O objeto JSON atualizado cuja propriedade você definiu

Exemplo 1

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

Exemplo 2

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

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

Aqui está o objeto JSON atual:

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

Aqui está o objeto JSON atualizado:

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

skip

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

skip([<collection>], <count>)
Parâmetro Necessário Type Description
<Coleção> Sim Matriz A coleção cujos itens você deseja remover
<count> Sim Número inteiro Um número inteiro positivo para o número de itens a remover na frente
Valor devolvido Tipo Description
[<coleção> atualizada] Matriz A coleção atualizada depois de remover os itens especificados

Exemplo

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

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

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

slice

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

slice('<text>', <startIndex>, <endIndex>?)
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que contém a substring para localizar
<startIndex> Sim Número inteiro A posição inicial baseada em zero ou o valor por onde começar a procurar a substring

- Se startIndex for maior que o comprimento da cadeia de caracteres, retorne uma cadeia de caracteres vazia.

- Se startIndex for negativo, comece a pesquisar no valor do índice que é a soma do comprimento da string e startIndex.
<endIndex> Não Número inteiro A posição ou valor final baseado em zero para onde terminar a pesquisa da substring. O caractere localizado no valor do índice final não é incluído na pesquisa.

- Se endIndex não for especificado ou maior que o comprimento da string, pesquise até o final da string.

- Se endIndex for negativo, termine a pesquisa no valor do índice que a soma do comprimento da string e endIndex.
Valor devolvido Tipo Description
<fatia-resultado> String Uma nova cadeia de caracteres que contém a substring encontrada

Exemplos

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

sort

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

sort([<collection>], <sortBy>?)
Parâmetro Necessário Type Description
<Coleção> Sim Matriz A coleção com os itens para classificar
<ordenarPor> Não String A chave a ser usada para classificar os objetos de coleção
Valor devolvido Tipo Description
[<coleção> atualizada] Matriz A coleção ordenada

Exemplo 1

Este exemplo classifica uma matriz de inteiros:

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

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

Exemplo 2

Este exemplo classifica uma matriz de objetos por chave:

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

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

split

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

split('<text>', '<delimiter>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres a ser separada em substrings com base no delimitador especificado na string original
<delimitador> Sim String O caractere na cadeia de caracteres original a ser usado como delimitador
Valor devolvido Tipo Description
[<substring1,substring2><>,...] Matriz Uma matriz que contém substrings da cadeia de caracteres original, separadas por vírgulas

Exemplo 1

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

split('a_b_c', '_')

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

Exemplo 2

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

split('a_b_c', ' ')

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

inícioOfDay

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

startOfDay('<timestamp>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo

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

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

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

iníciodehora

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

startOfHour('<timestamp>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo

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

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

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

iníciodemês

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

startOfMonth('<timestamp>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

começaCom

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

startsWith('<text>', '<searchText>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres a ser verificada
<pesquisaTexto> Sim String A cadeia de caracteres inicial para localizar
Valor devolvido Tipo Description
verdadeiro ou falso Boolean Retorne true quando a substring inicial for encontrada. Retornar false quando não encontrado.

Exemplo 1

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

startsWith('hello world', 'hello')

E devolve este resultado: true

Exemplo 2

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

startsWith('hello world', 'greetings')

E devolve este resultado: false

string

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

string(<value>)
Parâmetro Necessário Type Description
<valor> Sim Qualquer O valor a converter. Se esse valor for nulo ou for avaliado como nulo, o valor será convertido em um valor de cadeia de caracteres ("") vazia.



Por exemplo, se você atribuir uma variável de cadeia de caracteres a uma propriedade inexistente, que você pode acessar com o ? operador, o valor nulo será convertido em uma cadeia de caracteres vazia. No entanto, comparar um valor nulo não é o mesmo que comparar uma cadeia de caracteres vazia.
Valor devolvido Tipo Description
<valor da cadeia de caracteres> String A versão da cadeia de caracteres para o valor especificado. Se o parâmetro value for null ou for avaliado como null, esse valor será retornado como um valor de string ("") vazio.

Exemplo 1

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

string(10)

E devolve este resultado: "10"

Exemplo 2

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

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

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

sub

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

sub(<minuend>, <subtrahend>)
Parâmetro Necessário Type Description
<minuend> Sim Inteiro ou flutuador O número do qual subtrair o subtrahend
<Subtrahend> Sim Inteiro ou flutuador O número a subtrair do minuend
Valor devolvido Tipo Description
<Resultado> Inteiro ou flutuador O resultado da subtração do segundo número do primeiro número

Exemplo

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

sub(10.3, .3)

E devolve este resultado: 10

substring

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

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

Nota

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

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

Exemplo

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

substring('hello world', 6, 5)

E devolve este resultado: "world"

subtrairFromTime

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

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres que contém o carimbo de data/hora
<interval> Sim Número inteiro O número de unidades de tempo especificadas para subtrair
<timeUnit> Sim String A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

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

Exemplo 1

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

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

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

Exemplo 2

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

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

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

T

take

Devolver itens da frente de uma coleção.

take('<collection>', <count>)
take([<collection>], <count>)
Parâmetro Necessário Type Description
<Coleção> Sim String ou matriz A coleção cujos itens você deseja
<count> Sim Número inteiro Um número inteiro positivo para o número de itens que você deseja da frente
Valor devolvido Tipo Description
<subconjunto> ou [<subconjunto>] String ou Array, respectivamente Uma cadeia de caracteres ou matriz que tem o número especificado de itens retirados da frente da coleção original

Exemplo

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

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

E devolva estes resultados:

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

carrapatos

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

ticks('<timestamp>')
Parâmetro Necessário Type Description
<Carimbo de data/hora> Sim String A cadeia de caracteres para um carimbo de data/hora
Valor devolvido Tipo Description
<número de ticks> Número inteiro O número de ticks desde o carimbo de data/hora especificado

paraMais baixo

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

toLower('<text>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres a ser retornada em formato minúsculo
Valor devolvido Tipo Description
<texto minúsculo> String A cadeia de caracteres original em formato minúsculo

Exemplo

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

toLower('Hello World')

E devolve este resultado: "hello world"

toUpper

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

toUpper('<text>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres a ser retornada em formato maiúsculo
Valor devolvido Tipo Description
<texto em maiúsculas> String A cadeia de caracteres original em formato maiúsculo

Exemplo

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

toUpper('Hello World')

E devolve este resultado: "HELLO WORLD"

gatilho

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

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

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

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

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

triggerBody

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

triggerBody()
Valor devolvido Tipo Description
<Saída-corpo-gatilho> String A body saída do gatilho

triggerFormDataMultiValues

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

triggerFormDataMultiValues('<key>')
Parâmetro Necessário Type Description
<key> Sim String O nome da chave cujo valor você deseja
Valor devolvido Tipo Description
[<matriz-com-valores-chave>] Matriz Uma matriz com todos os valores que correspondem à chave especificada

Exemplo

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

triggerFormDataMultiValues('feedUrl')

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

triggerFormDataValue

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

triggerFormDataValue('<key>')
Parâmetro Necessário Type Description
<key> Sim String O nome da chave cujo valor você deseja
Valor devolvido Tipo Description
<valor-chave> String O valor na chave especificada

Exemplo

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

triggerFormDataValue('feedUrl')

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

triggerMultipartBody

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

triggerMultipartBody(<index>)
Parâmetro Necessário Type Description
<índice> Sim Número inteiro O valor de índice para a parte que você deseja
Valor devolvido Tipo Description
<corpo> String O corpo da parte especificada na saída de várias partes de um gatilho

triggerSaídas

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

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

guarnição

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

trim('<text>')
Parâmetro Necessário Type Descrição
<texto> Sim String A cadeia de caracteres que tem o espaço em branco à esquerda e à direita para remover
Valor devolvido Tipo Description
<updatedText> String Uma versão atualizada para a cadeia de caracteres original sem espaço em branco à esquerda ou à direita

Exemplo

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

trim(' Hello World  ')

E devolve este resultado: "Hello World"

U

união

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

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parâmetro Necessário Type Description
<coleção1>, <coleção2>, ... Sim Array ou Object, mas não ambos As coleções de onde você deseja todos os itens
Valor devolvido Tipo Description
<updatedCollection> Array ou Object, respectivamente Uma coleção com todos os itens das coleções especificadas - sem duplicatas

Exemplo

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

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

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

uriComponent

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

uriComponent('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres a ser convertida para o formato codificado por URI
Valor devolvido Tipo Description
<encoded-uri> String A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres codificada por URI para converter
Valor devolvido Tipo Description
<binário-para-encoded-uri> String A versão binária para a cadeia de caracteres codificada por URI. O conteúdo binário é codificado em base64 e representado por $content.

Exemplo

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

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

E devolve este resultado:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

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

uriComponentToString('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres codificada por URI para decodificar
Valor devolvido Tipo Description
<Decodificado-URI> String A versão decodificada para a cadeia de caracteres codificada por URI

Exemplo

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

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

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

uriHost

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

uriHost('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujo host valor você deseja
Valor devolvido Tipo Description
<valor do host> String O host valor para o URI especificado

Exemplo

Este exemplo localiza o host valor para este URI:

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

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

uriPath

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

uriPath('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujo path valor você deseja
Valor devolvido Tipo Description
<valor-caminho> String O path valor para o URI especificado. Se path não tiver um valor, retorne o caractere "/".

Exemplo

Este exemplo localiza o path valor para este URI:

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

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

uriPathAndQuery

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

uriPathAndQuery('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujos path valores e query você deseja
Valor devolvido Tipo Description
<path-query-value> String Os path valores e query para o URI especificado. Se path não especificar um valor, retorne o caractere "/".

Exemplo

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

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

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

uriPorto

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

uriPort('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujo port valor você deseja
Valor devolvido Tipo Description
<valor-porta> Número inteiro O port valor para o URI especificado. Se port não especificar um valor, retorne a porta padrão para o protocolo.

Exemplo

Este exemplo retorna o port valor para este URI:

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

E devolve este resultado: 8080

uriQuery

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

uriQuery('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujo query valor você deseja
Valor devolvido Tipo Description
<valor-consulta> String O query valor para o URI especificado

Exemplo

Este exemplo retorna o query valor para este URI:

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

E devolve este resultado: "?date=today"

uriScheme

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

uriScheme('<uri>')
Parâmetro Necessário Type Description
<URI> Sim String O URI cujo scheme valor você deseja
Valor devolvido Tipo Description
<Esquema-valor> String O scheme valor para o URI especificado

Exemplo

Este exemplo retorna o scheme valor para este URI:

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

E devolve este resultado: "http"

utcAgora

Retornar o carimbo de data/hora atual.

utcNow('<format>')

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

Parâmetro Necessário Type Description
<format> Não String Uma cadeia de caracteres de formato numérico que é um especificador de formato único ou um padrão de formato personalizado. O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com a ISO 8601 e preserva as informações de fuso horário.

Se o formato não for um valor válido, um erro será gerado.
Valor devolvido Tipo Description
<carimbo de data/hora atual> String A data e hora atuais

Exemplo 1

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

utcNow()

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

Exemplo 2

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

utcNow('D')

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

V

variáveis

Retornar o valor de uma variável especificada.

variables('<variableName>')
Parâmetro Necessário Type Description
<nomevariável> Sim String O nome da variável cujo valor você deseja
Valor devolvido Tipo Description
<valor-variável> Qualquer O valor para a variável especificada

Exemplo

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

variables('numItems')

E devolve este resultado: 20

Qua

fluxo de trabalho

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

workflow().<property>
Parâmetro Necessário Type Description
<propriedade> Não String O nome da propriedade de fluxo de trabalho cujo valor você deseja



Por padrão, um objeto de fluxo de trabalho tem estas propriedades: name, type, id, location, rune tags.



- O run valor da propriedade é um objeto JSON que inclui estas propriedades: name, type, e id.



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



Nota: Por predefinição, uma aplicação lógica não tem etiquetas, mas um fluxo Power Automate tem as flowDisplayName etiquetas e environmentName .

Exemplo 1

Este exemplo retorna o nome da execução atual de um fluxo de trabalho:

workflow().run.name

Exemplo 2

Se você usar o Power Automate, poderá criar uma @workflow() expressão que use a tags propriedade output para obter os valores da propriedade ou do fluxo flowDisplayName environmentName .

Por exemplo, você pode enviar notificações por e-mail personalizadas do próprio fluxo que vinculam de volta ao seu fluxo. Essas notificações podem incluir um link HTML que contém o nome de exibição do fluxo no título do e-mail e segue esta sintaxe:

<a href=https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details>Open flow @{workflow()['tags']['flowDisplayName']}</a>

X

xml

Retornar a versão XML para uma cadeia de caracteres que contém um objeto JSON.

xml('<value>')
Parâmetro Necessário Type Description
<valor> Sim String A cadeia de caracteres com o objeto JSON para converter

O objeto JSON deve ter apenas uma propriedade raiz, que não pode ser uma matriz.
Use o caractere de barra invertida (\) como um caractere de escape para as aspas duplas (").
Valor devolvido Tipo Description
<xml-versão> Object O XML codificado para a cadeia de caracteres especificada ou objeto JSON

Exemplo 1

Este exemplo converte a cadeia de caracteres em XML:

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

E retorna este resultado XML:

<name>Sophia Owen</name>

Exemplo 2

Este exemplo cria a versão XML para essa cadeia de caracteres, que contém um objeto JSON:

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

E retorna este resultado XML:

<name>Sophia Owen</name>

Exemplo 3

Suponha que você tenha este objeto JSON:

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

Este exemplo cria XML para uma cadeia de caracteres que contém esse objeto JSON:

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

E retorna este resultado XML:

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

XPath

Verifique se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e retorne os nós ou valores correspondentes. Uma expressão XPath, ou apenas "XPath", ajuda você a navegar por uma estrutura de documento XML para que você possa selecionar nós ou valores de computação no conteúdo XML.

Nota

Em aplicativos lógicos de consumo e padrão, todas as expressões de função usam a biblioteca .NET XPath. As expressões XPath são compatíveis com a biblioteca .NET subjacente e suportam apenas a expressão suportada pela biblioteca .NET subjacente.

xpath('<xml>', '<xpath>')
Parâmetro Necessário Type Description
<xml> Sim Qualquer A cadeia de caracteres XML para procurar nós ou valores que correspondam a um valor de expressão XPath
<XPath> Sim Qualquer A expressão XPath usada para localizar nós ou valores XML correspondentes
Valor devolvido Tipo Description
<nó xml> XML Um nó XML quando apenas um único nó corresponde à expressão XPath especificada
<valor> Qualquer O valor de um nó XML quando apenas um único valor corresponde à expressão XPath especificada
[<xml-node1>, <xml-node2>, ...] -ou- [<value1>, <value2>, ...] Matriz Uma matriz com nós XML ou valores que correspondem à expressão XPath especificada

Exemplo 1

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

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

Este exemplo passa a expressão XPath, '/produce/item/name/text()', para localizar os nós que correspondem ao <name></name> nó na 'items' cadeia de caracteres XML e retorna uma matriz com esses valores de nó:

xpath(xml(parameters('items')), '/produce/item/name/text()')

O exemplo também usa a função parameters() para obter a cadeia de 'items' caracteres XML e convertê-la no formato XML usando a função xml( ).

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

[ Gala, Honeycrisp ]

Exemplo 2

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

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

Eis o resultado: Gala

Exemplo 3

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

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

Eis o resultado: Honeycrisp

Exemplo 4

Neste exemplo, suponha que sua items cadeia de caracteres XML também contenha os atributos expired='true' e expired='false':

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

Este exemplo passa a expressão XPath, '//name[@expired]', para localizar todos os name elementos que têm o expired atributo:

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

Eis o resultado: [ Gala, Honeycrisp ]

Exemplo 5

Neste exemplo, suponha que sua items cadeia de caracteres XML contenha apenas este atributo, expired = 'true':

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

Este exemplo passa na expressão XPath, '//name[@expired = 'true']', para localizar todos os name elementos que têm o atributo, expired = 'true':

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

Eis o resultado: [ Gala ]

Exemplo 6

Neste exemplo, suponha que sua items cadeia de caracteres XML também contenha estes atributos:

  • expired='true' price='12'
  • expired='false' price='40'
<?xml version="1.0"?>
<produce>
  <item>
    <name expired='true' price='12'>Gala</name>
    <type>apple</type>
    <count>20</count>
  </item>
  <item>
    <name expired='false' price='40'>Honeycrisp</name>
    <type>apple</type>
    <count>10</count>
  </item>
</produce>

Este exemplo passa na expressão XPath, '//name[@price>35]', para localizar todos os name elementos que têm price > 35:

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

Eis o resultado: Honeycrisp

Exemplo 7

Neste exemplo, suponha que sua items cadeia de caracteres XML seja a mesma do Exemplo 1:

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

Este exemplo localiza nós que correspondem ao <count></count> nó e adiciona esses valores de nó com a sum() função:

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

Eis o resultado: 30

Exemplo 8

Neste exemplo, suponha que você tenha essa cadeia de caracteres XML, que inclui o namespace do documento XML, xmlns="https://contoso.com":

<?xml version="1.0"?><file xmlns="https://contoso.com"><location>Paris</location></file>

Essas expressões usam a expressão /*[name()="file"]/*[name()="location"] XPath ou /*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"], para localizar nós que correspondem ao <location></location> nó. Estes exemplos mostram a sintaxe que você usa no designer ou no editor de expressão:

  • xpath(xml(body('Http')), '/*[name()="file"]/*[name()="location"]')
  • xpath(xml(body('Http')), '/*[local-name()="file" and namespace-uri()="https://contoso.com"]/*[local-name()="location"]')

Aqui está o nó de resultado que corresponde ao <location></location> nó:

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

Importante

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

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

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

Exemplo 9

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

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

Eis o resultado: Paris

Próximos passos

Saiba mais sobre a linguagem de definição de fluxo de trabalho