Conteúdo dinâmico do fluxo de trabalho

Importante

Este recurso está atualmente no modo de visualização. Os Termos de Uso Suplementares para Visualizações do Microsoft Azure incluem termos legais adicionais que se aplicam aos recursos do Azure que estão em versão beta, em versão prévia ou ainda não lançados em disponibilidade geral.

Você pode usar conteúdo dinâmico dentro de fluxos de trabalho do Microsoft Purview para associar determinadas variáveis no fluxo de trabalho ou adicionar outras expressões para processar esses valores.

Ao adicionar conteúdo dinâmico aos fluxos de trabalho, você está criando expressões de blocos de construção fornecidos que fazem referência e processam informações em seu fluxo de trabalho para que você possa obter os valores necessários em tempo real.

No menu de conteúdo dinâmico, as opções disponíveis no momento são:

  • Variáveis internas – variáveis que representam valores que chegam ao fluxo de trabalho dos itens que o dispararam
  • Expressões – fórmulas criadas a partir de funções e variáveis que podem processar valores no fluxo de trabalho.

Variáveis internas

Atualmente, as seguintes variáveis estão disponíveis para um conector de fluxo de trabalho no Microsoft Purview:

Conector de pré-requisito Variável interna Funcionalidade Tipo Valores possíveis
Quando a solicitação de acesso a dados é enviada
Quando a solicitação de atualização de ativos é enviada
Workflow.Requestor A ID do solicitante do fluxo de trabalho cadeia de caracteres
Asset.Name O nome do ativo cadeia de caracteres
Asset.Description A descrição do ativo cadeia de caracteres ou nulo
Asset.Type O tipo do ativo cadeia de caracteres
Nome totalmente qualificado do Asset. O nome totalmente qualificado do ativo cadeia de caracteres
Asset.Owner As IDs dos proprietários de dados do ativo matriz de cadeias de caracteres
Asset.Classification Os nomes de exibição de classificações do ativo matriz de cadeias de caracteres
Asset.Schema.Classification Os nomes de exibição de classificações aplicados a uma coluna no esquema de ativos matriz de cadeias de caracteres
certificado Asset.Is O indicador de se o ativo atende aos padrões de qualidade da sua organização e pode ser considerado confiável boolean true ou false
Quando a solicitação de acesso a dados é enviada Destinatário workflow.request A ID do destinatário da solicitação do fluxo de trabalho cadeia de caracteres
Iniciar e aguardar uma aprovação Approval.Outcome O resultado da aprovação cadeia de caracteres 'Approved' ou 'Rejected'
Aprovação.Atribuída a As IDs dos aprovadores matriz de cadeias de caracteres
Approval.Comments Os nomes dos aprovadores e seus comentários cadeia de caracteres
Verificar o registro da fonte de dados para obter governança de uso de dados Governança de Uso de Dados O resultado do marcar de governança de uso de dados boolean true ou false
Quando a solicitação de criação de termo é enviada Workflow.Requestor A ID do solicitante do fluxo de trabalho cadeia de caracteres
Term.Name O nome do termo cadeia de caracteres
Nome term.formal O nome formal do termo cadeia de caracteres
Term.Definition A definição do termo cadeia de caracteres
Term.Experts As IDs dos especialistas do termo matriz de cadeias de caracteres
Term.Stewards As IDs dos administradores do termo matriz de cadeias de caracteres
Term.Parent.Name O nome do termo pai se existir cadeia de caracteres
Nome term.parent.formal O nome formal do termo pai se existir cadeia de caracteres
Quando a solicitação de atualização de termo é enviada
Quando a solicitação de exclusão de termo é enviada
Workflow.Requestor O solicitante do fluxo de trabalho cadeia de caracteres
Term.Name O nome do termo cadeia de caracteres
Nome term.formal O nome formal do termo cadeia de caracteres
Term.Definition A definição do termo cadeia de caracteres ou nulo
Term.Experts As IDs dos especialistas do termo matriz de cadeias de caracteres
Term.Stewards As IDs dos administradores do termo matriz de cadeias de caracteres
Term.Parent.Name O nome do termo pai se existir cadeia de caracteres
Nome term.parent.formal O nome formal do termo pai se existir cadeia de caracteres
Term.Created By A ID do criador do termo cadeia de caracteres
Term.Last Updated By A ID do último atualizador do termo cadeia de caracteres
Quando a solicitação de importação de termo é enviada Workflow.Requestor A ID do solicitante do fluxo de trabalho cadeia de caracteres
Importar File.Name O nome do arquivo a ser importado cadeia de caracteres
Http Http.Body Corpo da resposta HTTP objeto ou cadeia de caracteres
Http.Headers Cabeçalhos de resposta HTTP objeto
Código Http.Status Código de status de HTTP cadeia de caracteres
Aplicar a cada um Item O item atual de Aplicar a Cada ação Qualquer
Até Índice O índice de iteração atual da ação Until Inteiro
Criar registro
Excluir registro
Obter registro
Atualizar registro
Resultado O resultado da ação do ServiceNow objeto
Obter tipos de registro
Listar registros
Resultado O resultado da ação do ServiceNow matriz de objetoss

Expressões

As definições de fluxo de trabalho no Microsoft Purview permitem que você use funções em suas expressões para processar valores em seus fluxos de trabalho.

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

Quando você estiver criando um fluxo de trabalho e quiser adicionar uma função às suas expressões, siga estas etapas:

  1. Selecione o valor que você vai editar.
  2. Selecione o botão Adicionar conteúdo dinâmico que aparece abaixo da caixa de texto.
  3. Selecione a guia Expressões na janela de conteúdo dinâmico e role para selecionar seu valor.
  4. Atualize sua expressão e selecione OK para adicioná-la.

Captura de tela mostrando um campo de texto de fluxo de trabalho com Usar conteúdo dinâmico realçado e a guia expressões mostrada.

Considerações

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

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

    O exemplo a seguir mostra a sintaxe correta e incorreta:

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

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

  • As funções podem ter sobrecargas, que são várias versões de uma função com o mesmo nome, mas maneiras diferentes de fazer uma tarefa, dependendo da entrada que você fornece a elas.

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

Funções de cadeia de caracteres

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

Função da cadeia de caracteres Tarefa
endswith Verifique se uma cadeia de caracteres termina com a substring especificada.
startswith Verifique se uma cadeia de caracteres começa com uma substring específica.

Funções de coleção

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

Função de coleção Tarefa
Contém Verifique se uma coleção tem um item específico.
comprimento Retorne o número de itens em uma coleção ou o comprimento de uma cadeia de caracteres.

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

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

Função de comparação lógica Tarefa
not Verifique se uma expressão é falsa. Retorne true quando a expressão for false ou retorne false quando true.
and Verifique se todas as expressões são verdadeiras. Retorne true quando todas as expressões forem verdadeiras ou retornar false quando pelo menos uma expressão for falsa.
or Verifique se pelo menos uma expressão é verdadeira. Retorne true quando pelo menos uma expressão for verdadeira ou retornar false quando todas forem falsas.
Equals Verifique se ambos os valores são equivalentes.
Maior Verifique se o primeiro valor é maior que o segundo valor.
greaterOrEquals Verifique se o primeiro valor é maior ou igual ao segundo valor.
Menos Verifique se o primeiro valor é menor que o segundo valor.
lessOrEquals Verifique se o primeiro valor é menor ou igual ao segundo valor.

Funções do usuário

Para trabalhar com usuários, suas relações com outros usuários e grupos e os recursos que eles acessam, por exemplo, seus emails, calendários, arquivos, funções administrativas, associações de grupo. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de usuário Tarefa
Getusername Obtenha o nome do usuário.
getManager Obtenha a ID do gerenciador do usuário.
memberOfGroup Verifique se o usuário é membro do grupo.

