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.
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 |
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:
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. |
bidAcmeInc.txt
bidBudgetManufacture.txt
bidCrankCo.txt
bidSamAndSons.txt
bidWidgetRUs.txt
-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
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. |
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 Mostrar Parâmetros Opcionais. Se a opção 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.
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É 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.
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. |
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.