WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Padrões de Nomes de Arquivos

É possível especificar um padrão de nome do arquivo, usando caracteres curinga, para identificar um arquivo a ser lido pelo nós FileInput, CDInput e FTEInput. Também é possível especificar um padrão de nome de arquivo, utilizando um caractere curinga, para nomear o arquivo a ser criado pelos nós FileOutput e FTEOutput.

Usando Padrões de Nome do Arquivo com os Nós FileInput, CDInput e FTEInput

Os nós de entrada leem arquivos de um diretório especificado e propaga mensagens com base no conteúdo desses arquivos. Apenas arquivos com nomes que correspondem a um padrão (o padrão de entrada), conforme especificado na propriedade Nome do arquivo ou padrão do nó FileInput ou na propriedade Filtro do nome do arquivo do nó FTEInput, são lidos.

Se você estiver usando padrões de nome de arquivo para excluir arquivos do nó FileInput, arquivos com nomes que correspondam ao padrão de exclusão, conforme especificado em Padrão de exclusão do arquivo do nó FileInput não serão lidos ou processados.

A correspondência pode ser com um nome do arquivo ou uma seqüência de caracteres (um padrão). Um padrão é uma seqüência que contém pelo menos um dos seguintes caracteres curinga:
Caractere curinga Descrição Exemplo:
* Qualquer seqüência de zero ou mais caracteres *.xml atende a todos os nomes de arquivo com uma extensão xml
? Qualquer caractere único f??????.csv corresponde a todos os nomes de arquivos que consistem na letra f seguida pelos seis caracteres, em seguida, a sequência .csv.
O padrão é *, que corresponde a todos os nomes de arquivos.