Funções de conversão

Para alterar o tipo ou formato de um valor, você pode usar essas funções de conversão. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de conversão Tarefa
createArray Retorne uma matriz de qualquer número de entradas.
Createobject Retornar um objeto vazio.
cadeia de caracteres Retorne a versão da cadeia de caracteres para um valor.
int Tente converter o valor de entrada em um número inteiro.
float Tente converter o valor de entrada em um número flutuante..
bool Tente converter o valor de entrada em um valor booliano.
objeto Tente converter o valor de entrada em um objeto.
matriz Tente converter o valor de entrada em uma matriz.
nullOrElse Dê um valor padrão a um valor anulável.

Todas as funções – lista alfabética

e

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

Parâmetro Tipo Descrição
valor boolean A primeira expressão a marcar
Valores... boolean As expressões restantes para marcar
Tipo de valor retornado Descrição
boolean Retorne true quando todas as expressões forem verdadeiras. Retorne false quando pelo menos uma expressão for falsa.

Exemplos

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

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

E retorna estes resultados:

  • Primeiro exemplo: ambas as expressões são verdadeiras, portanto, retorna true.
  • Segundo exemplo: uma expressão é falsa, portanto, retorna false.
  • Terceiro exemplo: a expressão é falsa, portanto, retorna false.

array

Essa função tenta converter o valor de entrada em uma matriz. Ele é usado para lançar o valor de um tipo mais amplo para uma matriz. Para criar uma matriz a partir de itens, consulte createArray.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
matriz O valor da matriz convertida

Exemplo

Este exemplo afirma item de uma ação "Aplicar a cada" para ser do tipo de matriz :

array(items('Appy to each'))

bool

Essa função tenta converter o valor de entrada em um valor booliano. Ele é usado para lançar o valor de um tipo mais amplo para booliano.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
boolean O valor booliano convertido

Exemplo

Este exemplo afirma o item de uma ação "Aplicar a cada" para ser do tipo booliano :

bool(items('Appy to each'))

contains

Verifique se uma coleção tem um item específico. Retornar true quando o item for encontrado ou retornar false quando não for encontrado.

Sobrecarga 1: uma cadeia de caracteres para encontrar uma substring

Essa sobrecarga é sensível a casos.

Parâmetro Tipo Descrição
coleção cadeia de caracteres A cadeia de caracteres para marcar
valor cadeia de caracteres A subconserção a ser encontrada
Tipo de valor retornado Descrição
boolean Retorne true quando a substring for encontrada. Retornar false quando não for encontrado.

Sobrecarga 2: uma matriz para encontrar um valor

Parâmetro Tipo Descrição
coleção matriz A coleção a ser marcar
valor Qualquer O item a ser encontrado
Tipo de valor retornado Descrição
boolean Retorne true quando o item for encontrado. Retornar false quando não for encontrado.

Exemplo 1

Este exemplo verifica a cadeia de caracteres "hello world" para a substring "world" e retorna true:

contains('hello world', 'world')

Exemplo 2

Este exemplo verifica a variável Asset.Owner para o item igual à variável Workflow.Requestor:

contains(runInput()['asset']['dataOwner'], runInput()['requestor'])

createArray

Retorne uma matriz de qualquer número de entradas. Essa função não exige que os valores de entrada sejam do mesmo tipo.

Parâmetro Tipo Descrição
Valores... Qualquer Valores para criar a matriz.
Tipo de valor retornado Descrição
matriz A matriz criada a partir de todos os itens de entrada

Exemplos

Esses exemplos criam uma matriz a partir de entradas:

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

Createobject

Retornar um objeto vazio.

Tipo de valor retornado Descrição
objeto Um objeto vazio

Exemplo

Este exemplo cria uma matriz a partir de entradas e retorna {}.

createObject()

endswith

