Funções de transformação de utilitários

Use funções de transformação de utilitários para retornar um objeto complexo de uma matriz ou um valor associado a uma chave específica.

As funções de transformação de utilitários exigem uma matriz, par nome-valor, cadeia de caracteres, número inteiro ou cápsula de dados de entrada de escolha. Certifique-se de usar a entrada correta tipo de cápsula de dados ao aplicar funções de transformação de utilitários. Se uma função de transformação de utilitário for aplicada a um tipo de dados inadequado, os dados não serão transformados no tempo de execução e o valor de entrada será retornado. Para obter mais informações sobre como confirmar os valores de tempo de execução do fluxo, consulte Teste um fluxo .

Obter primeiro item da matriz

Retorna o primeiro item da matriz de entrada como um objeto complexo.

Cápsula de dados de entrada	Cápsula de dados de saída
Matriz	Complex Object - Primeiro item encontrado na matriz de entrada

Obter item da matriz

Retorna um objeto complexo a partir da matriz de entrada. Insira um valor para Nth ItemNa matriz de entrada que você deseja retornar. . Nth ItemRepresenta o índice de matriz, começando em 0.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Matriz	Nth Item - Insira o índice do objeto de destino na matriz de entrada. O índice de matriz começa em 0.	Objeto Complexo

Obter Item de Nome/Valores

Retorna um valor associado a uma chave correspondente de um mapa de pares Nome-Valor.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Pares Nome-Valor	Key - Nome da chave usada para pesquisar seu valor correspondente Default - O valor retornado quando não há chave correspondente	Cadeia de caracteres associada à chave correspondente

Nota:

Ao aplicar a função de transformação Obter item da função de transformação Nome/Valores, considere que o valor do tempo de execução pode ser o valor do sistema, não o valor de exibição. Por exemplo, se estiver mapeando Prioridade Na tabela Incidente a um campo semelhante em uma tabela remota, o valor de tempo de execução retornado pode ser 2, não 2 - Alto.

Exemplo de uso:

• Entrada: "username":"abel.tuter"
• Chave: nome de usuário
• Padrão: example.username
• Saída: abel.tuter

Neste exemplo, uma ação faz uma chamada REST para um sistema de terceiros e obtém dados do tíquete como um mapa de pares Nome-Valor. Um ID de tíquete é fornecido como uma saída para esta ação. A função de transformação Obter item de nome/valores retorna o valor associado ao tíquete_id chave ou ID do tíquete não encontrado .

Obter último item da matriz

Retorna o último item da matriz de entrada como um objeto complexo.

Cápsula de dados de entrada	Cápsula de dados de saída
Matriz	Complex Object Último item encontrado na matriz de entrada

Está em branco

Retorna verdadeiro quando a entrada está em branco. Uma entrada de cadeia de caracteres fica em branco quando é uma cadeia de caracteres vazia. Uma entrada de número inteiro fica em branco quando é zero. Uma entrada booliana fica em branco quando está falso .

Nota:

Esta função de transformação não oferece suporte a entradas de referência.

Cápsula de dados de entrada	Saída
Qualquer	Retorna verdadeiro ou falso

Exemplo de uso:

• Entrada: Uma cápsula de dados inteiros com 0
• Saída: verdadeiro

Falso

Retorna verdadeiro quando a entrada é falsa. Uma cadeia de caracteres é falsa quando é uma cadeia de caracteres vazia. Um número inteiro é falso quando é zero. Uma entrada booliana é falsa quando é falso .

Cápsula de dados de entrada	Cápsula de dados de saída
Qualquer	Retorna verdadeiro ou falso

Exemplo de uso:

• Entrada: Uma cápsula de dados inteiros com 13
• Saída: falso

Não está em branco

Retorna verdadeiro quando a entrada não está em branco. Uma cadeia de caracteres não fica em branco quando não é uma cadeia de caracteres vazia. Um número inteiro não fica em branco quando é qualquer coisa, menos zero. Uma entrada booliana não fica em branco quando está verdadeiro .

Nota:

Esta função de transformação não oferece suporte a entradas de referência.

Cápsula de dados de entrada	Cápsula de dados de saída
Qualquer	Retorna verdadeiro ou falso

Exemplo de uso:

• Entrada: Uma cápsula de dados inteiros com 13
• Saída: verdadeiro

Nulo

Retorna verdadeiro quando o valor de entrada é nulo. Uma entrada será nula se não for inicializada ou se for um objeto ou referência nulo.

Cápsula de dados de entrada	Saída
Qualquer	Retorna verdadeiro ou falso

Exemplo de uso:

• Entrada: Uma cápsula de dados inteiros com 725
• Saída: falso

Verdadeiro

Retorna verdadeiro quando a entrada é verdadeira. Uma cadeia de caracteres é verdadeira quando não é uma cadeia de caracteres vazia. Um número inteiro é verdadeiro quando é qualquer coisa, menos zero. Uma entrada booliana é verdadeira quando é verdadeiro .

Cápsula de dados de entrada	Cápsula de dados de saída
Qualquer	Retorna verdadeiro ou falso

Exemplo de uso:

• Entrada: Uma cápsula de dados inteiros com 13
• Saída: verdadeiro

Mapa de valor de chave

Retorna um valor associado a uma chave correspondente ou um valor padrão se não houver uma correspondência.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres ou Inteiro	Name - A chave usada para encontrar o valor correspondente Value - O valor correspondente a uma chave específica Default - O valor retornado quando não há nome correspondente	Cadeia de caracteres associada à chave correspondente

Exemplo de uso:

Neste exemplo, uma ação de log armazena a prioridade de um registro como uma mensagem. Na seção Nomes-Valores, cada prioridade é mapeada para um valor de cadeia de caracteres correspondente. Quando o fluxo é executado, o número de prioridade do registro é transformado em uma cadeia de caracteres e a cadeia de caracteres é registrada em uma mensagem.

Classificação

Classifica a matriz especificada em ordem crescente ou decrescente.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Matriz.Cadeia de caracteres, Matriz.Inteiro, Matriz.Booliano ou Matriz.DateTime. Matriz não classificada	Sort Order - Crescente ou decrescente	Matriz - Matriz classificada

Nota:

A função de classificação diferencia maiúsculas de minúsculas para array.strings.

Exemplo de uso:

• Entrada: [7, 2, 3, 1, 7, 9]
• Parâmetro: Crescente
• Saída: [1, 2, 3, 7, 7, 9]

Exclusivo

Remove os elementos duplicados da matriz especificada.

Cápsula de dados de entrada	Cápsula de dados de saída
Matriz.Cadeia de caracteres, Matriz.Inteiro, Matriz.Booliano ou Matriz.DateTime.	Matriz - Depois que os elementos duplicados são removidos

Exemplo de uso:

• Entrada: [7, 2, 3, 2, 7, 9]
• Saída: [7, 2, 3, 9]

Ingressar

Concatena os elementos individuais da matriz especificada com o delimitador especificado e retorna a cadeia de caracteres concatenada.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Matriz.Cadeia de caracteres, Matriz.Inteiro, Matriz.Booliano ou Matriz.DateTime.	Delimitador - caractere que separa os elementos individuais após a concatenação.	Cadeia de caracteres - Cadeia de caracteres após a adição de um delimitador.

Exemplo de uso:

• Entrada: [1, 2, 3]
• Parâmetros: .
• Saída: 2 1 3