Formato do arquivo sinônimo

Mapear por Nome permite criar mapeamentos entre origens e destinos específicos colocando os nomes das origens e dos destinos em um arquivo denominado 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.

Se o arquivo de sinônimo for criado fora do WebSphere Message Broker Toolkit, e usar uma codificação específica, salve o arquivo em um projeto do WebSphere Message Broker Toolkit 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 Origem, Destino, ou Origem_Destino, separadas pelo mesmo delimitador utilizado no restante do arquivo. A linha da parte superior é utilizada para indicar se os sinônimos devem ser utilizados para nomes correspondentes ao mapear a origem ou o destino:
  • Se a primeira palavra na linha da parte superior for Destino, apenas o primeiro nome em cada linha subseqüente será procurado no destino de mapeamento para correspondência de nomes.
  • Se a segunda palavra na linha da parte superior for Origem, apenas o segundo nome em cada linha subseqüente será procurado na origem de mapeamento para correspondência de nomes.
  • Se a terceira palavra na linha da parte superior for Origem_Destino, apenas o terceiro nome em cada linha subseqüente será procurado, tanto na origem quanto no destino 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 Origem, Destino, ou Origem_Destino, a linha da parte de cima será ignorada e haverá a suposição de que a linha da parte de cima está faltando. Se você omitir a linha da parte de cima opcional, cada nome no arquivo sinônimo será considerado como Origem_Destino; ou seja, qualquer nome localizado na origem do mapeamento ou no destino 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 fazer com que as três palavras sejam sinônimos, seu arquivo sinônimo pode ter:
  • Uma linha com as três palavras -
    carro automóvel veículo
    ou
  • 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é. Desde que todos os caracteres alfanuméricos no arquivo sinônimo correspondam aos do esquema, é possível utilizar o arquivo com a opção Apenas Letras e Dígitos, ignorando os caracteres que não sejam 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 sinônimo estiver pronto peloe WebSphere Message Broker Toolkit, as aspas duplas no início e no final do sinônimo são removidas e o WebSphere Message Broker Toolkit armazena o seguinte na tabela de sinônimo:
       comma,separated
       double"quote
         with<CR>newline
           spaces

O WebSphere Message Broker Toolkit lê um arquivo sinônimo contendo estes caracteres especiais corretamente e você deve selecionar a opção Apenas Letras e Dígitos, ignorar os caracteres que não forem alfanuméricos ao utilizar o arquivo sinônimo.

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

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:49:21


Tópico de ReferênciaTópico de Referência | Versão 7.0.0.5 | ar37513_