Verifique se uma cadeia de caracteres termina com uma substring específica. Retorne true quando a substring for encontrada ou retornar false quando não for encontrada. Essa função é sensível a casos.

Parâmetro Tipo Descrição
texto cadeia de caracteres A cadeia de caracteres para marcar
searchText cadeia de caracteres A substring final a ser encontrada
Tipo de valor retornado Descrição
boolean Retorne true quando a substring final for encontrada. Retornar false quando não for encontrado.

Exemplo 1

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

endsWith('hello world', 'world')

E retorna este resultado: true

Exemplo 2

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

endsWith('hello world', 'universe')

E retorna este resultado: false

Equals

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

Parâmetro Tipo Descrição
valor Qualquer Os valores, expressões ou objetos a serem comparados
Compareto Qualquer Os valores de comparação, expressões ou objetos
Tipo de valor retornado Descrição
boolean Retornar true quando ambos forem equivalentes. Retornar false quando não for equivalente.

Exemplos

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

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

E retorna estes resultados:

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

flutuação

Essa função tenta converter o valor de entrada em um número flutuante. Ele é usado para lançar o valor de um tipo mais amplo para flutuar.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
float O valor de flutuação convertido

Exemplo

Este exemplo afirma item de uma ação "Aplicar a cada" para ser do tipo float :

float(items('Appy to each'))

getManager

Obtenha a ID do gerenciador do usuário em Microsoft Entra ID.

Sobrecarga 1: Obter para um único usuário

Parâmetro Tipo Descrição
userId cadeia de caracteres A ID do usuário de entrada
Tipo de valor retornado Descrição
cadeia de caracteres ou nulo A ID do gerenciador ou nulo do usuário de entrada, se não existir

Sobrecarga 2: Obter para vários usuários

Parâmetro Tipo Descrição
userId matriz As IDs dos usuários de entrada
Tipo de valor retornado Descrição
matriz A união de IDs dos gerentes dos usuários de entrada

Exemplos

Esses exemplos obtêm os gerentes dos usuários de entrada:

getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])
  • Primeiro exemplo: o parâmetro de entrada é uma cadeia de caracteres, portanto, retorna a ID do gerenciador de Workflow.Requestor
  • Segundo exemplo: o parâmetro de entrada é uma matriz, portanto, retorna o conjunto de IDs de união de gerentes de Term.Stewards.

Getusername

Obtenha o nome do usuário em Microsoft Entra ID.

Sobrecarga 1: Obter para um único usuário

Parâmetro Tipo Descrição
userId cadeia de caracteres A ID do usuário de entrada
Tipo de valor retornado Descrição
cadeia de caracteres O nome do usuário de entrada

Sobrecarga 2: Obter para vários usuários

Parâmetro Tipo Descrição
userId matriz As IDs dos usuários de entrada
Tipo de valor retornado Descrição
matriz Os nomes dos usuários de entrada

Exemplos

Esses exemplos obtêm os nomes dos usuários de entrada:

getUserName(runInput()['requestor'])
getUserName(runInput()['term']['stewards'])
  • Primeiro exemplo: o parâmetro de entrada é uma cadeia de caracteres, portanto, retorna o nome de Workflow.Requestor
  • Segundo exemplo: o parâmetro de entrada é uma matriz, portanto, retorna uma matriz de nomes de Term.Stewards.

Maior

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

Sobrecarga 1: comparar números

Parâmetro Tipo Descrição
valor inteiro ou float O primeiro valor a marcar se maior que o segundo valor
Compareto inteiro ou float O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for maior que o segundo valor. Retorne false quando o primeiro valor for igual ou menor que o segundo valor.

Sobrecarga 2: comparar cadeias de caracteres

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar se maior que o segundo valor
Compareto cadeia de caracteres O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for maior que o segundo valor. Retorne false quando o primeiro valor for igual ou menor que o segundo valor.

Exemplos

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

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

E retorne esses resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

greaterOrEquals

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

Sobrecarga 1: comparar números

