Compartilhar via


Conteúdo dinâmico de fluxos de trabalho

Observação

Catálogo de Dados do Microsoft Purview (clássico) e o Data Health Insights (clássico) já não assumem novos clientes e estes serviços, anteriormente Azure Purview, estão agora no modo de suporte ao cliente.

Importante

Este recurso está atualmente no modo de visualização. Os Termos de Utilização Suplementares das Pré-visualizações do Microsoft Azure incluem termos legais adicionais que se aplicam às funcionalidades do Azure que estão em versão beta, em pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Pode utilizar conteúdo dinâmico dentro dos fluxos de trabalho do Microsoft Purview para associar determinadas variáveis no fluxo de trabalho ou adicionar outras expressões para processar estes valores.

Quando adiciona conteúdo dinâmico aos seus fluxos de trabalho, está a criar expressões de blocos modulares fornecidos que referenciam e processam informações no seu fluxo de trabalho para que possa obter os valores de que precisa em tempo real.

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

  • Variáveis incorporadas – variáveis que representam valores provenientes do fluxo de trabalho a partir dos itens que o acionaram
  • Expressões – fórmulas criadas a partir de funções e variáveis que podem processar valores no fluxo de trabalho.

Variáveis incorporadas

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

Conector de pré-requisitos Variável incorporada Funcionalidade Tipo Valores possíveis
Quando o pedido de acesso a dados é submetido
Quando o pedido de atualização de recursos é submetido
Workflow.Requestor O ID do requerente do fluxo de trabalho cadeia de caracteres
Asset.Name O nome do recurso cadeia de caracteres
Asset.Description A descrição do recurso cadeia ou nulo
Asset.Type O tipo do recurso cadeia de caracteres
Nome Completamente Qualificado de Asset. O nome completamente qualificado do recurso cadeia de caracteres
Asset.Owner Os IDs dos proprietários de dados do recurso matriz de cadeias
Asset.Classification Os nomes a apresentar das classificações do recurso matriz de cadeias
Asset.Schema.Classification Os nomes a apresentar das classificações aplicadas a uma coluna no esquema de recursos matriz de cadeias
Asset.Is Certificado O indicador de se o recurso cumpre os padrões de qualidade da sua organização e pode ser considerado fiável boolean true ou false
Quando o pedido de acesso a dados é submetido Fluxo de Trabalho.Destinatário do Pedido O ID do destinatário do pedido 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'
Approval.Assigned To Os IDs dos aprovadores matriz de cadeias
Approval.Comments Os nomes dos aprovadores e os respetivos comentários cadeia de caracteres
Verificar o registo da origem de dados para a governação de utilização de dados Governação de Utilização de Dados O resultado da marcar de governação de utilização de dados boolean true ou false
Quando o pedido de criação de termos é submetido Workflow.Requestor O ID do requerente 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 Os IDs dos especialistas do termo matriz de cadeias
Term.Stewards Os IDs dos administradores do termo matriz de cadeias
Term.Parent.Name O nome do termo principal, se existir cadeia de caracteres
Nome Term.Parent.Formal O nome formal do termo principal, se existir cadeia de caracteres
Quando o pedido de atualização de termos é submetido
Quando o pedido de eliminação de termos é submetido
Workflow.Requestor O requerente 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 ou nulo
Term.Experts Os IDs dos especialistas do termo matriz de cadeias
Term.Stewards Os IDs dos administradores do termo matriz de cadeias
Term.Parent.Name O nome do termo principal, se existir cadeia de caracteres
Nome Term.Parent.Formal O nome formal do termo principal, se existir cadeia de caracteres
Term.Created By O ID do criador do termo cadeia de caracteres
Term.Last Updated By O ID do último atualizador do termo cadeia de caracteres
Quando o pedido de importação de termos é submetido Workflow.Requestor O ID do requerente do fluxo de trabalho cadeia de caracteres
Importar File.Name O nome do ficheiro a importar cadeia de caracteres
Http Http.Body Corpo da resposta HTTP objeto ou cadeia
Http.Headers Cabeçalhos de resposta HTTP objeto
Código http.status Código de status de HTTP cadeia de caracteres
Aplicar a cada Item O item atual da ação Aplicar a Cada Qualquer
Até Índice O índice de iteração atual da ação Until inteiro
Criar registo
Eliminar registo
Obter registo
Atualizar registo
Resultado O resultado da ação ServiceNow objeto
Obter tipos de registo
Listar registos
Resultado O resultado da ação ServiceNow matriz de objetoss

