Guia de referência para a utilização de funções em expressões para aplicações lógicas azure e automatização de potênciaReference guide to using functions in expressions for Azure Logic Apps and Power Automate

Para definições de fluxo de trabalho em Aplicações lógicas Azure e Power Automate, algumas expressões obtêm os seus valores a partir de ações de tempo de execução que podem ainda não existir quando o seu fluxo de trabalho começa a funcionar.For workflow definitions in Azure Logic Apps and Power Automate, some expressions get their values from runtime actions that might not yet exist when your workflow starts running. Para fazer referência a estes valores ou processar os valores nestas expressões, pode utilizar funções fornecidas pela Linguagem definiçãode fluxo de trabalho.To reference these values or process the values in these expressions, you can use functions provided by the Workflow Definition Language.

Nota

Esta página de referência aplica-se tanto às Aplicações Lógicas Azure como ao Power Automate, mas aparece na documentação das Aplicações Lógicas Azure.This reference page applies to both Azure Logic Apps and Power Automate, but appears in the Azure Logic Apps documentation. Embora esta página se refira especificamente a aplicações lógicas, estas funções funcionam tanto para fluxos como para aplicações lógicas.Although this page refers specifically to logic apps, these functions work for both flows and logic apps. Para obter mais informações sobre funções e expressões no Power Automate, consulte As expressões de utilização em condições.For more information about functions and expressions in Power Automate, see Use expressions in conditions.

Por exemplo, pode calcular valores utilizando funções matemáticas, como a função add()quando se deseja a soma de inteiros ou carros alegóricos.For example, you can calculate values by using math functions, such as the add() function, when you want the sum from integers or floats. Aqui estão outros exemplos de tarefas que pode executar com funções:Here are other example tasks that you can perform with functions:

TarefaTask Sintaxe de funçãoFunction syntax ResultadoResult
Volte a colocar uma corda em formato minúsculo.Return a string in lowercase format. toLower('<texto>')toLower('<text>')

Por exemplo: para Lower ('Olá')For example: toLower('Hello')

"Olá""hello"
Devolva um identificador globalmente único (GUID).Return a globally unique identifier (GUID). guid()guid() "c2ecc88d-88c8-4096-912c-d6f2e2b138ce""c2ecc88d-88c8-4096-912c-d6f2e2b138ce"

Para encontrar funções com base no seu propósito geral,reveja as seguintes tabelas.To find functions based on their general purpose, review the following tables. Ou, para informação detalhada sobre cada função, consulte a lista alfabética.Or, for detailed information about each function, see the alphabetical list.

Nota

Na sintaxe para definições de parâmetros, um ponto de interrogação (?) que aparece após um parâmetro significa que o parâmetro é opcional.In the syntax for parameter definitions, a question mark (?) that appears after a parameter means the parameter is optional. Por exemplo, consulte getFutureTime().For example, see getFutureTime().

Funções em expressõesFunctions in expressions

Para mostrar como usar uma função numa expressão, este exemplo mostra como pode obter o valor do parâmetro customerName e atribuir esse valor à accountName propriedade utilizando a função dos parâmetros numa expressão:To show how to use a function in an expression, this example shows how you can get the value from the customerName parameter and assign that value to the accountName property by using the parameters() function in an expression:

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

Aqui estão outras formas gerais de usar funções em expressões:Here are some other general ways that you can use functions in expressions:

TarefaTask Sintaxe de função em uma expressãoFunction syntax in an expression
Execute o trabalho com um item passando esse item para uma função.Perform work with an item by passing that item to a function. "@<funçãoName>(<item>)""@<functionName>(<item>)"
1. Obtenha o valor do parâmetroNomeutilizando a função parameters() aninhada.1. Get the parameterName's value by using the nested parameters() function.
2. Realizar trabalhocom o resultado passando esse valor para a funçãoNome.2. Perform work with the result by passing that value to functionName.
"@ <funçãoName>(parâmetros('<parâmetroNome>')""@<functionName>(parameters('<parameterName>'))"
1. Obtenha o resultado da funçãointerna aninhadaNome .1. Get the result from the nested inner function functionName.
2. Passe o resultado para a função exteriorNome2.2. Pass the result to the outer function functionName2.
"@função <Name2>(<functionName>(<item>)""@<functionName2>(<functionName>(<item>))"
1. Obtenha o resultado da funçãoNome.1. Get the result from functionName.
2. Dado que o resultado é um objeto com propriedade name, obtenha o valor desse imóvel.2. Given that the result is an object with property propertyName, get that property's value.
"@<funçãoName>(<item>).<propertyName>""@<functionName>(<item>).<propertyName>"

Por exemplo, a função concat() pode ter dois ou mais valores de cadeia como parâmetros.For example, the concat() function can take two or more string values as parameters. Esta função combina essas cordas numa corda.This function combines those strings into one string. Pode passar em cordas literais, por exemplo, "Sophia" e "Owen" para que consiga uma corda combinada, "SophiaOwen":You can either pass in string literals, for example, "Sophia" and "Owen" so that you get a combined string, "SophiaOwen":

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

Ou pode obter valores de cordas a partir de parâmetros.Or, you can get string values from parameters. Este exemplo utiliza a função parameters() em cada parâmetro de concat() e os parâmetros firstName e lastName.This example uses the parameters() function in each concat() parameter and the firstName and lastName parameters. Em seguida, passa as cordas resultantes para a função concat() para que obtenha uma corda combinada, por exemplo, "SophiaOwen":You then pass the resulting strings to the concat() function so that you get a combined string, for example, "SophiaOwen":

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

De qualquer forma, ambos os exemplos atribuem o resultado à propriedade customerName.Either way, both examples assign the result to the customerName property.

Aqui estão as funções disponíveis ordenadas pelo seu propósito geral, ou pode navegar nas funções com base na ordem alfabética.Here are the available functions ordered by their general purpose, or you can browse the functions based on alphabetical order.

Funções de cadeiaString functions

Para trabalhar com cordas, pode utilizar estas funções de cadeia e também algumas funçõesde recolha.To work with strings, you can use these string functions and also some collection functions. As funções das cordas funcionam apenas em cordas.String functions work only on strings.

Função de cordaString function TarefaTask
concatconcat Combine duas ou mais cordas e devolva a corda combinada.Combine two or more strings, and return the combined string.
terminaComendsWith Verifique se uma corda termina com a subcadeia especificada.Check whether a string ends with the specified substring.
formatoNúmeroformatNumber Devolva um número como uma corda com base no formato especificadoReturn a number as a string based on the specified format
guiaguid Gere um identificador globalmente único (GUID) como uma corda.Generate a globally unique identifier (GUID) as a string.
indexofindexOf Volte a colocar a posição inicial para um substring.Return the starting position for a substring.
últimoIndexOflastIndexOf Volte a colocar a posição inicial na última ocorrência de um substring.Return the starting position for the last occurrence of a substring.
substituirreplace Substitua uma subcadeia com a corda especificada e devolva a corda atualizada.Replace a substring with the specified string, and return the updated string.
dividirsplit Devolva uma matriz que contenha subcordas, separadas por vírgulas, de uma corda maior baseada num caracteres delimitadores especificados na cadeia original.Return an array that contains substrings, separated by commas, from a larger string based on a specified delimiter character in the original string.
começaComstartsWith Verifique se uma corda começa com um substring específico.Check whether a string starts with a specific substring.
substringsubstring Volte a colocar caracteres de uma corda, a partir da posição especificada.Return characters from a string, starting from the specified position.
toLowertoLower Volte a colocar uma corda em formato minúsculo.Return a string in lowercase format.
toUppertoUpper Volte a colocar uma corda em formato superior.Return a string in uppercase format.
aparartrim Remova o espaço branco de liderar e arrastando a partir de uma corda e devolva a corda atualizada.Remove leading and trailing whitespace from a string, and return the updated string.

Funções de recolhaCollection functions

Para trabalhar com coleções, geralmente matrizes, cordas e, por vezes, dicionários, pode utilizar estas funções de coleção.To work with collections, generally arrays, strings, and sometimes, dictionaries, you can use these collection functions.

Função de recolhaCollection function TarefaTask
contémcontains Verifique se uma coleção tem um item específico.Check whether a collection has a specific item.
vazioempty Verifique se uma coleção está vazia.Check whether a collection is empty.
primeirofirst Devolva o primeiro item de uma coleção.Return the first item from a collection.
cruzamentointersection Devolva uma coleção que tenha apenas os itens comuns nas coleções especificadas.Return a collection that has only the common items across the specified collections.
itemitem Quando estiver dentro de uma ação repetida sobre uma matriz, devolva o item atual na matriz durante a iteração atual da ação.When inside a repeating action over an array, return the current item in the array during the action's current iteration.
aderirjoin Volte a colocar uma corda que tenha todos os itens de uma matriz, separadas pelo carácter especificado.Return a string that has all the items from an array, separated by the specified character.
últimalast Devolva o último item de uma coleção.Return the last item from a collection.
comprimentolength Volte a devolver o número de itens numa corda ou numa matriz.Return the number of items in a string or array.
saltarskip Retire os itens da parte da frente de uma coleção e devolva todos os outros itens.Remove items from the front of a collection, and return all the other items.
tomartake Devolver artigos da frente de uma coleção.Return items from the front of a collection.
uniãounion Devolva uma coleção que tenha todos os itens das coleções especificadas.Return a collection that has all the items from the specified collections.

Funções de comparação lógicaLogical comparison functions

Para trabalhar com condições, comparar valores e resultados de expressão, ou avaliar vários tipos de lógica, pode utilizar estas funções de comparação lógica.To work with conditions, compare values and expression results, or evaluate various kinds of logic, you can use these logical comparison functions. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de comparação lógicaLogical comparison function TarefaTask
eand Verifique se todas as expressões são verdadeiras.Check whether all expressions are true.
iguaisequals Verifique se ambos os valores são equivalentes.Check whether both values are equivalent.
maiorgreater Verifique se o primeiro valor é superior ao segundo valor.Check whether the first value is greater than the second value.
greaterOrEqualsgreaterOrEquals Verifique se o primeiro valor é maior ou igual ao segundo valor.Check whether the first value is greater than or equal to the second value.
seif Verifique se uma expressão é verdadeira ou falsa.Check whether an expression is true or false. Com base no resultado, devolva um valor especificado.Based on the result, return a specified value.
menosless Verifique se o primeiro valor é inferior ao segundo valor.Check whether the first value is less than the second value.
lessOrEqualslessOrEquals Verifique se o primeiro valor é inferior ou igual ao segundo valor.Check whether the first value is less than or equal to the second value.
nãonot Verifique se uma expressão é falsa.Check whether an expression is false.
ouor Verifique se pelo menos uma expressão é verdadeira.Check whether at least one expression is true.

Funções de conversãoConversion functions

Para alterar o tipo ou formato de um valor, pode utilizar estas funções de conversão.To change a value's type or format, you can use these conversion functions. Por exemplo, pode mudar um valor de um Boolean para um inteiro.For example, you can change a value from a Boolean to an integer. Para obter mais informações sobre como as Aplicações Lógicas lidam com tipos de conteúdo durante a conversão, consulte os tipos de conteúdo de Handle.For more information about how Logic Apps handles content types during conversion, see Handle content types. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de conversãoConversion function TarefaTask
matrizarray Devolva uma matriz de uma única entrada especificada.Return an array from a single specified input. Para várias inputs, consulte createArray.For multiple inputs, see createArray.
base64base64 Devolva a versão codificada base64 para uma corda.Return the base64-encoded version for a string.
base64ToBinarybase64ToBinary Volte a colocar a versão binária numa cadeia codificada com base64.Return the binary version for a base64-encoded string.
base64Tostringbase64ToString Volte a colocar a versão de corda numa cadeia codificada com base64.Return the string version for a base64-encoded string.
bináriobinary Devolva a versão binária por um valor de entrada.Return the binary version for an input value.
boolbool Devolva a versão Boolean por um valor de entrada.Return the Boolean version for an input value.
criar ArraycreateArray Devolva uma matriz de várias inputs.Return an array from multiple inputs.
dataUridataUri Devolva os dados URI por um valor de entrada.Return the data URI for an input value.
dataUriToBinarydataUriToBinary Devolva a versão binária para obter um URI de dados.Return the binary version for a data URI.
datauritostringdataUriToString Devolva a versão de cadeia para um URI de dados.Return the string version for a data URI.
descodificarBase64decodeBase64 Volte a colocar a versão de corda numa cadeia codificada com base64.Return the string version for a base64-encoded string.
descodificarDataUridecodeDataUri Devolva a versão binária para obter um URI de dados.Return the binary version for a data URI.
descodificar Componente UridecodeUriComponent Volte a colocar uma corda que substitua caracteres de fuga por versões descodificadas.Return a string that replaces escape characters with decoded versions.
codificar Componente UriUriencodeUriComponent Volte a colocar uma corda que substitua caracteres inseguros de URL por caracteres de fuga.Return a string that replaces URL-unsafe characters with escape characters.
flutuarfloat Devolva um número de ponto flutuante para obter um valor de entrada.Return a floating point number for an input value.
intint Devolva a versão inteiro para uma corda.Return the integer version for a string.
jsonjson Devolva o valor ou objeto do tipo JavaScript Object (JSON) para uma corda ou XML.Return the JavaScript Object Notation (JSON) type value or object for a string or XML.
cadeiastring Devolva a versão de corda por um valor de entrada.Return the string version for an input value.
uriComponenturiComponent Devolva a versão codificada por URI para obter um valor de entrada substituindo caracteres url-inseguros por caracteres de fuga.Return the URI-encoded version for an input value by replacing URL-unsafe characters with escape characters.
uriComponentToBinaryuriComponentToBinary Devolva a versão binária para uma corda codificada por URI.Return the binary version for a URI-encoded string.
uriComponentToStringuriComponentToString Devolva a versão de corda para uma corda codificada por URI.Return the string version for a URI-encoded string.
xmlxml Devolva a versão XML para uma corda.Return the XML version for a string.

Funções matemáticasMath functions

Para trabalhar com inteiros e carros alegóricos, pode usar estas funções matemáticas.To work with integers and floats, you can use these math functions. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função matemáticaMath function TarefaTask
adicionaradd Devolva o resultado da adição de dois números.Return the result from adding two numbers.
divdiv Devolva o resultado da divisão de dois números.Return the result from dividing two numbers.
máximomax Devolva o valor mais alto de um conjunto de números ou de uma matriz.Return the highest value from a set of numbers or an array.
minmin Devolva o valor mais baixo de um conjunto de números ou de uma matriz.Return the lowest value from a set of numbers or an array.
modmod Devolva o restante da divisão de dois números.Return the remainder from dividing two numbers.
mulmul Devolva o produto de multiplicar dois números.Return the product from multiplying two numbers.
randrand Devolva um inteiro aleatório de um intervalo especificado.Return a random integer from a specified range.
alcancerange Devolva uma matriz inteiro que começa a partir de um inteiro especificado.Return an integer array that starts from a specified integer.
subsub Devolva o resultado de subtrair o segundo número do primeiro número.Return the result from subtracting the second number from the first number.

Funções de data e horaDate and time functions

Para trabalhar com datas e horários, pode utilizar estas funções de data e hora.To work with dates and times, you can use these date and time functions. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de data ou horaDate or time function TarefaTask
addDaysaddDays Adicione alguns dias a uma marca de tempo.Add a number of days to a timestamp.
addHoursaddHours Adicione algumas horas a um carimbo temporal.Add a number of hours to a timestamp.
addMinutesaddMinutes Adicione alguns minutos a uma marca de tempo.Add a number of minutes to a timestamp.
adicionarSecondsaddSeconds Adicione alguns segundos a uma marca de tempo.Add a number of seconds to a timestamp.
adicionarToTimeaddToTime Adicione várias unidades de tempo a uma marca de tempo.Add a number of time units to a timestamp. Ver também getFutureTime.See also getFutureTime.
converterFromUtcconvertFromUtc Converta uma marca de tempo da Universal Time Coordenada (UTC) para o fuso horário-alvo.Convert a timestamp from Universal Time Coordinated (UTC) to the target time zone.
converterTimeZoneconvertTimeZone Converta uma marca de tempo do fuso horário de origem para o fuso horário alvo.Convert a timestamp from the source time zone to the target time zone.
converteToUtcconvertToUtc Converter uma marca de tempo do fuso horário de origem para Universal Time Coordenado (UTC).Convert a timestamp from the source time zone to Universal Time Coordinated (UTC).
dayOfMonthdayOfMonth Volte o componente do dia do mês a partir de uma marca de tempo.Return the day of the month component from a timestamp.
dayOfWeekdayOfWeek Volte o componente do dia da semana a partir de uma marca de tempo.Return the day of the week component from a timestamp.
dia ofyeardayOfYear Volte o componente do dia do ano a partir de uma marca de tempo.Return the day of the year component from a timestamp.
formatoDateTimeformatDateTime Devolva a data de uma marca de tempo.Return the date from a timestamp.
getFutureTimegetFutureTime Volte a colocar a marca atual mais as unidades de tempo especificadas.Return the current timestamp plus the specified time units. Consulte também adicionarToTime.See also addToTime.
getPastTimegetPastTime Volte a colocar a marca atual menos as unidades de tempo especificadas.Return the current timestamp minus the specified time units. Consulte também subtrairFromTime.See also subtractFromTime.
inícioOfDaystartOfDay Volte o início do dia para um carimbo temporal.Return the start of the day for a timestamp.
inícioOfHourstartOfHour Volte o início da hora por uma marca de tempo.Return the start of the hour for a timestamp.
inícioDo mêsstartOfMonth Devolva o início do mês por um carimbo temporal.Return the start of the month for a timestamp.
subtratoFromTimesubtractFromTime Subtraia várias unidades temporais de uma marca temporal.Subtract a number of time units from a timestamp. Ver também getPastTime.See also getPastTime.
tiquesticks Devolva o valor ticks propriedade por um carimbo de tempo especificado.Return the ticks property value for a specified timestamp.
utcNowutcNow Devolva o carimbo de tempo atual como uma corda.Return the current timestamp as a string.

