Crie sua primeira transformação no Jitterbit Integration Studio

Introdução

Esta página mostra como criar uma transformação simples que mapeia dados de clientes de um banco de dados para o formato JSON. Você aprenderá o fluxo de trabalho básico para construir transformações no Integration Studio.

Ao seguir este guia, você criará uma transformação que faz o seguinte:

• Obtém dados de clientes de uma consulta ao banco de dados.

• Mapeia os campos para um formato de saída JSON.

• Adiciona um campo calculado para o nome completo do cliente.

A consulta ao banco de dados fornece dados usando este esquema:

firstName: "Rosario"
lastName: "Garcia"
email: "rosario.garcia@example.com"
status: "active"

{
  "fullName": "Rosario Garcia",
  "contactEmail": "rosario.garcia@example.com",
  "isActive": true
}

Pré-requisitos

Antes de criar uma transformação, você precisa do seguinte:

• Um projeto existente no Integration Studio.

• Familiaridade básica com a interface do Integration Studio.

• Compreensão dos conceitos-chave de transformação.

Etapa 1: Crie uma operação

Primeiro, crie uma operação com atividades de origem e destino configuradas. Neste guia, uma atividade de Consulta ao Banco de Dados está sendo usada como origem e uma atividade de Gravação de Variável está sendo usada como destino:

Para informações sobre como configurar um endpoint específico, consulte a documentação dos Conectores. Para entender como os esquemas são herdados das atividades, veja Escolher fontes de esquema.

Etapa 2: Adicione uma transformação

1. Passe o mouse entre as duas atividades até ver a zona de queda da transformação:

   

2. Clique em Nova Transformação.

3. Uma nova transformação é aberta com estes esquemas:

   

   • Esquema de origem à esquerda (herdado da atividade de Banco de Dados).
   • Esquema de destino à direita (herdado do esquema definido pelo usuário fornecido na atividade HTTP v2).

Passo 3: Mapear campos

Crie mapeamentos entre os campos de origem e destino.

Mapear o campo de email manualmente

1. Do lado da origem, arraste o campo email para o campo de destino contactEmail.

2. O mapeamento aparece como uma linha conectando os campos, e o campo de destino mostra a origem mapeada:

   

Mapear o campo de status com transformação

1. Passe o mouse sobre o campo de destino isActive e clique em Expandir ou Adicionar valor personalizado.

2. Na área de script que se abre, insira este script:

   If(status == "active", 1, 0)
   

   

O script converte o status de texto em um valor booleano em tempo de execução.

Criar um campo calculado

1. Passe o mouse sobre o campo de destino fullName e clique em Expandir ou Adicionar valor personalizado.

2. Insira este script para combinar o primeiro e o último nome:

   firstName + " " + lastName
   

Etapa 4: Teste sua transformação

Use o modo de visualização para testar sua transformação com dados de exemplo:

1. Clique em Visualizar na barra de ferramentas de transformação.

2. Na tela de configuração, selecione Criar dados fictícios a partir da estrutura de origem.

3. Clique em Concluído.

4. Revise os dados de exemplo no modo de visualização para verificar se seus mapeamentos funcionam corretamente:

   

   A visualização mostra o seguinte:

   • Dados de origem à esquerda com valores de exemplo.
   • Dados de destino à direita com seus valores transformados.
   • Quaisquer erros de mapeamento destacados em vermelho.

Etapa 5: Validar

1. Feche a transformação para retornar à visualização da operação:

   

2. Verifique se sua operação não apresenta erros de validação.

Próximas etapas

Para continuar aprendendo sobre transformações, veja estes recursos:

• Escolher fontes de esquema para aprender sobre diferentes maneiras de definir esquemas.
• Navegar pela interface para explorar ferramentas de transformação.
• Mapear estruturas idênticas para aprender sobre automapeamento.