Expressões

As definições de fluxo de trabalho no Microsoft Purview permitem-lhe utilizar funções nas expressões para processar valores nos fluxos de trabalho.

Para localizar funções com base na respetiva finalidade geral, reveja as seguintes tabelas. Em alternativa, para obter informações detalhadas sobre cada função, consulte a lista alfabética.

Quando estiver a criar um fluxo de trabalho e quiser adicionar uma função às suas expressões, siga estes passos:

  1. Selecione o valor que vai editar.
  2. Selecione o botão Adicionar conteúdo dinâmico que aparece por baixo da caixa de texto.
  3. Selecione o separador Expressões na janela de conteúdo dinâmico e desloque-se para selecionar o seu valor.
  4. Atualize a expressão e selecione OK para a adicionar.

Captura de ecrã a mostrar um campo de texto de fluxo de trabalho com a opção Utilizar conteúdo dinâmico realçado e o separador expressões apresentado.

Considerações

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

  • As funções que aparecem inline com texto simples requerem a colocação de chavetas ({}) para utilizar o formato interpolado da expressão. Este formato ajuda a evitar problemas de análise. Se a expressão de função não aparecer inline com texto simples, não são necessárias chavetas.

    O exemplo seguinte 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 múltiplas versões de uma função com o mesmo nome, mas diferentes formas de realizar uma tarefa, consoante a entrada que lhes der.

As secções seguintes organizam funções com base na respetiva finalidade geral ou pode procurar estas funções por ordem alfabética.

Funções de cadeia

Para trabalhar com cadeias, pode utilizar estas funções de cadeia e também algumas funções de coleção. As funções de cadeia só funcionam em cadeias.

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

Funções de coleção

Para trabalhar com coleções, geralmente matrizes, cadeias e, por vezes, dicionários, pode utilizar estas funções de coleção.

Função Coleção Tarefa
contém Verifique se uma coleção tem um item específico.
comprimento Devolver o número de itens numa coleção ou o comprimento de uma cadeia.

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, pode utilizar estas 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. Devolver verdadeiro quando a expressão for falsa ou devolver falso quando for verdadeira.
and Verifique se todas as expressões são verdadeiras. Devolver verdadeiro quando todas as expressões forem verdadeiras ou devolver falso quando, pelo menos, uma expressão for falsa.
or Verifique se, pelo menos, uma expressão é verdadeira. Devolver verdadeiro quando, pelo menos, uma expressão for verdadeira ou devolver falso quando todas forem falsas.
é igual a 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 é inferior ao segundo valor.
lessOrEquals Verifique se o primeiro valor é menor ou igual ao segundo valor.

Funções do usuário

Para trabalhar com utilizadores, as respetivas relações com outros utilizadores e grupos e os recursos a que acedem, por exemplo, os respetivos e-mails, calendários, ficheiros, funções administrativas, associações a grupos. Para obter a referência completa sobre cada função, consulte a lista alfabética.

Função de utilizador Tarefa
getUserName Obtenha o nome do utilizador.
getManager Obtenha o ID do gestor do utilizador.
memberOfGroup Verifique se o utilizador é membro do grupo.

Funções de conversão

Para alterar o tipo ou formato de um valor, pode utilizar estas 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 Devolver uma matriz de qualquer número de entradas.
createObject Devolver um objeto vazio.
cadeia de caracteres Devolver a versão da cadeia de carateres para um valor.
int Tente converter o valor de entrada num número inteiro.
float Tente converter o valor de entrada num número flutuante.
bool Tente converter o valor de entrada num valor booleano.
objeto Tente converter o valor de entrada num objeto.
matriz Tente converter o valor de entrada numa matriz.
nullOrElse Atribua um valor predefinido a um valor anulável.

Todas as funções - lista alfabética

e

Verifique se todas as expressões são verdadeiras. Devolver verdadeiro quando todas as expressões forem verdadeiras ou devolver falso quando, pelo menos, uma expressão for falsa.

Parâmetro Tipo Descrição
valor boolean A primeira expressão a marcar
valores... boolean As restantes expressões para marcar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando todas as expressões forem verdadeiras. Devolver falso 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 devolve estes resultados:

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

array

Esta função tenta converter o valor de entrada numa matriz. É utilizado para converter o valor de um tipo mais amplo para matriz. Para criar uma matriz a partir de itens, veja createArray.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido 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

