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:
- A atividade Planejar Tarefa cria uma tarefa de orquestração a
cada hora.
- A atividade Listar Arquivos de FTP gera uma lista de arquivos
localizados no diretório \temp localizado no diretório-raiz do Servidor
FTP e armazena o resultado em uma sequência.
- A atividade Ler Arquivo Simples analisa a lista de arquivos e
armazena o resultado em uma estrutura de XML de repetição.
- A atividade For Each itera através da estrutura de repetição
que contém a lista de arquivos:
- Se o arquivo terminar com a extensão .tmp, a atividade Excluir
Arquivo de FTP excluirá o arquivo especificado.
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:
- 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 Excluir Arquivo de FTP na
Orquestração
- Crie ou
abra uma orquestração. Uma representação gráfica
da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta
FTP.
- Arraste a atividade Excluir Arquivo para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal FTP
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- 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".
- Selecione um terminal existente e clique em OK.
Acesse o procedimento "Configurando a Atividade".
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é
exibido.
- 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".
- Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Crie ou edite um terminal FTP:
Criando ou Editando um Terminal FTP
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
- 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 "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.
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 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.
|
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
- 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
- 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.
- 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 Atividade de Destino da área de janela Mapear Entradas, selecione
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 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. |