square-listListar Arquivos

circle-info

Esse objeto depende da utilização do objeto de Login FTP.

Visão Geral

O objeto Listar Arquivos é utilizado para listar arquivos e diretórios disponíveis em um caminho específico de um servidor FTP, utilizando um objeto de login FTP previamente configurado.

O resultado da listagem pode ser utilizado em etapas posteriores do robô, como loops ou validações.


Funcionamento

O objeto se conecta ao servidor FTP configurado no objeto de Login FTP selecionado e realiza a leitura do conteúdo do diretório informado no campo Caminho FTP, retornando a lista de arquivos encontrada.

Quando usar

  • Quando for necessário obter a lista de arquivos de um diretório FTP.

  • Para validar se arquivos existem antes de realizar downloads.

  • Em fluxos que processam múltiplos arquivos dinamicamente.

  • Para automações que dependem de leitura periódica de diretórios FTP.

Quando não usar

  • Quando já se conhece exatamente o nome do arquivo a ser manipulado.

  • Quando o servidor não utiliza protocolo FTP.

  • Para download ou upload de arquivos (utilizar os objetos específicos para essas ações).


Configuração

CAMPO
DESCRITIVO

Título

Nome do objeto dentro do fluxo do robô. Campo obrigatório.

Nome Identificador do Objeto

Identificador utilizado para referenciar os retornos deste objeto em outros pontos do robô. Campo obrigatório.

Selecionar objeto de Login FTP

Objeto de login FTP responsável pela conexão com o servidor. Campo obrigatório.

Caminho FTP

Caminho do diretório no servidor FTP que será listado. Campo obrigatório. Deve ser informado sem "/" no início, conforme orientação exibida na interface.


Exemplos

Exemplo simples

Listar todos os arquivos existentes no diretório exportacoes de um servidor FTP.

Fluxo resumido:

  1. Configurar um objeto de Login FTP.

  2. Informar exportacoes no campo Caminho FTP.

  3. Definir um Nome Identificador do Objeto.

  4. Executar o robô para obter a listagem de arquivos.

Exemplo aplicado

Em um cenário de integração, o robô lista diariamente os arquivos disponíveis em um diretório FTP, percorre cada item retornado e executa downloads apenas dos arquivos ainda não processados.


Erros comuns e como evitar

  • Caminho FTP iniciado com “/” Não iniciar o valor do campo Caminho FTP com barra (/), conforme orientação exibida abaixo do campo.

  • Nome Identificador duplicado Utilize identificadores únicos para evitar conflitos ao acessar os retornos do objeto.

  • Objeto de Login FTP inválido ou inexistente Verifique se o objeto de login FTP selecionado está corretamente configurado e ativo.


Boas práticas

  • Utilize Nomes Identificadores claros e descritivos para facilitar a leitura do fluxo.

  • Combine este objeto com estruturas de repetição para processar múltiplos arquivos.

  • Centralize credenciais FTP em objetos de login reutilizáveis.

  • Valide o retorno antes de executar ações dependentes da listagem.

circle-exclamation

Last updated

Was this helpful?