Atividade Obter Arquivo de FTP

Durante o tempo de execução, a atividade Obter Arquivo do FTP se conecta a um Servidor FTP e tenta obter um único arquivo no local especificado. É possível configurar a atividade Obter Arquivo do FTP para retornar o conteúdo do arquivo para uma variável da orquestração. Além disso, é possível configurar a atividade Obter Arquivo do FTP para retornar o registro de data e hora do arquivo retornado pelo Servidor FTP para uma variável da orquestração.

A atividade Obter Arquivo do FTP difere da atividade Pesquisar Diretório do FTP das seguintes maneiras:

Link Simbólico

O suporte para links simbólicos pela atividade Obter Arquivo do FTP durante o tempo de execução é dependente dos fatores a seguir:   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.

Incluindo uma Atividade Obter Arquivo 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 Obter Arquivo 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. É necessário especificar um novo Servidor de FTP que corresponda à estrutura do diretório do Servidor de FTP originalmente especificado ou alterar o diretório configurado do campo No Diretório, clicando em Navegar, conforme descrito no procedimento de Configuração da 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.
        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 especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento "Configurar 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

Especificando as Regras de Entrega

  1. Selecione a tarefa Regras de Entrega a partir da Lista de Verificação. A área de janela Regras de Entrega é exibida. 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. Se a segurança for ativada para o terminal FTP, o tipo de transferência de arquivos sempre será binário.
  2. 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 pelo Integration Appliance para o Servidor FTP. Esta opção é usada para transferir arquivos ASCII tais como arquivos HTML e de texto.
      CUIDADO:
      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 pelo Integration Appliance para o Servidor FTP. 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

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 Este campo não é usado para esta atividade. Especifique o nome do arquivo de saída usando o parâmetro de entrada filename da tarefa Mapear Entrada.
    Do Diretório Especifica o diretório no servidor FTP no qual o Integration Appliance coloca o arquivo gerado nesta atividade. É 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: /output.  (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/output.
    • 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.
    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.
     
    Atenção: Você deve especificar a opção Transferir como Texto (ASCII) para atividades de FTP ao recuperar arquivos de texto e colocar arquivos de texto em um Servidor FTP para Terminais que manipulam dados de 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 Obter Arquivo do FTP, para o campo Do Tipo, selecione a opção Texto.
    • Na atividade 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).

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 e parar o processamento da tarefa de orquestração atual.

    Se você implementar uma orquestração que contém uma atividade Obter Arquivo do FTP e o Integration Appliance não puder se conectar ao Servidor FTP especificado, o Integration Appliance registrará os erros de conexão como avisos nos logs do sistema e de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual.

    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 para o processamento da tarefa de orquestração atual.

Mapeando a Entrada para a Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. Os parâmetros de entrada da atividade são exibidos na área de janela Atividade de Destino.
  2. O parâmetro filename é o único parâmetro para o qual você precisa fornecer um valor na atividade. Todos os outros parâmetros são opcionais. O parâmetro filename especifica o nome do arquivo para obter a partir do Servidor FTP. Forneça um valor para o parâmetro filename criando um link a partir do parâmetro de entrada filename para uma variável ou definindo um valor-padrão para o parâmetro de entrada filename.

    Se o parâmetro de entrada opcional listado na tabela a seguir não for exibido na área de janela Atividade de Destino 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 Atividade de Destino 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 o arquivo 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, o Integration Appliance tenta obter o arquivo 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 Do Diretório da tarefa Configurar.
encoding Especifica como os dados de saída são gravados no arquivo:
  • Se nenhuma codificação for necessária, especifique a sequência: binary.
  • Se a codificação for necessária, especifique o tipo de codificação que deve ser usado para codificar os dados de saída, por exemplo: UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US ou SHIFT-JIS.
O parâmetro de entrada encoding substitui a codificação especificada no campo Do Tipo da tarefa Configurar mas, se a opção Binário estiver selecionada no campo Do Tipo da tarefa Configurar, a codificação especificada pelo parâmetro de entrada encoding será ignorada.
connection/timeout Especifica o tempo limite de conexão — o número de segundos antes que um tempo limite ocorra 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 Obter Arquivo do FTP, a quantidade de tempo em que o Integration Appliance tenta estabelecer uma conexão com o Servidor FTP antes de expirar.   O nó de tempo limite do parâmetro de entrada de conexão 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 da atividade são exibidos na área de janela Atividade de Partida, conforme descrito na tabela a seguir:
    Tabela 5.
    Nome do Parâmetro de Saída Descrição
    dados Contém o conteúdo do arquivo.
    timestamp Contém o registro de data e hora para o arquivo retornado do Servidor FTP, geralmente a data de criação ou data da última modificação do arquivo.  
  2. Mapeie os parâmetros de saída desejados para as variáveis.



Feedback | notices