Consulte os conectores compatíveis com a integração de aplicativos.

Tarefa do Data Transformer

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

A tarefa Data Transformer oferece dois modos (Diagram e Script) para transformar dados. No modo Diagrama, você usa uma tela de mapeamento visual, chamada de editor do transformador de dados, para realizar atribuições e mapeamentos de dados na sua integração. Além disso, também é possível usar as transformações compatíveis para transformar seus dados em variáveis e formatos significativos e torná-los acessíveis a outras tarefas ou acionadores na integração. No modo Script, é possível escrever, editar e avaliar modelos personalizados em Jsonnet (em inglês) para realizar o mapeamento de dados na sua integração.

Para informações sobre o mapeamento de dados na Application Integration, consulte Visão geral do mapeamento de dados.

Configurar a tarefa do transformador de dados

Para adicionar uma tarefa do transformador de dados à integração, siga estas etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrations aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma nova.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
5. Clique e posicione o elemento Data Transformer no editor de integração.
6. Clique no elemento Data Transformer para conferir o painel de configuração da tarefa.
7. Clique em Abrir editor do transformador de dados. Na página Editor de tarefas do transformador de dados (pré-lançamento), selecione uma das seguintes opções:
• Por padrão, o modo Diagrama é aberto. O modo Diagrama oferece uma experiência baseada em console para selecionar as variáveis de entrada e saída e realizar transformações no editor de transformação de dados.

  No modo Diagram, é possível realizar o mapeamento de dados visualmente entre variáveis de entrada e saída.

• Para realizar transformações de dados na sua integração escrevendo, editando e avaliando modelos personalizados do Jsonnet, acesse o modo de script clicando em Script. Use o modo Script se você tiver requisitos complexos de transformação de dados e quiser aproveitar as funções do Jsonnet.

  O editor do transformador de dados é exibido com um exemplo de modelo comentado em Jsonnet padrão. Escreva seu código Jsonnet e feche o editor quando ele for concluído. Todas as alterações serão salvas automaticamente.

Para ver etapas detalhadas sobre como adicionar um mapeamento, consulte Adicionar um mapeamento.

Adicionar um mapeamento

Para adicionar um mapeamento, use o modo Diagrama ou Script.

Usar o modo de diagrama

O modo Diagrama oferece uma experiência baseada em console para selecionar as variáveis de entrada e saída e realizar transformações no editor de transformação de dados. Para adicionar um mapeamento usando o modo Diagrama, siga estas etapas:

1. No painel de configuração da tarefa do Data Transformer, clique em Abrir editor do Data Transformer.

   Por padrão, o modo Diagrama está aberto.

   

2. Para adicionar a variável de entrada para o mapeamento, clique em + Adicionar entrada. A caixa de diálogo Choose Input Variable or Value aparece. A guia Variável é selecionada por padrão.
   Entrada: origem da entrada de transformação de dados. A origem pode ser um valor literal, uma função base ou uma variável de entrada, com funções de mapeamento.

   

   Em seguida, faça o seguinte:

   1. Na lista Selecionar variáveis, selecione as variáveis de entrada. Se você quiser criar uma nova variável, clique em + Adicionar nova variável.
   2. Clique em Enviar.

   Se quiser adicionar uma constante, clique na guia Constante.

   Ao contrário das variáveis, as constantes não são acessíveis a outras tarefas ou acionadores na integração e são limitadas apenas para uso na tarefa Transformação de dados em que são criadas. Por exemplo, é possível usar constantes para adicionar delimitadores ou mapear um valor constante para uma variável.

   

   Em seguida, faça o seguinte:

   1. No campo Identificador de constante, insira o nome da constante.
   2. Na lista Tipo de dados, selecione um dos seguintes tipos de dados:
      • String
      • Booleano
      • Número
   3. No campo Enter the constant value, insira o valor.
   4. Clique em Enviar.
3. Para adicionar a variável de saída para o mapeamento, clique em + Adicionar saída e selecione a variável de saída ou crie uma nova.

   

