Mit der Funktion 'Automatisch zuordnen' können Zuordnungen zwischen bestimmten Ein- und Ausgaben erstellt werden, wobei die Namen der Ein- und Ausgaben in eine sogenannte Synonymdatei gestellt werden.
Synonyme in der Synonymdatei sind Gruppen von Wörtern, bei denen es sich um Zuordnungen handelt, die erstellt werden sollen.
Eine Synonymdatei kann überall im Dateisystem gespeichert sein, wenn die Codierung in der Synonymdatei mit der im Eclipse Toolkit-System verwendeten Codierung identisch ist.
Verwendet die Synonymdatei dagegen eine spezielle möglicherweise von der Eclipse Toolkit-Codierung abweichende Codierung, muss sie sich in einem Projekt im WebSphere Message Broker Toolkit befinden.
Wird die Synonymdatei außerhalb der WebSphere Message Broker Toolkit erstellt und wird für sie eine besondere Codierung verwendet, speichern Sie diese Datei unter einem WebSphere Message Broker Toolkit-Projekt und klicken Sie auf Aktualisieren, damit die Datei im Navigator angezeigt wird.
Für die Synonymdatei werden nur durch Tabulatoren oder Kommas getrennte Dateien verwendet. Wenn die Zuordnungsvoraussetzung in einer externen Anwendung wie z. B. Microsoft Word oder Microsoft Excel geschrieben wurde, müssen die betreffenden Daten in einem von der Synonymdatei unterstützten Format exportiert werden.
In einer Synonymdatei sind die Namen der zuzuordnenden Elemente enthalten, ohne Angabe des Pfades bzw. des Namespaces des Elements.
<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>
In der Synonymdatei steht jede Zeile für eine Gruppe zuzuordnender Namen. Jede Zeile muss mindestens zwei Namen enthalten. Innerhalb einer Zeile sind die Namen bei .csv-Dateien durch Kommas und bei .txt-Dateien durch Tabulatorzeichen getrennt.
Wenn die oberste Reihe ein anderes Wort als Input, Output oder Input_Output enthält, wird sie ignoriert und es wird so vorgegangen, als ob sie nicht vorhanden wäre. Wird die optionale oberste Reihe weggelassen, so wird jeder Name in der Synonymdatei als Input_Output angesehen, es wird also jeder Name abgeglichen, der in der Zuordnungseingabe oder in der Zuordnungsausgabe gefunden wird.
Bei einer Synonymdatei mit zwei Zeilen:
Wagen Auto
Auto Fahrzeug
werden Wagen und Fahrzeug nicht als Synonyme angesehen.
Wagen Auto Fahrzeug
Wagen Auto
Auto Fahrzeug
Wagen Fahrzeug
Synonymdateien können manuell geschrieben oder aus einer anderen Anwendung wie z. B. Microsoft Excel exportiert werden. Elementnamen in Synonymdateien spiegeln die Anwendungsdomäne wider und müssen nicht exakt mit den Namen im XML-Schema oder der Spalte für die relationale Datenbank übereinstimmen.
Sommer l'été
Da l'été nicht dem XML-Format 'NCName' entspricht, kann das Element l_été genannt werden.
Wenn alle alphanumerischen Zeichen in der Synonymdatei und dem Schema identisch sind, kann die Datei mit der Option
Alphanumerische Zeichen (nur Buchstaben und Ziffern) verwendet werden.Viele Zuordnungsanforderungen sind in Microsoft Excel geschrieben. Zellen in einer Microsoft Excel-Datei können unter Umständen Sonderzeichen wie Anführungszeichen, Leerzeichen, Zeichen für Zeilenwechsel, Kommas etc. enthalten. Wenn eine solche Microsoft Excel-Datei als eine durch Tabulatoren oder Kommas getrennte Datei gespeichert wird, enthält sie zusätzliche Anführungszeichen.
In einer Synonymdatei werden zwei Gruppen von Synonymen entweder nur durch ein Zeilenvorschubzeichen oder durch ein Zeilenvorschubzeichen mit anschließendem Rücklaufzeichen begrenzt. Nur mit einem Rücklaufzeichen wird eine Synonymgruppe nicht beendet.
Dem Begrenzer (Komma oder Tabulatorzeichen) voran- und nachgestellte Leerzeichen werden ignoriert. Leere Zeilen bzw. Zeilen, die nur Leerzeichen enthalten, sind in einer Synonymdatei zulässig, werden jedoch ignoriert.
Es kann sein, dass von den verschiedenen Editoren unterschiedliche Leerzeichen in eine Synonymdatei eingefügt werden. Leerzeichen dienen nicht zur Begrenzung von Synonymen und werden ignoriert, sofern sie nicht in Anführungszeichen stehen.
"comma,separated"
"double""quote"
"with<CR>
newline"
" spaces "
comma,separated
double"quote
with<CR>newline
spaces
Synonymdateien mit diesen Sonderzeichen werden vom Editor für grafische Datenzuordnungen korrekt gelesen. Bei Verwendung der Synonymdatei sollten Sie die Option Alphanumerische Zeichen (nur Buchstaben und Ziffern) auswählen.