Obter Arquivos da Pasta

Obtém lista de arquivos dentro das pastas

Visão Geral

O objeto Obter Arquivos da Pasta é utilizado para buscar e listar arquivos existentes em um diretório do sistema operacional.

Esse objeto permite que o robô identifique os arquivos disponíveis dentro de um diretório específico e retorne uma lista contendo o caminho de cada arquivo encontrado. Esses dados podem ser utilizados posteriormente no fluxo para processamento, leitura, movimentação ou validação de arquivos.

A busca é realizada a partir do diretório informado no campo Diretório, podendo ser filtrada por extensão de arquivo e incluir arquivos presentes em subdiretórios.

---

Funcionamento

O objeto Obter Arquivos da Pasta realiza uma varredura no diretório informado e retorna uma lista com os arquivos encontrados.

Fluxo de funcionamento:

1. O robô executa o objeto Obter Arquivos da Pasta.

2. O caminho informado no campo Diretório é utilizado para localizar o diretório no sistema.

3. O objeto busca os arquivos existentes dentro desse diretório.

4. Caso configurado, a busca pode ser filtrada por extensão de arquivo.

5. Opcionalmente, os arquivos contidos em subdiretórios também podem ser incluídos.

6. O objeto retorna uma lista contendo o caminho de cada arquivo encontrado.

Quando usar

• Quando for necessário identificar arquivos existentes em um diretório.

• Quando o robô precisar processar múltiplos arquivos automaticamente.

• Quando for necessário filtrar arquivos por extensão específica.

Quando não usar

Não utilizar quando o objetivo for buscar pastas, pois nesse caso deve-se utilizar o objeto Buscar Pastas.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô.
Diretório	Caminho do diretório onde será realizada a busca pelos arquivos.
Extensão	Permite filtrar os arquivos retornados por extensão (ex.: .csv, .txt, .xlsx).
Verificar Subdiretórios	Quando habilitado, inclui arquivos localizados em subdiretórios durante a busca.

Observação: A busca retorna uma lista contendo o caminho completo de cada arquivo encontrado no diretório informado.

---

Exemplos

Exemplo simples

Fluxo básico para listar arquivos de uma pasta:

1. Inserir o objeto Obter Arquivos da Pasta no fluxo do robô.

2. Informar o caminho do diretório no campo Diretório.

3. Executar o robô.

Após a execução, o objeto retorna a lista de arquivos encontrados no diretório.

Exemplo aplicado

Cenário: um robô precisa processar arquivos CSV armazenados em uma pasta.

Fluxo:

1. O robô utiliza o objeto Obter Arquivos da Pasta para buscar arquivos no diretório configurado.

2. No campo Extensão, é definido o filtro .csv.

3. O objeto retorna a lista de arquivos encontrados.

4. O fluxo percorre essa lista e processa cada arquivo individualmente.

---

Retornos

---

Erros comuns e como evitar

Diretório inválido

Ocorre quando o caminho informado no campo Diretório não corresponde a um diretório existente.

Como evitar:

• Verificar se o diretório informado existe antes da execução.

Filtro de extensão incorreto

Se a extensão informada estiver incorreta, nenhum arquivo poderá ser retornado.

Como evitar:

• Garantir que a extensão informada corresponda ao tipo de arquivo existente no diretório.

Permissão insuficiente

Se o robô não possuir permissão para acessar o diretório, a busca pode falhar.

Como evitar:

• Garantir que o usuário ou runtime possua acesso ao diretório.

---

Boas práticas

• Utilizar filtros de extensão para reduzir o volume de arquivos retornados.

• Habilitar Verificar Subdiretórios apenas quando necessário para evitar buscas desnecessárias.

• Validar previamente a existência do diretório antes de executar a busca.

• Utilizar nomes claros no campo Título para facilitar a identificação do objeto no fluxo.