Consulte os conetores suportados para a solução Application Integration.

Tarefa de JavaScript

Descontinuado: a partir de 24 de janeiro de 2025, a integração de aplicações vai deixar de suportar o Rhino como o motor de execução do JavaScript. Todas as tarefas JavaScript publicadas existentes vão continuar a usar o Rhino e podem ser migradas para o V8 manualmente. As tarefas de JavaScript criadas recentemente vão usar exclusivamente o V8. Consulte o motor de execução de JavaScript para mais informações.

A tarefa JavaScript permite-lhe escrever fragmentos de código JavaScript personalizados para a sua integração.

Através do editor de JavaScript, pode programar uma lógica de mapeamento de dados complexa para a sua integração, realizar atribuições de variáveis e adicionar ou modificar variáveis de integração.

O editor de JavaScript suporta as seguintes funcionalidades:

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

Configure a tarefa de JavaScript

Para adicionar uma tarefa JavaScript à sua integração, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

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

   A página Integrações é apresentada com 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 estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar. A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
5. Clique e coloque o elemento JavaScript no editor de integração.
6. Clique no elemento JavaScript no criador para ver o painel de configuração da tarefa JavaScript.
7. Clique em Abrir editor de scripts para ver e editar o editor de JavaScript. Também pode usar o Gemini para gerar código JavaScript clicando em Script com o Gemini. Para obter informações sobre como usar o Gemini para gerar código JavaScript, consulte o artigo Configure tarefas de JavaScript com a ajuda do Gemini.
8. Escreva o seu código JavaScript na função executesScript(event) criada automaticamente no editor de JavaScript. Feche o editor quando terminar. Todas as alterações são guardadas automaticamente.
   Aviso: não elimine a função executesScript(event). Esta função é chamada quando a tarefa JavaScript é executada.

   Para obter informações sobre como aceder às variáveis de integração e às funções suportadas, consulte o artigo Usar o editor de JavaScript.

   Para ver informações sobre como ver os registos de execução gerados, consulte o artigo Registos de execução.

A imagem seguinte mostra um esquema de exemplo do editor de JavaScript:

Use o editor de JavaScript

Para ver e editar o editor de JavaScript, aceda ao painel de configuração da tarefa JavaScript e clique em Abrir editor de scripts. Por predefinição, o editor de JavaScript contém uma função denominada executesScript(event), em que:

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

  Para obter informações sobre os métodos suportados do objeto event, consulte o artigo Aceda às variáveis de integração.

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

Motor de execução de JavaScript

Descontinuado: a partir de 24 de janeiro de 2025, a integração de aplicações vai deixar de suportar o Rhino como o motor de execução do JavaScript. Todas as tarefas JavaScript publicadas existentes vão continuar a usar o Rhino e podem ser migradas para o V8 manualmente. As tarefas de JavaScript criadas recentemente vão usar exclusivamente o V8.

Anteriormente, a integração de aplicações suportava o Rhino como o motor de execução de JavaScript para executar tarefas de JavaScript. Para tirar partido das vantagens de desempenho e segurança do motor JavaScript de alto desempenho de código aberto da Google, o Rhino vai ser descontinuado e todas as execuções de JavaScript vão usar o V8, o motor JavaScript de alto desempenho de código aberto da Google.

Vantagens do V8

O motor V8 JavaScript oferece as seguintes vantagens:

• Desempenho: o V8 é significativamente mais rápido do que o Rhino, o que leva a velocidades de execução melhoradas para as suas tarefas de JavaScript. Os scripts com variáveis de grande dimensão e cálculos complexos podem ser executados mais rapidamente.
• Conformidade com as normas: o V8 suporta o ECMAScript 2024, o que garante uma melhor compatibilidade e capacidade de manutenção.
• Segurança: o V8 beneficia de atualizações e melhorias de segurança contínuas, oferecendo um ambiente mais seguro para as suas integrações.
• Funcionalidades modernas: o V8 suporta as funcionalidades JavaScript mais recentes, o que lhe permite tirar partido de construções e bibliotecas de linguagem modernas.

Migre tarefas JavaScript existentes para o V8

Para migrar as suas tarefas JavaScript existentes em execução no Rhino para o V8, faça o seguinte:

1. Identifique as integrações publicadas que contêm tarefas JavaScript e anule a publicação das mesmas.
2. Para cada JavaScript, clique em Abrir editor de scripts no painel de configuração da tarefa.

   A integração de aplicações atualiza automaticamente o script existente para usar o V8.

