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:
- Selecione o valor que vai editar.
- Selecione o botão Adicionar conteúdo dinâmico que aparece por baixo da caixa de texto.
- Selecione o separador Expressões na janela de conteúdo dinâmico e desloque-se para selecionar o seu valor.
- Atualize a expressão e selecione OK para a adicionar.
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: