Funções de transformação

Transforme valores de cápsula de dados sem a necessidade de escrever um script. Use funções de transformação para reformatar texto, executar cálculos matemáticos, limpar instruções SQL potencialmente inseguras e serializar objetos complexos em XML bruto.

As categorias de função de transformação disponíveis incluem data e hora, cadeia de caracteres, utilitários, matemática simples, limpar argumentos de shell, limpar SQLe dados complexos. Alguns exemplos de usos da função de transformação incluem:

• Cortar o espaço em branco de uma cadeia de caracteres antes de integrá-la ao CMDB.
• Adicionar dias, horas, minutos e segundos a uma data ou hora para localizar um fuso horário específico.
• Limpeza de valores SQL para impedir a injeção como parte de uma etapa JDBC para um spoke Integration Hub.
• Recuperar um valor apropriado de um mapa de prioridades que tem valores equivalentes em um banco de dados de terceiros.
• Transformação de um objeto complexo em XML bruto como parte de um campo Corpo da solicitaçãode etapa REST.

Nota:

As funções de transformação personalizadas não são compatíveis no momento. Para obter informações sobre como criar funções personalizadas para transformar dados Workflow Studio, consulte Scripts em linha.

Aplicando uma função de transformação

Você pode aplicar uma função de transformação a uma cápsula de dados ao projetar ou criar um fluxo. Para aplicar uma função de transformação, aponte ou tabule para uma cápsula de dados e selecione o ícone f(x) ( ) que aparece. Selecionar o ícone exibe a lista de transformações disponíveis. Selecione a função de transformação que você deseja aplicar à cápsula de dados, insira as informações nos campos obrigatórios e selecione Aplicar. A função de transformação selecionada aparece na lista Transformações aplicadas.

Aplicando várias funções de transformação

Você pode aplicar várias funções de transformação à mesma cápsula de dados. O sistema aplica funções de transformação sequencialmente de cima para baixo, conforme listado na lista Transformações aplicadas. Por exemplo, você pode aplicar uma função de transformação de cadeia de caracteres para data seguida pela função de transformação Adicionar hora.

Exibição de funções de transformação aplicadas

Você pode descobrir quais funções de transformação são aplicadas a uma cápsula de dados consultando a lista Transformações aplicadas. Ao projetar ou criar um fluxo ou ação, aponte para a cápsula de dados ou use a tecla Tab e selecione o ícone f(x) ( ). Você também pode exibir as funções de transformação aplicadas nos detalhes de execução do fluxo.

Nota:

Os valores de saída para funções de transformação aplicadas são valores de campo, não valores de exibição.

Quando uma cápsula de dados é solta em determinados tipos de entradas, o sistema sugere automaticamente uma categoria de função de transformação relacionada à entrada. Por exemplo, o sistema sugere funções de transformação para escapar de caracteres especiais em instruções SQL, impedir a injeção de script em scripts de shell e validar solicitações de API ou operação. Atualmente, o sistema sugere categorias de função de transformação para estas entradas:

• Para cápsulas de dados descartadas na entrada da Instrução SQL da etapa JDBC, a categoria de função de transformação limpar SQL é exibida automaticamente.
• Para cápsulas de dados descartadas na entrada do Comando da etapa SSH, a categoria de função de transformação limpar argumentos de shell é exibida automaticamente.

Diretrizes gerais

Aplicar funções de transformação a tipos válidos de cápsulas de dados para a entrada

Certifique-se de verificar o tipo de cápsula de dados da entrada antes de aplicar uma função de transformação. A aplicação de uma função de transformação a um tipo de cápsula de dados inválido faz com que o sistema ignore a transformação. Também ocorrerá um erro se as funções de transformação produzirem resultados que o sistema não possa analisar. Por exemplo, ao transformar uma cadeia de caracteres em uma data, o sistema emitirá um erro se a transformação não produzir uma data válida.

Confirmar funções de transformação aplicadas para várias entradas com a mesma cápsula de dados

Uma função de transformação cria um novo valor no tempo de execução para uma entrada específica e não muda a cápsula de dados original. Se você usar a mesma cápsula de dados em várias ações ou etapas, as funções de transformação deverão ser aplicadas a cada entrada individualt.

Exibir valores transformados finais nos detalhes de execução do fluxo

Somente o valor transformado final aparece nos detalhes de execução do fluxoe não o valor de cada transformação aplicada.

Testar funções de transformação para verificar se elas produzem os resultados esperados

Certifique-se de que suas funções de transformação produzam os valores de tempo de execução esperados para as cápsulas de dados. Para obter mais informações, consulte Testar um fluxo e Testar uma ação.

• Funções de transformação de data e hora
  Use funções de transformação de data e hora para recalcular ou reformatar cápsulas de dados para valores de data/hora.
• Funções de transformação de cadeia de caracteres
  Use funções de transformação de cadeia de caracteres para reformatar ou executar cálculos em cápsulas de dados de cadeia de caracteres.
• 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.
• Funções de transformação matemática simples
  Use funções de transformação matemática simples para executar cálculos matemáticos básicos em cápsulas de dados numéricos.
• Limpar funções de transformação de argumentos de shell
  Use as funções de transformação de limpar argumentos do shell para remover quaisquer injeções de comando potencialmente inseguras em cápsulas de dados de cadeia de caracteres a serem usadas para scripts de shell do Bash.
• Limpar funções de transformação do SQL
  Use as funções de transformação SQL de limpeza para escapar de caracteres especiais e impedir a injeção em cápsulas de dados de cadeia de caracteres a serem usadas para instruções SQL.
• Funções de transformação de dados complexos
  Use funções de transformação de dados complexos para serializar cápsulas de dados de objeto complexo em um formato XML.