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 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á-la em CMDB.
• Adicionar 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.

Nota:

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 Workflow Studio dados, 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 tabulação a uma cápsula de dados e selecione f(x) ( ícone ) que aparece. Selecionar o ícone exibe a lista 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 . Sua função de transformação selecionada aparece na lista Transformações aplicadas.

Aplicação de 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 cadeia de caracteres à função Transformação de data seguida pela função Adicionar transformação de tempo.

Exibindo funções de transformação aplicadas

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

Nota:

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

Quando uma cápsula de dados é descartada 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 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

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. Aplicar 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 pode analisar. Por exemplo, ao transformar uma cadeia de caracteres em uma data, o sistema emite 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 .

• Funções de transformação de data e hora
  Use as 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
  Limpe as funções de transformação de 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 script de shell do Bash.
• Limpar funções de transformação SQL
  Use Limpar funções de transformação SQL para escapar 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 complexas de transformação de dados
  Use funções complexas de transformação de dados para serializar cápsulas de dados de objetos complexos em um formato XML.