Consulte os conectores compatíveis com a Application Integration.

Tarefa em JavaScript

A tarefa JavaScript permite criar snippets de código JavaScript personalizados para sua integração.

Com o Editor de JavaScript, você pode codificar lógica de mapeamento de dados complexa para sua integração, realizar atribuições de variáveis e adicionar ou modificar variáveis de integração.

O Editor de JavaScript é compatível com os seguintes recursos:

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

Configurar a tarefa JavaScript

Para adicionar uma tarefa JavaScript à 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 Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

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

   Se você estiver criando uma integração:

   1. Digite um nome e uma descrição no painel Create Integration.
   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. Você pode 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.
      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 na 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 disponíveis.
5. Clique e posicione o elemento JavaScript no editor de integração.
6. Clique no elemento JavaScript no designer para visualizar o painel de configuração de tarefas JavaScript.
7. Clique em Abrir editor de script para ver e editar o Editor JavaScript.
8. Escreva seu código JavaScript na função executesScript(event) que é criada automaticamente no Editor JavaScript. Quando o editor for fechado, as alterações serão salvas automaticamente.
   Aviso: não exclua a função executesScript(event). Essa função é chamada quando a tarefa JavaScript é executada.

   Para ver informações sobre como acessar variáveis de integração e as funções compatíveis, consulte Como usar o editor JavaScript.

   Para informações sobre como visualizar os registros de execução gerados, consulte Registros de execução.

A imagem a seguir mostra um layout de exemplo do JavaScript Editor:

Como usar o Editor JavaScript

Para ver e editar o Editor JavaScript, acesse o painel de configuração de tarefas JavaScript e clique em Abrir editor javascript. Por padrão, o Editor JavaScript contém uma função chamada executesScript(event).

Em que:

• executesScript() é a função chamada quando a Application Integration executa a tarefa JavaScript durante a execução de uma integração.
• event é o objeto na memória da Application Integration.

  Para mais informações sobre os métodos compatíveis com o objeto event, consulte Acessar variáveis de integração.

Aviso: não exclua a função executesScript(event). Essa função é chamada quando a tarefa JavaScript é executada.

O mecanismo de execução JavaScript usado pela Application Integration é baseado no Rhino 1.7.14, que não é compatível com todas as sintaxes ES6. Somente o preenchimento automático da sintaxe ES5 é compatível. Para ver toda a sintaxe ES6 compatível, consulte Suporte ao Rhino ES2015.

Acessar variáveis de integração

As variáveis definidas na sua integração podem ser acessadas no Editor de JavaScript usando o objeto de evento na memória do Application Integration.

Os métodos a seguir são compatíveis com o acesso a variáveis de integração no seu Editor do JavaScript:

1. getEventExecutionInfoId
2. getGoogleCloudProjectId
3. getIntegrationName
4. getParameter
5. getRegion
6. log
7. setParameter

Nome da função	Descrição	Uso
getEventExecutionInfoId	Retorna o ID de execução da execução da integração. Tipo de retorno: String	Sintaxe: event.getEventExecutionInfoId() Exemplo: function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Retorna o ID do projeto do Google Cloud. Tipo de retorno: String	Sintaxe: event.getGoogleCloudProjectId() Exemplo: function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Retorna o nome atual da integração. Tipo de retorno: String	Sintaxe: event.getIntegrationName Exemplo: function executeScript(event) { event.getIntegrationName(); }
getParameter	Retorna o valor da variável de integração fornecida. Tipo de retorno: tipo de dado da variável de integração	Sintaxe: event.getParameter("value") Parâmetro de entrada: nome da variável de integração. Exemplo: function executeScript(event) { event.getParameter("var1"); }
getRegion	Retorna o nome da região de integração. Tipo de retorno: String	Sintaxe: event.getRegion() Exemplo: function executeScript(event) { event.getRegion(); }
log	Grava o valor especificado nos registros de execução. Para informações sobre como visualizar os registros de execução gerados, consulte Registros de execução.	Sintaxe: event.log(value) Parâmetro de entrada:qualquer variável ou função usada no script. Exemplo 1: function executeScript(event) { event.log(event.getParameter("var1")); } Exemplo 2: function executeScript(event) { event.log("Lorem ipsum"); }
setParameter	Define ou atualiza o valor de uma variável de integração.	Sintaxe: event.setParameter(value, value) Parâmetro de entrada: essa função usa os seguintes argumentos: Primeiro argumento: nome da variável. Segundo argumento: Valor. Exemplo: function executeScript(event) { event.setParameter("var1", "NewStringValue"); }

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.