Atividade Listar Arquivos de FTP

Durante o tempo de execução, a atividade Listar Arquivos do FTP se conecta a um Servidor FTP e gera uma lista de arquivos a partir do local do diretório especificado usando a expressão regular especificada. A atividade Listar Arquivos do FTP retorna a lista de arquivos para a orquestração usando o parâmetro de saída directoryListing ou fileListing.

Se a caixa de seleção Listar Apenas Arquivos (NLST) for desmarcada, uma listagem de diretórios completa, incluindo permissões de diretório, registros de data e hora e propriedade, será retornada no parâmetro de saída directoryListing como uma sequência única. Quando uma listagem de diretórios completa é retornada como uma sequência, você deve analisar a listagem de diretórios usando um esquema de Arquivo Simples com a atividade Ler Arquivo Simples. Se a caixa de seleção Listar Somente Arquivos (NLST) estiver selecionada e a atividade Arquivos de Lista do FTP suportar o formato da listagem do diretório do Servidor FTP, uma estrutura de repetição apenas dos nomes de arquivos (se suportada pelo servidor FTP) será retornada no parâmetro de saída fileListing. Quando uma estrutura de repetição do nome do arquivo é retornada, você não precisa analisar a listagem de diretórios e pode iterar apenas através da lista usando uma atividade For Each ou Loop While. O servidor FTP ao qual está se conectando deve suportar o comando NLST. A resposta fornecida pelo servidor FTP será retornada.

Para alguns casos, é necessário utilizar a atividade Listar Arquivos de FTP em conjunto com as atividades Obter Arquivo de FTP, Colocar Arquivo de FTP, Excluir Arquivo de FTP e Renomear Arquivo de FTP para processar um conjunto de arquivos localizados em um diretório de FTP, enquanto que em outros casos é possível utilizar a atividade Pesquisar Diretório de FTP.

Use a atividade Listar Arquivos do FTP em conjunto com as atividades Obter Arquivo do FTP, Colocar Arquivo do FTP, Excluir Arquivo do FTP e Renomear Arquivo do FTP para processar um conjunto de arquivos localizados em um diretório FTP se qualquer uma das condições a seguir for verdadeira:
  • A atividade Pesquisar Diretório de FTP não suporta o formato da listagem do diretório do Servidor de FTP - O formato das listagens do diretório são diferentes para os Servidores de FTP suportados em diferentes sistemas operacionais. A atividade Pesquisar Diretório do FTP suporta vários tipos de Servidores FTP mas, se o formato da listagem de diretórios de seu Servidor FTP não puder ser analisado pela atividade Pesquisar Diretório do FTP, use a atividade Listar Arquivos do FTP e as atividades Obter Arquivo do FTP, Colocar Arquivo do FTP, Excluir Arquivo do FTP e Renomear Arquivo do FTP para fornecer a mesma funcionalidade que a atividade Pesquisar Diretório do FTP, conforme mostrado no Exemplo Analisar Listagem de Diretórios: Exemplo de Análise da Listagem de Diretórios.
  • Cada arquivo na lista deve ser pós-processado com uma ação diferente. - Por exemplo, se você deve mover arquivos para diretórios diferentes com base no nome do arquivo, use a atividade Listar Arquivos do FTP em conjunto com as atividades Obter Arquivo do FTP, Colocar Arquivo do FTP, Excluir Arquivo do FTP e Renomear Arquivo do FTP, conforme mostrado no Exemplo Analisar Listagem de Diretórios: Exemplo de Análise da Listagem de Diretórios. Entretanto, se cada arquivo pode ser pós-processado usando a mesma ação, é possível usar a atividade Pesquisar Diretório do FTP para processar o conjunto de arquivos.

Links Simbólicos

O suporte para links simbólicos pela atividade Listar Arquivos do FTP durante o tempo de execução é dependente dos seguintes fatores:  
  • Os tipos de links simbólicos suportados pelo sistema operacional que hospeda o Servidor FTP.
  • Os tipos de links simbólicos suportados pelo próprio Servidor FTP.
  • Os tipos de links simbólicos suportados pela atividade Lista de Arquivos do FTP, conforme listado na tabela a seguir:
    Tabela 1.
    Links Simbólicos para... Links Simbólicos Completos Links Simbólicos Simples Notas
    Arquivos Não Suportados Não Suportados A atividade Listar Arquivos do FTP não interpreta links simbólicos para arquivos como arquivos e, portanto, os links simbólicos para arquivos não são processados pela atividade Listar Arquivos do FTP durante o tempo de execução.
    Diretórios Suportados Suportados  
Para determinar o suporte ao link simbólico específico para um Servidor FTP específico em um sistema operacional específico, consulte a documentação de seu sistema operacional e do Servidor FTP.

Processando Subdiretórios com o Terminal FTP Microsoft

Para o Terminal FTP Microsoft IIS (Internet Information Services), o comportamento do tempo de execução da atividade Listar Arquivos do FTP ao processar subdiretórios e os arquivos nos subdiretórios depende da expressão regular especificada no campo Arquivo Nomeado da tarefa Configurar da atividade, conforme descrito nos casos a seguir:
  • Quando a expressão regular é igual à sequência: *, a tarefa de orquestração processa os subdiretórios no diretório especificado.
  • Quando a expressão regular é igual à sequência: *.*, a tarefa de orquestração não processa os subdiretórios no diretório especificado.
  • Quando a expressão regular está em branco, a tarefa de orquestração não processa os subdiretórios no diretório especificado.

Incluindo uma atividade Listar Arquivos do FTP na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta FTP.
  3. Arraste a atividade Listar Arquivos para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

Criando, Selecionando ou Editando um Terminal FTP

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
        Atenção: Especificar um novo Terminal FTP com uma estrutura de diretório diferente do Terminal FTP original pode fazer com que a tarefa de orquestração falhe durante o tempo de execução. Você deve especificar um novo Servidor FTP que corresponda à estrutura de diretório do Servidor FTP originalmente especificado ou alterar o diretório configurado do campo No Diretório clicando em Procurar conforme descrito abaixo no procedimento "Configurando a Atividade".
      2. Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurando a Atividade".
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
        Atenção: Especificar um novo Terminal FTP com uma estrutura de diretório diferente do Terminal FTP original pode fazer com que a tarefa de orquestração falhe durante o tempo de execução. Você deve especificar um novo Servidor FTP que corresponda à estrutura de diretório do Servidor FTP originalmente especificado ou alterar o diretório configurado do campo No Diretório clicando em Procurar conforme descrito abaixo no procedimento "Configurando a Atividade".
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
  2. Crie ou edite um terminal de FTP: Criando ou Editando um Terminal FTP.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
  2. Configure todos os campos nessa área de janela, conforme descrito na tabela a seguir:
    Tabela 2.
    Campo Descrição
    No Diretório Especifica o diretório no servidor de FTP em que o Integration Appliance gera uma lista de arquivos no diretório. É possível especificar um diretório usando uma das opções a seguir:
    • Insira o caminho do diretório diretamente clicando no campo e digitando um dos seguintes caminhos do diretório:
      • Caminho do diretório relativo, por exemplo: /process. (Supõe que o início do FTP foi configurado para a conta do usuário que se conecta ao Servidor FTP. Consulte a nota abaixo para obter mais informações).
      • Caminho do diretório completo, por exemplo, em uma máquina UNIX: /home/user/process.
    • Clique em Procurar... para preencher a lista suspensa de diretórios disponíveis. Selecione o diretório apropriado na lista suspensa.
    Nota: UNIX: Se você especificar um caminho do diretório relativo ao se conectar a um Servidor FTP em uma máquina UNIX, verifique se o diretório inicial do FTP foi especificado corretamente no arquivo /etc/password para a conta do usuário que se conecta ao Servidor FTP.
    Arquivo Nomeado Especifica um padrão glob que define os nomes de arquivo que precisam ser obtidos do servidor FTP. O processamento do padrão glob é feito pelo servidor FTP. Para obter mais informações, consulte a documentação do servidor FTP sobre padrão glob.
    Listar Somente Arquivos (NLST) A caixa de seleção Listar Apenas Arquivos (NLST) determina o tipo de listagem de diretórios retornada pelo botão Testar e durante o tempo de execução. Além disso, esta caixa de seleção define se o parâmetro de saída fileListing ou directoryListing é exibido na tarefa Mapear Saídas e retornado pela atividade durante o tempo de execução.
      Se a caixa de seleção Listar Somente Arquivos (NLST) estiver selecionada, somente os nomes de arquivos (se suportados pelo servidor FTP) serão retornados quando o botão Teste for clicado, conforme mostrado em Figura 1. Além disso, quando a caixa de seleção Listar Apenas Arquivos (NLST) é selecionada, o parâmetro de saída fileListing é listado na tarefa Mapear Saídas. Durante o tempo de execução, o conjunto de arquivos é retornado no nó de repetição fileName do parâmetro de saída fileListing. O servidor FTP ao qual está se conectando deve suportar o comando NLST. A resposta fornecida pelo servidor FTP será retornada.
      Se a caixa de seleção Listar Apenas Arquivos (NLST) estiver desmarcada, uma listagem de diretório completa, incluindo permissões do diretório, registros de data e hora e propriedade serão retornados quando o botão Testar for clicado, conforme mostrado em Figura 2. Além disso, quando a caixa de seleção Listar Apenas Arquivos (NLST) é selecionada, o parâmetro de saída directoryListing é listado na tarefa Mapear Saídas. Durante o tempo de execução, a listagem de diretórios completa é fornecida como uma única sequência e retornada usando o parâmetro de saída directoryListing.
    Figura 1. Listagem de Exemplo quando Listar Apenas Arquivos (NLST) estiver selecionado.
    bidAcmeInc.txt
    bidBudgetManufacture.txt
    bidCrankCo.txt
    bidSamAndSons.txt
    bidWidgetRUs.txt
    Figura 2. Listagem de Exemplo quando Listar Apenas Arquivos (NLST) estiver desmarcado.
    -rw-r--r--  1 551    551      65 May  3 11:39 bidAcmeInc.txt
    -rw-r--r--  1 551    551     43 May  3 11:39 bidBudgetManufacture.txt
    -rw-r--r--  1 551    551       0 May  3 11:39 bidCrankCo.txt
    -rw-r--r--  1 551    551      73 May  3 11:39 bidSamAndSons.txt
    -rw-r--r--  1 551    551      33 May  3 11:39 bidWidgetRUs.txt

Especificando as Opções de Nova Tentativa

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
  2. Configure as opções de nova tentativa para conectar-se a um Servidor FTP. A tabela a seguir define as opções de nova tentativa para uma conexão com um Servidor FTP:
    Tabela 3.
    Campo Descrição
    Tentar novamente  
    1) Aguardar ___ segundo(s) entre cada nova tentativa. O número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Servidor FTP.
    2) Tentar se conectar ___ vezes antes de falhar. Especifica a contagem de novas tentativas - o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Servidor FTP antes de emitir um erro.

    Se uma orquestração que inicia com uma atividade Arquivos de Listas do FTP for implementada e o Integration Appliance não puder se conectar ao Servidor FTP especificado, o Integration Appliance registrará os erros de conexão como avisos no log do sistema até que o valor da contagem de novas tentativas seja atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro no log do sistema, reconfigura a contagem de erros de conexão para zero e continua tentando estabelecer uma conexão com o Servidor FTP.

    Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e reconfigura a contagem de erros de conexão para zero. Portanto, o quinto erro de conexão gera um aviso no log do sistema. O Integration Appliance continua tentando estabelecer uma conexão com o Servidor FTP.

Mapeando a Entrada da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. A área de janela Tentar Novamente é exibida. Os parâmetros de entrada da atividade são exibidos na área de janela Atividade de Destino.
  2. É opcional mapear os parâmetros de entrada da atividade Listar Arquivos do FTP. A atividade Listar Arquivos do FTP possui os seguintes parâmetros de entrada opcionais:    
    • directory
    • connection

    Se o parâmetro de entrada listado na tabela a seguir não for exibido na área de janela Atividade de Destino da área de janela Mapear Entradas, selecione Mapear > Mostrar Parâmetros Opcionais no menu da barra de ferramentas ou clique com o botão direito do mouse na área de janela Atividade de Destino e selecione a opção Mostrar Parâmetros Opcionais. Se a opção Mapear > Mostrar Parâmetros Opcionais não for selecionável no menu da barra de ferramentas, clique em um nó na área de janela Mapear Entradas para tornar essa opção ativa.

    É possível, opcionalmente, substituir as configurações que você especificou nas tarefas Configurar e Escolher Terminal da Lista de Verificação dinamicamente durante o tempo de execução, usando os parâmetros de entrada definidos na tabela a seguir.

    Por exemplo, o diretório no Servidor FTP no qual o Integration Appliance obtém a lista de arquivos poderia ser configurado na tarefa Configurar no diretório chamado input. Durante o tempo de execução, o nome de diretório: inputXML poderia ser transmitido para a atividade usando o parâmetro de entrada directory. O nome de diretório especificado dinamicamente durante o tempo de execução substitui a configuração original especificada na área de janela Configurar. Neste exemplo, a lista de arquivos é gerada a partir do diretório inputXML.

Tabela 4.
Nome do Parâmetro de Entrada/Nó Descrição Substitui a Configuração na Tarefa?
directory Especifica o diretório no servidor de FTP em que o Integration Appliance gera uma lista de arquivos nesta atividade. O parâmetro de entrada directory substitui o campo No Diretório da tarefa Configurar.
connection/timeout Especifica a quantidade de tempo em segundos antes de ocorrer um tempo limite entre o Integration Appliance tentar estabelecer uma conexão com o terminal e o tempo que demora para o terminal responder à solicitação de conexão. Para a atividade Excluir Arquivo de FTP, a quantidade de tempo em que o Integration Appliance tenta estabelecer uma conexão com o Servidor FTP antes de expirar. O nó timeout do parâmetro de entrada connection substitui o campo Tempo Limite de Conexão -Expirar após ___ segundo(s) ao estabelecer uma conexão com o Terminal do terminal FTP.
connection/host Especifica o Nome do Host ou o endereço IP para o servidor FTP. O nó host do parâmetro de entrada connection substitui o campo Nome do Host do terminal FTP.
connection/port Especifica o número da porta para o nome do host especificado. A porta padrão para o tráfego de FTP é 21. A porta padrão para o tráfego de SFTP é 22. O nó port do parâmetro de entrada connection substitui o campo Porta do terminal FTP.
connection/username Especifique um nome de usuário para a conta usada para conectar-se ao Servidor FTP. O nó username do parâmetro de entrada connection substitui o campo Nome de Usuário do terminal FTP.
connection/password Especifique uma senha para a conta usada para se conectar ao Servidor FTP. O nó password do parâmetro de entrada connection substitui o campo Senha do terminal FTP.

Mapeando a Saída da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação. Os parâmetros de saída directoryListing ou fileListing são exibidos na área de janela Atividade de Partida.
  2. Mapeie o parâmetro de saída directoryListing ou fileListing para uma variável. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.

Durante o tempo de execução, a atividade Listar Arquivos de FTP retorna a lista de arquivos para a orquestração usando o parâmetro de saída directoryListing ou fileListing.

Se a caixa de seleção Listar Apenas Arquivos (NLST) for desmarcada na tarefa Configurar, uma listagem de diretórios completa, incluindo permissões de diretório, registros de data e hora e propriedade, será retornada no parâmetro de saída directoryListing como uma sequência única. Quando uma listagem de diretórios completa é retornada como uma sequência, você deve analisar a listagem de diretórios usando um esquema de Arquivo Simples com a atividade Ler Arquivo Simples. É possível criar um Esquema de Arquivo Simples usando o Editor de Esquema de Arquivo Simples. Para obter uma orquestração de exemplo analisando uma listagem de diretórios usando um Esquema de Arquivo Simples, consulte o Exemplo Analisar Listagem de Diretórios: Exemplo de Análise da Listagem de Diretórios.

Se a caixa de seleção Listar Somente Arquivos (NLST) estiver selecionada e a atividade Arquivos de Lista do FTP suportar o formato da listagem do diretório do Servidor FTP, uma estrutura de repetição apenas dos nomes de arquivos (se suportada pelo servidor FTP) será retornada no parâmetro de saída fileListing. Quando uma estrutura de repetição do nome do arquivo é retornada, você não precisa analisar a listagem de diretórios e pode iterar apenas através da lista usando uma atividade For Each ou Loop While.