Mit dem .NETInput-Knoten können Sie Daten aus vielen unterschiedlichen Quellen abrufen, z. B. MSMQ, Dateien oder Datenbanken, indem Sie über den .NET-Code auf die Daten zugreifen.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Aus welcher Quelle der .NETInput-Knoten Daten abrufen soll, wird von dessen Ersteller angegeben, der den Nachrichtenfluss startet. Die vom .NETInput-Knoten erstellten Ausgabenachrichten werden durch Interpretation der Informationen gebildet, die aus der Datenquelle abgerufen werden, z. B. aus .NET- oder COM-Anwendungen.
Zum Erstellen der Nachricht kann der .NETInput-Knoten jede CLR-konforme (Common Language Runtime) Sprache wie C#, Visual Basic (VB), F# und C++/CLI (Common Language Infrastructure) verwenden.
Der Nachrichtenfluss-Entwickler kann mithilfe des .NET-Codes flexibel bestimmen, aus welcher Quelle der .NETInput-Knoten Daten abrufen soll. Beispielsweise können mithilfe von .NET-Code Nachrichten aus einer MSMQ-Quelle, einer WebSphere® MQ-Warteschlange, dem Dateisystem oder einer Datenbank gelesen werden. Für das Erstellen von Code für einen .NETInput-Knoten werden in Microsoft Visual Studio zwei Vorlagen bereitgestellt.
Der .NETInput-Knoten-Knoten befindet sich im Ablagefach
.NET der Palette und wird im IBM® Integration Toolkit durch folgendes Symbol dargestellt: 
Der .NETInput-Knoten-Knoten kann nur auf Brokern unter Windows ausgeführt werden. Wenn Sie versuchen, einen Nachrichtenfluss mit einem .NETInput-Knoten auf einem Broker auf einem Nicht-Windows-System zu implementieren, wird ein Fehler ausgelöst. Stellen Sie vor der Implementierung eines Nachrichtenflusses mit diesem Knoten sicher, dass der Broker unter Windows ausgeführt wird.
Für das Erstellen von Code für einen .NETInput-Knoten werden in Microsoft Visual Studio zwei Vorlagen bereitgestellt. Diese zwei Vorlagen sind für zwei unterschiedliche Interaktionsstile vorgesehen:
Der .NETInput-Knoten muss einer .NET-Assembly zugeordnet werden, die den Code zur Steuerung der Interaktion zwischen dem .NETInput-Knoten und der Quelle für die Daten oder Nachrichten enthält, die durch den Nachrichtenfluss weitergegeben werden.
Der Abschnitt Code für einen .NETInput-Knoten schreiben enthält weitere Informationen hierzu.
Um das Verhalten des .NETInput-Knotens anzupassen können Sie mithilfe der für Microsoft Visual Studio bereitgestellten Vorlagencodeentwürfe entsprechenden Code erstellen. Der .NETInput-Knoten-Knoten muss in einer .NET-Assembly konfiguriert sein, die den Code des Knotens enthält. Der Code besteht aus einer Klasse, die sich aus einer der in der Assembly IBM.Broker.Plugin.dll bereitgestellten, abstrakten Basisklassen (NBPollingConnector oder NBEventConnector) ableitet.
Unabhängig von der Anzahl der im Nachrichtenfluss ausgeführten Threads (als Resultat zusätzlicher Instanzen oder mehrerer Empfangsknoten) wird nur eine Instanz des .NETInput-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 für den .NET-Empfangsknoten geschriebene Code nimmt nicht an Transaktionen des Integration Bus teil.
Weitere Informationen zum Erstellen von .NET-Code für einen .NETCompute-Knoten finden Sie in der .NET-API-Dokumentation. Diese ist Teil Ihrer IBM Integration Bus-Installation und kann unter Windows über das Startmenü aufgerufen werden.
Wenn Sie eine Instanz des .NETInput-Knotens in einen Nachrichtenfluss einfügen, müssen Sie ihn konfigurieren. Informationen hierzu finden Sie im Abschnitt Nachrichtenflussknoten konfigurieren. Zum Konfigurieren des Knotens können Sie eine Assembly-Datei aus einem Dateiexplorer auf den Knoten ziehen oder auf die Schaltfläche Durchsuchen klicken. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.
Sie können die Parameter und Attribute reproduzieren, die Sie für einen .NETInput-Knoten angepasst haben, indem Sie einen Klon des Knotens erstellen. Der geklonte Knoten hat keine besonderen, eigenen Eigenschaften und kann nicht über das Ablagefach der Palette erstellt werden. Er kann nur aus einem vorhandenen, bereits konfigurierten .NETInput-Knoten erstellt werden.
Wenn Sie den .NETInput-Knoten klonen möchten, wählen Sie ihn aus, klicken Sie mit der rechten Maustaste darauf und wählen Sie dann Create Cloned Node... (Geklonten Knoten erstellen) aus.
Der geklonte Knoten wird im Ablagefach .NET der Palette mit dem von Ihnen gewählten Namen gespeichert und im IBM Integration Toolkit mit dem von Ihnen gewählten Symbol dargestellt.
Wenn Sie eine Instanz des geklonten Knotens erstellen, erhält der neue Knoten die Eigenschaften und Werte des ursprünglichen .NETInput-Knotens, den Sie geklont haben.
Die Eigenschaften und Werte eines geklonten Knotens können konfiguriert werden. Weitere Informationen hierzu finden Sie unter Nachrichtenflussknoten konfigurieren.
Die Instanz eines geklonten Knotens kann konfiguriert werden, wenn Sie ihn in eine grafische Datenzuordnung ziehen. Sie können den Knoten konfigurieren, indem Sie eine Assemblierungsdatei aus einem Dateiexplorer auf den Knoten ziehen. 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.
Durch die Festlegung der Auswertungseigenschaften können Sie definieren, wie die vom .NETInput-Knoten erstellten Nachrichten ausgewertet werden sollen.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
In der folgenden Tabelle werden die Terminals des .NETInput-Knoten-Knotens beschrieben.
| Terminal | Beschreibung |
|---|---|
| Fehlerterminal (Failure) | Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn ein Fehler auftritt, bevor eine Nachricht an das Ausgangsterminal weitergegeben wird. Selbst wenn die Eigenschaft 'Auswerten' festgelegt wird, werden Nachrichten, die an dieses Terminal weitergegeben werden, nicht ausgewertet. |
| Ausgabeterminal | Wenn keine Fehler im Eingabefluss auftreten, wird die von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgabeterminal gesendet. |
| Catch | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. Ausnahmen werden nur abgefangen, wenn dieses Terminal angeschlossen ist. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben, die Sie auf einer angegebenen Registerkarte festlegen können. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (im Toolkit mit einem Stern markiert, 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).
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Knotenname | No | No | Knotentyp | Name des Knotens. |
| Kurzbeschreibung | No | No | Kurze Beschreibung des Knotens | |
| Ausführliche Beschreibung | No | No | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
| Eigenschaft | M | C | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| Assembly-Name | Yes | Yes | Die Assemblierung, die den Knoten implementiert. Die Assemblierung können Sie mit der Funktion Durchsuchen auswählen oder Sie können die .dll-Datei der Assemblierung auf den Knoten ziehen, um diese Eigenschaft auszufüllen. | assemblyName | |
| Klassenname | No | Yes | Der Name der Klasse, die den Knoten implementiert. Für diese Eigenschaft ist nur dann ein Wert erforderlich, wenn von der gleichen Assemblierung zwei oder mehr Knoten bereitgestellt werden oder wenn als implementierender Knoten explizit eine Unterklasse angegeben werden soll. | connectorClassName |
| Eigenschaft | M | C | Standard | Beschreibung |
|---|---|---|---|---|
| Nachrichtendomäne | No | No | BLOB (Binary large object) | Die Domäne für die Syntaxanalyse der Nachricht. Wenn das Feld leer ist, ist der Standardwert BLOB. |
| Nachrichtenmodell | No | No | Gelöscht | Der Name oder die Position der Schemadatei des Nachrichtenmodells, in der die Nachricht definiert ist. Diese Liste wird mit allen verfügbaren Schemadateien für Nachrichtenmodelle gefüllt, die in der von Ihnen ausgewählten Nachrichtendomäne definiert sind. |
| Message | No | No | Gelöscht | Der Name bzw. die Position des Nachrichtenstamms innerhalb der Nachrichtenmodell-Schemadatei. Diese Liste wird mit allen verfügbaren Nachrichten gefüllt, die in dem von Ihnen ausgewählten Nachrichtenmodell definiert sind. |
| Physisches Format | No | No | Gelöscht | Der Name des physischen Formats der Nachricht. Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie das physische Format der eingehenden Nachricht in der Liste aus. Diese Liste enthält alle physischen Formate, die Sie für das ausgewählte Nachrichtenmodell definiert haben. Wenn Sie die Eigenschaft Nachrichtendomäne auf DataObject setzen, können Sie diese Eigenschaft auf XML oder SAP ALE IDoc setzen. Legen Sie für diese Eigenschaft SAP ALE IDoc fest, wenn Sie einen Bitstrom aus einer externen Quelle analysieren und eine Nachrichtenbaumstruktur generieren möchten. |
| ID des codierten Nachrichtenzeichensatzes | No | No | Systemstandardwert des Brokers | Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. Die Eigenschaft mqsiapplybaroverride des Befehls lautet 'messageCodedCharSetIdProperty'. |
| Nachrichtverschlüsselung | No | No | Ermitteltes Brokersystem | Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, das zur Interpretation der Bytes der gerade gelesenen Datei verwendet wird. Gültige Werte sind Ermitteltes Brokersystem oder ein numerischer Codierungswert. Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung. Die Eigenschaft mqsiapplybaroverride des Befehls lautet 'messageEncodingProperty'. |
| Eigenschaft | M | C | Standardwert | Beschreibung |
|---|---|---|---|---|
| Zeitpunkt für Syntaxanalyse | Yes | No | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird. Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält Informationen zur sofortigen Analyse von Nachrichten. |
| Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen | Yes | No | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen aus dem XML-Schema erstellt. Diese Eigenschaft kann nur ausgewählt werden, wenn für die Eigenschaft Auswerten auf der Registerkarte Auswertung Inhalt oder Inhalt und Wert festgelegt wurde. |
| XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Yes | No | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft definieren, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn es sich bei dem MQRFH2-Eingabeheader oder bei der Eigenschaft Nachrichtendomäne unter 'Syntaxanalyse der Eingabenachricht' um XMLNS handelt. Der Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten enthält weitere Informationen hierzu. |
| Zugriff auf gemischten Inhalt | Yes | No | Gelöscht | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert und es werden keine Elemente erstellt. |
| Kommentare beibehalten | Yes | No | Gelöscht | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert und es werden keine Elemente erstellt. |
| Verarbeitungsanweisung beibehalten | Yes | No | Gelöscht | Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in einer Eingabenachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert und es werden keine Elemente erstellt. |
| Nicht transparente Elemente | Yes | No | Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist. |
In der folgenden Tabelle werden die Auswertungseigenschaften des .NETInput-Knoten-Knotens beschrieben. Legen Sie diese Eigenschaften fest, wenn der Parser den Hauptteil der Nachrichten anhand des Nachrichtenmodells überprüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| Auswertung | Yes | Yes | Keines | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen. | validateMaster |
| Aktion bei Fehler | Yes | No | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Diese Eigenschaft kann nur angegeben werden, wenn Auswerten auf Inhalt oder Inhalt und Wert gesetzt ist. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste. |
Eine ausführliche Beschreibung der Eigenschaften von "Instanzen" finden Sie im Abschnitt Konfigurierbare Nachrichtenflusseigenschaften.
| Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| Pool zusätzlicher Instanzen | No | Yes | Pool verwenden, der dem Nachrichtenfluss zugeordnet ist | Der Pool, aus dem zusätzliche Instanzen beschafft werden.
|
|
| Zusätzliche Instanzen | No | Yes | 0 | Die Anzahl der zusätzlichen Instanzen, die der Knoten starten kann, wenn für die Eigenschaft 'Pool zusätzlicher Instanzen' 'Pool verwenden, der dem Knoten zugeordnet ist' angegeben wurde. | additionalInstances |
| Eigenschaft | O | K | Standardwert | Beschreibung |
|---|---|---|---|---|
| Ereignisse | No | No | - | 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. |
In der folgenden Tabelle werden die Microsoft Visual Studio-Eigenschaften des .NETInput-Knoten-Knotens beschrieben. Diese Eigenschaften werden während der Laufzeit als Teil der Implementierung an den Eingabe-Connector gesendet.
Weitere Informationen finden Sie im Abschnitt Nachrichten mithilfe eines .NETInput-Knotens erstellen.
| Eigenschaft | M | C | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| Name des Visual Studio-Projekts | No | No | Das Microsoft Visual Studio-Projekt oder die .NET-Lösung, das bzw. die den Code für diesen Knoten enthält. |
| Eigenschaft | M | C | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| AppDomain-Name | No | Yes | Die .NET-AppDomain, die diesen Knoten bereitstellt. | AppDomain | |
| Version | No | Yes | Die Version der Assemblierung. | AssemblyVersion | |
| Kultur | No | Yes | Die Kultur der Assemblierung. | AssemblyCulture | |
| Public Key-Token | No | Yes | Das Public Key-Token der Assemblierung. | AssemblyPublicKeyToken |
| Eigenschaft | M | C | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
|---|---|---|---|---|---|
| <Benutzerdefinierter Name> | No | No | Der Knoten stellt eine Tabelle bereit, in welcher der Benutzer Zeilen mit jeweils einem Name/Wert-Paar hinzufügen, bearbeiten oder löschen kann. |