4. Configure o mapeamento:
   1. Adicione um mapeamento de uma variável ou do subcampo dela da lista Variáveis na seção Entrada para a variável ou o subcampo dela da lista Variáveis na seção Saída.

      

   2. Para adicionar uma função de transformação, passe o cursor sobre a linha de mapeamento e clique em para adicionar a função de transformação de dados. O botão Transformation aparece na tela.

      Você também pode clicar em Adicionar transformação para adicionar a função de transformação.

      Em seguida, faça o seguinte:

      1. Para adicionar a transformação, clique no botão Transformation. O painel Transformation vai aparecer.

         

         Em seguida, faça o seguinte:

         1. Clique em + Adicionar operação. A caixa de diálogo Adicionar operação aparece.

            

         2. No campo Operações de pesquisa, insira a operação que você quer adicionar. Você também pode selecionar a operação na lista.

            Se você quiser adicionar uma operação personalizada, selecione Expressão de função e insira a expressão. Para copiar as variáveis, clique em na lista Variáveis e cole no editor de expressões.

            

         3. Clique em Concluído.
      2. Com base na operação, preencha os detalhes necessários. Opcionalmente, você pode adicionar várias operações em uma transformação. Se você quiser escolher o resultado da operação anterior na operação seguinte, selecione a variável Resultado da operação anterior, conforme mostrado na imagem a seguir:

         

      3. Para remover a operação, clique em Excluir ao lado dela.
   3. Opcionalmente, é possível adicionar o mapeamento de várias variáveis de entrada a uma função de transformação. No entanto, apenas um mapeamento pode ser adicionado para cada variável de saída de uma função de transformação.
   4. Para remover as variáveis de entrada e saída, clique em > Excluir.
   5. Se preferir, para excluir uma linha de mapeamento ou uma transformação, selecione o mapeamento e pressione Excluir.
   6. Feche o Editor de mapeamento de dados quando o mapeamento for concluído. Todas as alterações serão salvas automaticamente.

   Exemplo: como mapear um sistema antigo de tíquetes de bugs para um novo

   Suponha que você tenha um sistema legado de tíquetes de bugs que quer migrar para um novo sistema. Use a opção Diagram para mapear os campos do sistema antigo para o novo, conforme mostrado na imagem a seguir:

   

   Para adicionar um valor constante a um dos campos, clique em Adicionar entrada e adicione uma nova constante. É possível mapear a constante recém-adicionada da seção Entrada para o campo na seção Saída.

   

   Para adicionar a transformação de campos que não podem ser mapeados diretamente, clique em Transformação e adicione a operação de transformação clicando em + Adicionar operação:

   

   Depois que a transformação for concluída, você poderá executar a integração para mapear o antigo sistema de emissão de passagens para o novo.

   Usar o modo de script

   Use o editor do script transformador de dados para acessar as variáveis de integração, realizar atribuições de variáveis e adicionar ou modificar variáveis na sua integração. O editor do script transformador de dados fornece os seguintes recursos para enriquecer sua experiência de scripting:

   • Destaque de sintaxe/código, recuo e numeração de linhas para facilitar a legibilidade do código e o reconhecimento da estrutura.
   • Um minimapa que exibe uma visão geral de alto nível do código do script e ajuda na navegação rápida.
   • Opção clique para copiar o código na área de transferência.

   Para abrir o editor, acesse o painel de configuração da tarefa do script transformador de dados e clique em Abrir editor do script transformador de dados.

   Por padrão, o editor do script transformador de dados importa functions, uma biblioteca personalizada predefinida que contém um conjunto de funções em Jsonnet para mapeamento de dados na Application Integration. Para detalhes sobre as funções personalizadas disponíveis, consulte Funções do transformador de dados.

   A imagem a seguir mostra o layout de amostra do editor de script do Data Transformer:

   

   Acessar variáveis de integração

   Para ler uma variável de integração existente no editor do Script transformador de dados, use a função extVar da biblioteca functions predefinida.

   Cuidado: Jsonnet não permite usar hifens (-) como parte de um nome de identificador. Por exemplo, um nome de variável ou nome de função. Se você quiser usar um hífen (-) como parte de um nome de variável, declare a variável entre aspas duplas, como mostrado no exemplo a seguir.

   Exemplo: leia e atualize as variáveis de integração existentes usando o editor do script transformador de dados.

   Script em Jsonnet

   local f = import "functions"; // Import predefined Data Transformer function library
   
   local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
   local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
   {
     OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
     "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
   }

   Saída

   

   Referência de uso do JSONnet

   O jsonnet é uma linguagem puramente funcional e os programas dela são compostos de expressões. Para saber como formar essas expressões, consulte Expressões Jsonnet.

   Estratégia de solução de erros

   A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

   Cotas e limites

   Para informações sobre os limites de uso que se aplicam à tarefa Data Transformer, consulte Limites de uso.

   A seguir

   • Saiba mais sobre:
     • Todas as tarefas e acionadores.
     • Funções do Data Transformer (pré-lançamento)
     • Testar e publicar integrações.
     • Tratamento de erros.
     • Registros de execução da integração.