Durante o tempo de execução, a atividade Pesquisar Diretório do FTP conecta-se a um servidor FTP e pesquisa a existência do arquivo ou dos arquivos especificados no local especificado. Após ler o conteúdo do(s) arquivo(s) e mapear o conteúdo para a(s) variável(is) da orquestração, a atividade Pesquisar Diretório do FTP pode excluir o(s) arquivo(s), mover o(s) arquivo(s) ou deixar o arquivo(s) no arquivo do Servidor FTP.
A atividade Pesquisar Diretório do FTP é uma atividade iniciadora. Quando uma orquestração que inicia com uma atividade Pesquisar Diretório do FTP é implementada no Integration Appliance, o Integration Appliance pesquisa o(s) arquivo(s) a ser(em) incluído(s) em um diretório específico no Servidor FTP. Quando um arquivo ou arquivos são mostrados no Servidor FTP, uma tarefa de orquestração é iniciada para processar o arquivo ou os arquivos e o restante das atividades na orquestração. Para obter informações adicionais, consulte Comportamento do Intervalo de Sondagem. Para obter um exemplo de uma orquestração usando a atividade Pesquisar Diretório do FTP, consulte o Guia de Introdução.
Links Simbólicos para... | Links Simbólicos Completos | Links Simbólicos Simples | Notas |
---|---|---|---|
Arquivos | Não Suportados | Não Suportados | A atividade Pesquisas Diretório do FTP não interpreta links simbólicos para arquivos como arquivos e, portanto, os links simbólicos para arquivos não são processados pela atividade Pesquisar Diretório do FTP durante o tempo de execução. |
Diretórios | Suportados | Suportados |
Você pode desejar ativar a persistência para uma orquestração que contém uma atividade Pesquisar Diretório do FTP. Por exemplo, se você desativar a persistência e tiver uma tarefa de orquestração com uma atividade Pesquisar Diretório do FTP com a opção Manter no Local selecionada, durante o tempo de execução, se ocorrer uma falha que faz com que a tarefa pare, quando a orquestração for reinicializada, ela processará o arquivo novamente. O estado da tarefa será perdido e o Integration Appliance não saberá que já processou o arquivo. Para obter informações adicionais, consulte Ativando a Persistência.
Campo | Descrição |
---|---|
Arquivo Nomeado | Especifica um padrão ou uma expressão regular que
define o(s) nome(s) do arquivo para obter a partir do Servidor FTP. O
processamento da expressão regular é feito pelo Servidor FTP. Para obter
informações adicionais, consulte a documentação do Servidor FTP sobre
expressões regulares. Geralmente, os Servidores FTP suportam os seguintes
curingas em suas expressões regulares:
Nota: Como o processamento da
expressão regular é feito no servidor FTP, a distinção entre maiúsculas e
minúsculas é determinada pelo Servidor FTP.
Se o Servidor FTP fizer distinção entre maiúsculas e minúsculas, a
correspondência de arquivo feita pela atividade Pesquisar Diretório do FTP
também fará distinção entre maiúsculas e minúsculas.
|
No Diretório | Especifica o diretório no qual o Integration
Appliance procura arquivos no Servidor FTP. É possível especificar um
diretório usando uma das opções a seguir:
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.
|
Testar | Após uma expressão regular ter sido especificada no campo Nome do Arquivo e o diretório para procurar por arquivos no Servidor FTP tiver sido especificado no campo No Diretório, clique em Testar para testar a expressão regular com relação ao conjunto de arquivos no diretório especificado no Servidor FTP. Uma caixa de diálogo aparecerá listando qualquer um dos arquivos correspondentes. |
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:
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.
|
CUIDADO: Você deve especificar a opção Transferir como Texto (ASCII) para
atividades do FTP ao recuperar arquivos de texto e colocar arquivos de
texto em um Servidor FTP para Terminais que manipulam dados do 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:
|
|
Após ler o arquivo | Excluí-lo - Excluir o arquivo após ele ter sido lido. Mover para o diretório - Mover o arquivo para o diretório especificado depois que o arquivo foi lido. Especifique o diretório para o
qual o arquivo é movido durante o tempo de execução, usando uma das opções
a seguir:
|
Atenção: Especifique o separador do
diretório após o último nome de diretório listado. Por exemplo, para mover
um arquivo para o diretório processed/acme em um caminho relativo,
especifique o seguinte diretório no campo Mover para o Diretório:
processed/acme/
Opcional - Especifique o formato do nome do arquivo
após ele ter sido renomeado. Na lista suspensa
Padrão, selecione o padrão desejado. Para
especificar o caractere usado para separar os subcampos no nome do
arquivo, insira um caractere no campo Separador
Padrão.
Especifique o comportamento do tempo de execução quando um arquivo com o
mesmo nome do arquivo existir:
Nota: Na primeira vez em que a
atividade Pesquisar Diretório do FTP pesquisar durante o tempo de execução, se a atividade não conseguir mover o arquivo porque a movimentação
especificada para o diretório não existir, um aviso será registrado (não
um erro) no Web Management Console (WMC) e o arquivo permanecerá em vigor. Para todas pesquisas subsequentes, a atividade não tentará mover o mesmo
arquivo e uma mensagem informativa será registrada no WMC
declarando que o arquivo já foi processado.
Manter no Local - Deixar o arquivo no diretório de entrada após o arquivo ter sido lido. |
|
Opções Avançadas | Descrição |
Duplicar Tamanho da Lista | O tamanho da lista interna usada pelo Integration Appliance para controlar quais arquivos no Servidor FTP foram pesquisados ou não. O valor padrão é 10000. Você deve especificar apenas um tamanho maior que o padrão. |
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. Se uma orquestração que
inicia com uma atividade Pesquisar Diretório do FTP for
implementada e o Integration Appliance não puder se conectar ao Servidor
FTP especificado, o Integration Appliance registrará os erros de
conexão como avisos no log do sistema até que o valor da contagem de novas
tentativas seja atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance
registra um erro no log do sistema, reconfigura a contagem de erros de
conexão para zero e continua tentando estabelecer uma conexão com o
Servidor FTP. 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 reconfigura a contagem de erros de conexão para zero. Portanto, o quinto erro de conexão gera um aviso no log do sistema. O Integration Appliance continua tentando estabelecer uma conexão com o Servidor FTP. |
Parâmetro de Saída | Descrição |
---|---|
nome do arquivo | Fornece o nome do arquivo localizado no Servidor FTP. |
dados | Fornece o conteúdo do arquivo. |
timestamp | Fornece a data e hora como uma sequência no formato
de dataType do Esquema XML (YYYY-MM-DDhh:mm:ss, em que YY é o ano, MM é o
mês, DD é o dia, hh é o fuso horário, mm são os minutos e ss são os
segundos.) Nota: Se o parâmetro de saída timestamp for
mapeado para a tarefa Mapear Saídas, mas a funcionalidade do MDTM
(retornar o tempo de modificação de um arquivo) não estiver disponível ou
não estiver ativada para o Servidor FTP, durante o tempo de execução, a
orquestração parará o processamento devido a esse erro. Um aviso é gerado e a data
Época (1/1/1970) é retornada no parâmetro de saída timestamp.
|