Atividade Renomear Arquivo de FTP

Use a atividade Renomear Arquivo de FTP para renomear e/ou mover um arquivo para um diretório diferente durante o tempo de execução.

O diretório que a atividade Renomear Arquivo de FTP renomeia é mostrado nos seguintes casos suportados:
  • Mover o arquivo para um novo diretório e renomear o arquivo. Por exemplo, um arquivo denominado BidAcmeInc.xml é movido do diretório chamado diretório de entrada para o diretório do processo e renomeado para NewBidAcmeInc.xml.
  • Mover o arquivo para um novo diretório mas manter o nome do arquivo existente. Por exemplo, um arquivo denominado BidAcmeInc.xml é movido do diretório chamado diretório de entrada para o diretório do processo.
  • Renomear o arquivo e mantê-lo no diretório original. Por exemplo, um arquivo denominado BidAcmeInc.xml é renomeado para NewBidAcmeInc.xml no diretório de entrada.
Para obter um projeto de exemplo que usa uma atividade Renomear Arquivo de FTP, consulte o Exemplo Analisar Listagem de Diretórios: Exemplo de Análise da Listagem de Diretórios.

Link Simbólico

A atividade Renomear Arquivo de FTP suporta links simbólicos para diretórios se as seguintes condições são verdadeiras:
  • Se links simbólicos para diretórios são suportados pelo sistema operacional que hospeda o Servidor FTP.
  • Se 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 Renomear Arquivo 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 Renomear 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. 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. Acesse o procedimento "Configurando 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

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
    Renomear  
    Arquivo Nomeado Este campo não é usado para esta atividade. Especifique o nome do arquivo a renomear usando o parâmetro de entrada fromFilename da tarefa Mapear Entrada.
    Do Diretório Especifica o diretório no servidor FTP no qual o Integration Appliance exclui o arquivo especificado. É 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: /process. (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/process.
    • 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.
    Novo Caminho Este campo não é usado para esta atividade. Especifique o caminho completo, incluindo o novo nome do arquivo e o novo diretório no servidor FTP, no qual o Integration Appliance coloca o arquivo que foi movido usando o parâmetro de entrada toPath da tarefa Mapear Entrada.
    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.
    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.
    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 Renomear Arquivo de 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, o segundo e o 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 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 Atividade de Destino.
  2. Você deve mapear uma variável para os seguintes parâmetros de entrada:
    • fromFilename - Durante uma ação de renomeação, este parâmetro especifica o nome original do arquivo a renomear.
    • toPath - Durante uma ação de renomeação, este parâmetro especifica o caminho, incluindo o novo nome de diretório e o novo nome do arquivo. Por exemplo, para especificar que o arquivo seja movido para o diretório /output da raiz do Servidor FTP usando o nome do arquivo fileNewName.txt, especifique o valor a seguir para toPath: /output/fileNewName.txt

      Todos os outros parâmetros de entrada são opcionais. Consulte Criando um Mapa para obter instruções gerais sobre o mapeamento.

      Se o parâmetro de entrada 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 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?
      fromDirectory Especifica o diretório no servidor FTP no qual o Integration Appliance obtém a lista de arquivos. O parâmetro de entrada directory substitui o campo No Diretório da tarefa Configurar.
      overwrite Especifica a quantidade de tempo em segundos antes de ocorrer um tempo limite 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 Listar Arquivos de FTP, a quantidade de tempo 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/timeout Especifica o Nome do Host ou o endereço IP para o servidor FTP. 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 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ó 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 directoryListing ou fileListing são exibidos na área de janela Atividade de Partida.
  2. Mapeie o parâmetro de saída directoryListing ou fileListing para uma variável. Consulte Criando um Mapa para obter instruções gerais sobre o mapeamento.

    Durante o tempo de execução, a atividade Listar Arquivos de FTP retorna a lista de arquivos para a orquestração usando o parâmetro de saída directoryListing ou fileListing.

    Se a caixa de seleção Listar Apenas Arquivos (NLST) for desmarcada na tarefa Configurar, uma listagem de diretórios completa, incluindo permissões de diretório, registros de data e hora e propriedade, será retornada no parâmetro de saída directoryListing como uma sequência única. Quando uma listagem de diretórios completa é retornada como uma sequência, você deve analisar a listagem de diretórios usando um esquema de Arquivo Simples com a atividade Ler Arquivo Simples. É possível criar um Esquema de Arquivo Simples usando o Editor de Esquema de Arquivo Simples. Para obter uma orquestração de exemplo analisando uma listagem de diretórios usando um Esquema de Arquivo Simples, consulte o Exemplo Analisar Listagem de Diretórios: Exemplo de Análise da Listagem de Diretórios.

    Se a caixa de seleção Listar Apenas Arquivos (NLST) for selecionada e a atividade Listar Arquivos do FTP suportar o formato da listagem de diretórios para seu Servidor FTP, uma estrutura de repetição apenas dos nomes de arquivos será retornada no parâmetro de saída fileListing. Quando uma estrutura de repetição do nome do arquivo é retornada, você não precisa analisar a listagem de diretórios e pode iterar apenas através da lista usando uma atividade For Each ou Loop While.