Parâmetro Tipo Descrição
valor inteiro ou float O primeiro valor a marcar maior ou igual ao segundo valor
Compareto inteiro ou float O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for maior ou igual ao segundo valor. Retorne false quando o primeiro valor for menor que o segundo valor.

Sobrecarga 2: comparar cadeias de caracteres

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar maior ou igual ao segundo valor
Compareto cadeia de caracteres O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for maior ou igual ao segundo valor. Retorne false quando o primeiro valor for menor que o segundo valor.

Exemplos

Esses exemplos marcar se o primeiro valor é maior ou igual ao segundo valor:

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

E retorne esses resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

int

Essa função tenta converter o valor de entrada em um número inteiro. Ele é usado para lançar o valor de um tipo mais amplo para inteiro.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
Inteiro O valor inteiro convertido

Exemplo

Este exemplo afirma item de uma ação "Aplicar a cada" para ser do tipo inteiro :

int(items('Appy to each'))

Comprimento

Retorne o número de itens em uma coleção ou o comprimento de uma cadeia de caracteres.

Parâmetro Tipo Descrição
valor cadeia de caracteres ou matriz A cadeia de caracteres ou a coleção com os itens a serem contados
Tipo de valor retornado Descrição
boolean O número de itens na coleção ou no comprimento da cadeia de caracteres

Exemplos

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

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

E ambos retornam este resultado: 4

Menos

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

Sobrecarga 1: comparar números

Parâmetro Tipo Descrição
valor inteiro ou float O primeiro valor a marcar se menor que o segundo valor
Compareto inteiro ou float O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for menor que o segundo valor. Retorne false quando o primeiro valor for igual ou maior que o segundo valor.

Sobrecarga 2: comparar cadeias de caracteres

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar se maior que o segundo valor
Compareto cadeia de caracteres O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for menor que o segundo valor. Retorne false quando o primeiro valor for igual ou maior que o segundo valor.

Exemplos

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

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

E retorne esses resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

lessOrEquals

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

Sobrecarga 1: comparar números

Parâmetro Tipo Descrição
valor inteiro ou float O primeiro valor a marcar menor ou igual ao segundo valor
Compareto inteiro ou float O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo valor.

Sobrecarga 2: comparar cadeias de caracteres

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar menor ou igual ao segundo valor
Compareto cadeia de caracteres O valor de comparação
Tipo de valor retornado Descrição
boolean Retorne true quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo valor.

Exemplos

Esses exemplos marcar se o primeiro valor é menor ou igual ao segundo valor.

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

E retorne esses resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

memberOfGroup

Verifique se o usuário é membro do grupo em Microsoft Entra ID. A ID do grupo pode ser encontrada na página de gerenciamento de grupo de ID Microsoft Entra.

Parâmetro Tipo Descrição
userId cadeia de caracteres A ID do usuário de entrada
groupId cadeia de caracteres A ID do grupo a ser marcar
Tipo de valor retornado Descrição
boolean Retornar true quando o usuário for um membro do grupo. Retorne false quando o usuário não for membro do grupo ou o grupo não existir.

Exemplo

Este exemplo marcar se Workflow.Requestor é um membro do grupo especificado:

memberOfGroup(runInput()['requestor'], '00000000-0000-0000-0000-111111111111')

not

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

Parâmetro Tipo Descrição
valor boolean A expressão para marcar
Tipo de valor retornado Descrição
boolean Retorne true quando a expressão for false. Retorne false quando a expressão for verdadeira.

Exemplos

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

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

E retorne esses resultados:

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

nullOrElse

Dê um valor padrão a um valor anulável. Retornar um valor não anulável.

Sobrecarga 1: versão de cadeia de caracteres

Parâmetro Tipo Descrição
valor cadeia de caracteres ou nulo O valor anulável
Defaultvalue cadeia de caracteres O valor de fallback
Tipo de valor retornado Descrição
cadeia de caracteres Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Sobrecarga 2: versão inteiro