Esta função tenta converter o valor de entrada num valor booleano. É utilizado para converter o valor de um tipo mais amplo para booleano.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido Descrição
boolean O valor booleano convertido

Exemplo

Este exemplo afirma Item de uma ação "Aplicar a cada" para ser de tipo booleano :

bool(items('Appy to each'))

contains

Verifique se uma coleção tem um item específico. Devolver verdadeiro quando o item for encontrado ou devolver falso quando não for encontrado.

Sobrecarga 1: uma cadeia para localizar uma subcadeia

Esta sobrecarga é sensível a maiúsculas e minúsculas.

Parâmetro Tipo Descrição
coleção cadeia de caracteres A cadeia a marcar
valor cadeia de caracteres A subcadeia a localizar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando a subcadeia for encontrada. Devolver falso quando não for encontrado.

Sobrecarga 2: uma matriz para localizar um valor

Parâmetro Tipo Descrição
coleção matriz A coleção a marcar
valor Qualquer O item a localizar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o item for encontrado. Devolver falso quando não for encontrado.

Exemplo 1

Este exemplo verifica a cadeia "hello world" para a subcadeia "world" e devolve 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

Devolver uma matriz de qualquer número de entradas. Esta função não requer que os valores de entrada sejam do mesmo tipo.

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

Exemplos

Estes exemplos criam uma matriz a partir de entradas:

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

createObject

Devolver um objeto vazio.

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

Exemplo

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

createObject()

endswith

Verifique se uma cadeia termina com uma subcadeia específica. Devolva true quando a subcadeia for encontrada ou devolva false quando não for encontrada. Esta função é sensível a maiúsculas e minúsculas.

Parâmetro Tipo Descrição
texto cadeia de caracteres A cadeia a marcar
searchText cadeia de caracteres A subcadeia final a localizar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando a subcadeia final for encontrada. Devolver falso quando não for encontrado.

Exemplo 1

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

endsWith('hello world', 'world')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia "hello world" termina com a cadeia "universo":

endsWith('hello world', 'universe')

E devolve este resultado: false

é igual a

Verifique se ambos os valores, expressões ou objetos são equivalentes. Devolver verdadeiro quando ambos forem equivalentes ou devolver falso quando não forem equivalentes.

Parâmetro Tipo Descrição
valor Qualquer Os valores, expressões ou objetos a comparar
compareTo Qualquer Os valores, expressões ou objetos de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando ambos forem equivalentes. Devolver falso quando não for equivalente.

Exemplos

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

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

E devolve estes resultados:

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

flutuação

Esta função tenta converter o valor de entrada num número flutuante. É utilizado para converter o valor de um tipo mais amplo para flutuar.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido Descrição
float O valor flutuante 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 o ID do gestor do utilizador no Microsoft Entra ID.

Sobrecarga 1: Obter para um único utilizador

Parâmetro Tipo Descrição
userId cadeia de caracteres O ID do utilizador de entrada
Tipo de valor devolvido Descrição
cadeia ou nulo O ID do gestor do utilizador de entrada ou nulo se não existir

Sobrecarga 2: Obter para vários utilizadores

Parâmetro Tipo Descrição
userId matriz Os IDs dos utilizadores de entrada
Tipo de valor devolvido Descrição
matriz A união de IDs dos gestores de utilizadores de entrada

Exemplos

Estes exemplos obtêm os gestores dos utilizadores de entrada:

getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])
  • Primeiro exemplo: o parâmetro de entrada é uma cadeia, pelo que devolve o ID do gestor de Workflow.Requestor
  • Segundo exemplo: o parâmetro de entrada é uma matriz, pelo que devolve o conjunto união de IDs dos gestores de Term.Stewards.

getUserName

Obtenha o nome do utilizador no Microsoft Entra ID.

Sobrecarga 1: Obter para um único utilizador

Parâmetro Tipo Descrição
userId cadeia de caracteres O ID do utilizador de entrada
Tipo de valor devolvido Descrição
cadeia de caracteres O nome do utilizador de entrada

Sobrecarga 2: Obter para vários utilizadores

Parâmetro Tipo Descrição
userId matriz Os IDs dos utilizadores de entrada
Tipo de valor devolvido Descrição
matriz Os nomes dos utilizadores de entrada

Exemplos

Estes exemplos obtêm os nomes dos utilizadores de entrada:

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

maior

