Abrir Totvs Datasul

Objeto serve para abrir a url de login do Datasul, realizar o login e deixar o Datasul Interactive aberto, pronto para executar os programas.

Visão Geral

O objeto Abrir Totvs Datasul é responsável por abrir a página de login do TOTVS Datasul, realizar o login no sistema e deixar o Datasul Interactive aberto e pronto para execução de programas dentro do ERP.

Esse objeto automatiza todo o fluxo inicial de acesso ao ambiente, incluindo abertura do navegador, autenticação do usuário e validação do login.

---

Funcionamento

O objeto executa automaticamente as etapas necessárias para acessar o ambiente Datasul Interactive.

Fluxo de execução:

1. O objeto abre o navegador configurado.

2. Acessa o endereço definido no campo Endereço da página.

3. Preenche os campos de Usuário e Senha na tela de login.

4. Realiza a validação do login utilizando o Xpath de validação do login.

5. Caso exista uma janela de confirmação, o robô identifica a Janela de Confirmação.

6. O robô localiza e clica no botão OK da janela Interactive.

7. O sistema abre a Janela Interactive configurada e o ambiente fica pronto para execução.

Quando usar

• Quando for necessário iniciar uma automação que utilize o ERP Totvs Datasul.

• Quando o robô precisa acessar o Datasul Interactive antes de executar outras rotinas.

• Em automações que dependem de login automático no ambiente Datasul.

Quando não usar

Não há restrições documentadas para uso deste objeto.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Pode ser alterado para facilitar a identificação, por exemplo: Abrir Totvs Datasul - Principal.
Nome Identificador do Validador	Identificador único do objeto. Pode ser renomeado para facilitar referência em outros objetos, desde que seja único e não contenha espaços ou caracteres especiais.
Selecionar um navegador	Define o navegador que será utilizado para abrir o Datasul. Exemplo: Chrome ou Firefox.
Endereço da página	URL da página de login do Datasul que será acessada pelo robô.
Utilizar Domínio	Opção para utilizar domínio no login.
Usuário	Nome de usuário utilizado para acessar o Datasul.
Senha	Senha correspondente ao usuário informado.
Xpath de validação do login	Xpath de um elemento presente após o login, utilizado para validar se a autenticação foi realizada com sucesso.
Nome da Janela de Confirmação	Nome da janela pop-up exibida após a autenticação no sistema.
Xpath do botão "OK" da Janela Interactive	Xpath do botão OK utilizado para confirmar a janela exibida após o login.
Nome da Janela do Interactive	Nome da janela do Datasul Interactive que será aberta após o login.
Tempo máximo de espera (em segundos)	Tempo máximo que o objeto aguardará pela execução das etapas antes de gerar erro.

---

Exemplos

Exemplo simples

Um robô precisa acessar o Datasul antes de executar qualquer operação.

Configuração básica:

• Navegador: Chrome

• Endereço da página: http://site.com

• Usuário: usuário do ERP

• Senha: senha do ERP

• Xpath de validação: elemento presente após o login

• Nome da janela Interactive: DATASUL Interactive

Fluxo:

1. O robô abre o navegador.

2. Acessa a página de login.

3. Realiza o login.

4. Confirma a janela de Interactive.

5. O Datasul Interactive é aberto.

Exemplo aplicado

Automação de extração de dados do Datasul.

Fluxo do robô:

1. Executar o objeto Abrir Totvs Datasul.

2. Aguardar abertura do Datasul Interactive.

3. Executar objetos que acessam programas do ERP.

4. Extrair dados e exportar relatórios.

---

Retornos

---

Erros comuns e como evitar

Xpath de validação incorreto

Se o Xpath não representar um elemento presente após o login, o robô pode interpretar que o login falhou.

Como evitar:

• Validar o Xpath utilizando ferramentas de inspeção do navegador.

Nome da janela incorreto

Caso o nome da janela Interactive esteja incorreto, o robô pode não identificar a janela aberta.

Como evitar:

• Verificar o nome exato da janela exibida pelo Datasul.

URL inválida

Se o endereço da página estiver incorreto, o login não será executado.

Como evitar:

• Confirmar o endereço correto do ambiente Datasul.

---

Boas práticas

• Utilizar identificadores únicos para facilitar a reutilização do objeto.

• Validar corretamente o Xpath de login para garantir estabilidade da automação.

• Definir um tempo de espera adequado para ambientes com maior latência.

• Testar o login manualmente antes de configurar o objeto no robô.

---

Robô Exemplo

---

Resumo das Alterações e Pontos de Atenção

Identificado no print enviado:

• Campo Endereço da página para definição da URL do login.

• Campo Utilizar Domínio disponível como opção.

• Campos adicionais para tratamento de janela:

  • Nome da Janela de Confirmação

  • Xpath do botão OK da Janela Interactive

  • Nome da Janela do Interactive

• Campo Tempo máximo de espera (em segundos) configurado com valor padrão 60.

Pontos de atenção

• Os campos de Xpath são críticos para o funcionamento do objeto.

• Os nomes das janelas devem corresponder exatamente aos exibidos no Datasul.

• O navegador selecionado deve estar instalado no ambiente de execução.

---

Se quiser, também posso te entregar uma versão otimizada para GitBook já com imagens nomeadas (abrir-datasul-config.png, etc.) e pronta para commit no repositório de docs. Isso normalmente facilita muito para manter o padrão da documentação.