Atividade Pesquisar Diretório de FTP
Durante o tempo de execução, a atividade Pesquisar Diretório do FTP conecta-se a um servidor FTP e pesquisa a existência do arquivo ou dos arquivos especificados no local especificado. Após ler o conteúdo do(s) arquivo(s) e mapear o conteúdo para a(s) variável(is) da orquestração, a atividade Pesquisar Diretório do FTP pode excluir o(s) arquivo(s), mover o(s) arquivo(s) ou deixar o arquivo(s) no arquivo do Servidor FTP.
A atividade Pesquisar Diretório do FTP é uma atividade iniciadora. Quando uma orquestração que inicia com uma atividade Pesquisar Diretório do FTP é implementada no Integration Appliance, o Integration Appliance pesquisa o(s) arquivo(s) a ser(em) incluído(s) em um diretório específico no Servidor FTP. Quando um arquivo ou arquivos são mostrados no Servidor FTP, uma tarefa de orquestração é iniciada para processar o arquivo ou os arquivos e o restante das atividades na orquestração. Para obter informações adicionais, consulte Comportamento do Intervalo de Sondagem. Para obter um exemplo de uma orquestração usando a atividade Pesquisar Diretório do FTP, consulte o Guia de Introdução.
- Para alguns casos, é possível usar apenas a atividade Pesquisar Diretório do FTP para processar um conjunto de arquivos localizados em um diretório FTP.
- Nos outros 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.
- A atividade Pesquisar Diretório do FTP suporta o formato da listagem de diretórios de seu Servidor FTP. - O formato das listagens de diretórios é diferente para os Servidores FTP suportados em sistemas operacionais diferentes. 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 com um Esquema de Arquivo Simples 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.
- Após ler cada arquivo na lista, cada um deles pode ser pós-processado com a mesma ação. - Por exemplo, ao processar um conjunto de arquivos de um diretório FTP, se cada arquivo na lista puder ser movido para o mesmo diretório, será possível usar a atividade Pesquisar Diretório do FTP para processar o conjunto de arquivos. Se, no entanto, for necessário processar uma ação diferente baseada nas propriedades de um arquivo, você deverá 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. Por exemplo, se tiver que 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.
Links Simbólicos
- 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 Pesquisar
Diretório 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 Pesquisas Diretório 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 Pesquisar Diretório do FTP durante o tempo de execução. Diretórios Suportados Suportados
Persistência
Você pode desejar ativar a persistência para uma orquestração que contém uma atividade Pesquisar Diretório do FTP. Por exemplo, se você desativar a persistência e tiver uma tarefa de orquestração com uma atividade Pesquisar Diretório do FTP com a opção Manter no Local selecionada, durante o tempo de execução, se ocorrer uma falha que faz com que a tarefa pare, quando a orquestração for reinicializada, ela processará o arquivo novamente. O estado da tarefa será perdido e o Integration Appliance não saberá que já processou o arquivo. Para obter informações adicionais, consulte Ativando a Persistência.
Processando Subdiretórios com o Terminal FTP Microsoft
- 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 fica em branco, a tarefa de orquestração não processa os subdiretórios no diretório especificado
Incluindo uma Atividade Pesquisar Diretório do FTP na Orquestração
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta FTP.
- Arraste a atividade Pesquisar Diretório para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal FTP
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é
exibido. CUIDADO: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 especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento "Configurar a Atividade".
- Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurar a Atividade".
- Selecione Procurar. O Explorador de Projetos é
exibido.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.CUIDADO: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 especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento "Configurar a Atividade". Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Selecione um terminal existente:
- Crie ou edite um terminal FTP.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
- Configure todos os campos nessa área de janela, conforme descrito na tabela
a seguir:
Tabela 2. Campo Descrição Arquivo Nomeado Especifica um padrão ou uma expressão regular que define o(s) nome(s) do arquivo 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.No Diretório Especifica o diretório no qual o Integration Appliance procura arquivos no Servidor FTP. É 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: entrada. (Supõe que o início do FTP foi configurado para a conta do usuário que se conecta ao Servidor FTP. Consulte "Nota" para obter mais informações.)
- Caminho do diretório completo, por exemplo, em uma máquina UNIX: /home/user/input.
- 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 está se conectando ao Servidor FTP.Testar Após uma expressão regular ter sido especificada no campo Nome do Arquivo e o diretório para procurar por arquivos no Servidor FTP tiver sido especificado no campo No Diretório, clique em Testar para testar a expressão regular com relação ao conjunto de arquivos no diretório especificado no Servidor FTP. Uma caixa de diálogo aparecerá listando qualquer um dos arquivos correspondentes. De Tipo Especifica como ler no conteúdo do arquivo - como dados binários ou texto codificado. Se a opção Texto for selecionada, configure o tipo de codificação usando uma das opções a seguir: - Na lista suspensa Codificado com, selecione um dos tipos de codificação padrão.
- Insira o tipo de codificação diretamente clicando no campo Codificado com e digitando seu tipo de codificação.
Nota: Alguns caracteres de byte duplo não são convertidos com o uso da codificação SHIFT-JIS. Para obter informações adicionais, consulte Usando a Codificação Shift-JIS.CUIDADO:Você deve especificar a opção Transferir como Texto (ASCII) para atividades do FTP ao recuperar arquivos de texto e colocar arquivos de texto em um Servidor FTP para Terminais que manipulam dados do texto durante a transferência de dados de/para o terminal FTP no modo ASCII. Por exemplo, Terminais FTP de mainframe e DOS manipulam dados ASCII quando transmitem dados no modo ASCII. Por exemplo, se sua orquestração recuperar arquivos ASCII usando a atividade Pesquisar Diretório do FTP e colocar arquivos ASCII usando a atividade Colocar Arquivo do FTP em um servidor FTP de mainframe, você deverá especificar as opções nas tarefas a seguir no Studio:- Na tarefa Configurar de uma atividade Pesquisar Diretório do FTP, para o campo Do Tipo, selecione a opção Texto.
- Na tarefa Regras de Entrega de uma atividade Pesquisar Diretório do FTP, para o campo Tipo de Transferência de Arquivos, selecione a opção Transferir como Texto (ASCII).
- Na tarefa Configurar de uma atividade Colocar Arquivo do FTP, para o campo Do Tipo, selecione a opção Texto.
- Na tarefa Regras de Entrega de uma atividade Colocar Arquivo do FTP, para o campo Tipo de Transferência de Arquivos, selecione a opção Transferir como Texto (ASCII).
Após ler o arquivo Excluí-lo - Excluir o arquivo após ele ter sido lido.
Mover para o diretório - Mover o arquivo para o diretório especificado depois que o arquivo foi lido.
Especifique o diretório para o qual o arquivo é movido durante o tempo de execução, usando uma das opções a seguir:- Insira um caminho do diretório diretamente clicando no campo e
digitando um dos seguintes caminhos do diretório:
- Caminho do diretório relativo, por exemplo: input/. (Supõe que o início do FTP foi configurado para a conta do usuário que se conecta ao Servidor FTP. Consulte "Nota" para obter mais informações.)
- Caminho do diretório completo, por exemplo, em uma máquina UNIX: /home/user/input/.
- Clique em Procurar... para preencher a lista suspensa de diretórios disponíveis. Selecione o diretório apropriado na lista suspensa.
Atenção: Especifique o separador do diretório após o último nome de diretório listado. Por exemplo, para mover um arquivo para o diretório processed/acme em um caminho relativo, especifique o seguinte diretório no campo Mover para o Diretório: processed/acme/Opcional - Especifique o formato do nome do arquivo após ele ter sido renomeado. Na lista suspensa Padrão, selecione o padrão desejado. Para especificar o caractere usado para separar os subcampos no nome do arquivo, insira um caractere no campo Separador Padrão. Especifique o comportamento do tempo de execução quando um arquivo com o mesmo nome do arquivo existir:- Selecione a caixa de seleção Sobrescrever para especificar que o arquivo existente deve ser sobrescrito se um arquivo com o mesmo nome já existir.
- Limpe a caixa de seleção Sobrescrever para especificar que o arquivo existente não deve ser sobrescrito se um arquivo com o mesmo nome já existir.
Nota: Na primeira vez em que a atividade Pesquisar Diretório do FTP pesquisar durante o tempo de execução, se a atividade não conseguir mover o arquivo porque a movimentação especificada para o diretório não existir, um aviso será registrado (não um erro) no Web Management Console (WMC) e o arquivo permanecerá em vigor. Para todas pesquisas subsequentes, a atividade não tentará mover o mesmo arquivo e uma mensagem informativa será registrada no WMC declarando que o arquivo já foi processado.Manter no Local - Deixar o arquivo no diretório de entrada após o arquivo ter sido lido.
Opções Avançadas Descrição Duplicar Tamanho da Lista O tamanho da lista interna usada pelo Integration Appliance para controlar quais arquivos no Servidor FTP foram pesquisados ou não. O valor padrão é 10000. Você deve especificar apenas um tamanho maior que o padrão.
Especificando as Regras de Entrega
- Selecione a tarefa Regras de Entrega na Lista de Verificação. A área de janela Regras de Entrega é exibida.
- Especifique o intervalo de tempo para pesquisar os arquivos no
Servidor FTP:
- Selecione uma unidade de tempo no menu suspenso: segundos, minutos, horas ou dias.
- Especifique a quantidade de tempo clicando no campo Intervalo de Pesquisa e inserindo um valor ou usando as setas para cima e para baixo.
- Se a segurança não estiver ativada para o terminal FTP, as opções
Transferir como Texto (ASCII) e Transferir como Binário (BINARY) serão
ativadas na tarefa Regras de Entrega. Se a segurança estiver ativada para
o Terminal FTP, o tipo de transferência de arquivos será sempre binário. Selecione o tipo de transferência de arquivos entre o Integration Appliance e o Servidor FTP a partir de uma das opções a seguir:
- Transferir como Texto (ASCII) - Apenas sete bits de cada caractere no arquivo são transferidos do Servidor FTP para o Integration Appliance. Esta opção é usada para transferir arquivos ASCII tais como arquivos HTML e de texto. AVISO: Usar esta opção com arquivos binários pode resultar em uma perda de dados.
- Transferir como Binário (BINARY) - Todos os oito bits de cada
byte no arquivo são transferidos do Servidor FTP para o Integration
Appliance.Esta opção é usada para transferir arquivos binários.Nota: A configuração do modo de transferência na tarefa Regras de Entrega é equivalente à configuração do modo de transferência por meio de uma sessão de linha de comandos com um Servidor FTP usando os comandos a seguir:
- ascii
- binary
Nota: O terminal de SFTP do conector de FTP Cast Iron suporta apenas o protocolo de SFTP do lado do cliente versão 3. Consequentemente, o protocolo de SFTP não suporta transferência de arquivos de modo ASCII/texto. Certifique-se de configurar o Tipo de Transferência de Arquivos para Transferir como Binário (BINARY) nas .
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
- 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 Pesquisar Diretório 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 Saída da Atividade
- Selecione a tarefa Mapear Saídas na Lista de Verificação. Os parâmetros de saída da atividade são exibidos na área de janela Atividade de Partida conforme listado na tabela a seguir:
Tabela 4. Parâmetro de Saída Descrição nome do arquivo Fornece o nome do arquivo localizado no Servidor FTP. dados Fornece o conteúdo do arquivo. timestamp Fornece a data e hora como uma sequência no formato de dataType do Esquema XML (YYYY-MM-DDhh:mm:ss, em que YY é o ano, MM é o mês, DD é o dia, hh é o fuso horário, mm são os minutos e ss são os segundos.) Nota: Se o parâmetro de saída timestamp for mapeado para a tarefa Mapear Saídas, mas a funcionalidade do MDTM (retornar o tempo de modificação de um arquivo) não estiver disponível ou não estiver ativada para o Servidor FTP, durante o tempo de execução, a orquestração parará o processamento devido a esse erro. Um aviso é gerado e a data Época (1/1/1970) é retornada no parâmetro de saída timestamp. - Não é necessário mapear os parâmetros de saída da atividade. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.