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 escolha. Certifique-se de usar o tipo de cápsula de dados de entrada correto 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 impróprio, os dados não serão transformados no tempo de execução e, em vez disso, o valor de entrada será retornado. Para obter mais informações sobre como confirmar os valores de tempo de execução do fluxo, consulte Testar 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 Item na matriz de entrada que você deseja retornar. O Nth Item representa o índice da 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 da matriz começa em 0.	Objeto Complexo

Obter item de nome/valores

Retorna um valor que está associado a uma chave correspondente de um mapa de pares de nome-valor.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Pares de nome-valor	Key - Nome da chave usada para pesquisar o 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 de nome/valores, considere que o valor de tempo de execução pode ser o valor do sistema, não o valor de exibição. Por exemplo, se estiver mapeando o campo Prioridade na tabela Incidente para um campo semelhante em uma tabela remota, o valor de tempo de execução retornado poderá ser 2, e 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 os dados do tíquete como um mapa de pares de 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 que está associado à chave ticket_id ou o 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 está em branco quando é uma cadeia de caracteres vazia. Uma entrada de número inteiro está em branco quando é zero. Uma entrada booliana está em branco quando é falsa.

Nota:

Esta função de transformação não é compatível com 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 de número inteiro 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 é falsa.

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 de número inteiro 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 está em branco quando não é uma cadeia de caracteres vazia. Um número inteiro não está em branco quando não é zero. Uma entrada booliana não está em branco quando é verdadeira.

Nota:

Esta função de transformação não é compatível com 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 de número inteiro 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 nula.

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

Exemplo de uso:

• Entrada: uma cápsula de dados de número inteiro 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, exceto zero. Uma entrada booliana é verdadeira quando é verdadeira.

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 de número inteiro 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 número 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 Nome-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 log 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
Array.String, Array.Integer, Array.Boolean ou Array.Datetime. - Matriz não classificada	Sort Order - Crescente ou decrescente	Matriz - Matriz classificada

Nota:

A função de classificação faz distinção entre maiúsculas e 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
Array.String, Array.Integer, Array.Boolean ou Array.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
Array.String, Array.Integer, Array.Boolean ou Array.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: 1<2<3