Veja os conectores suportados para integração de aplicativos.

Tarefa JavaScript

A tarefa JavaScript permite que você escreva trechos de código JavaScript personalizados para sua integração.

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

O Editor JavaScript suporta 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 localizar e rastrear erros no código.
  • Dobrar para expandir e recolher regiões do código do script.
  • Opção de clicar para copiar o código do script para a área de transferência.

Configurar a tarefa JavaScript

Para adicionar uma tarefa JavaScript à sua integração, execute as seguintes etapas:

  1. No Google Cloud console, vá para a página Integração de Aplicativos .

    Ir para Integração de Aplicativos

  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 nova integração:

    1. Insira um nome e uma descrição no painel Criar integração .
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. Você pode alterar 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.
    4. Clique em Criar . A integração recém-criada será aberta no editor de integração .

  4. Na barra de navegação do editor de integração , clique em Tarefas para visualizar a lista de tarefas e conectores disponíveis.
  5. Clique e coloque o elemento JavaScript no editor de integração.
  6. Clique no elemento JavaScript no designer para visualizar o painel de configuração da tarefa JavaScript .
  7. Clique em Abrir editor de script para visualizar e editar o Editor de JavaScript . Você 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 Configurar tarefas de JavaScript com a assistência do Gemini .
  8. Escreva seu código JavaScript dentro da função executesScript(event) que é criada automaticamente no Editor JavaScript . Feche o editor após a conclusão; todas as alterações serão salvas automaticamente.

    Para obter informações sobre como acessar variáveis ​​de integração e as funções suportadas, consulte Usando o Editor JavaScript .

    Para obter informações sobre como visualizar os logs de execução gerados, consulte Logs de execução .

A imagem a seguir mostra um layout de exemplo do Editor JavaScript : imagem mostrando o editor javascriptimagem mostrando o editor javascript

Use o Editor JavaScript

Para visualizar e editar o Editor JavaScript , acesse o painel de configuração de tarefas JavaScript e clique em Abrir editor de script . O Editor JavaScript contém, por padrão, uma função chamada executesScript( event ) , onde:

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

    Para obter informações sobre os métodos suportados do objeto de evento , consulte Variáveis ​​de integração do Access .

Mecanismo de execução de JavaScript

A Integração de Aplicativos anteriormente oferecia suporte ao Rhino como mecanismo de execução de JavaScript para executar tarefas JavaScript . Para aproveitar os benefícios de desempenho e segurança do mecanismo JavaScript de alto desempenho e código aberto do Google, o Rhino será descontinuado e todas as execuções de JavaScript agora utilizarão o V8, o mecanismo JavaScript de alto desempenho e código aberto do Google.

Benefícios do V8

O mecanismo JavaScript V8 oferece os seguintes benefícios:

  • Desempenho: O V8 é significativamente mais rápido que o Rhino, resultando em velocidades de execução aprimoradas para suas tarefas JavaScript . Scripts com variáveis ​​de grande porte e cálculos complexos podem ser executados mais rapidamente.
  • Conformidade com os padrões: o V8 oferece suporte ao ECMAScript 2024, garantindo melhor compatibilidade e manutenibilidade.
  • Segurança: o V8 se beneficia de atualizações e melhorias contínuas de segurança, proporcionando um ambiente mais seguro para suas integrações.
  • Recursos modernos: o V8 oferece suporte aos recursos mais recentes do JavaScript, permitindo que você aproveite construções e bibliotecas de linguagem modernas.

Migrar tarefas JavaScript existentes para o V8

Para migrar 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 cancele a publicação delas.
  2. Para cada JavaScript , clique em Abrir editor de script no painel de configuração de tarefas.

    A integração de aplicativos atualiza automaticamente o script existente para usar o V8.

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

Variáveis ​​de integração de acesso

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

Os seguintes métodos são suportados para acessar variáveis ​​de integração do seu Editor JavaScript :

Nome da função Descrição Uso

getEventExecutionInfoId

 Retorna o ID de 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 dados da variável de integração

Sintaxe: event.getParameter("variable_name")

Parâmetro de entrada: Nome da variável de integração. Se o variable_name for uma variável gerada automaticamente, coloque-a entre acentos graves ( `` ). Por exemplo, `responseBody` .

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 logs de execução.

Para obter informações sobre como visualizar os logs de execução gerados, consulte Logs 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 aceita os seguintes argumentos:

  • Primeiro argumento: Nome da variável. Se o variable_name for uma variável gerada automaticamente, coloque-a entre acentos graves ( `` ). Por exemplo, `responseBody` .
  • Segundo argumento: Valor.

Exemplo: 

function executeScript(event) {
  event.setParameter("`responseBody`", "NewStringValue");
  }

Definir parâmetros de tarefa

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

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

Console

  1. Acesse a página Integração de aplicativos .

    Ir para Integração de Aplicativos

  2. Selecione uma integração. O editor de integração será aberto.
  3. Clique em Ação > Baixar Integração > Versão da Integração . A versão da integração é baixada como um arquivo JSON.
  4. Abra o arquivo da versão de integração em um editor e faça o seguinte:
    1. Localize o campo taskConfigs com a tarefa JavaScriptTask . No campo parameters , localize o parâmetro chamado 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 usando o seguinte modelo: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  5. Salve as alterações feitas no arquivo de versão de integração.
  6. Carregue o arquivo da versão de integração para a integração.

API

  1. Para baixar a versão de integração, faça uma chamada para o método projects.locations.integrations.versions.download com o filFormat definido como JSON .
  2. Abra o arquivo da versão de integração em um editor e faça o seguinte:
    1. Localize o campo taskConfigs com a tarefa JavaScriptTask . No campo parameters , localize o parâmetro chamado 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 usando o seguinte modelo: 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  3. Para carregar a versão de integração, faça uma chamada para o método projects.locations.integrations.versions.upload com o arquivo da versão de integração atualizado.

Estratégia de tratamento de erros

Uma estratégia de tratamento de erros para uma tarefa especifica a ação a ser tomada se a tarefa falhar devido a um erro temporário . Para obter 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 obter informações sobre cotas e limites, consulte Cotas e limites .

O que vem a seguir