.NETCompute-Knoten

Mit dem .NETCompute-Knoten können Sie auf Brokern unter Windows Ausgabenachrichten erstellen und mit Microsoft .NET Framework (.NET)- oder Component Object Model (COM)-Anwendungen interagieren.

Dieses Thema enthält folgende Abschnitte:

Zweck

Die vom .NETCompute-Knoten erstellten Ausgabenachrichten werden durch Modifizierung der durch die Eingabenachricht bereitgestellten Daten oder aus Daten anderer Quellen, beispielsweise .NET- oder COM-Anwendungen, gebildet. Zur Erstellung der Ausgabenachricht können Elemente der Eingabenachricht (z. B. Header, Headerfelder und Nachrichtendaten) sowie deren Umgebung, lokale Umgebung und Ausnahmeliste verwendet werden.

Der .NETCompute-Knoten kann zur Erstellung oder Modifizierung der Nachricht jede Common Language Runtime (CLR)-konforme Sprache wie C#, Visual Basic (VB), F# und C++/CLI (Common Language Infrastructure) verwenden.

Der .NETCompute-Knoten kann folgende Tasks ausführen:

  • Nachrichten erstellen.
  • Mit .NET- oder COM-Anwendungen interagieren.
  • Nachrichten von einem Format in ein anderes umwandeln.
  • Nachrichten zwischen Parsern kopieren.
  • Eine eingehende Nachricht mit einer .NET-Programmiersprache prüfen und abhängig von ihrem Nachrichteninhalt unverändert an eines der Ausgabeterminals des .NETCompute-Knotens weitergeben. Der Knoten verhält sich ähnlich wie ein Filterknoten-Knoten, verwendet jedoch .NET-Programmiersprachen (anstelle von ESQL), um zu ermitteln, welches Ausgabeterminal verwendet werden soll.
  • Einen Teil einer eingehenden Nachricht mithilfe von .NET ändern und die geänderte Nachricht an eines der Ausgabeterminals weitergeben.
  • Eine Ausgabenachricht mithilfe von .NET erstellen und aufbauen, die unabhängig von der Eingabenachricht ist.

Der .NETCompute-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für den .NETCompute-Knoten

Der .NETCompute-Knoten kann nur auf Brokern unter Windows ausgeführt werden. Wenn Sie versuchen, einen Nachrichtenfluss mit einem .NETCompute-Knoten auf einem Broker auf einem Nicht-Windows-System zu implementieren, erhalten Sie einen Fehler. Stellen Sie vor der Implementierung eines Nachrichtenflusses mit diesem Knoten sicher, dass der Broker unter Windows ausgeführt wird.

Verwendung dieses Knotens in einem Nachrichtenfluss

Der .NETCompute-Knoten kann in jedem Nachrichtenfluss verwendet werden, der auf einem Broker unter Windows implementiert ist. Häufig findet der .NETCompute-Knoten in Szenarien Verwendung, in denen die zu erstellende Nachricht mit anderen .NET-Anwendungen interagieren muss, die Daten aus der Nachricht speichern oder zur Erweiterung der Nachricht Daten aus anderen Quellen abrufen.

Unabhängig von der Anzahl der am Nachrichtenfluss ausgeführten Threads (als Resultat weiterer Instanzen oder mehrerer Empfangsknoten) wird nur eine Instanz des jeweiligen .NETCompute-Knotens erstellt. Aus diesem Grund muss der gesamte .NET-Benutzercode threadsicher und simultan verwendbar sein. Wie Sie einen Knoten threadsicher machen und sicherstellen, dass die durch benutzerdefinierte Erweiterungen implementierten und gestarteten Funktionen simultan verwendbar sind, erfahren Sie in den Abschnitten Ausführungsmodell der benutzerdefinierten Erweiterungen und Hinweise zum Threading bei benutzerdefinierten Erweiterungen.

Der .NETCompute-Knoten muss in einer .NET-Assembly konfiguriert sein, die den Code des Knotens enthält. Der Code besteht aus einer Klasse, die von der abstrakten, in der IBM.Broker.Plugin.dll-Assembly bereitgestellten NBComputeNode-Klasse abgeleitet wird.

