RPA Connector

1. Visão Geral

O componente RPA Connector (rpa-connector) executa automação de navegador web (RPA — Robotic Process Automation), controlando um navegador Chrome sem interface gráfica através de um código de automação escrito pelo próprio usuário.

Use quando o fluxo precisa interagir com um site que não tem API disponível (preencher formulários, clicar em botões, extrair dados de uma página). Prefira sempre um conector direto (HTTP, banco de dados, etc.) quando existir — RPA é mais lento e mais sensível a mudanças no site-alvo. Só funciona como ação de saída.

2. Pré-requisitos

• O ambiente onde a plataforma roda precisa ter o Google Chrome/ChromeDriver disponível.
• Conhecimento da linguagem de expressão MVEL para escrever o código de automação.
• Credenciais de acesso ao site-alvo (login, senha), se necessário, embutidas no próprio código de automação.

3. Autenticação e Conexão

Não há autenticação própria do componente — qualquer login em sites de terceiros deve ser feito manualmente dentro do código de automação (expression), usando as credenciais do site-alvo.

4. Configuração / Operações Suportadas

O componente tem uma única operação: executar um código de automação de navegador.

Campo	Obrigatório	Tipo	Descrição	Exemplo
expression	Sim	Texto (código MVEL)	Código de automação a ser executado. Dentro dele, a variável webDriver dá acesso ao navegador Chrome controlado; body dá acesso ao corpo da mensagem (como objeto, se for JSON); headers dá acesso aos headers da mensagem. O valor retornado pela expressão vira o novo corpo da mensagem.	Um script MVEL que navega até um site e extrai um valor

5. Exemplos Práticos

Exemplo simples: acessar uma página e extrair um valor exibido nela (por exemplo, uma cotação).

Entrada:

{
  "moeda": "USD"
}

Configuração do componente:

{
  "componentName": "rpa-connector",
  "configurations": {
    "expression": "webDriver.get('https://cotacoes.exemplo.com/' + body.moeda); webDriver.findElement(org.openqa.selenium.By.id('valor')).getText();"
  }
}

Resposta (o texto extraído da página vira o corpo da mensagem):

"5.42"

Exemplo avançado: preencher um formulário de login em um sistema legado sem API, e extrair uma confirmação da página seguinte.

Configuração do componente:

{
  "componentName": "rpa-connector",
  "configurations": {
    "expression": "webDriver.get('https://sistema-legado.exemplo.com/login'); webDriver.findElement(org.openqa.selenium.By.id('usuario')).sendKeys('usuario_automacao'); webDriver.findElement(org.openqa.selenium.By.id('senha')).sendKeys('senha_segura'); webDriver.findElement(org.openqa.selenium.By.id('entrar')).click(); webDriver.findElement(org.openqa.selenium.By.id('mensagemSucesso')).getText();"
  }
}

Resposta:

"Login realizado com sucesso"

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"This component is not a trigger. Configuration not supported"	Tentativa de usar o RPA Connector como gatilho de entrada.	Usar o componente apenas como ação de saída no fluxo.
Erro de execução com a mensagem original do Selenium/MVEL	O elemento buscado na página não existe, ou a estrutura do site mudou.	Revisar o código de automação e os seletores usados (IDs, classes) contra o site atual.
Automação trava ou demora muito	O site-alvo demora a carregar, ou o elemento esperado nunca aparece.	Adicionar esperas explícitas no código de automação antes de interagir com elementos.