Exportar Excel

Objeto serve para exportar Excel - ERP Totvs Datasul

Visão Geral

O objeto Exportar Excel é responsável por exportar dados exibidos em um grid do TOTVS Datasul Interactive para um arquivo no formato Excel.

Esse objeto automatiza o processo de exportação presente na interface do Datasul, permitindo que o robô gere arquivos .xls ou .xlsx a partir das informações exibidas na tela do sistema.

A exportação é realizada a partir de uma janela específica do Datasul, onde o robô identifica o grid de dados e executa o processo de geração do arquivo no caminho configurado.

---

Funcionamento

O objeto executa o processo de exportação do grid do Datasul para um arquivo Excel.

Fluxo de execução:

1. O robô identifica a janela do Datasul Interactive informada no campo Título da Janela.

2. Caso a opção Focar no Grid esteja habilitada, o robô localiza o grid utilizando o Xpath do Grid.

3. O robô executa a ação de exportação presente no Datasul.

4. O sistema gera o arquivo Excel no caminho completo definido na configuração.

5. O robô aguarda até o limite definido no campo Tempo Limite para que o arquivo seja criado.

Quando usar

• Quando for necessário extrair dados de relatórios ou consultas do Datasul.

• Em automações que precisam gerar arquivos Excel a partir de grids do Datasul Interactive.

• Quando o robô precisa armazenar dados do ERP para processamento posterior.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Pode ser alterado para facilitar a identificação.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô. Utilizado para referência em outras etapas do fluxo.
Título da Janela	Nome da janela do Datasul Interactive onde o grid de dados está localizado.
Caminho completo do arquivo Excel	Caminho completo onde o arquivo Excel será salvo após a exportação.
Tempo Limite	Tempo máximo, em segundos, que o robô aguardará pela geração do arquivo Excel.
Focar no Grid	Quando habilitado, o robô tenta focar diretamente no grid antes de executar a exportação.
Xpath do Grid	Xpath utilizado para localizar o grid de dados na interface do Datasul.

---

Exemplos

Exemplo simples

Um robô executa uma consulta no Datasul e precisa exportar os dados exibidos.

Configuração:

• Título da Janela: DATASUL Interactive

• Caminho do arquivo: C:\Robos\Relatorios\dados.xlsx

• Tempo limite: 150

• Focar no Grid: habilitado

Fluxo:

1. O robô executa uma consulta no Datasul.

2. Os dados são exibidos em um grid.

3. O objeto Exportar Excel é executado.

4. O arquivo Excel é gerado no caminho configurado.

Exemplo aplicado

Automação de geração diária de relatórios.

Fluxo do robô:

1. Abrir o Datasul Interactive.

2. Executar um programa ou consulta no ERP.

3. Exibir os resultados em um grid.

4. Executar o objeto Exportar Excel.

5. Salvar o arquivo em um diretório de relatórios.

---

Retornos

---

Erros comuns e como evitar

Título da janela incorreto

Se o nome da janela informado não corresponder ao título real da janela do Datasul, o robô não conseguirá localizar o grid.

Como evitar:

• Verificar o título exato da janela exibida no Datasul Interactive.

Caminho do arquivo inválido

Se o caminho informado não existir ou não possuir permissão de escrita, o arquivo Excel não será gerado.

Como evitar:

• Garantir que o diretório exista e que o robô tenha permissão de escrita.

Xpath do grid incorreto

Se o Xpath não localizar corretamente o grid, o robô pode não conseguir executar a exportação.

Como evitar:

• Validar o Xpath utilizando ferramentas de inspeção da interface.

---

Boas práticas

• Utilizar caminhos de arquivo padronizados para facilitar a organização dos relatórios.

• Definir um tempo limite adequado para exportações de grandes volumes de dados.

• Validar a presença do grid antes de executar a exportação.

• Utilizar nomes claros para os arquivos exportados, especialmente em automações recorrentes.