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

Formato do arquivo sinônimo

O recurso Mapear Automaticamente permite criar mapeamentos entre entradas e saídas específicas colocando os nomes das entradas e saídas em um arquivo chamado arquivo sinônimo.

Sinônimos, no contexto do arquivo de sinônimo, são grupos de palavras que representam mapeamentos que você deseja criar.

Tipo de Arquivo

Um arquivo sinônimo pode residir em qualquer lugar no sistema do arquivo, apenas se a codificação utilizada no arquivo sinônimo for a mesma do que a utilizada pelo sistema Eclipse Toolkit.

No entanto, se o arquivo sinônimo utilizar uma codificação específica que seja, ou possa ser, diferente da codificação do Eclipse Toolkit, o arquivo deverá residir em um projeto no WebSphere® Message Broker Toolkit.

Caso o arquivo sinônimo seja criado fora do WebSphere Message Broker Toolkit e use uma codificação específica, salve o arquivo sob um WebSphere Message Broker Toolkit projeto e clique em Atualizar para tornar o arquivo visível no navegador.

O arquivo sinônimo utiliza apenas arquivos separados por tabulação ou separados por vírgula. Se você tiver gravado seu requisito de mapeamento em qualquer aplicativo externo, por exemplo, Microsoft Word ou Microsoft Excel, será necessário exportar os dados relevantes para um formato que o arquivo sinônimo suporta.

Nomes do item no arquivo

Um arquivo sinônimo contém os nomes dos itens a serem mapeados, sem o caminho para o item ou o namespace do item.

Por exemplo, se desejar mapear partNum para partNumber no XML a seguir, deve colocar partNum no arquivo sinônimo, não item/partNum, items/item/partNum nem purchaseOrder/items/item/partNum.
<po:purchaseOrder xmlns:po="http://www.ibm.com">
 <items> 
    <item>
         <partnum>100-abc</partnum>
         <productName>Acme Integrator</productName>
         <quantity>22</quantity>
         <USPrice>100.99</USPrice>
         <po:comment>Acme Integrator</po:comment>
         <shipDate>2008-12-01</shipDate>
    </item>
 </items> 
</po:purchaseOrder> 
Os sinônimos no arquivo podem:
  • Fazer distinção entre maiúsculas e minúsculas ou não
  • Conter o nome do item de mapeamento inteiro
  • Ter caracteres não alfanuméricos removidos

Linhas no arquivo sinônimo

No arquivo sinônimo cada linha representa um grupo de nomes que devem ser mapeados uns entre os outros e cada linha deve conter ao menos dois nomes. Nomes dentro de uma linha são separados por vírgulas em arquivos .csv e por caracteres de tabulação em arquivos .txt.

Um arquivo sinônimo pode conter uma linha especial opcional na parte superior. Esta linha da parte superior contém palavras-chave Entrada, Saída ou Entrada_Saída, separadas pelo mesmo delimitador usado no restante do arquivo. A linha da parte superior é usada para indicar se os sinônimos devem ser usados para corresponder nomes ao mapear a entrada ou a saída:
  • Se a primeira palavra na linha da parte superior for Saída, apenas o primeiro nome de cada linha subsequente será procurado na saída de mapeamento para correspondência de nomes.
  • Se a segunda palavra na linha da parte superior for Entrada, apenas o segundo nome de cada linha subsequente será procurado na entrada de mapeamento para correspondência de nomes.
  • Se a terceira palavra na linha da parte superior for Entrada_Saída, apenas o terceiro nome de cada linha subsequente será procurado, tanto na entrada quanto na saída de mapeamento para correspondência de nomes.
A linha da parte superior não pode conter menos palavras-chave do que o número máximo de nomes em qualquer linha do arquivo.

Se a linha da parte superior contiver qualquer palavra que não seja Entrada, Saída ou Entrada_Saída, a linha da parte superior será ignorada e haverá a suposição de que está ausente. Se você omitir a linha da parte superior opcional, todos os nomes do arquivo sinônimo serão considerados como Entrada_Saída, ou seja, qualquer nome localizado na entrada ou saída do mapeamento será correspondente.

Se um arquivo sinônimo contiver duas linhas:

carro               automóvel
automóvel        veículo

carro e veículo não são considerados como sendo sinônimos.

Para que as três palavras sejam sinônimas, seu arquivo sinônimo pode ter umas das seguintes estruturas:
  • Uma linha com as três palavras -
    carro          automóvel          veículo
  • Três linhas -
    carro          automóvel
    automóvel    veículo
    carro        veículo

Caracteres Especiais

É possível gravar arquivos de sinônimo manualmente ou exportá-los a partir de outro aplicativo; por exemplo, Microsoft Excel. Os nomes de itens nos arquivos de sinônimo refletem o domínio de aplicativo e não precisam corresponder exatamente aos nomes no esquema XML ou na coluna de banco de dados relacional.

Por exemplo, um arquivo sinônimo pode conter a linha:
         summer	      l'été
Como l'été não está em conformidade com o formato XML NCName, você poderia nomear o elemento l_été. Se todos os caracteres alfanuméricos no arquivo sinônimo corresponderem aos do esquema, é possível usar o arquivo com a opção Apenas letras e dígitos, ignorar caracteres não alfanuméricos.

Muitos requisitos do mapeamento são gravados no Microsoft Excel, e as células em um arquivo do Microsoft Excel podem conter caracteres específicos como aspas duplas, espaço, nova linha, vírgula e assim por diante. Quando um arquivo Microsoft Excel desse tipo é salvo como um arquivo separado por tabulação ou separado por vírgula, ele contém aspas duplas adicionais.

Dois grupos de sinônimos em um arquivo sinônimo são delimitados por um caractere LF (Line Feed), ou por LFCR (Line Feed seguido de um Carriage Return). Um caractere CR (Carriage Return) por si só não finaliza um grupo de sinônimos.

Caracteres de espaço Leading e Trailing adjacentes ao delimitador (caractere de vírgula ou de tabulação) serão ignorados. Linhas em branco, ou linhas que contêm somente caracteres de espaço, são permitidas e ignorada em um arquivo de sinônimo.

Diferentes editores podem injetar diferentes caracteres de espaço em um arquivo de sinônimo; espaços não são usados para delimitar sinônimos e espaços são ignorados, a menos que eles estejam dentro de aspas duplas.

Se o sinônimo contiver uma vírgula, aspas duplas, um retorno de carro ou espaço leading ou trailing significativos, o sinônimo deve ser colocado entre aspas duplas. As aspas duplas dentro de um sinônimo são escapadas com outras aspas duplas. Exemplo:
       "comma,separated"
       "double""quote"
         "with<CR>
          newline"
         "  spaces   "
Quando o arquivo de sinônimo estiver pronto pelo editor de Mapeamento de Dados Gráficos, as aspas duplas no início e final do sinônimo serão removidas e os seguintes dados serão armazenados na tabela de sinônimos:
       comma,separated
       double"quote
         with<CR>newline
           spaces

O editor de Mapeamento de Dados Gráficos lê um arquivo de sinônimo que contém esses caracteres especiais corretamente e você deve selecionar a opção Letras e Dígitos Apenas, Ignorar Caracteres Não Alfanuméricos ao usar o arquivo de sinônimo.

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:31:53


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | cm28808_