Wenn Sie eine Nachrichtenzuordnung aus einer früheren Version von
IBM® Integration Bus in eine
grafische Datenzuordnung konvertieren, müssen Sie gegebenenfalls
zusätzliche Tasks ausführen, bevor Sie Ihre
grafische Datenzuordnung in einer Messaging-Lösung verwenden können.
Bei der Vorbereitung einer Nachrichtenzuordnung für die Konvertierung in eine grafische Datenzuordnung müssen folgende Punkte berücksichtigt werden:
- Die grafische Datenzuordnung wird auf der Java™ Virtual Machine auf dem Broker ausgeführt. Stellen Sie sicher, dass der Broker richtig konfiguriert ist (siehe Größe des JVM-Heapspeichers festlegen).
- Datenbanktransformationen in einer grafische Datenzuordnung nutzen die in IBM Integration Bus integrierte Unterstützung für JDBC-Verbindungen.
Für die Konvertierung der in Nachrichtenzuordnungen enthaltenen relationalen Datenbankoperationen in Transformationen grafischer Datenzuordnungen sind im Editor für grafische Datenzuordnungen weitere Aktionen erforderlich. Der Abschnitt Datenbankinhalt zuordnen enthält weitere Informationen hierzu.
- Grafische Datenzuordnungen können nur als Quelle implementiert werden. So implementieren Sie eine grafische Datenzuordnung:
- Stellen Sie ein Nachrichtenmodellschema für Ihre Ein- und Ausgabenachrichten bereit.
Für XML-Nachrichten muss eine XML-Schemadatei bereitgestellt werden. Für Text- bzw. binäre Nachrichten kann das Modell in einer DFDL-Schemadatei oder in einer Nachrichtengruppe bereitgestellt werden.
- Wenn Ihre Nachricht in einer Nachrichtengruppe modelliert wird, erfordert die
grafische Datenzuordnung, dass das Nachrichtengruppenschema
(.xsdzip-Datei) zur Ausführung der grafischen Datenzuordnung implementiert
wird. Wird die bestehende Nachrichtengruppe nur für Text- und Binärformate verwendet, können Sie
Ihre grafische Datenzuordnung nur mit einer
.dictionary-Datei im Brokerarchiv (BAR) implementieren. In diesem Fall müssen
Sie die Nachrichtengruppe ändern, indem Sie zusätzlich die XMLNSC-Domänenunterstützungsoption
setzen, damit sie sowohl mit einer .dictionary-Datei als auch mit einer
.xsdzip-Datei zu einem BAR hinzugefügt wird. Wird diese Option nicht gesetzt,
wird in der Ansicht Probleme eine Warnung zusammen mit einer
Schnellkorrekturaktion angezeigt.
- Wenn eine konvertierte Nachrichtenzuordnung Aufrufe an benutzer-bereitgestellte ESQL-Prozeduren enthält, werden diese in Custom ESQL-Transformationen konvertiert. Grafische Datenzuordnungen können ESQL-Prozeduren nur aufrufen, wenn bestimmte Voraussetzungen erfüllt sind.
Der Abschnitt Custom ESQL (Angepasstes ESQL) enthält weitere Informationen hierzu. Folgende Aspekte müssen berücksichtigt werden:
- Die ESQL-Module müssen als Quelle implementiert sein. Weitere Informationen hierzu finden Sie unter Dateien zu einem Brokerarchiv hinzufügen.
- Wenn Sie nicht die Anwendungs- und Bibliotheksfunktionen von
IBM Integration Bus verwenden, müssen die ESQL-Prozeduren eindeutige Namen
haben, da sie auf dem Integrationsserver implementiert werden.
- Aufrufe von ESQL-Prozeduren mit dem Datentyp ESQL REFERENCE werden in der konvertierten
grafische Datenzuordnung durch Task-Transformationen ersetzt. Diese
Task-Transformationen müssen Sie durch eine Custom XPath-, Custom
Java- oder Custom ESQL-Transformation mit entsprechender
Funktion ersetzen.
- Wenn eine konvertierte Nachrichtenzuordnung Aufrufe an vordefinierte
Nachrichtenzuordnungsfunktionen (msgmap:) enthält, werden diese in XPath- oder Custom
XPath-Transformationen konvertiert. Die eingesetzten Transformationen müssen überprüft werden, um
sicherzustellen, dass sie das erforderliche Verhalten nachbilden. Gibt es zu einer
Nachrichtenzuordnungsfunktion keine XPath-Entsprechung, so wird diese in der
grafische Datenzuordnung durch eine Task-Transformation
ersetzt. Diese Task-Transformationen müssen Sie durch eine Custom XPath-, Custom
Java- oder Custom ESQL-Transformation ersetzen, die das
gewünschte Verhalten nachbildet. Zu folgenden Nachrichtenzuordnungsfunktionen gibt es keine XPath-Entsprechung:
- msgmap:element-from-bitstream
- msgmap:cdata-element
- msgmap:db-path
- Sie können eine Cast-Transformation und XML Schema-Funktionen in Custom XPath-Transformationen
verwenden, um eine Wertetypumwandlung durchzuführen. Sie finden weitere Informationen hierzu in den Abschnitten Umsetzung und ESQL-Typen und Schematypen.
- Wenn Sie eine Nachrichtenzuordnung für eine Transformation konvertieren, die die Handhabung von
fehlenden, leeren oder auf null gesetzten Elementen einschließt, finden Sie weitere Informationen
im Abschnitt Nullwerte handhaben. Für die Implementierung solcher Transformationen
werden folgende XPath-Funktionen bereitgestellt:
- fn:empty testet, ob ein Element einen leeren Wert enthält.
- fn:nilled testet, ob für ein XML-Element das Attribut xsi:nil gesetzt ist.
- fn:exists testet, ob ein Element vorhanden ist. Ein XML-Element, für das das Attribut xsi:nil
gesetzt ist, wird als vorhanden betrachtet.
- Wenn eine konvertierte Nachrichtenzuordnung Aufrufe an vordefinierte ESQL-Zuordnungsfunktionen (esql:) enthält, werden diese in XPath- oder Custom XPath-Transformationen konvertiert. Die eingesetzten Transformationen müssen überprüft werden, um sicherzustellen, dass sie das erforderliche Verhalten nachbilden. Gibt es zu einer ESQL-Zuordnungsfunktion keine XPath-Entsprechung, so wird diese in der grafische Datenzuordnung durch eine Task-Transformation ersetzt.
Diese Task-Transformationen müssen Sie durch eine Custom XPath-, Custom
Java- oder Custom ESQL-Transformation ersetzen, die das
gewünschte Verhalten nachbildet. Zu folgenden ESQL-Zuordnungsfunktionen gibt es keine XPath-Entsprechung:
- Folgende mathematische Funktionen:
- ACOS
- ASIN
- ATAN
- ATAN2
- BITAND
- BITNOT
- BITOR
- BITXOR
- COS
- COSH
- COT
- DEGREES
- EXP
- LN
- LOG
- LOG10
- MOD
- POWER
- RADIANS
- RAND
- SIGN
- SIN
- SINH
- SQRT
- TAN
- TANH
- Dezimalfunktionen:
- Folgende Zeichenfolgefunktionen:
- LTRIM
- RTRIM
- TRIM-LEADING
- TRIM-TRAILING
- REPLICATE
- SPACE
- Folgende Feldfunktionen:
- ABITSTREAM
- BITSTREAM
- SAMEFIELD
- Folgende Datum-/Zeitfunktionen:
- TIMESTAMP
- CURRENT-GMTDATE
- CURRENT-GMTTIME
- CURRENT-GMTTIMESTAMP
- Alle INTERVAL-Funktionen
- Die ESQL-Funktion LIKE
- Die Form ESQL FOLLOWING der ESQL-Funktion POSITION
- Alle SQL-Funktionen
- Die Funktionen UUIDASCHAR und UUIDASBLOB