3. Reveja e teste o código JavaScript.
4. Publique as integrações.

Aceda às variáveis de integração

As variáveis definidas na sua integração podem ser acedidas a partir do editor de JavaScript através do objeto de eventos na memória da integração de aplicações.

Os seguintes métodos são suportados para aceder a variáveis de integração a partir do editor de JavaScript:

Nome da função	Descrição	Utilização
getEventExecutionInfoId	Devolve o ID de execução da execução da integração. Tipo devolvido: string	Sintaxe: event.getEventExecutionInfoId() Exemplo: function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Devolve o ID do projeto do Google Cloud. Tipo devolvido: string	Sintaxe: event.getGoogleCloudProjectId() Exemplo: function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Devolve o nome atual da integração. Tipo devolvido: string	Sintaxe: event.getIntegrationName Exemplo: function executeScript(event) { event.getIntegrationName(); }
getParameter	Devolve o valor da variável de integração fornecida. Tipo de retorno: tipo de dados da variável de integração	Sintaxe: event.getParameter("variable_name") Parâmetro de entrada: nome da variável de integração. Se variable_name for uma variável gerada automaticamente, coloque a variável entre acentos graves (``). Por exemplo, `responseBody`. Exemplo: function executeScript(event) { event.getParameter("var1"); }
getRegion	Devolve o nome da região de integração. Tipo devolvido: string	Sintaxe: event.getRegion() Exemplo: function executeScript(event) { event.getRegion(); }
log	Escreve o valor especificado nos registos de execução. Para ver informações sobre como ver os registos de execução gerados, consulte o artigo Registos 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("variable_name", "variable_value") Parâmetro de entrada: esta função usa os seguintes argumentos: Primeiro argumento: nome da variável. Se variable_name for uma variável gerada automaticamente, coloque a variável entre acentos graves (``). Por exemplo, `responseBody`. Segundo argumento: valor. Exemplo: function executeScript(event) { event.setParameter("`responseBody`", "NewStringValue"); }

Defina parâmetros de tarefas

Se a sua integração tiver vários parâmetros de grande dimensão que não são usados pela tarefa de JavaScript, pode definir o campo TaskParameter para a tarefa de JavaScript para melhorar o desempenho.

Para definir o campo TaskParameter para a tarefa JavaScript, selecione uma das seguintes opções:

Consola

1. Aceda à página Application Integration.

   Aceda à solução Application Integration

2. Selecione uma integração. O editor de integração é aberto.
3. Clique em Ação > Transferir integração > Versão de integração. A versão da integração é transferida como um ficheiro JSON.
4. Abra o ficheiro da versão de integração num editor e, de seguida, faça o seguinte:
   1. Localize o campo taskConfigs com a tarefa como JavaScriptTask. No campo parameters, localize o parâmetro denominado script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. Neste campo parameters, adicione parâmetros que são usados no campo JavaScriptTask através do seguinte modelo:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

5. Guarde as alterações que fez ao ficheiro da versão de integração.
6. Carregue o ficheiro da versão de integração para a integração.

API

1. Para transferir a versão de integração, faça uma chamada para o método projects.locations.integrations.versions.download com o parâmetro filFormat definido como JSON.
2. Abra o ficheiro da versão de integração num editor e, de seguida, faça o seguinte:
   1. Localize o campo taskConfigs com a tarefa como JavaScriptTask. No campo parameters, localize o parâmetro denominado script.

      "taskConfigs": [{
        "task": "JavaScriptTask",
        "taskId": 1,
        "parameters": {
          "script": {
            "key": "script",
            "value": {
              "stringValue": "function that is called during the JavaScriptTask execution"
            }
        }"
      }]
      

   2. Neste campo parameters, adicione parâmetros que são usados no campo JavaScriptTask através do seguinte modelo:

      "ParamName": {
        "key": "ParamName",
        "value": {
          "stringValue": "$ParamName$"
        }
      }
      

3. Para carregar a versão de integração, faça uma chamada ao método projects.locations.integrations.versions.upload com o ficheiro da versão de integração atualizada.

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre o seguinte:
  • Configurar tarefas JavaScript com a ajuda do Gemini
  Todas as tarefas e acionadores
  • Testar e publicar integrações
  • Processamento de erros
  • Registos de execução da integração