Vorhandene .NET-Assembly verwenden

Falls Sie über eine von einem Anbieter bereitgestellte Assembly verfügen, die Ihnen als kompilierte .dll-Datei vorliegt, können Sie die Assembly mit der Funktion Durchsuchen der Eigenschaft Assembly-Name des .NETCompute-Knotens auswählen. Wenn Ihnen keine Assembly vorliegt, müssen Sie eine Knoten-Assembly erstellen.

.NET-Assembly erstellen

Zur Erstellung einer .NET-Assembly, die diesen Knoten darstellt, kann der Broker mit Microsoft Visual Studio 2010 interagieren. Wenn Sie Visual Studio direkt von diesem Knoten starten möchten, muss Microsoft Visual Studio 2010 installiert sein. Sie brauchen dann nur doppelt auf den .NETCompute-Knoten zu klicken. Eine Alternative wäre, mit der rechten Maustaste auf den Knoten zu klicken und Microsoft Visual Studio öffnen auszuwählen. Wenn im Fenster von Visual Studio der Name eines Visual Studio-Projekts oder einer Visual Studio-Lösung angezeigt wird, wird das Projekt bzw. die Lösung beim Laden von Visual Studio automatisch geöffnet.

In Visual Studio können Sie durch Auswahl von Neues Projekt ein Message Broker-Rechenknoten-Projekt auswählen, das sich unter der Sprache Ihrer Wahl, zum Beispiel C# oder Visual Basic, befindet. Dieses Projekt startet eine Schablonenauswahl, in der Sie den grundlegenden Knotentyp (z. B. 'Erstellen', 'Filtern' oder 'Ändern') für den zum jeweiligen Typ passenden Basiscode auswählen können. Dieser Basiscode wird im Editor für die jeweilige .NET-Sprache (z. B. C#) angezeigt.

Die Klasse NBComputeNode enthält eine Methode, die überschrieben werden muss, sowie zwei optionale Zusatzmethoden, die Sie bei Bedarf überschreiben können. Die Methode Evaluate() wird automatisch von der Schablone Message Broker-Projekt implementiert, wenn die Schablone zur Generierung des Basiscodes verwendet wird. Diese Methode muss auf jeden Fall überschrieben werden. Bei den optionalen Methoden handelt es sich um die Methoden OnInitialize() und OnDelete(). Wenn der Knoten Initialisierungs- oder Bereinigungsoperationen durchführen soll, müssen Sie eine Implementierung der jeweiligen Methode(n) bereitstellen.

Die Methode OnDelete() wird vom Broker unmittelbar vor dem Löschen des Knotens aufgerufen. Die Methode OnInitialize() wird vom Broker bei der Erstellung des Knotens unmittelbar nach der Festlegung der Knotenattribute aufgerufen. Die Methode OnInitialize() wird bei der Implementierung, jedoch noch vor deren Festschreibung aufgerufen. Somit können nachgeordnete Knoten während der Initialisierung immer noch Ausnahmen auslösen, wodurch die Implementierung fehlschlagen würde. Aus diesem Grund muss der gesamte Benutzeranwendungscode, der vom implementierten Nachrichtenfluss abhängig ist, in der Methode Evaluate() enthalten sein.

.NETCompute-Knoten konfigurieren

Nachdem Sie eine Instanz des .NETCompute-Knotens in einen Nachrichtenfluss eingefügt haben, müssen Sie diese Instanz konfigurieren. Informationen hierzu finden Sie im Abschnitt Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

.NET-Code angeben

Das Verhalten des .NETCompute-Knotens können Sie mit Anweisungen anpassen, zu deren Vorlage Sie den Basiscode der Visual Studio Message Broker-Rechenknoten-Projekte verwenden können. Sie können den Knoten beispielsweise so anpassen, dass er eine oder mehrere Nachrichten auf Grundlage einer Eingabenachricht oder auf Grundlage der Daten einer externen Quelle erstellt. Ein mögliches Szenario wäre beispielsweise die Änderung eines Werts der Eingabenachricht durch Hinzufügen eines oder mehrerer Werte, die aus der .NET-Schnittstelle einer externen Anwendung abgerufen werden, und das Speichern des Ergebnisses in der Ausgabenachricht.

