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.

Dependendo de seus requisitos do aplicativo, é possível processar uma lista de arquivos em um diretório FTP usando um dos métodos a seguir:
Use a atividade Pesquisar Diretório do FTP para processar um conjunto de arquivos localizados em um diretório FTP quando as seguintes condições são verdadeiras:

Links Simbólicos

O suporte para links simbólicos pela atividade Pesquisar Diretório 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 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  
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.

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

Para o Terminal FTP Microsoft IIS (Internet Information Services), o comportamento do tempo de execução da atividade Pesquisar Diretório 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 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

  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 Pesquisar Diretório 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.
        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 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 "Configurar 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.
        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 originalmente especificado ou alterar o diretório configurado do campo No Diretório clicando em Procurar conforme descrito abaixo no procedimento "Configurando 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.
  2. Crie ou edite 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
    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: /input.  (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/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 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.
    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 Pasta - Mover o arquivo para o diretório especificado após ele ter sido 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 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: input/.  (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/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 que a atividade Pesquisar Diretório do FTP pesquisar durante o tempo de execução, se a atividade não puder mover para o arquivo porque a movimentação especificada para o diretório não existe, um aviso será registrado (não um erro) no Web Management Console (WMC) e o arquivo permanecerá no local. Para todas as pesquisas subsequentes, a atividade não tenta mover o mesmo arquivo e uma mensagem de nível de informação é registrada no WMC indicando 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

  1. Selecione a tarefa Regras de Entrega na Lista de Verificação. A área de janela Regras de Entrega é exibida.
  2. Especifique o intervalo de tempo para pesquisar os arquivos no Servidor FTP:
    1. Selecione uma unidade de tempo no menu suspenso: segundos, minutos, horas ou dias.
    2. Especifique a quantidade de tempo clicando no campo Intervalo de Pesquisa e inserindo um valor ou usando as setas para cima e para baixo.
    Para obter informações adicionais, consulte Comportamento do Intervalo de Pesquisa.
  3. 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

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

  1. 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 Da Atividade 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 na tarefa Mapear Saídas, mas a funcionalidade MDTM (retornar o horário 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 este erro. Um aviso é gerado e a data Epoch (1/1/1970) é retornada no parâmetro de saída timestamp.
  2. Não é necessário mapear os parâmetros de saída da atividade. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.