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.

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:

• Fluxos de trabalho no Microsoft Purview
• Fluxo de trabalho de aprovação para termos de negócios
• Gerenciar solicitações e aprovações de fluxo de trabalho