Atividade Excluir Arquivo de FTP

Use a atividade Excluir Arquivo de FTP para excluir arquivos específicos dos diretórios específicos, durante o tempo de execução.

Geralmente, a atividade Excluir Arquivo do FTP é usada em conjunto com a atividade Listar Arquivos de FTP, conforme mostrado no exemplo de orquestração a seguir: Para obter um projeto de exemplo que usa uma atividade Excluir Arquivo de FTP, consulte Exemplo de Análise da Listagem de Diretórios.

Link Simbólico

A atividade Excluir Arquivo de FTP suporta links simbólicos para diretórios se as seguintes condições são verdadeiras: 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 Excluir Arquivo de 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 Excluir 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 Procurar, conforme descrito abaixo 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 originalmente especificado ou alterar o diretório configurado do campo No Diretório clicando em Procurar conforme descrito abaixo no procedimento "Configurando 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
    Procurar  
    Arquivo Nomeado Este campo não é usado para esta atividade. Especifique o nome do arquivo a ser excluído 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 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 a nota abaixo 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.
    Durante o tempo de execução, o valor especificado no campo No Diretório da tarefa Configurar é sobrescrito se um valor é fornecido para o parâmetro de entrada directory opcional usando uma das opções a seguir:
    • O parâmetro de entrada directory é mapeado para uma variável.
    • Um valor padrão é fornecido para o parâmetro de entrada directory.
    Para obter informações adicionais, consulte o procedimento "Mapeando a Entrada da Atividade".
    Nota: UNIX: Se você especificar um caminho do diretório relativo ao conectar-se 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.

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 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 Excluir 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, 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. Você deve mapear uma variável para o parâmetro de entrada filename. Todos os outros parâmetros de entrada são opcionais. O parâmetro filename especifica o nome do arquivo para excluir no Servidor FTP.

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 exclui o arquivo poderia ser configurado na tarefa Configurar no diretório chamado process. Durante o tempo de execução, o nome de diretório: processXML 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 excluído do diretório processXML.

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.
connection/timeout Especifica o número de segundos antes de um tempo limite ocorrer 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 Excluir Arquivo de FTP, a quantidade de tempo em 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.