Funções de fluxo de trabalhoWorkflow functions

Estas funções de fluxo de trabalho podem ajudá-lo:These workflow functions can help you:

  • Obtenha detalhes sobre uma instância de fluxo de trabalho no tempo de execução.Get details about a workflow instance at run time.
  • Trabalhe com as entradas usadas para instantâneos aplicações lógicas ou fluxos.Work with the inputs used for instantiating logic apps or flows.
  • Referenciar as saídas a partir de gatilhos e ações.Reference the outputs from triggers and actions.

Por exemplo, pode fazer referência às saídas de uma ação e utilizar esses dados numa ação posterior.For example, you can reference the outputs from one action and use that data in a later action. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de fluxo de trabalhoWorkflow function TarefaTask
açãoaction Devolva a produção da ação atual em tempo de execução, ou valores de outros pares de nome e valor da JSON.Return the current action's output at runtime, or values from other JSON name-and-value pairs. Ver também ações.See also actions.
actionBodyactionBody Devolva a saída de body de uma ação no tempo de execução.Return an action's body output at runtime. Ver também o corpo.See also body.
actionSaídasactionOutputs Devolva a saída de uma ação no tempo de execução.Return an action's output at runtime. Ver saídas e ações.See outputs and actions.
açõesactions Devolva a saída de uma ação no prazo de execução, ou valores de outros pares de nome e valor da JSON.Return an action's output at runtime, or values from other JSON name-and-value pairs. Ver também ação.See also action.
corpobody Devolva a saída de body de uma ação no tempo de execução.Return an action's body output at runtime. Ver também actionBody.See also actionBody.
formDataMultiValuesformDataMultiValues Crie uma matriz com os valores que correspondam a um nome chave em dados de formulário ou saídas de ação codificadas por formulários.Create an array with the values that match a key name in form-data or form-encoded action outputs.
formulárioDataValueformDataValue Devolva um único valor que corresponda a um nome-chave nos dados de formulário de uma ação ou na saída codificada por formulários.Return a single value that matches a key name in an action's form-data or form-encoded output.
itemitem Quando estiver dentro de uma ação repetida sobre uma matriz, devolva o item atual na matriz durante a iteração atual da ação.When inside a repeating action over an array, return the current item in the array during the action's current iteration.
itensitems Quando estiver dentro de um foreach ou até o loop, devolva o item atual do laço especificado.When inside a Foreach or Until loop, return the current item from the specified loop.
iteraçõesIndexesiterationIndexes Quando estiver dentro de um loop Until, devolva o valor do índice para a iteração atual.When inside an Until loop, return the index value for the current iteration. Pode utilizar esta função dentro de aninhados até os laços.You can use this function inside nested Until loops.
listaCallbackUrllistCallbackUrl Devolva o "URL de chamada" que chama um gatilho ou ação.Return the "callback URL" that calls a trigger or action.
multipartBodymultipartBody Devolva o corpo para uma parte específica da saída de uma ação que tenha várias partes.Return the body for a specific part in an action's output that has multiple parts.
saídasoutputs Devolva a saída de uma ação no tempo de execução.Return an action's output at runtime.
parametersparameters Devolva o valor de um parâmetro descrito na sua definição de fluxo de trabalho.Return the value for a parameter that is described in your workflow definition.
resultadoresult Devolva as inputs e saídas de todas as ações no âmbito da ação de âmbito especificado, tais como For_each, Untile Scope.Return the inputs and outputs from all the actions inside the specified scoped action, such as For_each, Until, and Scope.
gatilhotrigger Volte a colocar a saída de um gatilho no prazo de execução, ou de outros pares de nome e valor da JSON.Return a trigger's output at runtime, or from other JSON name-and-value pairs. Consulte também gatilhoS saídas e gatilhoS.See also triggerOutputs and triggerBody.
triggerBodytriggerBody Volte a colocar um gatilho body saída no tempo de execução.Return a trigger's body output at runtime. Ver gatilho.See trigger.
triggerFormDataValuetriggerFormDataValue Devolva um único valor correspondente a um nome-chave em dados de formulário ou saídas de gatilho codificadas por formulários.Return a single value matching a key name in form-data or form-encoded trigger outputs.
gatilhoMultipartBodytriggerMultipartBody Devolva o corpo para uma parte específica na saída multiparte de um gatilho.Return the body for a specific part in a trigger's multipart output.
triggerFormDataMultiValuestriggerFormDataMultiValues Crie uma matriz cujos valores correspondam a um nome chave em dados de formulário ou saídas de gatilho codificadas por formulários.Create an array whose values match a key name in form-data or form-encoded trigger outputs.
gatilhoSaídastriggerOutputs Volte a colocar a saída de um gatilho no prazo de execução, ou valores de outros pares de nome e valor da JSON.Return a trigger's output at runtime, or values from other JSON name-and-value pairs. Ver gatilho.See trigger.
variáveisvariables Devolva o valor para uma variável especificada.Return the value for a specified variable.
fluxo de trabalhoworkflow Devolva todos os detalhes sobre o fluxo de trabalho em si durante o tempo de funcionamento.Return all the details about the workflow itself during run time.

Funções de parsing URIURI parsing functions

Para trabalhar com identificadores de recursos uniformes (URIs) e obter vários valores de propriedade para estes URIs, você pode usar estas funções de parsing URI.To work with uniform resource identifiers (URIs) and get various property values for these URIs, you can use these URI parsing functions. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de parsing URIURI parsing function TarefaTask
uriHosturiHost Devolver o valor host para um identificador de recursos uniforme (URI).Return the host value for a uniform resource identifier (URI).
uriPathuriPath Devolver o valor path para um identificador de recursos uniforme (URI).Return the path value for a uniform resource identifier (URI).
uriPathAndqueryuriPathAndQuery Devolva os valores path e query para um identificador de recursos uniforme (URI).Return the path and query values for a uniform resource identifier (URI).
uriPortouriPort Devolver o valor port para um identificador de recursos uniforme (URI).Return the port value for a uniform resource identifier (URI).
uriQueryuriQuery Devolver o valor query para um identificador de recursos uniforme (URI).Return the query value for a uniform resource identifier (URI).
uriSchemeuriScheme Devolver o valor scheme para um identificador de recursos uniforme (URI).Return the scheme value for a uniform resource identifier (URI).

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

Para trabalhar com objetos JSON e nós XML, pode utilizar estas funções de manipulação.To work with JSON objects and XML nodes, you can use these manipulation functions. Para obter a referência completa sobre cada função, consulte a lista alfabética.For the full reference about each function, see the alphabetical list.

Função de manipulaçãoManipulation function TarefaTask
adicionarPropriedadeaddProperty Adicione uma propriedade e o seu valor, ou par de valor de nome, a um objeto JSON, e devolva o objeto atualizado.Add a property and its value, or name-value pair, to a JSON object, and return the updated object.
coalescecoalesce Devolva o primeiro valor não nulo de um ou mais parâmetros.Return the first non-null value from one or more parameters.
removerPropriedaderemoveProperty Retire uma propriedade de um objeto JSON e devolva o objeto atualizado.Remove a property from a JSON object and return the updated object.
setPropertysetProperty Desloque o valor para a propriedade de um objeto JSON e devolva o objeto atualizado.Set the value for a JSON object's property and return the updated object.
xpathxpath Verifique o XML para ver se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e devolva os nós ou valores correspondentes.Check XML for nodes or values that match an XPath (XML Path Language) expression, and return the matching nodes or values.

Todas as funções - lista alfabéticaAll functions - alphabetical list

Esta secção lista todas as funções disponíveis por ordem alfabética.This section lists all the available functions in alphabetical order.

actionaction

Devolva a produção da ação atual no prazo de execução, ou valores de outros pares de nome e valor da JSON, que pode atribuir a uma expressão.Return the current action's output at runtime, or values from other JSON name-and-value pairs, which you can assign to an expression. Por predefinição, esta função refere todo o objeto de ação, mas pode especificar opcionalmente uma propriedade cujo valor deseja.By default, this function references the entire action object, but you can optionally specify a property whose value you want. Ver também ações().See also actions().

Só pode utilizar a função action() nestes locais:You can use the action() function only in these places:

  • A propriedade unsubscribe para uma ação webhook para que você possa aceder ao resultado do pedido original de subscribeThe unsubscribe property for a webhook action so you can access the result from the original subscribe request
  • A propriedade trackedProperties para uma açãoThe trackedProperties property for an action
  • A condição de ciclo do-until para uma açãoThe do-until loop condition for an action
action()
action().outputs.body.<property>
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de propriedade<property> NãoNo StringString O nome para o imóvel do objeto de ação cujo valor deseja: nome, início, tempo final, inputs, saídas, estado, código, trackingIde clienteTrackingId.The name for the action object's property whose value you want: name, startTime, endTime, inputs, outputs, status, code, trackingId, and clientTrackingId. No portal Azure, pode encontrar estas propriedades revendo detalhes específicos do histórico de execução.In the Azure portal, you can find these properties by reviewing a specific run history's details. Para mais informações, consulte REST API - Workflow Run Actions.For more information, see REST API - Workflow Run Actions.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção de ação<action-output> StringString A saída da ação ou propriedade em cursoThe output from the current action or property

actionBodyactionBody

Devolva a saída de body de uma ação no tempo de execução.Return an action's body output at runtime. Abreviatura para actions('<actionName>').outputs.body.Shorthand for actions('<actionName>').outputs.body. Ver corpo() e ações().See body() and actions().