Parâmetro Tipo Descrição
valor inteiro ou nulo O valor anulável
Defaultvalue Inteiro O valor de fallback
Tipo de valor retornado Descrição
Inteiro Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Sobrecarga 3: versão float

Parâmetro Tipo Descrição
valor float ou null O valor anulável
Defaultvalue float O valor de fallback
Tipo de valor retornado Descrição
float Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Sobrecarga 4: versão booliana

Parâmetro Tipo Descrição
valor booliano ou nulo O valor anulável
Defaultvalue boolean O valor de fallback
Tipo de valor retornado Descrição
boolean Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Sobrecarga 5: Versão da matriz

Parâmetro Tipo Descrição
valor matriz ou nulo O valor anulável
Defaultvalue matriz O valor de fallback
Tipo de valor retornado Descrição
matriz Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Sobrecarga 6: versão do objeto

Parâmetro Tipo Descrição
valor objeto ou nulo O valor anulável
Defaultvalue objeto O valor de fallback
Tipo de valor retornado Descrição
objeto Retorne o valor de entrada se ele não for nulo. Retorne o valor padrão se o valor de entrada for nulo.

Exemplo

Este exemplo fornece à variável anulável Term.Definition um valor 'Empty'padrão:

nullOrElse(runInput()['term']['definition'], 'Empty')

objeto

Essa função tenta converter o valor de entrada em um valor de objeto. Ele é usado para lançar o valor de um tipo mais amplo para objeto.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
boolean O valor do objeto convertido

Exemplo

Este exemplo afirma item de uma ação "Aplicar a cada" para ser do tipo de objeto :

object(items('Appy to each'))

ou

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

Parâmetro Tipo Descrição
valor boolean A primeira expressão a marcar
Valores... boolean As expressões restantes para marcar
Tipo de valor retornado Descrição
boolean Retorne true quando pelo menos uma expressão for verdadeira. Retorne false quando todas as expressões forem falsas.

Exemplos

Esses exemplos marcar se pelo menos uma expressão é verdadeira:

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

E retorne esses resultados:

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

startswith

Verifique se uma cadeia de caracteres começa com uma substring específica. Retorne true quando a substring for encontrada ou retornar false quando não for encontrada. Essa função é sensível a casos.

Parâmetro Tipo Descrição
texto cadeia de caracteres A cadeia de caracteres para marcar
searchText cadeia de caracteres A subconserção inicial a ser encontrada
Tipo de valor retornado Descrição
boolean Retorne true quando a substring inicial for encontrada. Retornar false quando não for encontrado.

Exemplo 1

Este exemplo verifica se a cadeia de caracteres "olá mundo" começa com a substring "olá":

startsWith('hello world', 'hello')

E retorna este resultado: true

Exemplo 2

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

startsWith('hello world', 'greetings')

E retorna este resultado: false

string

Essa função retorna a versão da cadeia de caracteres do valor.

Parâmetro Tipo Descrição
valor Qualquer O valor a ser convertido
Tipo de valor retornado Descrição
cadeia de caracteres A versão da cadeia de caracteres para o valor especificado. Se o parâmetro de valor for nulo, esse valor será retornado como um valor de cadeia de caracteres vazia ("").

Exemplos

Esses exemplos convertem o valor de entrada em uma cadeia de caracteres:

string('abc')
string(true)
string(createArray())

E retorne esses resultados:

  • Primeiro exemplo: o valor de entrada é uma cadeia de caracteres, portanto, retorna um valor 'abc'de identidade .
  • Segundo exemplo: a versão de cadeia de caracteres de valores boolianos é maiúscula, portanto, a função retorna 'True'.
  • Terceiro exemplo: matrizes ou objetos são convertidos no formulário JSON, portanto, a função retorna '[]'.

Próximas etapas

Para obter mais informações sobre fluxos de trabalho, confira estes artigos: