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 Apenas Arquivos (NLST) for selecionada e a atividade Listar Arquivos do FTP suportar o formato da listagem de diretórios para seu Servidor FTP, uma estrutura de repetição apenas dos nomes de listas 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.

Para alguns casos, você deve usar 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, enquanto em outros casos é possível usar apenas a atividade Pesquisar Diretório do 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:

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:   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 do 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:

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 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 FTP no qual o Integration Appliance exclui o arquivo especificado. É 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 conectar-se 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 está se conectando ao Servidor FTP.
    Arquivo Nomeado Especifica um padrão ou uma expressão regular que define os nomes de arquivos para obter a partir do Servidor FTP. O processamento da expressão regular é feito pelo Servidor FTP. Para obter informações adicionais, consulte a documentação do Servidor FTP sobre expressões regulares. Geralmente, os Servidores FTP suportam os seguintes curingas em suas expressões regulares:
    • * - zero ou mais caracteres
    • ? - zero ou um caractere
    Nota: Como o processamento da expressão regular é feito no servidor FTP, a distinção entre maiúsculas e minúsculas é determinada pelo Servidor FTP. Se o Servidor FTP fizer distinção entre maiúsculas e minúsculas, a correspondência de arquivo feita pela atividade Pesquisar Diretório do FTP também fará distinção entre maiúsculas e minúsculas.
    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 Apenas Arquivos (NLST) for selecionada, apenas os nomes de arquivos serão retornados quando o botão Testar for clicado, conforme mostrado na listagem de exemplo a seguir:
      bidAcmeInc.txt
      bidBudgetManufacture.txt
      bidCrankCo.txt
      bidSamAndSons.txt
      bidWidgetRUs.txt
      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 Nomes de Arquivos é retornado no nó de repetição fileName do parâmetro de saída fileListing. Para este exemplo, a primeira instância do elemento de repetição fileListing/fileName é igual a bidAcmeInc.txt, a segunda instância do elemento de repetição fileListing/fileName é igual a bidBudgetManufacture.txt, etc.
    • Se a caixa de seleção Listar Apenas Arquivos (NLST) for desmarcada, uma listagem de diretórios completa, incluindo permissões do diretório, registros de data e hora e propriedade, será retornada quando o botão Testar for clicado, conforme mostrado na listagem de exemplo a seguir:
      -rw-r--r--   1 551
           551
                 65
      3 de maio 11h39 bidAcmeInc.txt
      -rw-r--r--   1 551
           551
                 43
      3 de maio 11h39 bidBudgetManufacture.txt
      -rw-r--r--   1 551
           551
                  0
      3 de maio 11h39 bidCrankCo.txt
      -rw-r--r--   1 551
           551
                 73
      3 de maio 11h39 bidSamAndSons.txt
      -rw-r--r--   1 551      551            33 May  3 11:39 bidWidgetRUs.txt
      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.

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 Para Atividade.
  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 Para Atividade 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 Para Atividade 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 FTP no qual o Integration Appliance coloca o arquivo gerado 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 Da Atividade.
  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 Apenas Arquivos (NLST) for selecionada e a atividade Listar Arquivos do FTP suportar o formato da listagem de diretórios para seu Servidor FTP, uma estrutura de repetição apenas dos nomes de arquivos 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.