Verifique se o primeiro valor é maior que o segundo valor. Devolver verdadeiro quando o primeiro valor for mais ou devolver falso quando menor.

Sobrecarga 1: Comparar números

Parâmetro Tipo Descrição
valor número inteiro ou flutuante O primeiro valor a marcar se é maior que o segundo valor
compareTo número inteiro ou flutuante O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for maior que o segundo valor. Devolver falso quando o primeiro valor for igual ou inferior ao segundo valor.

Sobrecarga 2: Comparar cadeias

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 devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for maior que o segundo valor. Devolver falso quando o primeiro valor for igual ou inferior ao segundo valor.

Exemplos

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

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

E devolve estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

greaterOrEquals

Verifique se o primeiro valor é maior ou igual ao segundo valor. Devolver verdadeiro quando o primeiro valor for maior ou igual ou devolver falso quando o primeiro valor for menor.

Sobrecarga 1: Comparar números

Parâmetro Tipo Descrição
valor número inteiro ou flutuante O primeiro valor a marcar se é maior ou igual ao segundo valor
compareTo número inteiro ou flutuante O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for maior ou igual ao segundo valor. Devolver falso quando o primeiro valor for inferior ao segundo valor.

Sobrecarga 2: Comparar cadeias

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar se é maior ou igual ao segundo valor
compareTo cadeia de caracteres O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for maior ou igual ao segundo valor. Devolver falso quando o primeiro valor for inferior ao segundo valor.

Exemplos

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

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

E devolve estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

int

Esta função tenta converter o valor de entrada num número inteiro. É utilizado para converter o valor de um tipo mais amplo para um número inteiro.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido Descrição
número inteiro O valor inteiro convertido

Exemplo

Este exemplo afirma Item de uma ação "Aplicar a cada" para ser do tipo de número inteiro :

int(items('Appy to each'))

Comprimento

Devolver o número de itens numa coleção ou o comprimento de uma cadeia.

Parâmetro Tipo Descrição
valor cadeia ou matriz A cadeia ou a coleção com os itens a contar
Tipo de valor devolvido Descrição
boolean O número de itens na coleção ou o comprimento da cadeia

Exemplos

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

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

E ambos devolvem este resultado: 4

menos

Verifique se o primeiro valor é inferior ao segundo valor. Devolver verdadeiro quando o primeiro valor for menor ou devolver falso quando o primeiro valor for maior.

Sobrecarga 1: Comparar números

Parâmetro Tipo Descrição
valor número inteiro ou flutuante O primeiro valor a marcar se é menor que o segundo valor
compareTo número inteiro ou flutuante O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for inferior ao segundo valor. Devolver falso quando o primeiro valor for igual ou superior ao segundo valor.

Sobrecarga 2: Comparar cadeias

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 devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for inferior ao segundo valor. Devolver falso quando o primeiro valor for igual ou superior ao segundo valor.

Exemplos

Estes exemplos marcar se o primeiro valor é inferior ao segundo valor.

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

E devolve estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

lessOrEquals

Verifique se o primeiro valor é menor ou igual ao segundo valor. Devolver verdadeiro quando o primeiro valor for menor ou igual ou devolver falso quando o primeiro valor for superior.

Sobrecarga 1: Comparar números

Parâmetro Tipo Descrição
valor número inteiro ou flutuante O primeiro valor a marcar se é menor ou igual ao segundo valor
compareTo número inteiro ou flutuante O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for menor ou igual ao segundo valor. Devolver falso quando o primeiro valor for maior do que o segundo valor.

Sobrecarga 2: Comparar cadeias

Parâmetro Tipo Descrição
valor cadeia de caracteres O primeiro valor a marcar se é menor ou igual ao segundo valor
compareTo cadeia de caracteres O valor de comparação
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o primeiro valor for menor ou igual ao segundo valor. Devolver falso quando o primeiro valor for maior do que o segundo valor.

Exemplos

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

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

E devolve estes resultados:

  • Primeiro exemplo: true
  • Segundo exemplo: false

memberOfGroup

Verifique se o utilizador é membro do grupo no Microsoft Entra ID. O ID de Grupo pode ser encontrado na Microsoft Entra página de gestão de grupos.

Parâmetro Tipo Descrição
userId cadeia de caracteres O ID do utilizador de entrada
groupId cadeia de caracteres O ID do grupo a marcar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando o utilizador for membro do grupo. Devolver falso quando o utilizador não for membro do grupo ou se 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. Devolver verdadeiro quando a expressão for falsa ou devolver falso quando for verdadeira.

