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 depende dos fatores a seguir:  
  • 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 especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento "Configurar 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 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.
  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: 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

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



Feedback | notices