Atividade Colocar Arquivo de FTP

Durante o tempo de execução, a atividade Colocar Arquivo do FTP obtém dados de variáveis da orquestração, coloca os dados em um arquivo e se conecta a um Servidor FTP e coloca o arquivo no local do diretório especificado.

Para obter um exemplo de como usar a atividade Colocar Arquivo do FTP, consulte o Guia de Introdução.

Interrupção da Transferência

A transferência de arquivos feita pela atividade Colocar Arquivo do FTP durante o tempo de execução é não transacional e, portanto, não é garantida. Por exemplo, se uma atividade Colocar Arquivo do FTP transferir um arquivo do Integration Appliance para um Servidor FTP e a transferência do arquivo for interrompida porque o Integration Appliance foi reinicializado, não é garantido que o arquivo inteiro seja transferido.

Link Simbólico

A atividade Colocar Arquivo do FTP suporta links simbólicos para diretórios se os links simbólicos para os diretórios são suportados pelo sistema operacional que hospeda o Servidor FTP e os links simbólicos para diretórios são suportados pelo próprio Servidor FTP. 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 Colocar 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 Colocar 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 uma das ações a seguir:
    • 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. 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 Procurar, conforme descrito abaixo no procedimento para 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.
        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 Procurar, conforme descrito abaixo 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 os campos nesta área de janela, conforme descrito na tabela a seguir:
    Tabela 1.
    Campo Descrição
    Salvar  
    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.
    No 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 a nota abaixo 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 se conecta 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.
    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.
    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).
    Opções - Selecione uma das opções a seguir para definir o comportamento quando um arquivo com o mesmo nome já existe no diretório de saída especificado:
    Sobrescrever Arquivo Existente se Nome de Arquivo Duplicado for Localizado Especifica se o arquivo já existe, destrói o conteúdo do arquivo original com novos dados retornados da atividade.
    Anexar no Arquivo Existente Especifica se o arquivo já existe, mantém os dados originais no arquivo e anexa os novos dados (retornados da atividade) no final do arquivo.
    Levantar Erro se Arquivo com Nome Duplicado for Localizado Especifica se o arquivo já existe, mantém os dados originais no arquivo, emite um erro e não faz nada com os novos dados retornados da atividade.

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 descreve as opções de nova tentativa para conectar-se a um Servidor FTP:
    Tabela 2.
    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 Colocar 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, configure a contagem de novas tentativas como 3. O primeiro, segundo e terceiro erros de conexão são mostrados 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 da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. A área de janela Tentar Novamente é exibida. Os parâmetros de entrada da atividade são exibidos na área de janela Para Atividade.
  2. Não é necessário mapear todos os parâmetros de entrada da atividade. Os parâmetros a seguir são os necessários:  
    • filename
    • dados
Todos os outros parâmetros são opcionais. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.  

Se o parâmetro de entrada listado na tabela a seguir não for exibido na área de janela Para Atividade 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 Para Atividade 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 coloca o arquivo gerado nesta atividade poderia ser configurado na tarefa Configurar no diretório chamado output. Durante o tempo de execução, o nome de diretório: outputXML 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 arquivo seria colocado no diretório outputXML.

Tabela 3.
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 No 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.
overwrite Especifica o comportamento quando um arquivo existente com o mesmo nome já existe no diretório de saída especificado. Especifique um dos valores a seguir:
  • y - Especifica se o arquivo já existe, destrói o conteúdo do arquivo original com novos dados retornados da atividade.
  • a - Especifica se o arquivo já existe, mantém os dados originais no arquivo e anexa os novos dados (retornados da atividade) no final do arquivo.
  • n - Especifica se o arquivo já existe, mantém os dados originais no arquivo e não faz nada com os novos dados retornados da atividade.
O parâmetro de entrada overwrite substituir o campo Opções da tarefa Configurar.
connection/timeout Especifica o tempo limite de conexão - a quantidade de tempo em 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 Colocar Arquivo do FTP, a quantidade de vezes 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.