Parâmetro Tipo Descrição
valor boolean A expressão a marcar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando a expressão for falsa. Devolver falso 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 devolve estes resultados:

  • Primeiro exemplo: a expressão é falsa, pelo que a função devolve true.
  • Segundo exemplo: a expressão é verdadeira, pelo que a função devolve false.

nullOrElse

Atribua um valor predefinido a um valor anulável. Devolver um valor não anulável.

Sobrecarga 1: Versão da cadeia

Parâmetro Tipo Descrição
valor cadeia ou nulo O valor anulável
defaultValue cadeia de caracteres O valor de contingência
Tipo de valor devolvido Descrição
cadeia de caracteres Devolver o valor de entrada se não for nulo. Devolver o valor predefinido se o valor de entrada for nulo.

Sobrecarga 2: versão de número inteiro

Parâmetro Tipo Descrição
valor número inteiro ou nulo O valor anulável
defaultValue inteiro O valor de contingência
Tipo de valor devolvido Descrição
número inteiro Devolver o valor de entrada se não for nulo. Devolver o valor predefinido se o valor de entrada for nulo.

Sobrecarga 3: Versão flutuante

Parâmetro Tipo Descrição
valor float ou null O valor anulável
defaultValue float O valor de contingência
Tipo de valor devolvido Descrição
float Devolver o valor de entrada se não for nulo. Devolver o valor predefinido se o valor de entrada for nulo.

Sobrecarga 4: versão booleana

Parâmetro Tipo Descrição
valor booleano ou nulo O valor anulável
defaultValue boolean O valor de contingência
Tipo de valor devolvido Descrição
boolean Devolver o valor de entrada se não for nulo. Devolver o valor predefinido 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 contingência
Tipo de valor devolvido Descrição
matriz Devolver o valor de entrada se não for nulo. Devolver o valor predefinido 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 contingência
Tipo de valor devolvido Descrição
objeto Devolver o valor de entrada se não for nulo. Devolver o valor predefinido se o valor de entrada for nulo.

Exemplo

Este exemplo dá à variável anulável Term.Definition um valor 'Empty'predefinido:

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

objeto

Esta função tenta converter o valor de entrada num valor de objeto. É utilizado para converter o valor de um tipo mais amplo para objeto.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido 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. Devolver verdadeiro quando, pelo menos, uma expressão for verdadeira ou devolver falso quando todas forem falsas.

Parâmetro Tipo Descrição
valor boolean A primeira expressão a marcar
valores... boolean As restantes expressões para marcar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando, pelo menos, uma expressão for verdadeira. Devolver falso quando todas as expressões forem falsas.

Exemplos

Estes 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 devolve estes resultados:

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

startswith

Verifique se uma cadeia começa com uma subcadeia específica. Devolva true quando a subcadeia for encontrada ou devolva false quando não for encontrada. Esta função é sensível a maiúsculas e minúsculas.

Parâmetro Tipo Descrição
texto cadeia de caracteres A cadeia a marcar
searchText cadeia de caracteres A subcadeia inicial a localizar
Tipo de valor devolvido Descrição
boolean Devolver verdadeiro quando a subcadeia inicial for encontrada. Devolver falso quando não for encontrado.

Exemplo 1

Este exemplo verifica se a cadeia "hello world" começa com a subcadeia "hello":

startsWith('hello world', 'hello')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia "hello world" começa com a subcadeia "greetings":

startsWith('hello world', 'greetings')

E devolve este resultado: false

string

Esta função devolve a versão de cadeia do valor.

Parâmetro Tipo Descrição
valor Qualquer O valor a converter
Tipo de valor devolvido Descrição
cadeia de caracteres A versão da cadeia para o valor especificado. Se o parâmetro de valor for nulo, este valor é devolvido como um valor de cadeia vazia ("").

Exemplos

Estes exemplos convertem o valor de entrada numa cadeia:

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

E devolve estes resultados:

  • Primeiro exemplo: o valor de entrada é uma cadeia, pelo que devolve um valor 'abc'de identidade .
  • Segundo exemplo: a versão de cadeia de valores booleanos está em maiúscula, pelo que a função devolve 'True'.
  • Terceiro exemplo: as matrizes ou objetos são convertidos em formulário JSON, pelo que a função devolve '[]'.

Próximas etapas

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