Verwenden Sie den DataInsert-Knoten zur Interaktion mit einer Datenbank innerhalb der angegebenen ODBC-Datenquelle.
Dieses Kapitel enthält folgende Abschnitte:
Der DataInsert-Knoten ist eine spezialisierte Form des Database-Knotens, und die Interaktion ist auf das Einfügen einer oder mehrerer Zeilen in einer Tabelle der Datenbank beschränkt. Sie legen fest, was eingefügt wird, indem Sie Zuordnungsanweisungen definieren, die mithilfe der Daten aus der Eingabenachricht die erforderliche Aktion definieren.
Sie können eine Eigenschaft so konfigurieren, dass gesteuert wird, ob die Datenbank sofort oder erst nach Beendigung des Nachrichtenflusses aktualisiert wird, und zu welchem Zeitpunkt die Aktualisierung entsprechend dem Gesamtabschluss-Status des Nachrichtenflusses festgeschrieben oder zurückgesetzt wird.
Der DataInsert-Knoten befindet sich im Ablagefach Datenbank der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Stellen Sie sich vor, Ihr Unternehmen hat ein neues Produkt entwickelt. Die Produktdetails wurden von Ihrer Konstruktionsabteilung versendet, und Sie müssen Einzelangaben aus der Nachricht extrahieren und sie als neue Zeile in Ihre Bestandsdatenbank einfügen.
Wenn Sie eine Instanz des DataInsert-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Eigenschaften im Eigenschaftsdialogfeld mit der rechten Maustaste auf den Knoten und dann im Kontextmenü auf Eigenschaften. (Durch Doppelklicken auf einen DataInsert-Knoten wird das Dialogfenster Neue Nachrichtenzuordnung geöffnet.) Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.
In der folgenden Tabelle werden die Terminals des DataInsert-Knotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Fehlerterminal | Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Berechnung ein Fehler auftritt. Wenn Sie die Option Warnungen als Fehler behandeln ausgewählt haben, gibt der Knoten die Nachricht auch dann an dieses Terminal weiter, wenn die Verarbeitung erfolgreich beendet wird. |
Ausgabeterminal | Das Ausgabeterminal, das die Nachricht nach Ausführung der Datenbankanweisung ausgibt. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des DataInsert-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | DataInsert | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
In der folgenden Tabelle werden die grundlegenden Eigenschaften des DataInsert-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Datenquelle | Nein | Ja | Der Name der ODBC-Datenquelle für die Datenbank mit den Tabellen, auf die Sie
in den mit diesem Knoten verknüpften Zuordnungen verweisen (wie unter der Eigenschaft
Anweisung festgelegt).
Dieser Name gibt die entsprechende Datenbank auf dem System an, auf dem dieser Nachrichtenfluss ausgeführt werden soll. Der Broker stellt mit der Benutzer-ID und den Kennwortdaten, die Sie in den Befehlen mqsicreatebroker, mqsichangebroker oder mqsisetdbparms angegeben haben, eine Verbindung zu dieser Datenbank her.
|
|
Anweisung | Ja | Nein | DataInsert | Der Name der Zuordnungsroutine, die die Anweisungen enthält, die gegen die Datenbank oder Nachrichtenbaumstruktur ausgeführt werden sollen. Die Routine ist eindeutig und kann nur mit diesem Knotentyp verwendet werden. Standardmäßig ist der Name der Zuordnungsroutine
identisch mit dem Namen der Abgleichungsdatei, in der die Routine definiert ist. Der Standardname der Datei ist der Name des Nachrichtenflusses, der mit dem Knotennamen verknüpft wird, wenn Sie ihn in den Nachrichtenfluss einschließen (z. B. MFlow1_DataInsert.msgmap für den ersten DataInsert-Knoten im Nachrichtenfluss MFlow1). Sie können keinen Wert angeben, der Leerzeichen enthält. Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfenster mit allen verfügbaren Zuordnungsroutinen angezeigt, auf die dieser Knoten zugreifen kann. Wählen Sie die gewünschte Routine aus, und klicken Sie auf OK; der Name der Routine wird unter Anweisung angegeben. Um mit der Zuordnungsroutine, die mit diesem Knoten verknüpft ist, zu arbeiten, klicken Sie doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten, und wählen Sie im Kontextmenü Zuordnungen öffnen aus. Wenn die Zuordnungsroutine nicht existiert, wird sie für Sie mit dem Standardnamen in der Standarddatei erstellt. Wenn die Datei bereits existiert, können Sie die Datei Nachrichtenflussname_Knotenname.msgmap auch in der Brokerentwicklungsansicht öffnen. Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen DataInsert-Knoten entwickelte Zuordnungsroutine nicht mit einem anderen Knoten einsetzen, der Zuordnungen verwendet (z. B. einem DataDelete-Knoten). Wenn Sie eine Zuordnungsroutine erstellen, können Sie sie nicht aus einer anderen Zuordnungsroutine heraus aufrufen, obwohl sie aus einer ESQL-Routine heraus aufgerufen werden kann. Weitere Informationen zum Arbeiten mit Zuordnungsdateien und Definieren ihres Inhalts erhalten Sie unter Nachrichtenzuordnungen entwickeln. |
Transaktion | Ja | Nein | Automatisch | Der Transaktionsmodus für den Knoten. Folgende Werte stehen zur Verfügung:
|
Warnungen als Fehler behandeln | Ja | Nein | Nicht ausgewählt | Wenn Datenbankwarnungen als Fehler behandelt werden sollen und der Knoten die Ausgabenachricht
an das Fehlerterminal weitergeben soll, aktivieren Sie
Warnungen als Fehler behandeln. Das
Kontrollkästchen ist standardmäßig inaktiviert. Wenn Sie es aktivieren, behandelt der Knoten alle positiven Rückkehrcodes von der Datenbank als Fehler und generiert Ausnahmebedingungen auf dieselbe Art wie bei negativen oder schwer wiegenden Fehlern. Wenn Sie das Kontrollkästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und löst keine Ausnahmebedingungen aus. Die höchstwertige Warnung, die ausgegeben werden kann, lautet nicht gefunden. Sie kann in den meisten Fällen als normaler Rückkehrcode sicher bearbeitet werden. |
Ausnahmebedingung für Datenbankfehler ausgeben | Ja | Nein | Ausgewählt | Wenn der Broker bei Erkennung eines Datenbankfehlers eine Ausnahmebedingung generieren soll,
aktivieren Sie Ausnahme für Datenbankfehler
ausgeben. Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie das Kontrollkästchen inaktivieren, müssen Sie ihn im Nachrichtenfluss bearbeiten, um die Integrität des Brokers und der Datenbank zu gewährleisten. Wenn Sie den Fehler nicht über einen eigenen Prozess bearbeiten, wird er ignoriert, da Sie sich gegen den Aufruf der Standardfehlerbehandlung durch den Broker entschieden haben. Sie könnten beispielsweise das Fehlerterminal mit einer Fehlerbehandlungs-Subroutine verbinden. |