actionBody('<actionName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome da body saída da ação que você querThe name for the action's body output that you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção corporal<action-body-output> StringString A body saída da ação especificadaThe body output from the specified action

ExemploExample

Este exemplo obtém a saída body da ação do Twitter Get user:This example gets the body output from the Twitter action Get user:

actionBody('Get_user')

E devolve este resultado:And returns this result:

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

actionOutputsactionOutputs

Devolva a saída de uma ação no tempo de execução.Return an action's output at runtime. e é abreviatura para actions('<actionName>').outputs.and is shorthand for actions('<actionName>').outputs. Ver ações().See actions(). A função actionOutputs() resolve outputs() no Logic App Designer, por isso considere usar saídas() ()em vez de actionOutputs().The actionOutputs() function resolves to outputs() in the Logic App Designer, so consider using outputs(), rather than actionOutputs(). Embora ambas as funções funcionem da mesma forma, outputs() é preferível.Although both functions work the same way, outputs() is preferred.

actionOutputs('<actionName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome para a saída da ação que você querThe name for the action's output that you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção<output> StringString A saída da ação especificadaThe output from the specified action

ExemploExample

Este exemplo obtém a saída da ação do Twitter Get user:This example gets the output from the Twitter action Get user:

actionOutputs('Get_user')

E devolve este resultado:And returns this result:

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

açõesactions

Devolva a saída de uma ação no prazo de execução, ou valores de outros pares de nome e valor da JSON, que pode atribuir a uma expressão.Return an action's output at runtime, or values from other JSON name-and-value pairs, which you can assign to an expression. Por predefinição, a função refere todo o objeto de ação, mas pode especificar opcionalmente uma propriedade cujo valor deseja.By default, the function references the entire action object, but you can optionally specify a property whose value that you want. Para versões abreviadas, consulte actionBody(), actionOutputs()e body().For shorthand versions, see actionBody(), actionOutputs(), and body(). Para a ação em curso, consulte a ação().For the current action, see action().

Nota

Anteriormente, poderia utilizar a função actions() ou o elemento conditions ao especificar que uma ação decorreu com base na saída de outra ação.Previously, you could use the actions() function or the conditions element when specifying that an action ran based on the output from another action. No entanto, para declarar explicitamente dependências entre ações, deve agora usar a propriedade runAfter da ação dependente.However, to declare explicitly dependencies between actions, you must now use the dependent action's runAfter property. Para saber mais sobre a propriedade runAfter, consulte Catch e lide com falhas com a propriedade runAfter.To learn more about the runAfter property, see Catch and handle failures with the runAfter property.

actions('<actionName>')
actions('<actionName>').outputs.body.<property>
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome do objeto de ação cuja saída querThe name for the action object whose output you want
< > de propriedade<property> NãoNo StringString O nome para o imóvel do objeto de ação cujo valor deseja: nome, início, tempo final, inputs, saídas, estado, código, trackingIde clienteTrackingId.The name for the action object's property whose value you want: name, startTime, endTime, inputs, outputs, status, code, trackingId, and clientTrackingId. No portal Azure, pode encontrar estas propriedades revendo detalhes específicos do histórico de execução.In the Azure portal, you can find these properties by reviewing a specific run history's details. Para mais informações, consulte REST API - Workflow Run Actions.For more information, see REST API - Workflow Run Actions.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção de ação<action-output> StringString A saída da ação ou propriedade especificadaThe output from the specified action or property

ExemploExample

Este exemplo obtém o valor status propriedade da ação do Twitter Get user em tempo de execução:This example gets the status property value from the Twitter action Get user at runtime:

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

E devolve este resultado: "Succeeded"And returns this result: "Succeeded"

adicionaradd

Devolva o resultado da adição de dois números.Return the result from adding two numbers.

add(<summand_1>, <summand_2>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<summand_1>, <summand_2><summand_1>, <summand_2> SimYes Inteiro, Flutuador ou MistoInteger, Float, or mixed Os números a adicionarThe numbers to add
Valor de retornoReturn value TipoType DescriçãoDescription
<> de soma de resultados<result-sum> Inteiro ou FlutuadorInteger or Float O resultado da adição dos números especificadosThe result from adding the specified numbers

ExemploExample

Este exemplo adiciona os números especificados:This example adds the specified numbers:

add(1, 1.5)

E devolve este resultado: 2.5And returns this result: 2.5

addDaysaddDays

Adicione alguns dias a uma marca de tempo.Add a number of days to a timestamp.

addDays('<timestamp>', <days>, '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<dias><days> SimYes Número inteiroInteger O número positivo ou negativo de dias a adicionarThe positive or negative number of days to add
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo mais o número especificado de diasThe timestamp plus the specified number of days

Exemplo 1Example 1

Este exemplo adiciona 10 dias ao carimbo de tempo especificado:This example adds 10 days to the specified timestamp:

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

E devolve este resultado: "2018-03-25T00:00:0000000Z"And returns this result: "2018-03-25T00:00:0000000Z"

Exemplo 2Example 2

Este exemplo subtrai cinco dias do carimbo de tempo especificado:This example subtracts five days from the specified timestamp:

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

E devolve este resultado: "2018-03-10T00:00:0000000Z"And returns this result: "2018-03-10T00:00:0000000Z"

addHoursaddHours

Adicione algumas horas a um carimbo temporal.Add a number of hours to a timestamp.

addHours('<timestamp>', <hours>, '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<horas><hours> SimYes Número inteiroInteger O número positivo ou negativo de horas a adicionarThe positive or negative number of hours to add
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo mais o número especificado de horasThe timestamp plus the specified number of hours

Exemplo 1Example 1

Este exemplo adiciona 10 horas ao carimbo de tempo especificado:This example adds 10 hours to the specified timestamp:

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

E devolve este resultado: "2018-03-15T10:00:0000000Z"And returns this result: "2018-03-15T10:00:0000000Z"

Exemplo 2Example 2

Este exemplo subtrai cinco horas do carimbo de tempo especificado:This example subtracts five hours from the specified timestamp:

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

E devolve este resultado: "2018-03-15T10:00:0000000Z"And returns this result: "2018-03-15T10:00:0000000Z"

addMinutesaddMinutes

Adicione alguns minutos a uma marca de tempo.Add a number of minutes to a timestamp.

addMinutes('<timestamp>', <minutes>, '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<minutos><minutes> SimYes Número inteiroInteger O número positivo ou negativo de minutos a adicionarThe positive or negative number of minutes to add
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo mais o número especificado de minutosThe timestamp plus the specified number of minutes

Exemplo 1Example 1

Este exemplo adiciona 10 minutos à marca ção especificada:This example adds 10 minutes to the specified timestamp:

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

E devolve este resultado: "2018-03-15T00:20:00.0000000Z"And returns this result: "2018-03-15T00:20:00.0000000Z"

Exemplo 2Example 2

Este exemplo subtrai cinco minutos da marca ção especificada:This example subtracts five minutes from the specified timestamp:

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

E devolve este resultado: "2018-03-15T00:15:00.0000000Z"And returns this result: "2018-03-15T00:15:00.0000000Z"

adicionarPropriedadeaddProperty

Adicione uma propriedade e o seu valor, ou par de valor de nome, a um objeto JSON, e devolva o objeto atualizado.Add a property and its value, or name-value pair, to a JSON object, and return the updated object. Se a propriedade já existir no tempo de funcionamento, a função falha e lança um erro.If the property already exists at runtime, the function fails and throws an error.

addProperty(<object>, '<property>', <value>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON onde você quer adicionar uma propriedadeThe JSON object where you want to add a property
< > de propriedade<property> SimYes StringString O nome para a propriedade adicionarThe name for the property to add
< > de valor<value> SimYes QualquerAny O valor para o imóvelThe value for the property
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos atualizados<updated-object> ObjectObject O objeto JSON atualizado com a propriedade especificadaThe updated JSON object with the specified property

Para adicionar uma propriedade infantil a uma propriedade existente, use esta sintaxe:To add a child property to an existing property, use this syntax:

addProperty(<object>['<parent-property>'], '<child-property>', <value>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON onde você quer adicionar uma propriedadeThe JSON object where you want to add a property
<> de propriedade-mãe<parent-property> SimYes StringString O nome da propriedade dos pais onde você quer adicionar a propriedade da criançaThe name for parent property where you want to add the child property
<> de propriedade infantil<child-property> SimYes StringString O nome da propriedade da criança para adicionarThe name for the child property to add
< > de valor<value> SimYes QualquerAny O valor a definir para o imóvel especificadoThe value to set for the specified property
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos atualizados<updated-object> ObjectObject O objeto JSON atualizado cuja propriedade você definiuThe updated JSON object whose property you set

Exemplo 1Example 1

Este exemplo adiciona a propriedade middleName a um objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON()This example adds the middleName property to a JSON object, which is converted from a string to JSON by using the JSON() function. O objeto já inclui as propriedades firstName e surName.The object already includes the firstName and surName properties. A função atribui o valor especificado à nova propriedade e devolve o objeto atualizado:The function assigns the specified value to the new property and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

Exemplo 2Example 2

Este exemplo adiciona a propriedade middleName criança à propriedade customerName existente num objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON.This example adds the middleName child property to the existing customerName property in a JSON object, which is converted from a string to JSON by using the JSON() function. A função atribui o valor especificado à nova propriedade e devolve o objeto atualizado:The function assigns the specified value to the new property and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

addSecondsaddSeconds

Adicione alguns segundos a uma marca de tempo.Add a number of seconds to a timestamp.

addSeconds('<timestamp>', <seconds>, '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<segundos><seconds> SimYes Número inteiroInteger O número positivo ou negativo de segundos a adicionarThe positive or negative number of seconds to add
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo mais o número especificado de segundosThe timestamp plus the specified number of seconds

Exemplo 1Example 1

Este exemplo adiciona 10 segundos à marca ção especificada:This example adds 10 seconds to the specified timestamp:

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

E devolve este resultado: "2018-03-15T00:00:10.0000000Z"And returns this result: "2018-03-15T00:00:10.0000000Z"

Exemplo 2Example 2

Este exemplo subtrai cinco segundos para a marca de tempo especificada:This example subtracts five seconds to the specified timestamp:

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

E devolve este resultado: "2018-03-15T00:00:25.0000000Z"And returns this result: "2018-03-15T00:00:25.0000000Z"

addToTimeaddToTime

Adicione várias unidades de tempo a uma marca de tempo.Add a number of time units to a timestamp. Consulte também o FutureTime().See also getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<intervalo><interval> SimYes Número inteiroInteger O número de unidades de tempo especificadas para adicionarThe number of specified time units to add
<> da Unidade de Tempo<timeUnit> SimYes StringString A unidade de tempo para usar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"The unit of time to use with interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo mais o número especificado de unidades de tempoThe timestamp plus the specified number of time units

Exemplo 1Example 1

Este exemplo adiciona um dia à marca de tempo especificada:This example adds one day to the specified timestamp:

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

E devolve este resultado: "2018-01-02T00:00:00.0000000Z"And returns this result: "2018-01-02T00:00:00.0000000Z"

Exemplo 2Example 2

Este exemplo adiciona um dia à marca de tempo especificada:This example adds one day to the specified timestamp:

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

E devolve o resultado usando o formato "D" opcional: "Tuesday, January 2, 2018"And returns the result using the optional "D" format: "Tuesday, January 2, 2018"

eand

Verifique se todas as expressões são verdadeiras.Check whether all expressions are true. Volte a ser verdade quando todas as expressões forem verdadeiras, ou volte a ser falsa quando pelo menos uma expressão é falsa.Return true when all expressions are true, or return false when at least one expression is false.

and(<expression1>, <expression2>, ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<expressão1>, <expression2>, ...<expression1>, <expression2>, ... SimYes BooleanoBoolean As expressões para verificarThe expressions to check
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando todas as expressões forem verdadeiras.Return true when all expressions are true. Volte falso quando pelo menos uma expressão é falsa.Return false when at least one expression is false.

Exemplo 1Example 1

Estes exemplos verificam se os valores booleanos especificados são todos verdadeiros:These examples check whether the specified Boolean values are all true:

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

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: Ambas as expressões são verdadeiras, por isso devolve true.First example: Both expressions are true, so returns true.
  • Segundo exemplo: Uma expressão é falsa, por isso devolve false.Second example: One expression is false, so returns false.
  • Terceiro exemplo: Ambas as expressões são falsas, por isso devolve false.Third example: Both expressions are false, so returns false.

Exemplo 2Example 2

Estes exemplos verificam se as expressões especificadas são todas verdadeiras:These examples check whether the specified expressions are all true:

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:And returns these results:

  • Primeiro exemplo: Ambas as expressões são verdadeiras, por isso devolve true.First example: Both expressions are true, so returns true.
  • Segundo exemplo: Uma expressão é falsa, por isso devolve false.Second example: One expression is false, so returns false.
  • Terceiro exemplo: Ambas as expressões são falsas, por isso devolve false.Third example: Both expressions are false, so returns false.

arrayarray

Devolva uma matriz de uma única entrada especificada.Return an array from a single specified input. Para várias inputs, consulte createArray().For multiple inputs, see createArray().

array('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para criar uma matrizThe string for creating an array
Valor de retornoReturn value TipoType DescriçãoDescription
[<valor>][<value>] ArrayArray Uma matriz que contém a única entrada especificadaAn array that contains the single specified input

ExemploExample

Este exemplo cria uma matriz a partir da corda "olá":This example creates an array from the "hello" string:

array('hello')

E devolve este resultado: ["hello"]And returns this result: ["hello"]

base64base64

Devolva a versão codificada base64 para uma corda.Return the base64-encoded version for a string.

base64('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia de entradaThe input string
Valor de retornoReturn value TipoType DescriçãoDescription
< > de cadeias base64<base64-string> StringString A versão codificada base64 para a cadeia de entradaThe base64-encoded version for the input string

ExemploExample

Este exemplo converte a corda "olá" para uma cadeia codificada base64:This example converts the "hello" string to a base64-encoded string:

base64('hello')

E devolve este resultado: "aGVsbG8="And returns this result: "aGVsbG8="

base64ToBinarybase64ToBinary

Volte a colocar a versão binária numa cadeia codificada com base64.Return the binary version for a base64-encoded string.

base64ToBinary('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia codificada base64 para converterThe base64-encoded string to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<> de cordas binárias para base64<binary-for-base64-string> StringString A versão binária para a cadeia codificada base64The binary version for the base64-encoded string

ExemploExample

Este exemplo converte a cadeia "aGVsbG8=" base64-codificada numa cadeia binária:This example converts the "aGVsbG8=" base64-encoded string to a binary string:

base64ToBinary('aGVsbG8=')

E devolve este resultado:And returns this result:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToStringbase64ToString

Volte a colocar a versão de corda para uma cadeia codificada base64, descodificando eficazmente a cadeia base64.Return the string version for a base64-encoded string, effectively decoding the base64 string. Utilize esta função em vez de descodificarBase64().Use this function rather than decodeBase64(). Embora ambas as funções funcionem da mesma forma, base64ToString() é preferível.Although both functions work the same way, base64ToString() is preferred.

base64ToString('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia codificada base64 para descodificarThe base64-encoded string to decode
Valor de retornoReturn value TipoType DescriçãoDescription
<> de descodificado de base64<decoded-base64-string> StringString A versão de corda para uma cadeia codificada base64The string version for a base64-encoded string

ExemploExample

Este exemplo converte a cadeia "aGVsbG8=" base64 codificada em apenas uma corda:This example converts the "aGVsbG8=" base64-encoded string to just a string:

base64ToString('aGVsbG8=')

E devolve este resultado: "hello"And returns this result: "hello"

binarybinary

Devolva a versão binária por uma corda.Return the binary version for a string.

binary('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para converterThe string to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<> binário-para-input<binary-for-input-value> StringString A versão binária para a corda especificadaThe binary version for the specified string

ExemploExample

Este exemplo converte a corda "olá" para uma corda binária:This example converts the "hello" string to a binary string:

binary('hello')

E devolve este resultado:And returns this result:

"0110100001100101011011000110110001101111"

corpobody

Devolva a saída de body de uma ação no tempo de execução.Return an action's body output at runtime. Abreviatura para actions('<actionName>').outputs.body.Shorthand for actions('<actionName>').outputs.body. Ver actionBody() e ações().See actionBody() and actions().

body('<actionName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome da body saída da ação que você querThe name for the action's body output that you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção corporal<action-body-output> StringString A body saída da ação especificadaThe body output from the specified action

ExemploExample

Este exemplo obtém a body saída da ação do Twitter Get user:This example gets the body output from the Get user Twitter action:

body('Get_user')

E devolve este resultado:And returns this result:

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

boolbool

Devolva a versão Boolean por um valor.Return the Boolean version for a value.

bool(<value>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes QualquerAny O valor para converterThe value to convert
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean A versão Boolean para o valor especificadoThe Boolean version for the specified value

ExemploExample

Estes exemplos convertem os valores especificados em valores booleanos:These examples convert the specified values to Boolean values:

bool(1)
bool(0)

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: falseSecond example: false

coalescecoalesce

Devolva o primeiro valor não nulo de um ou mais parâmetros.Return the first non-null value from one or more parameters. Cordas vazias, matrizes vazias e objetos vazios não são nulos.Empty strings, empty arrays, and empty objects are not null.

coalesce(<object_1>, <object_2>, ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<object_1>, <object_2>, ...<object_1>, <object_2>, ... SimYes Qualquer, pode misturar tiposAny, can mix types Um ou mais itens para verificar se há nulosOne or more items to check for null
Valor de retornoReturn value TipoType DescriçãoDescription
<primeiro item não nulo><first-non-null-item> QualquerAny O primeiro item ou valor que não é nulo.The first item or value that is not null. Se todos os parâmetros forem nulos, esta função devolve-se a nulas.If all parameters are null, this function returns null.

ExemploExample

Estes exemplos devolvem o primeiro valor não nulo dos valores especificados, ou nulos quando todos os valores são nulos:These examples return the first non-null value from the specified values, or null when all the values are null:

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

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: "hello"Second example: "hello"
  • Terceiro exemplo: nullThird example: null

concatconcat

Combine duas ou mais cordas e devolva a corda combinada.Combine two or more strings, and return the combined string.

concat('<text1>', '<text2>', ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<texto1>, <text2>, ...<text1>, <text2>, ... SimYes StringString Pelo menos duas cordas para combinarAt least two strings to combine
Valor de retornoReturn value TipoType DescriçãoDescription
<texto1texto2... ><text1text2...> StringString A cadeia criada a partir das cordas combinadas de entradaThe string created from the combined input strings

ExemploExample

Este exemplo combina as cordas "Olá" e "Mundo":This example combines the strings "Hello" and "World":

concat('Hello', 'World')

E devolve este resultado: "HelloWorld"And returns this result: "HelloWorld"

Contémcontains

Verifique se uma coleção tem um item específico.Check whether a collection has a specific item. Volte a ser verdade quando o artigo for encontrado, ou volte a ser falso quando não for encontrado.Return true when the item is found, or return false when not found. Esta função é sensível ao caso.This function is case-sensitive.

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

Especificamente, esta função funciona nestes tipos de recolha:Specifically, this function works on these collection types:

  • Uma corda para encontrar uma subcordaA string to find a substring
  • Uma matriz para encontrar um valorAn array to find a value
  • Um dicionário para encontrar uma chaveA dictionary to find a key
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda, Matriz ou DicionárioString, Array, or Dictionary A coleção para verificarThe collection to check
< > de valor<value> SimYes String, Array ou Dicionário, respectivamenteString, Array, or Dictionary, respectively O item para encontrarThe item to find
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o artigo for encontrado.Return true when the item is found. Devolver falso quando não for encontrado.Return false when not found.

Exemplo 1Example 1

Este exemplo verifica a corda "hello world" para o substring "mundo" e retorna verdadeira:This example checks the string "hello world" for the substring "world" and returns true:

contains('hello world', 'world')

Exemplo 2Example 2

Este exemplo verifica a corda "hello world" para o substring "universo" e devolve falso:This example checks the string "hello world" for the substring "universe" and returns false:

contains('hello world', 'universe')

convertFromUtcconvertFromUtc

Converta uma marca de tempo da Universal Time Coordenada (UTC) para o fuso horário-alvo.Convert a timestamp from Universal Time Coordinated (UTC) to the target time zone.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<destinoTimeZone><destinationTimeZone> SimYes StringString O nome do fuso horário alvo.The name for the target time zone. Para obter nomes de fusos horários, consulte os valores do Índice do Fuso Horáriodo Microsoft, mas poderá ter de remover qualquer pontuação do nome do fuso horário.For time zone names, see Microsoft Time Zone Index Values, but you might have to remove any punctuation from the time zone name.
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
< > de carimbo saqueado<converted-timestamp> StringString O carimbo de tempo convertido para o fuso horário alvoThe timestamp converted to the target time zone

Exemplo 1Example 1

Este exemplo converte uma marca de tempo para o fuso horário especificado:This example converts a timestamp to the specified time zone:

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

E devolve este resultado: "2018-01-01T00:00:00.0000000"And returns this result: "2018-01-01T00:00:00.0000000"

Exemplo 2Example 2

Este exemplo converte uma marca de tempo para o fuso horário e formato especificados:This example converts a timestamp to the specified time zone and format:

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

E devolve este resultado: "Monday, January 1, 2018"And returns this result: "Monday, January 1, 2018"

convertTimeZoneconvertTimeZone

Converta uma marca de tempo do fuso horário de origem para o fuso horário alvo.Convert a timestamp from the source time zone to the target time zone.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<fonteTimeZone><sourceTimeZone> SimYes StringString O nome do fuso horário de origem.The name for the source time zone. Para obter nomes de fusos horários, consulte os valores do Índice do Fuso Horáriodo Microsoft, mas poderá ter de remover qualquer pontuação do nome do fuso horário.For time zone names, see Microsoft Time Zone Index Values, but you might have to remove any punctuation from the time zone name.
<destinoTimeZone><destinationTimeZone> SimYes StringString O nome do fuso horário alvo.The name for the target time zone. Para obter nomes de fusos horários, consulte os valores do Índice do Fuso Horáriodo Microsoft, mas poderá ter de remover qualquer pontuação do nome do fuso horário.For time zone names, see Microsoft Time Zone Index Values, but you might have to remove any punctuation from the time zone name.
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
< > de carimbo saqueado<converted-timestamp> StringString O carimbo de tempo convertido para o fuso horário alvoThe timestamp converted to the target time zone

Exemplo 1Example 1

Este exemplo converte o fuso horário de origem para o fuso horário alvo:This example converts the source time zone to the target time zone:

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

E devolve este resultado: "2018-01-01T00:00:00.0000000"And returns this result: "2018-01-01T00:00:00.0000000"

Exemplo 2Example 2

Este exemplo converte um fuso horário para o fuso horário e formato especificados:This example converts a time zone to the specified time zone and format:

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

E devolve este resultado: "Monday, January 1, 2018"And returns this result: "Monday, January 1, 2018"

convertToUtcconvertToUtc

Converter uma marca de tempo do fuso horário de origem para Universal Time Coordenado (UTC).Convert a timestamp from the source time zone to Universal Time Coordinated (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<fonteTimeZone><sourceTimeZone> SimYes StringString O nome do fuso horário de origem.The name for the source time zone. Para obter nomes de fusos horários, consulte os valores do Índice do Fuso Horáriodo Microsoft, mas poderá ter de remover qualquer pontuação do nome do fuso horário.For time zone names, see Microsoft Time Zone Index Values, but you might have to remove any punctuation from the time zone name.
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
< > de carimbo saqueado<converted-timestamp> StringString O carimbo de tempo convertido em UTCThe timestamp converted to UTC

Exemplo 1Example 1

Este exemplo converte uma marca de tempo para UTC:This example converts a timestamp to UTC:

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

E devolve este resultado: "2018-01-01T08:00:00.0000000Z"And returns this result: "2018-01-01T08:00:00.0000000Z"

Exemplo 2Example 2

Este exemplo converte uma marca de tempo para UTC:This example converts a timestamp to UTC:

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

E devolve este resultado: "Monday, January 1, 2018"And returns this result: "Monday, January 1, 2018"

createArraycreateArray

Devolva uma matriz de várias inputs.Return an array from multiple inputs. Para uma única dosmina de entrada, consulte a matriz().For single input arrays, see array().

createArray('<object1>', '<object2>', ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<object1>, <object2>, ...<object1>, <object2>, ... SimYes Qualquer, mas não misturadoAny, but not mixed Pelo menos dois itens para criar a matrizAt least two items to create the array
Valor de retornoReturn value TipoType DescriçãoDescription
[<object1>, <object2>, ...][<object1>, <object2>, ...] ArrayArray A matriz criada a partir de todos os itens de entradaThe array created from all the input items

ExemploExample

Este exemplo cria uma matriz a partir destas inputs:This example creates an array from these inputs:

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

E devolve este resultado: ["h", "e", "l", "l", "o"]And returns this result: ["h", "e", "l", "l", "o"]

dataUridataUri

Devolva um identificador de recursos uniforme de dados (URI) para uma cadeia.Return a data uniform resource identifier (URI) for a string.

dataUri('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para converterThe string to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<data-uri><data-uri> StringString Os dados URI para a cadeia de entradaThe data URI for the input string

ExemploExample

Este exemplo cria um URI de dados para a cadeia "olá":This example creates a data URI for the "hello" string:

dataUri('hello')

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

dataUriToBinarydataUriToBinary

Devolva a versão binária para um identificador de recursos uniforme de dados (URI).Return the binary version for a data uniform resource identifier (URI). Utilize esta função em vez de descodificarDataUri().Use this function rather than decodeDataUri(). Embora ambas as funções funcionem da mesma forma, dataUriBinary() é preferível.Although both functions work the same way, dataUriBinary() is preferred.

dataUriToBinary('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString Os dados URI para converterThe data URI to convert
Valor de retornoReturn value TipoType DescriçãoDescription
< > binária-para-dados-uri<binary-for-data-uri> StringString A versão binária para os dados URIThe binary version for the data URI

ExemploExample

Este exemplo cria uma versão binária para estes dados URI:This example creates a binary version for this data URI:

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

E devolve este resultado:And returns this result:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToStringdataUriToString

Devolva a versão de cadeia para um identificador de recursos uniforme de dados (URI).Return the string version for a data uniform resource identifier (URI).

dataUriToString('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString Os dados URI para converterThe data URI to convert
Valor de retornoReturn value TipoType DescriçãoDescription
< > de cordas para dados-uri<string-for-data-uri> StringString A versão de cadeia para os dados URIThe string version for the data URI

ExemploExample

Este exemplo cria uma cadeia para estes dados URI:This example creates a string for this data URI:

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

E devolve este resultado: "hello"And returns this result: "hello"

dayOfMonthdayOfMonth

Volte o dia do mês de uma marca de tempo.Return the day of the month from a timestamp.

dayOfMonth('<timestamp>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
Valor de retornoReturn value TipoType DescriçãoDescription
< > do dia do mês<day-of-month> Número inteiroInteger O dia do mês a partir do carimbo de tempo especificadoThe day of the month from the specified timestamp

ExemploExample

Este exemplo devolve o número do dia do mês a partir deste carimbo temporal:This example returns the number for the day of the month from this timestamp:

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

E devolve este resultado: 15And returns this result: 15

dayOfWeekdayOfWeek

Volte o dia da semana de uma marca de tempo.Return the day of the week from a timestamp.

dayOfWeek('<timestamp>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
Valor de retornoReturn value TipoType DescriçãoDescription
< > do dia-a-dia<day-of-week> Número inteiroInteger O dia da semana a partir do carimbo de tempo especificado onde domingo é 0, segunda-feira é 1, e assim por dianteThe day of the week from the specified timestamp where Sunday is 0, Monday is 1, and so on

ExemploExample

Este exemplo devolve o número para o dia da semana a partir deste carimbo temporal:This example returns the number for the day of the week from this timestamp:

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

E devolve este resultado: 3And returns this result: 3

dayOfYeardayOfYear

Volte o dia do ano de uma marca de tempo.Return the day of the year from a timestamp.

dayOfYear('<timestamp>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
Valor de retornoReturn value TipoType DescriçãoDescription
<dia-a-dia><day-of-year> Número inteiroInteger O dia do ano a partir do carimbo de tempo especificadoThe day of the year from the specified timestamp

ExemploExample

Este exemplo devolve o número do dia do ano a partir deste carimbo temporal:This example returns the number of the day of the year from this timestamp:

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

E devolve este resultado: 74And returns this result: 74

decodeBase64decodeBase64

Volte a colocar a versão de corda para uma cadeia codificada base64, descodificando eficazmente a cadeia base64.Return the string version for a base64-encoded string, effectively decoding the base64 string. Considere utilizar base64ToString() em vez de decodeBase64().Consider using base64ToString() rather than decodeBase64(). Embora ambas as funções funcionem da mesma forma, base64ToString() é preferível.Although both functions work the same way, base64ToString() is preferred.

decodeBase64('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia codificada base64 para descodificarThe base64-encoded string to decode
Valor de retornoReturn value TipoType DescriçãoDescription
<> de descodificado de base64<decoded-base64-string> StringString A versão de corda para uma cadeia codificada base64The string version for a base64-encoded string

ExemploExample

Este exemplo cria uma cadeia para uma cadeia codificada base64:This example creates a string for a base64-encoded string:

decodeBase64('aGVsbG8=')

E devolve este resultado: "hello"And returns this result: "hello"

decodeDataUridecodeDataUri

Devolva a versão binária para um identificador de recursos uniforme de dados (URI).Return the binary version for a data uniform resource identifier (URI). Considere utilizar dadosUriToBinary() ()em vez de decodeDataUri().Consider using dataUriToBinary(), rather than decodeDataUri(). Embora ambas as funções funcionem da mesma forma, dataUriToBinary() é preferível.Although both functions work the same way, dataUriToBinary() is preferred.

decodeDataUri('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia URI de dados para descodificarThe data URI string to decode
Valor de retornoReturn value TipoType DescriçãoDescription
< > binária-para-dados-uri<binary-for-data-uri> StringString A versão binária para uma cadeia URI de dadosThe binary version for a data URI string

ExemploExample

Este exemplo devolve a versão binária para estes dados URI:This example returns the binary version for this data URI:

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

E devolve este resultado:And returns this result:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponentdecodeUriComponent

Volte a colocar uma corda que substitua caracteres de fuga por versões descodificadas.Return a string that replaces escape characters with decoded versions.

decodeUriComponent('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda com os personagens de fuga para descodificarThe string with the escape characters to decode
Valor de retornoReturn value TipoType DescriçãoDescription
<> descodificado-uri<decoded-uri> StringString A cadeia atualizada com os caracteres de fuga descodificadosThe updated string with the decoded escape characters

ExemploExample

Este exemplo substitui os caracteres de fuga nesta cadeia por versões descodificadas:This example replaces the escape characters in this string with decoded versions:

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

E devolve este resultado: "https://contoso.com"And returns this result: "https://contoso.com"

divdiv

Devolva o resultado inteiro da divisão de dois números.Return the integer result from dividing two numbers. Para obter o resultado remanescente, consulte mod().To get the remainder result, see mod().

div(<dividend>, <divisor>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<> de dividendos<dividend> SimYes Inteiro ou FlutuadorInteger or Float O número a dividir pelo divisorThe number to divide by the divisor
< > divisor<divisor> SimYes Inteiro ou FlutuadorInteger or Float O número que divide o dividendo, mas não pode ser 0The number that divides the dividend, but cannot be 0
Valor de retornoReturn value TipoType DescriçãoDescription
<> de resultado sinuoso<quotient-result> Número inteiroInteger O resultado inteiro de dividir o primeiro número pelo segundo númeroThe integer result from dividing the first number by the second number

ExemploExample

Ambos os exemplos dividem o primeiro número pelo segundo número:Both examples divide the first number by the second number:

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

E devolva este resultado: 2And return this result: 2

encodeUriComponentencodeUriComponent

Volte a colocar uma versão codificada por um identificador de recursos uniforme (URI) para uma cadeia, substituindo caracteres inseguros de URL por caracteres de fuga.Return a uniform resource identifier (URI) encoded version for a string by replacing URL-unsafe characters with escape characters. Considere utilizar uriComponent()em vez de encodeUriComponent().Consider using uriComponent(), rather than encodeUriComponent(). Embora ambas as funções funcionem da mesma forma, uriComponent() é preferível.Although both functions work the same way, uriComponent() is preferred.

encodeUriComponent('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para converter em formato codificado por URIThe string to convert to URI-encoded format
Valor de retornoReturn value TipoType DescriçãoDescription
<codificado-uri><encoded-uri> StringString A corda codificada uri com caracteres de fugaThe URI-encoded string with escape characters

ExemploExample

Este exemplo cria uma versão codificada por URI para esta cadeia:This example creates a URI-encoded version for this string:

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

E devolve este resultado: "http%3A%2F%2Fcontoso.com"And returns this result: "http%3A%2F%2Fcontoso.com"

vazioempty

Verifique se uma coleção está vazia.Check whether a collection is empty. Volte a ser verdade quando a coleção estiver vazia, ou volte a ser falsa quando não estiver vazia.Return true when the collection is empty, or return false when not empty.

empty('<collection>')
empty([<collection>])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda, Matriz ou ObjetoString, Array, or Object A coleção para verificarThe collection to check
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando a coleção estiver vazia.Return true when the collection is empty. Volte falso quando não estiver vazio.Return false when not empty.

ExemploExample

Estes exemplos verificam se as coleções especificadas estão vazias:These examples check whether the specified collections are empty:

empty('')
empty('abc')

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: Passa uma corda vazia, para que a função retorne true.First example: Passes an empty string, so the function returns true.
  • Segundo exemplo: Passa a corda "abc", para que a função retorne false.Second example: Passes the string "abc", so the function returns false.

endsWithendsWith

Verifique se uma corda termina com um substring específico.Check whether a string ends with a specific substring. Volte a ser verdade quando o substring for encontrado, ou volte a ser falso quando não for encontrado.Return true when the substring is found, or return false when not found. Esta função não é sensível a casos.This function is not case-sensitive.

endsWith('<text>', '<searchText>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda para verificarThe string to check
<pesquisaTexto><searchText> SimYes StringString O substring final para encontrarThe ending substring to find
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o substring final for encontrado.Return true when the ending substring is found. Devolver falso quando não for encontrado.Return false when not found.

Exemplo 1Example 1

Este exemplo verifica se a corda "hello world" termina com a corda "mundo":This example checks whether the "hello world" string ends with the "world" string:

endsWith('hello world', 'world')

E devolve este resultado: trueAnd returns this result: true

Exemplo 2Example 2

Este exemplo verifica se a corda "hello world" termina com a corda "universo":This example checks whether the "hello world" string ends with the "universe" string:

endsWith('hello world', 'universe')

E devolve este resultado: falseAnd returns this result: false

é igual aequals

Verifique se ambos os valores, expressões ou objetos são equivalentes.Check whether both values, expressions, or objects are equivalent. Volte a ser verdade quando ambos são equivalentes, ou devolva falsoquando não são equivalentes.Return true when both are equivalent, or return false when they're not equivalent.

equals('<object1>', '<object2>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<object1>, <objeto2><object1>, <object2> SimYes VáriosVarious Os valores, expressões ou objetos para compararThe values, expressions, or objects to compare
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando ambos são equivalentes.Return true when both are equivalent. Devolver falso quando não equivalente.Return false when not equivalent.

ExemploExample

Estes exemplos verificam se as inputs especificadas são equivalentes.These examples check whether the specified inputs are equivalent.

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

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: Ambos os valores são equivalentes, pelo que a função retorna true.First example: Both values are equivalent, so the function returns true.
  • Segundo exemplo: Ambos os valores não são equivalentes, pelo que a função retorna false.Second example: Both values aren't equivalent, so the function returns false.

primeirofirst

Volte a devolver o primeiro item de uma corda ou matriz.Return the first item from a string or array.

first('<collection>')
first([<collection>])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda ou MatrizString or Array A coleção onde encontrar o primeiro itemThe collection where to find the first item
Valor de retornoReturn value TipoType DescriçãoDescription
<primeiro item><first-collection-item> QualquerAny O primeiro item da coleçãoThe first item in the collection

ExemploExample

Estes exemplos encontram o primeiro item nestas coleções:These examples find the first item in these collections:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: "h"First example: "h"
  • Segundo exemplo: 0Second example: 0

floatfloat

Converta uma versão de corda para um número de ponto flutuante para um número de ponto flutuante real.Convert a string version for a floating-point number to an actual floating point number. Só pode utilizar esta função ao passar parâmetros personalizados para uma aplicação, por exemplo, uma aplicação lógica ou fluxo.You can use this function only when passing custom parameters to an app, for example, a logic app or flow.

float('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda que tem um número de ponto flutuante válido para converterThe string that has a valid floating-point number to convert
Valor de retornoReturn value TipoType DescriçãoDescription
> de <de valor flutuante<float-value> FloatFloat O número de ponto flutuante para a corda especificadaThe floating-point number for the specified string

ExemploExample

Este exemplo cria uma versão de cadeia para este número de ponto flutuante:This example creates a string version for this floating-point number:

float('10.333')

E devolve este resultado: 10.333And returns this result: 10.333

formatDateTimeformatDateTime

Devolva uma marca de tempo no formato especificado.Return a timestamp in the specified format.

formatDateTime('<timestamp>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
< > de carimbo seleto<reformatted-timestamp> StringString A marca de tempo atualizada no formato especificadoThe updated timestamp in the specified format

ExemploExample

Este exemplo converte uma marca de tempo para o formato especificado:This example converts a timestamp to the specified format:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

E devolve este resultado: "2018-03-15T12:00:00"And returns this result: "2018-03-15T12:00:00"

formDataMultiValuesformDataMultiValues

Devolva uma matriz com valores que correspondam a um nome chave nos dados de formulário de uma ação ou na saída codificada pelo formulário.Return an array with values that match a key name in an action's form-data or form-encoded output.

formDataMultiValues('<actionName>', '<key>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString A ação cuja saída tem o valor-chave que desejaThe action whose output has the key value you want
< > chave<key> SimYes StringString O nome da chave cujo valor querThe name for the key whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
[<array-with-key-values>][<array-with-key-values>] ArrayArray Uma matriz com todos os valores que correspondem à chave especificadaAn array with all the values that match the specified key

ExemploExample

Este exemplo cria uma matriz a partir do valor da chave "Sujeito" nos dados de formulário da ação especificada ou na saída codificada pelo formulário:This example creates an array from the "Subject" key's value in the specified action's form-data or form-encoded output:

formDataMultiValues('Send_an_email', 'Subject')

E devolve o texto do assunto numa matriz, por exemplo: ["Hello world"]And returns the subject text in an array, for example: ["Hello world"]

formDataValueformDataValue

Devolva um único valor que corresponda a um nome-chave nos dados de formulário de uma ação ou na saída codificada pelo formulário.Return a single value that matches a key name in an action's form-data or form-encoded output. Se a função encontrar mais de um fósforo, a função lança um erro.If the function finds more than one match, the function throws an error.

formDataValue('<actionName>', '<key>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString A ação cuja saída tem o valor-chave que desejaThe action whose output has the key value you want
< > chave<key> SimYes StringString O nome da chave cujo valor querThe name for the key whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor-chave<key-value> StringString O valor na chave especificadaThe value in the specified key

ExemploExample

Este exemplo cria uma cadeia a partir do valor da chave "Sujeito" nos dados de formulário da ação especificada ou na saída codificada pelo formulário:This example creates a string from the "Subject" key's value in the specified action's form-data or form-encoded output:

formDataValue('Send_an_email', 'Subject')

E devolve o texto do assunto como uma corda, por exemplo: "Hello world"And returns the subject text as a string, for example: "Hello world"

formatoNúmeroformatNumber

Volte a devolver um número como uma corda baseada no formato especificado.Return a number as a string that's based on the specified format.

formatNumber(<number>, <format>, <locale>?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<número><number> SimYes Inteiro ou DuploInteger or Double O valor que quer formatar.The value that you want to format.
> de formato <<format> SimYes StringString Uma cadeia de formato composto que especifica o formato que pretende utilizar.A composite format string that specifies the format that you want to use. Para as cordas de formato numérico suportadas, consulte as cordas de formato numérico Standard,que são suportadas por number.ToString(<format>, <locale>).For the supported numeric format strings, see Standard numeric format strings, which are supported by number.ToString(<format>, <locale>).
<> local<locale> NãoNo StringString O local a usar como apoiado por number.ToString(<format>, <locale>).The locale to use as supported by number.ToString(<format>, <locale>). Se não especificado, o valor predefinido é en-us.If not specified, the default value is en-us.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de número formatado<formatted-number> StringString O número especificado como uma cadeia no formato que especificou.The specified number as a string in the format that you specified. Pode lançar este valor de devolução a um int ou float.You can cast this return value to an int or float.

Exemplo 1Example 1

Suponha que queira formatar o número 1234567890.Suppose that you want to format the number 1234567890. Este exemplo formata esse número como a corda "1.234.567.890,00".This example formats that number as the string "1,234,567,890.00".

formatNumber(1234567890, '{0:0,0.00}', 'en-us')

*Exemplo 2"*Example 2"

Suponha que queira formatar o número 1234567890.Suppose that you want to format the number 1234567890. Este exemplo formata o número para a corda "1.234.567.890,00".This example formats the number to the string "1.234.567.890,00".

formatNumber(1234567890, '{0:0,0.00}', 'is-is')

Exemplo 3Example 3

Suponha que queira formatar o número 17.35.Suppose that you want to format the number 17.35. Este exemplo formata o número para a corda "$17.35".This example formats the number to the string "$17.35".

formatNumber(17.36, 'C2')

Exemplo 4Example 4

Suponha que queira formatar o número 17.35.Suppose that you want to format the number 17.35. Este exemplo formata o número para a corda "17,35 kr".This example formats the number to the string "17,35 kr".

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

getFutureTimegetFutureTime

Volte a colocar a marca atual mais as unidades de tempo especificadas.Return the current timestamp plus the specified time units.

getFutureTime(<interval>, <timeUnit>, <format>?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<intervalo><interval> SimYes Número inteiroInteger O número de unidades de tempo especificadas para adicionarThe number of specified time units to add
<> da Unidade de Tempo<timeUnit> SimYes StringString A unidade de tempo para usar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"The unit of time to use with interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString O carimbo de tempo atual mais o número especificado de unidades de tempoThe current timestamp plus the specified number of time units

Exemplo 1Example 1

Suponha que o atual carimbo temporal é "2018-03-01T00:00.00.00000000Z".Suppose the current timestamp is "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias a essa marca de tempo:This example adds five days to that timestamp:

getFutureTime(5, 'Day')

E devolve este resultado: "2018-03-06T00:00:00.0000000Z"And returns this result: "2018-03-06T00:00:00.0000000Z"

Exemplo 2Example 2

Suponha que o atual carimbo temporal é "2018-03-01T00:00.00.00000000Z".Suppose the current timestamp is "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias e converte o resultado em formato "D":This example adds five days and converts the result to "D" format:

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

E devolve este resultado: "Tuesday, March 6, 2018"And returns this result: "Tuesday, March 6, 2018"

getPastTimegetPastTime

Volte a colocar a marca atual menos as unidades de tempo especificadas.Return the current timestamp minus the specified time units.

getPastTime(<interval>, <timeUnit>, <format>?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<intervalo><interval> SimYes Número inteiroInteger O número de unidades de tempo especificadas para subtrairThe number of specified time units to subtract
<> da Unidade de Tempo<timeUnit> SimYes StringString A unidade de tempo para usar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"The unit of time to use with interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString O carimbo de tempo atual menos o número especificado de unidades de tempoThe current timestamp minus the specified number of time units

Exemplo 1Example 1

Suponha que o atual carimbo temporal é "2018-02-01T00:00.00.00000000Z".Suppose the current timestamp is "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias a partir desse carimbo temporal:This example subtracts five days from that timestamp:

getPastTime(5, 'Day')

E devolve este resultado: "2018-01-27T00:00:00.0000000Z"And returns this result: "2018-01-27T00:00:00.0000000Z"

Exemplo 2Example 2

Suponha que o atual carimbo temporal é "2018-02-01T00:00.00.00000000Z".Suppose the current timestamp is "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias e converte o resultado em formato "D":This example subtracts five days and converts the result to "D" format:

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

E devolve este resultado: "Saturday, January 27, 2018"And returns this result: "Saturday, January 27, 2018"

maiorgreater

Verifique se o primeiro valor é superior ao segundo valor.Check whether the first value is greater than the second value. Volte a ser verdade quando o primeiro valor for mais, ou volte a ser falso quando menos.Return true when the first value is more, or return false when less.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes Inteiro, Flutuador ou CordaInteger, Float, or String O primeiro valor para verificar se maior do que o segundo valorThe first value to check whether greater than the second value
<comparaM><compareTo> SimYes Inteiro, Flutuador ou Corda, respectivamenteInteger, Float, or String, respectively O valor de comparaçãoThe comparison value
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o primeiro valor é maior que o segundo valor.Return true when the first value is greater than the second value. Devolver falso quando o primeiro valor for igual ou inferior ao segundo valor.Return false when the first value is equal to or less than the second value.

ExemploExample

Estes exemplos verificam se o primeiro valor é superior ao segundo valor:These examples check whether the first value is greater than the second value:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: falseSecond example: false

greaterOrEqualsgreaterOrEquals

Verifique se o primeiro valor é maior ou igual ao segundo valor.Check whether the first value is greater than or equal to the second value. Volte a ser verdade quando o primeiro valor for maior ou igual, ou volte a ser falso quando o primeiro valor for menor.Return true when the first value is greater or equal, or return false when the first value is less.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes Inteiro, Flutuador ou CordaInteger, Float, or String O primeiro valor para verificar se maior ou igual ao segundo valorThe first value to check whether greater than or equal to the second value
<comparaM><compareTo> SimYes Inteiro, Flutuador ou Corda, respectivamenteInteger, Float, or String, respectively O valor de comparaçãoThe comparison value
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o primeiro valor for maior ou igual ao segundo valor.Return true when the first value is greater than or equal to the second value. Devolver falso quando o primeiro valor for inferior ao segundo valor.Return false when the first value is less than the second value.

ExemploExample

Estes exemplos verificam se o primeiro valor é maior ou igual ao segundo valor:These examples check whether the first value is greater or equal than the second value:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: falseSecond example: false

guidguid

Gerar um identificador globalmente único (GUID) como uma corda, por exemplo, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":Generate a globally unique identifier (GUID) as a string, for example, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Além disso, pode especificar um formato diferente para o GUID que não seja o formato predefinido, "D", que é de 32 dígitos separados por hífenes.Also, you can specify a different format for the GUID other than the default format, "D", which is 32 digits separated by hyphens.

guid('<format>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de formato <<format> NãoNo StringString Um único especificador de formato para o GUID devolvido.A single format specifier for the returned GUID. Por padrão, o formato é "D", mas pode utilizar "N", "D", "B", "P" ou "X".By default, the format is "D", but you can use "N", "D", "B", "P", or "X".
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor GUID<GUID-value> StringString Um GUID gerado aleatoriamenteA randomly generated GUID

ExemploExample

Este exemplo gera o mesmo GUID, mas como 32 dígitos, separados por hífenes, e fechados em parênteses:This example generates the same GUID, but as 32 digits, separated by hyphens, and enclosed in parentheses:

guid('P')

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

seif

Verifique se uma expressão é verdadeira ou falsa.Check whether an expression is true or false. Com base no resultado, devolva um valor especificado.Based on the result, return a specified value.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<expressão><expression> SimYes BooleanoBoolean A expressão para verificarThe expression to check
valor <IfTrue><valueIfTrue> SimYes QualquerAny O valor a devolver quando a expressão é verdadeiraThe value to return when the expression is true
<valorIfFalse><valueIfFalse> SimYes QualquerAny O valor a devolver quando a expressão é falsaThe value to return when the expression is false
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de retorno especificado<specified-return-value> QualquerAny O valor especificado que retorna com base em se a expressão é verdadeira ou falsaThe specified value that returns based on whether the expression is true or false

ExemploExample

Este exemplo devolve "yes" porque a expressão especificada retorna verdadeiramente.This example returns "yes" because the specified expression returns true. Caso contrário, o exemplo retorna "no":Otherwise, the example returns "no":

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

indexOfindexOf

Volte a colocar a posição inicial ou o valor do índice para um substring.Return the starting position or index value for a substring. Esta função não é sensível a casos, e os índices começam com o número 0.This function is not case-sensitive, and indexes start with the number 0.

indexOf('<text>', '<searchText>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda que tem o substring para encontrarThe string that has the substring to find
<pesquisaTexto><searchText> SimYes StringString O substring para encontrarThe substring to find
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor do índice<index-value> Número inteiroInteger A posição inicial ou o valor do índice para o substring especificado.The starting position or index value for the specified substring.

Se a corda não for encontrada, devolva o número -1.If the string is not found, return the number -1.

ExemploExample

Este exemplo encontra o valor do índice inicial para o substring "mundo" na cadeia "hello world":This example finds the starting index value for the "world" substring in the "hello world" string:

indexOf('hello world', 'world')

E devolve este resultado: 6And returns this result: 6

intint

Devolva a versão inteiro para uma corda.Return the integer version for a string.

int('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para converterThe string to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<> resultado inteiro<integer-result> Número inteiroInteger A versão inteiro para a corda especificadaThe integer version for the specified string

ExemploExample

Este exemplo cria uma versão inteiro para a corda "10":This example creates an integer version for the string "10":

int('10')

E devolve este resultado: 10And returns this result: 10

itemitem

Quando utilizado dentro de uma ação de repetição sobre uma matriz, devolva o item atual na matriz durante a iteração atual da ação.When used inside a repeating action over an array, return the current item in the array during the action's current iteration. Também pode obter os valores das propriedades desse item.You can also get the values from that item's properties.

item()
Valor de retornoReturn value TipoType DescriçãoDescription
<> de de matriz de corrente<current-array-item> QualquerAny O item atual na matriz para a iteração atual da açãoThe current item in the array for the action's current iteration

ExemploExample

Este exemplo obtém o elemento body da mensagem atual para a ação "Send_an_email" dentro da iteração atual de cada loop:This example gets the body element from the current message for the "Send_an_email" action inside a for-each loop's current iteration:

item().body

itemsitems

Volte a colocar o item atual de cada ciclo num ciclo para cada ciclo.Return the current item from each cycle in a for-each loop. Utilize esta função dentro do laço para cada um.Use this function inside the for-each loop.

items('<loopName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<loopName><loopName> SimYes StringString O nome para cada loopThe name for the for-each loop
Valor de retornoReturn value TipoType DescriçãoDescription
< > de artigos<item> QualquerAny O item do ciclo atual no laço especificado para cadaThe item from the current cycle in the specified for-each loop

ExemploExample

Este exemplo obtém o item atual do circuito especificado para cada loop:This example gets the current item from the specified for-each loop:

items('myForEachLoopName')

iteraçõesIndexesiterationIndexes

Volte a colocar o valor do índice para a iteração atual dentro de um loop Until.Return the index value for the current iteration inside an Until loop. Pode utilizar esta função dentro de aninhados até os laços.You can use this function inside nested Until loops.

iterationIndexes('<loopName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<loopName><loopName> SimYes StringString O nome para o loop UntilThe name for the Until loop
Valor de retornoReturn value TipoType DescriçãoDescription
> do índice <<index> Número inteiroInteger O valor do índice para a iteração atual dentro do circuito especificado Até ao loopThe index value for the current iteration inside the specified Until loop

ExemploExample

Este exemplo cria uma contra variável e incrementos que variáveis por um durante cada iteração em loop Until até que o valor de contador atinja cinco.This example creates a counter variable and increments that variable by one during each iteration in an Until loop until the counter value reaches five. O exemplo também cria uma variável que acompanha o índice atual para cada iteração.The example also creates a variable that tracks the current index for each iteration. No lacete Until, durante cada iteração, o exemplo incrementa o contador e atribui o valor de contador ao valor do índice atual e, em seguida, incrementa o contador.In the Until loop, during each iteration, the example increments the counter and then assigns the counter value to the current index value and then increments the counter. A qualquer momento, pode determinar o número atual de iteração recuperando o valor atual do índice.At any time, you can determine the current iteration number by retrieving the current index value.

{
   "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": {
         "type": "Until",
         "actions": {
            "Assign_current_index_to_counter": {
               "type": "SetVariable",
               "inputs": {
                  "name": "myCurrentLoopIndex",
                  "value": "@variables('myCounter')"
               },
               "runAfter": {
                  "Increment_variable": [ "Succeeded" ]
               }
            },
            "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" ]
         }
      }
   }
}

jsonjson

Devolva o valor ou objeto do tipo JavaScript Object (JSON) para uma corda ou XML.Return the JavaScript Object Notation (JSON) type value or object for a string or XML.

json('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes Corda ou XMLString or XML A corda ou XML para converterThe string or XML to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<> resultado jSON<JSON-result> Tipo ou objeto nativo JSONJSON native type or object O valor ou objeto do tipo nativo JSON para a corda especificada ou XML.The JSON native type value or object for the specified string or XML. Se a corda for nula, a função devolve um objeto vazio.If the string is null, the function returns an empty object.

Exemplo 1Example 1

Este exemplo converte esta cadeia para o valor JSON:This example converts this string to the JSON value:

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

E devolve este resultado: [1, 2, 3]And returns this result: [1, 2, 3]

Exemplo 2Example 2

Este exemplo converte esta cadeia para JSON:This example converts this string to JSON:

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

E devolve este resultado:And returns this result:

{
  "fullName": "Sophia Owen"
}

Exemplo 3Example 3

Este exemplo converte este XML em JSON:This example converts this XML to JSON:

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

E devolve este resultado:And returns this result:

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

cruzamentointersection

Devolva uma coleção que tenha apenas os itens comuns nas coleções especificadas.Return a collection that has only the common items across the specified collections. Para aparecer no resultado, deve aparecer um item em todas as coleções passadas para esta função.To appear in the result, an item must appear in all the collections passed to this function. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparece no resultado.If one or more items have the same name, the last item with that name appears in the result.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<collection1>, <collection2>, ...<collection1>, <collection2>, ... SimYes Matriz ou Objeto, mas não ambosArray or Object, but not both As coleções de onde você quer apenas os itens comunsThe collections from where you want only the common items
Valor de retornoReturn value TipoType DescriçãoDescription
<itens comuns><common-items> Matriz ou Objeto, respectivamenteArray or Object, respectively Uma coleção que tem apenas os itens comuns em todas as coleções especificadasA collection that has only the common items across the specified collections

ExemploExample

Este exemplo encontra os itens comuns através destas matrizes:This example finds the common items across these arrays:

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

E devolve uma matriz apenas com estes itens: [1, 2]And returns an array with only these items: [1, 2]

aderirjoin

Volte a colocar uma corda que tenha todos os itens de uma matriz e tenha cada personagem separado por um delimitador.Return a string that has all the items from an array and has each character separated by a delimiter.

join([<collection>], '<delimiter>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes ArrayArray A matriz que tem os itens para se juntarThe array that has the items to join
<> delimitador<delimiter> SimYes StringString O separador que aparece entre cada personagem na corda resultanteThe separator that appears between each character in the resulting string
Valor de retornoReturn value TipoType DescriçãoDescription
<char1><delimitador><char2><delimiter>...<char1><delimiter><char2><delimiter>... StringString A cadeia resultante criada a partir de todos os itens na matriz especificadaThe resulting string created from all the items in the specified array

ExemploExample

Este exemplo cria uma cadeia de todos os itens desta matriz com o caráter especificado como delimitador:This example creates a string from all the items in this array with the specified character as the delimiter:

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

E devolve este resultado: "a.b.c"And returns this result: "a.b.c"

últimalast

Devolva o último item de uma coleção.Return the last item from a collection.

last('<collection>')
last([<collection>])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda ou MatrizString or Array A coleção onde encontrar o último itemThe collection where to find the last item
Valor de retornoReturn value TipoType DescriçãoDescription
<último item de recolha><last-collection-item> String ou Array, respectivamenteString or Array, respectively O último item da coleçãoThe last item in the collection

ExemploExample

Estes exemplos encontram o último item nestas coleções:These examples find the last item in these collections:

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

E devolve estes resultados:And returns these results:

  • Primeiro exemplo: "d"First example: "d"
  • Segundo exemplo: 3Second example: 3

lastIndexOflastIndexOf

Volte a colocar a posição inicial ou o valor do índice para a última ocorrência de um substring.Return the starting position or index value for the last occurrence of a substring. Esta função não é sensível a casos, e os índices começam com o número 0.This function is not case-sensitive, and indexes start with the number 0.

lastIndexOf('<text>', '<searchText>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda que tem o substring para encontrarThe string that has the substring to find
<pesquisaTexto><searchText> SimYes StringString O substring para encontrarThe substring to find
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor final do índice<ending-index-value> Número inteiroInteger A posição inicial ou o valor do índice para a última ocorrência do substring especificado.The starting position or index value for the last occurrence of the specified substring.

Se a corda não for encontrada, devolva o número -1.If the string is not found, return the number -1.

ExemploExample

Este exemplo encontra o valor do índice inicial para a última ocorrência do substring "mundo" na cadeia "hello world":This example finds the starting index value for the last occurrence of the "world" substring in the "hello world" string:

lastIndexOf('hello world', 'world')

E devolve este resultado: 6And returns this result: 6

lengthlength

Devolva o número de artigos numa coleção.Return the number of items in a collection.

length('<collection>')
length([<collection>])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda ou MatrizString or Array A coleção com os itens para contarThe collection with the items to count
Valor de retornoReturn value TipoType DescriçãoDescription
< > de comprimento ou contagem<length-or-count> Número inteiroInteger O número de itens na coleçãoThe number of items in the collection

ExemploExample

Estes exemplos contam o número de itens nestas coleções:These examples count the number of items in these collections:

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

E devolva este resultado: 4And return this result: 4

menosless

Verifique se o primeiro valor é inferior ao segundo valor.Check whether the first value is less than the second value. Volte a ser verdade quando o primeiro valor for menor, ou volte a ser falso quando o primeiro valor for mais.Return true when the first value is less, or return false when the first value is more.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes Inteiro, Flutuador ou CordaInteger, Float, or String O primeiro valor para verificar se menos do que o segundo valorThe first value to check whether less than the second value
<comparaM><compareTo> SimYes Inteiro, Flutuador ou Corda, respectivamenteInteger, Float, or String, respectively O item de comparaçãoThe comparison item
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o primeiro valor for inferior ao segundo valor.Return true when the first value is less than the second value. Devolver falso quando o primeiro valor for igual ou superior ao segundo valor.Return false when the first value is equal to or greater than the second value.

ExemploExample

Estes exemplos verificam se o primeiro valor é inferior ao segundo valor.These examples check whether the first value is less than the second value.

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: falseSecond example: false

lessOrEqualslessOrEquals

Verifique se o primeiro valor é inferior ou igual ao segundo valor.Check whether the first value is less than or equal to the second value. Volte a ser verdade quando o primeiro valor for inferior ou igual, ou volte a ser falso quando o primeiro valor for mais.Return true when the first value is less than or equal, or return false when the first value is more.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes Inteiro, Flutuador ou CordaInteger, Float, or String O primeiro valor para verificar se menos ou igual ao segundo valorThe first value to check whether less than or equal to the second value
<comparaM><compareTo> SimYes Inteiro, Flutuador ou Corda, respectivamenteInteger, Float, or String, respectively O item de comparaçãoThe comparison item
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o primeiro valor for inferior ou igual ao segundo valor.Return true when the first value is less than or equal to the second value. Devolver falso quando o primeiro valor for maior do que o segundo valor.Return false when the first value is greater than the second value.

ExemploExample

Estes exemplos verificam se o primeiro valor é inferior ou igual ao segundo valor.These examples check whether the first value is less or equal than the second value.

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: trueFirst example: true
  • Segundo exemplo: falseSecond example: false

listCallbackUrllistCallbackUrl

Devolva o "URL de chamada" que chama um gatilho ou ação.Return the "callback URL" that calls a trigger or action. Esta função funciona apenas com gatilhos e ações para os tipos de conector HttpWebhook e ApiConnectionWebhook, mas não com os tipos Manual, Recurrence, HTTPe APIConnection.This function works only with triggers and actions for the HttpWebhook and ApiConnectionWebhook connector types, but not the Manual, Recurrence, HTTP, and APIConnection types.

listCallbackUrl()
Valor de retornoReturn value TipoType DescriçãoDescription
<> de callback-URL<callback-URL> StringString O URL de callback para um gatilho ou açãoThe callback URL for a trigger or action

ExemploExample

Este exemplo mostra um URL de chamada de amostra que esta função pode devolver:This example shows a sample callback URL that this function might return:

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

máxmax

Devolva o valor mais alto de uma lista ou matriz com números que são inclusivos em ambas as extremidades.Return the highest value from a list or array with numbers that is inclusive at both ends.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<número1>, <número2>, ...<number1>, <number2>, ... SimYes Inteiro, Float, ou ambosInteger, Float, or both O conjunto de números a partir do qual quer o maior valorThe set of numbers from which you want the highest value
[<número1>, <número2>, ...][<number1>, <number2>, ...] SimYes Array - Inteiro, Flutuador, ou ambosArray - Integer, Float, or both A variedade de números a partir dos quais quer o maior valorThe array of numbers from which you want the highest value
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor máximo<max-value> Inteiro ou FlutuadorInteger or Float O valor mais elevado na matriz ou conjunto de números especificadosThe highest value in the specified array or set of numbers

ExemploExample

Estes exemplos obtêm o maior valor a partir do conjunto de números e da matriz:These examples get the highest value from the set of numbers and the array:

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

E devolva este resultado: 3And return this result: 3

mínmin

Devolva o valor mais baixo de um conjunto de números ou de uma matriz.Return the lowest value from a set of numbers or an array.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<número1>, <número2>, ...<number1>, <number2>, ... SimYes Inteiro, Float, ou ambosInteger, Float, or both O conjunto de números a partir do qual quer o valor mais baixoThe set of numbers from which you want the lowest value
[<número1>, <número2>, ...][<number1>, <number2>, ...] SimYes Array - Inteiro, Flutuador, ou ambosArray - Integer, Float, or both A variedade de números a partir dos quais quer o valor mais baixoThe array of numbers from which you want the lowest value
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor min<min-value> Inteiro ou FlutuadorInteger or Float O valor mais baixo no conjunto especificado de números ou matriz especificadaThe lowest value in the specified set of numbers or specified array

ExemploExample

Estes exemplos obtêm o valor mais baixo no conjunto de números e na matriz:These examples get the lowest value in the set of numbers and the array:

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

E devolva este resultado: 1And return this result: 1

modmod

Devolva o restante da divisão de dois números.Return the remainder from dividing two numbers. Para obter o resultado inteiro, consulte div().To get the integer result, see div().

mod(<dividend>, <divisor>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<> de dividendos<dividend> SimYes Inteiro ou FlutuadorInteger or Float O número a dividir pelo divisorThe number to divide by the divisor
< > divisor<divisor> SimYes Inteiro ou FlutuadorInteger or Float O número que divide o dividendo, mas não pode ser 0.The number that divides the dividend, but cannot be 0.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de resultados do modulo<modulo-result> Inteiro ou FlutuadorInteger or Float O restante de dividir o primeiro número pelo segundo númeroThe remainder from dividing the first number by the second number

ExemploExample

Este exemplo divide o primeiro número pelo segundo número:This example divides the first number by the second number:

mod(3, 2)

E devolva este resultado: 1And return this result: 1

mulmul

Devolva o produto de multiplicar dois números.Return the product from multiplying two numbers.

mul(<multiplicand1>, <multiplicand2>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<multiplicar1><multiplicand1> SimYes Inteiro ou FlutuadorInteger or Float O número a multiplicar por multiplicador2The number to multiply by multiplicand2
<multiplicação2><multiplicand2> SimYes Inteiro ou FlutuadorInteger or Float O número que múltiplos multiplicam1The number that multiples multiplicand1
Valor de retornoReturn value TipoType DescriçãoDescription
> <resultado do produto<product-result> Inteiro ou FlutuadorInteger or Float O produto de multiplicar o primeiro número pelo segundo númeroThe product from multiplying the first number by the second number

ExemploExample

Estes exemplos múltiplos o primeiro número pelo segundo número:These examples multiple the first number by the second number:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: 2First example: 2
  • Segundo exemplo 3Second example 3

multipartBodymultipartBody

Devolva o corpo para uma parte específica da saída de uma ação que tenha várias partes.Return the body for a specific part in an action's output that has multiple parts.

multipartBody('<actionName>', <index>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome para a ação que tem saída com várias partesThe name for the action that has output with multiple parts
> do índice <<index> SimYes Número inteiroInteger O valor do índice para a parte que você querThe index value for the part that you want
Valor de retornoReturn value TipoType DescriçãoDescription
< > do corpo<body> StringString O corpo para a parte especificadaThe body for the specified part

nãonot

Verifique se uma expressão é falsa.Check whether an expression is false. Volte a ser verdade quando a expressão é falsa, ou retorne falsa quando for verdadeira.Return true when the expression is false, or return false when true.

not(<expression>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<expressão><expression> SimYes BooleanoBoolean A expressão para verificarThe expression to check
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando a expressão é falsa.Return true when the expression is false. Volte falso quando a expressão for verdadeira.Return false when the expression is true.

Exemplo 1Example 1

Estes exemplos verificam se as expressões especificadas são falsas:These examples check whether the specified expressions are false:

not(false)
not(true)

E devolver estes resultados:And return these results:

  • Primeiro exemplo: A expressão é falsa, por isso a função devolve true.First example: The expression is false, so the function returns true.
  • Segundo exemplo: A expressão é verdadeira, por isso a função retorna false.Second example: The expression is true, so the function returns false.

Exemplo 2Example 2

Estes exemplos verificam se as expressões especificadas são falsas:These examples check whether the specified expressions are false:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: A expressão é falsa, por isso a função devolve true.First example: The expression is false, so the function returns true.
  • Segundo exemplo: A expressão é verdadeira, por isso a função retorna false.Second example: The expression is true, so the function returns false.

ouor

Verifique se pelo menos uma expressão é verdadeira.Check whether at least one expression is true. Volte a ser verdade quando pelo menos uma expressão for verdadeira, ou volte a ser falsa quando todas são falsas.Return true when at least one expression is true, or return false when all are false.

or(<expression1>, <expression2>, ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<expressão1>, <expression2>, ...<expression1>, <expression2>, ... SimYes BooleanoBoolean As expressões para verificarThe expressions to check
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando pelo menos uma expressão é verdadeira.Return true when at least one expression is true. Volte falso quando todas as expressões forem falsas.Return false when all expressions are false.

Exemplo 1Example 1

Estes exemplos verificam se pelo menos uma expressão é verdadeira:These examples check whether at least one expression is true:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: Pelo menos uma expressão é verdadeira, pelo que a função retorna true.First example: At least one expression is true, so the function returns true.
  • Segundo exemplo: Ambas as expressões são falsas, pelo que a função retorna false.Second example: Both expressions are false, so the function returns false.

Exemplo 2Example 2

Estes exemplos verificam se pelo menos uma expressão é verdadeira:These examples check whether at least one expression is true:

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

E devolver estes resultados:And return these results:

  • Primeiro exemplo: Pelo menos uma expressão é verdadeira, pelo que a função retorna true.First example: At least one expression is true, so the function returns true.
  • Segundo exemplo: Ambas as expressões são falsas, pelo que a função retorna false.Second example: Both expressions are false, so the function returns false.

outputsoutputs

Devolva as saídas de uma ação no tempo de execução.Return an action's outputs at runtime. Utilize esta função, em vez de actionOutputs(), que se resolve a outputs() no Logic App Designer.Use this function, rather than actionOutputs(), which resolves to outputs() in the Logic App Designer. Embora ambas as funções funcionem da mesma forma, outputs() é preferível.Although both functions work the same way, outputs() is preferred.

outputs('<actionName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
ação <Nome><actionName> SimYes StringString O nome para a saída da ação que você querThe name for the action's output that you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de produção<output> StringString A saída da ação especificadaThe output from the specified action

ExemploExample

Este exemplo obtém a saída da ação do Twitter Get user:This example gets the output from the Twitter action Get user:

outputs('Get_user')

E devolve este resultado:And returns this result:

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

parâmetrosparameters

Devolva o valor de um parâmetro descrito na sua definição de fluxo de trabalho.Return the value for a parameter that is described in your workflow definition.

parameters('<parameterName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
parâmetro <Nome><parameterName> SimYes StringString O nome do parâmetro cujo valor querThe name for the parameter whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de parâmetros<parameter-value> QualquerAny O valor para o parâmetro especificadoThe value for the specified parameter

ExemploExample

Suponha que tenha este valor JSON:Suppose that you have this JSON value:

{
  "fullName": "Sophia Owen"
}

Este exemplo obtém o valor para o parâmetro especificado:This example gets the value for the specified parameter:

parameters('fullName')

E devolve este resultado: "Sophia Owen"And returns this result: "Sophia Owen"

randrand

Devolva um inteiro aleatório de uma gama especificada, que só é inclusiva no final inicial.Return a random integer from a specified range, which is inclusive only at the starting end.

rand(<minValue>, <maxValue>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<minValue><minValue> SimYes Número inteiroInteger O inteiro mais baixo da gamaThe lowest integer in the range
<maxValue><maxValue> SimYes Número inteiroInteger O inteiro que segue o maior inteiro na gama que a função pode devolverThe integer that follows the highest integer in the range that the function can return
Valor de retornoReturn value TipoType DescriçãoDescription
<> de resultados aleatórios<random-result> Número inteiroInteger O inteiro aleatório voltou da gama especificadaThe random integer returned from the specified range

ExemploExample

Este exemplo obtém um inteiro aleatório da gama especificada, excluindo o valor máximo:This example gets a random integer from the specified range, excluding the maximum value:

rand(1, 5)

E devolve um destes números como resultado: 1, 2, 3ou 4And returns one of these numbers as the result: 1, 2, 3, or 4

alcancerange

Devolva uma matriz inteiro que começa a partir de um inteiro especificado.Return an integer array that starts from a specified integer.

range(<startIndex>, <count>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<início> do Index<startIndex> SimYes Número inteiroInteger Um valor inteiro que começa a matriz como o primeiro itemAn integer value that starts the array as the first item
<contagem><count> SimYes Número inteiroInteger O número de inteiros na matrizThe number of integers in the array
Valor de retornoReturn value TipoType DescriçãoDescription
[<range-result>][<range-result>] ArrayArray A matriz com inteiros a partir do índice especificadoThe array with integers starting from the specified index

ExemploExample

Este exemplo cria uma matriz inteiro que começa a partir do índice especificado e tem o número especificado de inteiros:This example creates an integer array that starts from the specified index and has the specified number of integers:

range(1, 4)

E devolve este resultado: [1, 2, 3, 4]And returns this result: [1, 2, 3, 4]

substituirreplace

Substitua uma subcadeia com a corda especificada e devolva a corda de resultado.Replace a substring with the specified string, and return the result string. Esta função é sensível ao caso.This function is case-sensitive.

replace('<text>', '<oldText>', '<newText>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda que tem a subcadeia para substituirThe string that has the substring to replace
< > de texto antigo<oldText> SimYes StringString A subcadeia para substituirThe substring to replace
Text<newText> SimYes StringString A corda de substituiçãoThe replacement string
Valor de retornoReturn value TipoType DescriçãoDescription
<> de texto atualizado<updated-text> StringString A cadeia atualizada após a substituição da subcadeiaThe updated string after replacing the substring

Se o substring não for encontrado, devolva a corda original.If the substring is not found, return the original string.

ExemploExample

Este exemplo encontra o substring "velho" na "corda velha" e substitui "velho" por "novo":This example finds the "old" substring in "the old string" and replaces "old" with "new":

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

E devolve este resultado: "the new string"And returns this result: "the new string"

removerPropriedaderemoveProperty

Retire uma propriedade de um objeto e devolva o objeto atualizado.Remove a property from an object and return the updated object. Se a propriedade que tenta remover não existir, a função devolve o objeto original.If the property that you try to remove doesn't exist, the function returns the original object.

removeProperty(<object>, '<property>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON de onde você quer remover uma propriedadeThe JSON object from where you want to remove a property
< > de propriedade<property> SimYes StringString O nome para a propriedade removerThe name for the property to remove
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos atualizados<updated-object> ObjectObject O objeto JSON atualizado sem a propriedade especificadaThe updated JSON object without the specified property

Para remover uma propriedade infantil de uma propriedade existente, use esta sintaxe:To remove a child property from an existing property, use this syntax:

removeProperty(<object>['<parent-property>'], '<child-property>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON cuja propriedade pretende removerThe JSON object whose property you want to remove
<> de propriedade-mãe<parent-property> SimYes StringString O nome da propriedade dos pais com a propriedade da criança que você quer removerThe name for parent property with the child property that you want to remove
<> de propriedade infantil<child-property> SimYes StringString O nome para a propriedade da criança removerThe name for the child property to remove
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos atualizados<updated-object> ObjectObject O objeto JSON atualizado cuja propriedade infantil que removeuThe updated JSON object whose child property that you removed

Exemplo 1Example 1

Este exemplo remove a propriedade middleName de um objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON() e devolve o objeto atualizado:This example removes the middleName property from a JSON object, which is converted from a string to JSON by using the JSON() function, and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

Exemplo 2Example 2

Este exemplo remove a propriedade middleName criança de uma propriedade customerName progenitornum objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON() e devolve o objeto atualizado:This example removes the middleName child property from a customerName parent property in a JSON object, which is converted from a string to JSON by using the JSON() function, and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

Resultadoresult

Devolva as inputs e saídas de todas as ações que estejam dentro da ação de âmbito especificado, como uma ação For_each, Untilou Scope.Return the inputs and outputs from all the actions that are inside the specified scoped action, such as a For_each, Until, or Scope action. Esta função é útil devolvendo os resultados de uma ação falhada para que possa diagnosticar e lidar com exceções.This function is useful returning the results from a failed action so that you can diagnose and handle exceptions. Para mais informações, consulte O contexto e os resultados para falhas.For more information, see Get context and results for failures.

result('<scopedActionName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > actionname<scopedActionName> SimYes StringString O nome da ação de âmbito de aplicação a partir da qual devolver as inputs e saídas de todas as ações internasThe name of the scoped action from which to return the inputs and outputs from all the inner actions
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos de matriz<array-object> Objeto de matrizArray object Uma matriz que contém matrizes de inputs e saídas de cada ação que aparece dentro da ação específicaAn array that contains arrays of inputs and outputs from each action that appears inside the specified scoped action

ExemploExample

Este exemplo devolve as inputs e saídas de cada iteração de uma ação HTTP dentro de um ciclo de For_each usando a função result() na ação Compose:This example returns the inputs and outputs from each iteration of an HTTP action inside that's inside a For_each loop by using the result() function in the Compose action:

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

Aqui está como o exemplo de volta array pode olhar onde o objeto outputs exterior contém as inputs e saídas de cada iteração das ações dentro da ação For_each.Here's how the example returned array might look where the outer outputs object contains the inputs and outputs from each iteration of the actions inside the For_each action.

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

setPropertysetProperty

Depreite o valor para a propriedade do objeto JSON e devolva o objeto atualizado.Set the value for JSON object's property and return the updated object. Se a propriedade que você tenta definir não existe, a propriedade é adicionada ao objeto.If the property that you try to set doesn't exist, the property gets added to the object. Para adicionar uma nova propriedade, utilize a função addProperty()To add a new property, use the addProperty() function.

setProperty(<object>, '<property>', <value>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON cuja propriedade você quer definirThe JSON object whose property you want to set
< > de propriedade<property> SimYes StringString O nome para o imóvel existente ou novo para definirThe name for the existing or new property to set
< > de valor<value> SimYes QualquerAny O valor a definir para o imóvel especificadoThe value to set for the specified property

Para colocar a propriedade da criança num objeto de criança, use uma chamada setProperty() aninhada.To set the child property in a child object, use a nested setProperty() call instead. Caso contrário, a função devolve apenas o objeto da criança como saída.Otherwise, the function returns only the child object as output.

setProperty(<object>['<parent-property>'], '<parent-property>', setProperty(<object>['parentProperty'], '<child-property>', <value>))
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de objeto <<object> SimYes ObjectObject O objeto JSON cuja propriedade você quer definirThe JSON object whose property you want to set
<> de propriedade-mãe<parent-property> SimYes StringString O nome da propriedade dos pais com a propriedade da criança que você quer definirThe name for parent property with the child property that you want to set
<> de propriedade infantil<child-property> SimYes StringString O nome para a propriedade da criança para definirThe name for the child property to set
< > de valor<value> SimYes QualquerAny O valor a definir para o imóvel especificadoThe value to set for the specified property
Valor de retornoReturn value TipoType DescriçãoDescription
<> de objetos atualizados<updated-object> ObjectObject O objeto JSON atualizado cuja propriedade você definiuThe updated JSON object whose property you set

Exemplo 1Example 1

Este exemplo define a propriedade surName num objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON.This example sets the surName property in a JSON object, which is converted from a string to JSON by using the JSON() function. A função atribui o valor especificado à propriedade e devolve o objeto atualizado:The function assigns the specified value to the property and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

Exemplo 2Example 2

Este exemplo define a propriedade surName para a criança para a propriedade customerName progenitornum objeto JSON, que é convertido de uma corda para JSON utilizando a função JSON()This example sets the surName child property for the customerName parent property in a JSON object, which is converted from a string to JSON by using the JSON() function. A função atribui o valor especificado à propriedade e devolve o objeto atualizado:The function assigns the specified value to the property and returns the updated object:

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

Aqui está o objeto json atual:Here's the current JSON object:

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

Aqui está o objeto jSON atualizado:Here's the updated JSON object:

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

saltarskip

Retire os itens da parte da frente de uma coleção e devolva todos os outros itens.Remove items from the front of a collection, and return all the other items.

skip([<collection>], <count>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes ArrayArray A coleção cujos itens pretende removerThe collection whose items you want to remove
<contagem><count> SimYes Número inteiroInteger Um inteiro positivo para o número de itens a remover na frenteA positive integer for the number of items to remove at the front
Valor de retornoReturn value TipoType DescriçãoDescription
[<atualização da coleção>][<updated-collection>] ArrayArray A recolha atualizada após a remoção dos itens especificadosThe updated collection after removing the specified items

ExemploExample

Este exemplo remove um item, o número 0, da frente da matriz especificada:This example removes one item, the number 0, from the front of the specified array:

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

E devolve esta matriz com os restantes itens: [1,2,3]And returns this array with the remaining items: [1,2,3]

dividirsplit

Volte a colocar uma matriz que contenha subcordas, separadas por vírgulas, com base no carácter delimitador especificado na cadeia original.Return an array that contains substrings, separated by commas, based on the specified delimiter character in the original string.

split('<text>', '<delimiter>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda para separar em subcordas com base no delimitador especificado na corda originalThe string to separate into substrings based on the specified delimiter in the original string
<> delimitador<delimiter> SimYes StringString O personagem na corda original para usar como delimitadorThe character in the original string to use as the delimiter
Valor de retornoReturn value TipoType DescriçãoDescription
[<substring1><substring2>,...][<substring1>,<substring2>,...] ArrayArray Uma matriz que contém subcordas da corda original, separada por vírgulasAn array that contains substrings from the original string, separated by commas

ExemploExample

Este exemplo cria uma matriz com subcordas da corda especificada com base no carácter especificado como delimitador:This example creates an array with substrings from the specified string based on the specified character as the delimiter:

split('a_b_c', '_')

E devolve esta matriz como resultado: ["a","b","c"]And returns this array as the result: ["a","b","c"]

inícioOfDaystartOfDay

Volte o início do dia para um carimbo temporal.Return the start of the day for a timestamp.

startOfDay('<timestamp>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo especificada, mas começando na marca de zero horas para o diaThe specified timestamp but starting at the zero-hour mark for the day

ExemploExample

Este exemplo encontra o início do dia para este carimbo temporal:This example finds the start of the day for this timestamp:

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

E devolve este resultado: "2018-03-15T00:00:00.0000000Z"And returns this result: "2018-03-15T00:00:00.0000000Z"

startOfHourstartOfHour

Volte o início da hora por uma marca de tempo.Return the start of the hour for a timestamp.

startOfHour('<timestamp>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo especificada, mas começando na marca de zero minutos para a horaThe specified timestamp but starting at the zero-minute mark for the hour

ExemploExample

Este exemplo encontra o início da hora para este carimbo temporal:This example finds the start of the hour for this timestamp:

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

E devolve este resultado: "2018-03-15T13:00:00.0000000Z"And returns this result: "2018-03-15T13:00:00.0000000Z"

startOfMonthstartOfMonth

Devolva o início do mês por um carimbo temporal.Return the start of the month for a timestamp.

startOfMonth('<timestamp>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString A marca de tempo especificada, mas a partir do primeiro dia do mês na marca de zero horasThe specified timestamp but starting on the first day of the month at the zero-hour mark

ExemploExample

Este exemplo devolve o início do mês para este carimbo temporal:This example returns the start of the month for this timestamp:

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

E devolve este resultado: "2018-03-01T00:00:00.0000000Z"And returns this result: "2018-03-01T00:00:00.0000000Z"

startsWithstartsWith

Verifique se uma corda começa com um substring específico.Check whether a string starts with a specific substring. Volte a ser verdade quando o substring for encontrado, ou volte a ser falso quando não for encontrado.Return true when the substring is found, or return false when not found. Esta função não é sensível a casos.This function is not case-sensitive.

startsWith('<text>', '<searchText>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda para verificarThe string to check
<pesquisaTexto><searchText> SimYes StringString A corda de partida para encontrarThe starting string to find
Valor de retornoReturn value TipoType DescriçãoDescription
true ou falsetrue or false BooleanoBoolean Volte a ser verdade quando o substring inicial for encontrado.Return true when the starting substring is found. Devolver falso quando não for encontrado.Return false when not found.

Exemplo 1Example 1

Este exemplo verifica se a corda "hello world" começa com o substring "olá":This example checks whether the "hello world" string starts with the "hello" substring:

startsWith('hello world', 'hello')

E devolve este resultado: trueAnd returns this result: true

Exemplo 2Example 2

Este exemplo verifica se a corda "hello world" começa com o substring "saudações":This example checks whether the "hello world" string starts with the "greetings" substring:

startsWith('hello world', 'greetings')

E devolve este resultado: falseAnd returns this result: false

stringstring

Devolva a versão de corda por um valor.Return the string version for a value.

string(<value>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes QualquerAny O valor para converterThe value to convert
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de cadeia<string-value> StringString A versão de corda para o valor especificadoThe string version for the specified value

Exemplo 1Example 1

Este exemplo cria a versão de cadeia para este número:This example creates the string version for this number:

string(10)

E devolve este resultado: "10"And returns this result: "10"

Exemplo 2Example 2

Este exemplo cria uma corda para o objeto JSON especificado e utiliza o carácter backslash (\) como um personagem de fuga para a marca de dupla citação (").This example creates a string for the specified JSON object and uses the backslash character (\) as an escape character for the double-quotation mark (").

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

E devolve este resultado: "{ \\"name\\": \\"Sophie Owen\\" }"And returns this result: "{ \\"name\\": \\"Sophie Owen\\" }"

subsub

Devolva o resultado de subtrair o segundo número do primeiro número.Return the result from subtracting the second number from the first number.

sub(<minuend>, <subtrahend>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<> minuend<minuend> SimYes Inteiro ou FlutuadorInteger or Float O número a partir do qual subtrair o subsoloThe number from which to subtract the subtrahend
< > de subrahend<subtrahend> SimYes Inteiro ou FlutuadorInteger or Float O número para subtrair do minúendoThe number to subtract from the minuend
Valor de retornoReturn value TipoType DescriçãoDescription
<resultado><result> Inteiro ou FlutuadorInteger or Float O resultado de subtrair o segundo número do primeiro númeroThe result from subtracting the second number from the first number

ExemploExample

Este exemplo subtrai o segundo número do primeiro número:This example subtracts the second number from the first number:

sub(10.3, .3)

E devolve este resultado: 10And returns this result: 10

substringsubstring

Volte a colocar caracteres de uma corda, a partir da posição especificada, ou do índice.Return characters from a string, starting from the specified position, or index. Os valores do índice começam com o número 0.Index values start with the number 0.

substring('<text>', <startIndex>, <length>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda cujos personagens querThe string whose characters you want
<início> do Index<startIndex> SimYes Número inteiroInteger Um número positivo igual ou superior a 0 que pretende utilizar como posição inicial ou valor de índiceA positive number equal to or greater than 0 that you want to use as the starting position or index value
> de comprimento <<length> SimYes Número inteiroInteger Um número positivo de caracteres que você quer no substringA positive number of characters that you want in the substring
Valor de retornoReturn value TipoType DescriçãoDescription
<> de resultado sinuoso<substring-result> StringString Uma subcadeia com o número especificado de caracteres, a partir da posição de índice especificada na cadeia de origemA substring with the specified number of characters, starting at the specified index position in the source string

ExemploExample

Este exemplo cria uma subcadeia de cinco caracteres a partir da corda especificada, a partir do valor do índice 6:This example creates a five-character substring from the specified string, starting from the index value 6:

substring('hello world', 6, 5)

E devolve este resultado: "world"And returns this result: "world"

subtratoFromTimesubtractFromTime

Subtraia várias unidades temporais de uma marca temporal.Subtract a number of time units from a timestamp. Ver também getPastTime.See also getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda que contém o carimbo de tempoThe string that contains the timestamp
<intervalo><interval> SimYes Número inteiroInteger O número de unidades de tempo especificadas para subtrairThe number of specified time units to subtract
<> da Unidade de Tempo<timeUnit> SimYes StringString A unidade de tempo para usar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"The unit of time to use with interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo atualizado<updated-timestamp> StringString O carimbo de tempo menos o número especificado de unidades de tempoThe timestamp minus the specified number of time units

Exemplo 1Example 1

Este exemplo subtrai um dia a partir desta marca de tempo:This example subtracts one day from this timestamp:

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

E devolve este resultado: "2018-01-01T00:00:00:0000000Z"And returns this result: "2018-01-01T00:00:00:0000000Z"

Exemplo 2Example 2

Este exemplo subtrai um dia a partir desta marca de tempo:This example subtracts one day from this timestamp:

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

E devolve este resultado usando o formato "D" opcional: "Monday, January, 1, 2018"And returns this result using the optional "D" format: "Monday, January, 1, 2018"

tomartake

Devolver artigos da frente de uma coleção.Return items from the front of a collection.

take('<collection>', <count>)
take([<collection>], <count>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de recolha<collection> SimYes Corda ou MatrizString or Array A coleção cujos itens você querThe collection whose items you want
<contagem><count> SimYes Número inteiroInteger Um inteiro positivo para o número de itens que você quer da frenteA positive integer for the number of items that you want from the front
Valor de retornoReturn value TipoType DescriçãoDescription
<subconjunto> ou [<subconjunto>]<subset> or [<subset>] String ou Array, respectivamenteString or Array, respectively Uma cadeia ou matriz que tenha o número especificado de itens retirados da parte da frente da coleção originalA string or array that has the specified number of items taken from the front of the original collection

ExemploExample

Estes exemplos obtêm o número especificado de itens da parte da frente destas coleções:These examples get the specified number of items from the front of these collections:

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

E devolver estes resultados:And return these results:

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

tiquesticks

Devolva o valor ticks propriedade por um carimbo de tempo especificado.Return the ticks property value for a specified timestamp. Um tique é um intervalo de 100 nanossegundos.A tick is a 100-nanosecond interval.

ticks('<timestamp>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de carimbo de tempo<timestamp> SimYes StringString A corda para um carimbo temporalThe string for a timestamp
Valor de retornoReturn value TipoType DescriçãoDescription
<número><ticks-number> Número inteiroInteger O número de carrapatos desde o carimbo de tempo especificadoThe number of ticks since the specified timestamp

toLowertoLower

Volte a colocar uma corda em formato minúsculo.Return a string in lowercase format. Se um personagem na corda não tem uma versão minúscula, esse personagem permanece inalterado na corda devolvida.If a character in the string doesn't have a lowercase version, that character stays unchanged in the returned string.

toLower('<text>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda para voltar em formato minúsculoThe string to return in lowercase format
Valor de retornoReturn value TipoType DescriçãoDescription
<> de texto minúsculo<lowercase-text> StringString A cadeia original em formato minúsculoThe original string in lowercase format

ExemploExample

Este exemplo converte esta cadeia em minúscula:This example converts this string to lowercase:

toLower('Hello World')

E devolve este resultado: "hello world"And returns this result: "hello world"

toUppertoUpper

Volte a colocar uma corda em formato superior.Return a string in uppercase format. Se um personagem na corda não tem uma versão maiúscula, esse personagem permanece inalterado na corda devolvida.If a character in the string doesn't have an uppercase version, that character stays unchanged in the returned string.

toUpper('<text>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda para voltar em formato maiúsculoThe string to return in uppercase format
Valor de retornoReturn value TipoType DescriçãoDescription
<> de texto maiúsculo<uppercase-text> StringString A cadeia original em formato maiúsculoThe original string in uppercase format

ExemploExample

Este exemplo converte esta cadeia em maiúsculas:This example converts this string to uppercase:

toUpper('Hello World')

E devolve este resultado: "HELLO WORLD"And returns this result: "HELLO WORLD"

gatilhotrigger

Volte a devolva a saída de um gatilho no prazo de execução, ou valores de outros pares de nome e valor da JSON, que pode atribuir a uma expressão.Return a trigger's output at runtime, or values from other JSON name-and-value pairs, which you can assign to an expression.

  • Dentro das inputs de um gatilho, esta função devolve a saída da execução anterior.Inside a trigger's inputs, this function returns the output from the previous execution.

  • Dentro da condição de um gatilho, esta função devolve a saída da execução atual.Inside a trigger's condition, this function returns the output from the current execution.

Por predefinição, a função refere todo o objeto do gatilho, mas pode especificar opcionalmente uma propriedade cujo valor deseja.By default, the function references the entire trigger object, but you can optionally specify a property whose value that you want. Além disso, esta função tem versões abreviadas disponíveis, ver triggerOutputs() e triggerBody().Also, this function has shorthand versions available, see triggerOutputs() and triggerBody().

trigger()
Valor de retornoReturn value TipoType DescriçãoDescription
<> de saída do gatilho<trigger-output> StringString A saída de um gatilho no tempo de execuçãoThe output from a trigger at runtime

triggerBodytriggerBody

Volte a colocar um gatilho body saída no tempo de execução.Return a trigger's body output at runtime. Abreviatura para trigger().outputs.body.Shorthand for trigger().outputs.body. Ver gatilho().See trigger().

triggerBody()
Valor de retornoReturn value TipoType DescriçãoDescription
<> de saída do corpo do gatilho<trigger-body-output> StringString A saída body do gatilhoThe body output from the trigger

triggerFormDataMultiValuestriggerFormDataMultiValues

Devolva uma matriz com valores que correspondam a um nome chave nos dados de formulário de um gatilho ou na saída codificada pelo formulário.Return an array with values that match a key name in a trigger's form-data or form-encoded output.

triggerFormDataMultiValues('<key>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > chave<key> SimYes StringString O nome da chave cujo valor querThe name for the key whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
[<array-with-key-values>][<array-with-key-values>] ArrayArray Uma matriz com todos os valores que correspondem à chave especificadaAn array with all the values that match the specified key

ExemploExample

Este exemplo cria uma matriz a partir do valor-chave "feedUrl" nos dados de formulário de um gatilho RSS ou na saída codificada por formulários:This example creates an array from the "feedUrl" key value in an RSS trigger's form-data or form-encoded output:

triggerFormDataMultiValues('feedUrl')

E devolve esta matriz como um resultado exemplo: ["http://feeds.reuters.com/reuters/topNews"]And returns this array as an example result: ["http://feeds.reuters.com/reuters/topNews"]

triggerFormDataValuetriggerFormDataValue

Volte a colocar uma corda com um único valor que corresponda a um nome-chave nos dados de formulário de um gatilho ou na saída codificada pelo formulário.Return a string with a single value that matches a key name in a trigger's form-data or form-encoded output. Se a função encontrar mais de um fósforo, a função lança um erro.If the function finds more than one match, the function throws an error.

triggerFormDataValue('<key>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > chave<key> SimYes StringString O nome da chave cujo valor querThe name for the key whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor-chave<key-value> StringString O valor na chave especificadaThe value in the specified key

ExemploExample

Este exemplo cria uma cadeia a partir do valor-chave "feedUrl" nos dados de formulário de um gatilho RSS ou na saída codificada por formulários:This example creates a string from the "feedUrl" key value in an RSS trigger's form-data or form-encoded output:

triggerFormDataValue('feedUrl')

E devolve esta corda como um resultado exemplo: "http://feeds.reuters.com/reuters/topNews"And returns this string as an example result: "http://feeds.reuters.com/reuters/topNews"

triggerMultipartBodytriggerMultipartBody

Devolva o corpo para uma parte específica da saída de um gatilho que tenha várias partes.Return the body for a specific part in a trigger's output that has multiple parts.

triggerMultipartBody(<index>)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> do índice <<index> SimYes Número inteiroInteger O valor do índice para a parte que você querThe index value for the part that you want
Valor de retornoReturn value TipoType DescriçãoDescription
< > do corpo<body> StringString O corpo para a parte especificada na saída multiparte de um gatilhoThe body for the specified part in a trigger's multipart output

triggerOutputstriggerOutputs

Volte a colocar a saída de um gatilho no prazo de execução, ou valores de outros pares de nome e valor da JSON.Return a trigger's output at runtime, or values from other JSON name-and-value pairs. Abreviatura para trigger().outputs.Shorthand for trigger().outputs. Ver gatilho().See trigger().

triggerOutputs()
Valor de retornoReturn value TipoType DescriçãoDescription
<> de saída do gatilho<trigger-output> StringString A saída de um gatilho no tempo de execuçãoThe output from a trigger at runtime

aparartrim

Remova o espaço branco de liderar e arrastando a partir de uma corda e devolva a corda atualizada.Remove leading and trailing whitespace from a string, and return the updated string.

trim('<text>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de texto <<text> SimYes StringString A corda que tem o espaço branco líder e trailing para removerThe string that has the leading and trailing whitespace to remove
Valor de retornoReturn value TipoType DescriçãoDescription
<atualizadoTexto><updatedText> StringString Uma versão atualizada para a cadeia original sem liderar ou seguir o espaço brancoAn updated version for the original string without leading or trailing whitespace

ExemploExample

Este exemplo remove o espaço branco líder e trailing da corda " Hello World ":This example removes the leading and trailing whitespace from the string " Hello World ":

trim(' Hello World  ')

E devolve este resultado: "Hello World"And returns this result: "Hello World"

unionunion

Devolva uma coleção que tenha todos os itens das coleções especificadas.Return a collection that has all the items from the specified collections. Para aparecer no resultado, um item pode aparecer em qualquer coleção passada para esta função.To appear in the result, an item can appear in any collection passed to this function. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparece no resultado.If one or more items have the same name, the last item with that name appears in the result.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<collection1>, <collection2>, ...<collection1>, <collection2>, ... SimYes Matriz ou Objeto, mas não ambosArray or Object, but not both As coleções de onde você quer todos os itensThe collections from where you want all the items
Valor de retornoReturn value TipoType DescriçãoDescription
<atualizado> de recolha<updatedCollection> Matriz ou Objeto, respectivamenteArray or Object, respectively Uma coleção com todos os itens das coleções especificadas - sem duplicadosA collection with all the items from the specified collections - no duplicates

ExemploExample

Este exemplo obtém todos os itens destas coleções:This example gets all the items from these collections:

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

E devolve este resultado: [1, 2, 3, 10, 101]And returns this result: [1, 2, 3, 10, 101]

uriComponenturiComponent

Volte a colocar uma versão codificada por um identificador de recursos uniforme (URI) para uma cadeia, substituindo caracteres inseguros de URL por caracteres de fuga.Return a uniform resource identifier (URI) encoded version for a string by replacing URL-unsafe characters with escape characters. Utilize esta função em vez de codificar o Componente Uri().Use this function rather than encodeUriComponent(). Embora ambas as funções funcionem da mesma forma, uriComponent() é preferível.Although both functions work the same way, uriComponent() is preferred.

uriComponent('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda para converter em formato codificado por URIThe string to convert to URI-encoded format
Valor de retornoReturn value TipoType DescriçãoDescription
<codificado-uri><encoded-uri> StringString A corda codificada uri com caracteres de fugaThe URI-encoded string with escape characters

ExemploExample

Este exemplo cria uma versão codificada por URI para esta cadeia:This example creates a URI-encoded version for this string:

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

E devolve este resultado: "http%3A%2F%2Fcontoso.com"And returns this result: "http%3A%2F%2Fcontoso.com"

uriComponentToBinaryuriComponentToBinary

Devolva a versão binária para um componente de identificador de recursos uniforme (URI).Return the binary version for a uniform resource identifier (URI) component.

uriComponentToBinary('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia codificada uri para converterThe URI-encoded string to convert
Valor de retornoReturn value TipoType DescriçãoDescription
< > binária-para-codificada-uri<binary-for-encoded-uri> StringString A versão binária para a cadeia codificada por URI.The binary version for the URI-encoded string. O conteúdo binário é codificado por base64 e representado por $content.The binary content is base64-encoded and represented by $content.

ExemploExample

Este exemplo cria a versão binária para esta cadeia codificada por URI:This example creates the binary version for this URI-encoded string:

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

E devolve este resultado:And returns this result:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToStringuriComponentToString

Devolva a versão de cadeia para um fio codificado de um identificador de recursos uniforme (URI), descodificando eficazmente a cadeia codificada pelo URI.Return the string version for a uniform resource identifier (URI) encoded string, effectively decoding the URI-encoded string.

uriComponentToString('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A cadeia codificada uri para descodificarThe URI-encoded string to decode
Valor de retornoReturn value TipoType DescriçãoDescription
<> descodificado-uri<decoded-uri> StringString A versão descodificada para a cadeia codificada uriThe decoded version for the URI-encoded string

ExemploExample

Este exemplo cria a versão de string descodificada para esta cadeia codificada por URI:This example creates the decoded string version for this URI-encoded string:

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

E devolve este resultado: "https://contoso.com"And returns this result: "https://contoso.com"

uriHosturiHost

Devolver o valor host para um identificador de recursos uniforme (URI).Return the host value for a uniform resource identifier (URI).

uriHost('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujo valor host querThe URI whose host value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor hospedeiro<host-value> StringString O valor host para o URI especificadoThe host value for the specified URI

ExemploExample

Este exemplo encontra o valor host para este URI:This example finds the host value for this URI:

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

E devolve este resultado: "www.localhost.com"And returns this result: "www.localhost.com"

uriPathuriPath

Devolver o valor path para um identificador de recursos uniforme (URI).Return the path value for a uniform resource identifier (URI).

uriPath('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujo valor path querThe URI whose path value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de caminho<path-value> StringString O valor path para o URI especificado.The path value for the specified URI. Se path não tiver valor, devolva o caráter "/".If path doesn't have a value, return the "/" character.

ExemploExample

Este exemplo encontra o valor path para este URI:This example finds the path value for this URI:

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

E devolve este resultado: "/catalog/shownew.htm"And returns this result: "/catalog/shownew.htm"

uriPathAndQueryuriPathAndQuery

Devolva os valores path e query para um identificador de recursos uniforme (URI).Return the path and query values for a uniform resource identifier (URI).

uriPathAndQuery('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujos valores path e query desejaThe URI whose path and query values you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de consulta de caminho<path-query-value> StringString Os valores path e query para o URI especificado.The path and query values for the specified URI. Se path não especificar um valor, devolva o carácter "/".If path doesn't specify a value, return the "/" character.

ExemploExample

Este exemplo encontra os valores path e query para este URI:This example finds the path and query values for this URI:

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

E devolve este resultado: "/catalog/shownew.htm?date=today"And returns this result: "/catalog/shownew.htm?date=today"

uriPortouriPort

Devolver o valor port para um identificador de recursos uniforme (URI).Return the port value for a uniform resource identifier (URI).

uriPort('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujo valor port querThe URI whose port value you want
Valor de retornoReturn value TipoType DescriçãoDescription
< > de valor portuário<port-value> Número inteiroInteger O valor port para o URI especificado.The port value for the specified URI. Se port não especificar um valor, devolva a porta padrão para o protocolo.If port doesn't specify a value, return the default port for the protocol.

ExemploExample

Este exemplo devolve o valor port para este URI:This example returns the port value for this URI:

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

E devolve este resultado: 8080And returns this result: 8080

uriQueryuriQuery

Devolver o valor query para um identificador de recursos uniforme (URI).Return the query value for a uniform resource identifier (URI).

uriQuery('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujo valor query querThe URI whose query value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor de consulta<query-value> StringString O valor query para o URI especificadoThe query value for the specified URI

ExemploExample

Este exemplo devolve o valor query para este URI:This example returns the query value for this URI:

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

E devolve este resultado: "?date=today"And returns this result: "?date=today"

uriSchemeuriScheme

Devolver o valor scheme para um identificador de recursos uniforme (URI).Return the scheme value for a uniform resource identifier (URI).

uriScheme('<uri>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<uri><uri> SimYes StringString O URI cujo valor scheme querThe URI whose scheme value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor do regime<scheme-value> StringString O valor scheme para o URI especificadoThe scheme value for the specified URI

ExemploExample

Este exemplo devolve o valor scheme para este URI:This example returns the scheme value for this URI:

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

E devolve este resultado: "http"And returns this result: "http"

utcNowutcNow

Devolva o carimbo de tempo atual.Return the current timestamp.

utcNow('<format>')

Opcionalmente, pode especificar um formato diferente com o formato <formato> parâmetro.Optionally, you can specify a different format with the <format> parameter.

ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
> de formato <<format> NãoNo StringString Ou um único especificador de formato ou um padrão de formato personalizado.Either a single format specifier or a custom format pattern. O formato predefinido para a marca de tempo é "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), que cumpre com a ISO 8601 e preserva as informações do fuso horário.The default format for the timestamp is "o" (yyyy-MM-ddTHH:mm:ss:fffffffK), which complies with ISO 8601 and preserves time zone information.
Valor de retornoReturn value TipoType DescriçãoDescription
<> de carimbo seletos atuais<current-timestamp> StringString A data e hora atuaisThe current date and time

Exemplo 1Example 1

Suponha que hoje é 15 de abril de 2018 às 13:00.Suppose today is April 15, 2018 at 1:00:00 PM. Este exemplo obtém o carimbo de tempo atual:This example gets the current timestamp:

utcNow()

E devolve este resultado: "2018-04-15T13:00:00.0000000Z"And returns this result: "2018-04-15T13:00:00.0000000Z"

Exemplo 2Example 2

Suponha que hoje é 15 de abril de 2018 às 13:00.Suppose today is April 15, 2018 at 1:00:00 PM. Este exemplo obtém a marca de tempo atual utilizando o formato "D" opcional:This example gets the current timestamp using the optional "D" format:

utcNow('D')

E devolve este resultado: "Sunday, April 15, 2018"And returns this result: "Sunday, April 15, 2018"

variáveisvariables

Devolva o valor para uma variável especificada.Return the value for a specified variable.

variables('<variableName>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
variável <> de nome<variableName> SimYes StringString O nome da variável cujo valor querThe name for the variable whose value you want
Valor de retornoReturn value TipoType DescriçãoDescription
<> de valor variável<variable-value> QualquerAny O valor da variável especificadaThe value for the specified variable

ExemploExample

Suponha que o valor atual para uma variável "numItems" é de 20.Suppose the current value for a "numItems" variable is 20. Este exemplo obtém o valor inteiro para esta variável:This example gets the integer value for this variable:

variables('numItems')

E devolve este resultado: 20And returns this result: 20

fluxo de trabalhoworkflow

Devolva todos os detalhes sobre o fluxo de trabalho em si durante o tempo de funcionamento.Return all the details about the workflow itself during run time.

workflow().<property>
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de propriedade<property> NãoNo StringString O nome da propriedade workflow cujo valor você querThe name for the workflow property whose value you want

Um objeto de fluxo de trabalho tem estas propriedades: nome, tipo, id, localização, e execução.A workflow object has these properties: name, type, id, location, and run. O valor da propriedade executada é também um objeto que tem estas propriedades: nome, tipo, e id.The run property value is also an object that has these properties: name, type, and id.

ExemploExample

Este exemplo devolve o nome para a execução atual de um fluxo de trabalho:This example returns the name for a workflow's current run:

workflow().run.name

xmlxml

Devolva a versão XML para uma corda que contenha um objeto JSON.Return the XML version for a string that contains a JSON object.

xml('<value>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
< > de valor<value> SimYes StringString A corda com o objeto JSON para converterThe string with the JSON object to convert

O objeto JSON deve ter apenas uma propriedade de raiz, que não pode ser uma matriz.The JSON object must have only one root property, which can't be an array.
Use o carácter backslash (\) como um personagem de fuga para a marca de citação dupla (").Use the backslash character (\) as an escape character for the double quotation mark (").

Valor de retornoReturn value TipoType DescriçãoDescription
<> da versão xml<xml-version> ObjectObject O XML codificado para a corda especificada ou objeto JSONThe encoded XML for the specified string or JSON object

Exemplo 1Example 1

Este exemplo cria a versão XML para esta cadeia, que contém um objeto JSON:This example creates the XML version for this string, which contains a JSON object:

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

E devolve este resultado XML:And returns this result XML:

<name>Sophia Owen</name>

Exemplo 2Example 2

Suponha que tenha este objeto JSON:Suppose you have this JSON object:

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

Este exemplo cria XML para uma cadeia que contém este objeto JSON:This example creates XML for a string that contains this JSON object:

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

E devolve este resultado XML:And returns this result XML:

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

xpathxpath

Verifique o XML para ver se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e devolva os nós ou valores correspondentes.Check XML for nodes or values that match an XPath (XML Path Language) expression, and return the matching nodes or values. Uma expressão XPath, ou apenas "XPath", ajuda-o a navegar numa estrutura de documentoXML para que possa selecionar nós ou calcular valores no conteúdo XML.An XPath expression, or just "XPath", helps you navigate an XML document structure so that you can select nodes or compute values in the XML content.

xpath('<xml>', '<xpath>')
ParâmetroParameter NecessárioRequired TipoType DescriçãoDescription
<xml><xml> SimYes QualquerAny A cadeia XML para procurar por nóouos ou valores que correspondam a um valor de expressão XPathThe XML string to search for nodes or values that match an XPath expression value
<xpath><xpath> SimYes QualquerAny A expressão XPath usada para encontrar nódosos ou valores XML correspondentesThe XPath expression used to find matching XML nodes or values
Valor de retornoReturn value TipoType DescriçãoDescription
<> de nó xml<xml-node> XMLXML Um nó XML quando apenas um nó corresponde à expressão XPath especificadaAn XML node when only a single node matches the specified XPath expression
< > de valor<value> QualquerAny O valor de um nó XML quando apenas um único valor corresponde à expressão XPath especificadaThe value from an XML node when only a single value matches the specified XPath expression
[<xml-node1>, <xml-node2>, ...][<xml-node1>, <xml-node2>, ...]
-ou--or-
[<value1>, <value2>, ...][<value1>, <value2>, ...]
ArrayArray Uma matriz com nódosos ou valores XML que correspondem à expressão XPath especificadaAn array with XML nodes or values that match the specified XPath expression

Exemplo 1Example 1

Este exemplo encontra nós que combinam com o nó <name></name> nos argumentos especificados, e devolve uma matriz com esses valores de nó:This example finds nodes that match the <name></name> node in the specified arguments, and returns an array with those node values:

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

Aqui estão os argumentos:Here are the arguments:

  • A corda "itens", que contém este XML:The "items" string, which contains this 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>"

    O exemplo utiliza a função de parâmetros() para obter a cadeia XML a partir do argumento "itens", mas também deve converter a cadeia para o formato XML utilizando a função xml().The example uses the parameters() function to get the XML string from the "items" argument, but must also convert the string to XML format by using the xml() function.

  • Esta expressão XPath, que é passada como uma corda:This XPath expression, which is passed as a string:

    "/produce/item/name"

Aqui está o conjunto de resultados com os nós que combinam <name></name:Here is the result array with the nodes that match <name></name:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Exemplo 2Example 2

Seguindo o Exemplo 1, este exemplo encontra nós que combinam com o nó <count></count> e adiciona esses valores de nó com a função sum():Following on Example 1, this example finds nodes that match the <count></count> node and adds those node values with the sum() function:

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

E devolve este resultado: 30And returns this result: 30

Exemplo 3Example 3

Para este exemplo, ambas as expressões encontram nós que correspondem ao nó <location></location>, nos argumentos especificados, que incluem XML com um espaço de nome.For this example, both expressions find nodes that match the <location></location> node, in the specified arguments, which include XML with a namespace.

Nota

Se estiver a trabalhar em vista de código, escape da marca de citação dupla (") utilizando o caracteres backslash (\).If you're working in code view, escape the double quotation mark (") by using the backslash character (\). Por exemplo, precisa de usar caracteres de fuga quando serializar uma expressão como uma corda JSON.For example, you need to use escape characters when you serialize an expression as a JSON string. No entanto, se estiver a trabalhar no Logic App Designer ou editor de expressão, não precisa de escapar à marca de citação dupla porque o carácter backslash é adicionado automaticamente à definição subjacente, por exemplo:However, if you're working in the Logic App Designer or expression editor, you don't need to escape the double quotation mark because the backslash character is added automatically to the underlying definition, for example:

  • Vista de código: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')Code view: xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

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

Os seguintes exemplos aplicam-se às expressões que introduz no editor de expressão.The following examples apply to expressions that you enter in the expression editor.

  • Expressão 1Expression 1

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

  • Expressão 2Expression 2

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

Aqui estão os argumentos:Here are the arguments:

  • Este XML, que inclui o espaço de nome do documento XML, xmlns="http://contoso.com":This XML, which includes the XML document namespace, xmlns="http://contoso.com":

    <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
    
  • Ou expressão XPath aqui:Either XPath expression here:

    • /*[name()="file"]/*[name()="location"]

    • /*[local-name()="file" and namespace-uri()="http://contoso.com"]/*[local-name()="location"]

Aqui está o nó de resultados que combina com o nó <location></location>:Here is the result node that matches the <location></location> node:

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

Exemplo 4Example 4

Seguindo o Exemplo 3, este exemplo encontra o valor no nó <location></location>:Following on Example 3, this example finds the value in the <location></location> node:

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

E devolve este resultado: "Paris"And returns this result: "Paris"

Passos seguintesNext steps

Conheça a Linguagem de Definição de Fluxo de TrabalhoLearn about the Workflow Definition Language