Zum Debuggen eines innerhalb der Ausführungsgruppe ausgeführten .NETCompute-Knotens müssen Sie die .pdb-Datei der Assembly, durch die der Knoten implementiert wird, in das gleiche Verzeichnis einfügen, in dem sich die Knoten-Assembly befindet. Außerdem müssen Sie Visual Studio an den Prozess DataFlowEngine.exe anhängen. Danach können Sie Ihrem Code Unterbrechungspunkte hinzufügen, an denen zum Beispiel Variablen überprüft werden.

Nachrichten prüfen

Durch die Festlegung der Auswertungseigenschaften können Sie festlegen, wie die vom .NETCompute-Knoten generierte Nachricht ausgewertet werden soll. Diese Eigenschaften führen nicht dazu, dass die Eingabenachricht ausgewertet wird. Falls diese Auswertung erforderlich ist, wird davon ausgegangen, dass die Auswertung bereits durch den Empfangsknoten oder einen vorhergehenden Auswertungsknoten ausgeführt wurde.

Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

Terminals und Eigenschaften

In der folgenden Tabelle werden die .NETCompute-Knotenterminals beschrieben .

Terminal Beschreibung
Eingang Das Eingangsterminal, das Daten einer fernen Quelle annimmt.
Fehler Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Berechnung eine unbearbeitete Ausnahmebedingung festgestellt wird.
Ausgang Das Ausgabeterminal, das Daten an einen nachgeordneten Knoten sendet.
Alternative Das Ausgabeterminal, das Daten an einen nachgeordneten Knoten sendet.

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 für die Implementierung zur BAR-Datei hinzugefügt wird).

In der folgenden Tabelle werden die Beschreibungseigenschaften des .NETCompute-Knotens beschrieben.

Eigenschaft M K Standard Beschreibung
Knotenname Nein Nein Knotentyp Name des Knotens
Kurzbeschreibung Nein Nein   Kurzbeschreibung 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 .NETCompute-Knotens beschrieben.

Eigenschaft M K Standard Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Assembly-Name Ja Ja   Die Assembly, die den Knoten implementiert. Die Assembly können Sie mit der Funktion Durchsuchen auswählen oder Sie können die .dll-Datei der Assembly auf den Knoten ziehen, um diese Eigenschaft auszufüllen. AssemblyName
Klassenname Nein Ja   Der Name der Klasse, die den Knoten implementiert. Für diese Eigenschaft ist nur dann ein Wert erforderlich, wenn von der gleichen Assembly zwei oder mehr Knoten bereitgestellt werden oder wenn als implementierender Knoten explizit eine Unterklasse angegeben werden soll. AssemblyNodeClassName

In der folgenden Tabelle werden die Visual Studio-Eigenschaften des .NETCompute-Knotens beschrieben.

Eigenschaft M K Standard Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Name des Visual Studio-Projekts Nein Nein   Das Visual Studio-Projekt bzw. die Visual Studio-Lösung, das bzw. die den Code für diesen Knoten enthält.  

In der folgenden Tabelle werden die erweiterten Eigenschaften des .NETCompute-Knotens beschrieben.

Eigenschaft M K Standard Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
AppDomain-Name Nein Ja   Die .NET-AppDomain, die diesen Knoten bereitstellt. AppDomain
Version Nein Ja   Die Version der Assembly. AssemblyVersion
Kultur Nein Ja   Die Kultur der Assembly. AssemblyCulture
Public Key-Token Nein Ja   Das Public Key-Token der Assembly. AssemblyPublicKeyToken

In der folgenden Tabelle werden die Auswertungseigenschaften des .NETCompute-Knotens beschrieben.

Eine vollständige Beschreibung zu diesen Eigenschaften erhalten Sie unter Auswertungseigenschaften.
Eigenschaft M K Standard Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswerten Nein Ja Ohne Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. validateMaster
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur festgelegt werden, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert setzen. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.  
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standard Beschreibung
Ereignisse Nein Nein None (Keinen) Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:55:51


ReferenzthemaReferenzthema | Version 8.0.0.0 | bc16270_