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 , limpe argumentos de shell , Limpe o SQL e. dados complexos . Alguns exemplos de usos da função de transformação incluem:
- Aparando o espaço em branco de uma cadeia de caracteres antes de integrá-lo ao CMDB.
- Adição de dias, horas, minutos e segundos a uma data ou hora para localizar um fuso horário específico.
- Limpar valores SQL para evitar injeção como parte de um Etapa JDBC para um IntegrationHub spoke.
- Recuperando um valor apropriado de um mapa de prioridades que têm valores equivalentes em um banco de dados de terceiros.
- Transformar um objeto complexo em XML bruto como parte de um Etapa REST Corpo da solicitação campo.
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 tabulação a uma cápsula de dados e selecione f(x) ( 
) que aparece. A seleção do í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 informações em todos os 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 Adicionar transformação de tempo.
Exibindo funções de transformação aplicadas
). Você também pode exibir funções de transformação aplicadas no detalhes da execução do fluxo .- 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
- Aplique 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 ocorre um erro se as funções de transformação produzirem resultados que o sistema não pode analisar. Por exemplo, ao transformar uma cadeia de caracteres em uma data, o sistema gera um erro se a transformação não produzir uma data válida.
- Confirme as funções de transformação aplicadas para várias entradas com o mesmo 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 devem, portanto, ser aplicadas a cada entrada individual t.
- Exiba os valores transformados finais nos detalhes da execução do fluxo
- Somente o valor transformado final aparece em detalhes da execução do fluxo e não o valor de cada transformação aplicada.
- Teste as 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 Teste um fluxo e. Teste uma ação .