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.
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.
Um arquivo sinônimo contém os nomes dos itens a serem mapeados, sem o caminho para o item ou o namespace do item.
<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>
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.
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.
| carro | automóvel |
| automóvel | veículo |
| carro | automóvel | veículo |
| carro | automóvel |
| automóvel | veículo |
| carro | veículo |
É 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.
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.
"comma,separated"
"double""quote"
"with<CR>
newline"
" spaces "
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.