Não é possível especificar nomes de arquivos que contêm os seguintes caracteres: o asterisco ('*'), o ponto de interrogação ('?')ou caracteres separadores de nome do arquivo ('/' e '\').

Por Exemplo:
  • Se você quiser que o nó FileInput processe todos os arquivos que tenham uma determinada extensão, como xml, configure sua propriedade Nome do arquivo ou padrão como *.xml e o nó processará todos os arquivos no diretório (e subdiretórios, se selecionados) que possuam essa extensão.
  • Se você quiser que o nó FileInput exclua todos os arquivos com uma determinada extensão do processamento, como .csv, configure sua propriedade Padrão de exclusão do arquivo como *.csv e o nó não processará nenhum dos arquivos com essa extensão no diretório (e subdiretórios, se selecionados).

Se você implementar o fluxo para um servidor Windows, os nomes dos arquivos correspondem ao padrão, independentemente do caso. Entretanto, se você implementar o fluxo para um servidor Linux, UNIX ou z/OS, os nomes de arquivos deverão corresponder à cadeia de caracteres padrão e suas letras maiúsculas e minúsculas.

Correspondência de Padrão

Os nós FileInput, CDInput e FTEInput configuram o elemento LocalEnvironment.Wildcard.WildcardMatch para a sequência correspondida por caracteres curinga no nome do arquivo. O elemento LocalEnvironment.Wildcard.WildcardMatch não é afetado pelos padrões de exclusão do arquivo. A seguir há alguns exemplos de correspondência de padrão com o valor nesse elemento, em que o valor na propriedade Nome do arquivo ou padrão do nó FileInput é File????.from*.xml:
  • Se o nó FileInput localizar um arquivo com o nome de arquivo File1234.fromHQ.xml, há uma correspondência. O valor no elemento LocalEnvironment.Wildcard.WildcardMatch é configurado para 1234.fromHQ e o nó processa o arquivo.
  • Se o nome do arquivo for File123.fromHQ.xml, não há correspondência, pois há caracteres insuficientes entre os elementos File e .from do nome do arquivo. O nó FileInput ignora esse arquivo.
  • Se o nome do arquivo for File2345.from.xml, há uma correspondência. O valor no elemento LocalEnvironment.Wildcard.WildcardMatch está configurado para 2345.from e o nó processa o arquivo. Neste exemplo, * na cadeia de caracteres na propriedade Nome ou Padrão do Arquivo corresponde a uma cadeia de zero caracteres. Se você precisar que a cadeia de caracteres entre os elementos from e .xml do nome do arquivo sempre tenha pelo menos um caractere, especifique a propriedade Nome ou Padrão do Arquivo com um valor igual a File????.from?*.xml.

Usando Padrões de Nome do Arquivo com os Nós FileOutput, CDOutput e FTEOutput

O nó grava mensagens em arquivos que ele cria ou substitui no sistema de arquivos do broker. Somente padrões que contêm um único caractere curinga (o asterisco, '*') são permitidos nessa propriedade. O nome do arquivo a ser usado é determinado da seguinte maneira:
  • Se a propriedade de nome do arquivo não contiver curingas, o valor dessa propriedade será o nome do arquivo criado. Este valor deve ser um nome do arquivo válido no sistema de arquivos que hospeda o broker no qual o fluxo de mensagens está implementado.
  • Se a propriedade de nome do arquivo contiver um único curinga, o valor do elemento LocalEnvironment.Wildcard.WildcardMatch na mensagem atual substituirá o caractere curinga, e o valor resultante será o nome do arquivo criado. Este valor deve ser um nome do arquivo válido no sistema de arquivos que hospeda o broker no qual o fluxo de mensagens está implementado. Se o valor WildcardMatch não for encontrado, o caractere curinga será substituído pela cadeia vazia.
Não é possível especificar nomes de arquivos que contêm os seguintes caracteres: o asterisco ('*'), o ponto de interrogação ('?'), caracteres separadores de nomes de arquivos ('/' e ' \'). O nome do arquivo pode ser substituído pelos valores na mensagem atual.

Se a propriedade Nome do arquivo ou padrão no nó FileOutput estiver vazia, o nome deve ser substituído pela mensagem atual. A substituição do curinga ocorre somente se essa propriedade não for substituída dessa forma.

Os nomes de arquivos são transmitidos ao sistema de arquivos ao qual o broker tem acesso e precisam respeitar as convenções destes sistemas de arquivos. Por exemplo, os nomes de arquivos nos sistemas Windows não fazem distinção de maiúsculas e minúsculas; nos sistemas UNIX, os nomes de arquivos que diferem entre letras maiúsculas e minúsculas são considerados diferentes.

Exemplo: Se o nó FileInput tiver *.out na propriedade Nome do arquivo ou padrão e o arquivo recebido for myfile, o nome do arquivo recebido será myfile.out.

Considerações sobre FTP e SFTP

É possível usar o nó FileInput para transferir arquivos de um servidor FTP ou SFTP remoto e processá-los. Somente os arquivos com nomes que correspondem ao padrão de nome do arquivo especificado no nó são lidos. Também é possível usar um padrão de exclusão de arquivo para evitar que os arquivos sejam lidos em um servidor FTP ou SFTP remoto. Se seu broker estiver em um sistema operacional que respeita a distinção entre maiúsculas e minúsculas (tal como o UNIX), será possível especificar um padrão que inclua uma combinação de caracteres maiúsculos e minúsculos. Se você, então, usar este padrão para processar arquivos que estão em um diretório em um servidor FTP ou SFTP remoto, e este servidor estiver em execução em um sistema operacional que não respeita a distinção entre letras maiúsculas e minúsculas (como o Windows), a correspondência de nome do arquivo poderá falhar resultando em nenhum arquivo sendo processado. Esta falha ocorre porque os nomes de arquivos no servidor remoto não são compostos por letras maiúsculas e minúsculas. Se seu broker estiver em um sistema operacional que não respeita a distinção entre maiúsculas e minúsculas, qualquer padrão especificado poderá ser correspondido por mais de um arquivo em um servidor FTP ou SFTP remoto que está em execução em um sistema operacional no qual a distinção entre maiúsculas e minúsculas é importante. Cada um desses arquivos é, então, processado seqüencialmente.

Você pode usar o nó FileOutput para gravar arquivos em um servidor FTP ou SFTP remoto. Somente arquivos com nomes que correspondem ao padrão especificado no nó são gravados. Se seu broker estiver em execução em um sistema operacional que respeita distinção entre maiúsculas e minúsculas (tal como o UNIX), será possível especificar um padrão que inclua uma combinação de caracteres maiúsculos e minúsculos. Entretanto, se você, então, usar este padrão para gravar arquivos em um diretório em um servidor FTP ou SFTP remoto em execução em um sistema operacional que não respeita distinção entre maiúsculas e minúsculas (tal como o Windows), o nome do arquivo será gravado em letras maiúsculas em vez de na maneira como ele foi especificado em seu padrão.

Se o nome de um arquivo em um servidor FTP remoto contiver um ou mais caracteres que não são válidos no sistema operacional no qual o broker no qual você especificou o padrão de nome de arquivo está em execução, o arquivo não será transferido do servidor FTP para processamento pelo nó FileInput.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:43


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ac55200_