Knoteneigenschaften definieren

Definieren Sie die Eigenschaften für einen benutzerdefinierten Knoten, und fügen Sie Eingangs- und Ausgangsterminals hinzu.

Vorbereitungen:

Führen Sie die folgenden Aufgaben aus:
  1. Projekt für benutzerdefinierten Knoten erstellen
  2. Benutzerdefinierte Knoten-Plug-in-Dateien erstellen
Wenn Sie die im Abschnitt Benutzerdefinierte Knoten-Plug-in-Dateien erstellen beschriebene Aufgabe ausführen, wird eine Datei mit der Erweiterung '.msgnode' für den neuen Knoten erstellt und im Nachrichtenknoteneditor der Ansicht 'Brokeranwendungsentwicklung' geöffnet. Sie können jetzt Terminals und Eigenschaften zum Knoten hinzufügen.

Terminals zum Knoten hinzufügen

  1. Wenn die Seite 'Terminals' noch nicht angezeigt wird, klicken Sie am unteren Rand des Nachrichtenknoteneditors auf die Registerkarte Terminals.
  2. Klicken Sie auf rechts neben dem Feld Eingangsterminals oder Ausgangsterminals auf Hinzufügen, um ein Eingabe- oder Ausgabeterminal hinzuzufügen.

    Es muss mindestens ein Eingangsterminal definiert werden, während Ausgangsterminal optional sind.

  3. Sie können ein Terminal umbenennen, indem Sie auf den Terminalnamen klicken, so dass er hervorgehoben und hinter dem Namen ein blinkender Cursor angezeigt wird, und einen neuen Namen eingeben.
  4. Wenn Ihr Knoten dynamische Eingangs- oder Ausgangsterminals unterstützt, aktivieren Sie das entsprechende Kontrollkästchen.

    Dynamische Terminals sind Terminals, die zu bestimmten Knoten hinzugefügt werden können, nachdem sie im Nachrichtenflusseditor zu einem Nachrichtenfluss hinzugefügt wurden. Weitere Informationen finden Sie im Abschnitt Terminals für Nachrichtenflussknoten.

Eigenschaften für den Knoten definieren

  1. Klicken Sie am unteren Rand des Nachrichtenknoteneditors auf die Registerkarte Eigenschaften.

    Auf der Eigenschaftenseite können Sie die Eigenschaften des Knotens hinzufügen, z. B. einen Datenbanknamen, den Namen eines Host-Servers oder ein Kennwort. Die hier angegebenen Eigenschaften müssen mit den Eigenschaften übereinstimmen, die im benutzerdefinierten Knoten selbst mit den Methoden get und set angegeben wurden.

  2. Wenn es sich bei dem Knoten um einen Empfangsknoten handelt, klicken Sie in der Hierarchie auf den Knotennamen, um ihn hervorzuheben, und wählen Sie Empfangsknoten aus. Wählen Sie Standardwerte für den Broker verwenden aus, wenn der Knoten mit den Standardwerten des Brokers initialisiert werden soll.
  3. Optional: Es gibt unter der Eigenschaftenhierarchie bereits eine Eigenschaftenseite mit dem Namen 'Grundeinstellung'. Klicken Sie zum Erstellen weiterer Eigenschaftenseiten auf Eigenschaftengruppe hinzufügen .

    Beim Hinzufügen einer neuen Gruppe zur Hierarchie, wird der Namen hervorgehoben, so dass Sie ihn ändern können.

  4. Sie können eine skalare Eigenschaft hinzufügen, indem Sie auf den Namen einer Eigenschaftsgruppe klicken, um ihn hervorzuheben, und dann auf Skalare Eigenschaft hinzufügen klicken.

    Die neue Eigenschaft wird als untergeordnetes Element der Eigenschaftsgruppe zur Hierarchie hinzugefügt. Ihr Name wird hervorgehoben, so dass Sie ihn ändern können. Im Bereich 'Details' werden mehrere Felder angezeigt, in denen die Eigenschaft konfiguriert werden kann.

    1. Wählen Sie den richtigen Attributtyp aus: Dies kann ein integrierter Typ sein oder ein Typ, der der Liste der Werte entspricht, die die Eigenschaft annehmen kann.
    2. Geben Sie Standardwerte ein, die in der Eigenschaftenansicht angezeigt werden, wenn der Knoten in einem Nachrichtenfluss enthalten ist.
    3. Wenn Sie einen Eigenschafteneditor oder Compiler generieren möchten, geben Sie im entsprechenden Feld die Position für diese Ressourcen ein.
    4. Geben Sie für jedes Attribut, das Sie definieren, die Systemeigenschaft an:
      • Verdeckt: Die Eigenschaft wird in der Ansicht 'Eigenschaften' oder im Dialogfenster 'Eigenschaft übergeben' nicht angezeigt.
      • Lesezugriff: Die Eigenschaft wird angezeigt, kann jedoch nicht geändert werden.
      • Obligatorisch: Es ist ein Wert erforderlich. Das Feld darf nicht leer bleiben. Eigenschaften des Typs 'Boolesch' oder 'Aufzählung' sind immer obligatorisch.
      • Konfigurierbar: Die Eigenschaft kann bei der Implementierung konfiguriert werden.
  5. Sie können eine komplexe Eigenschaft hinzufügen, indem Sie auf den Namen einer Eigenschaftsgruppe klicken, um ihn hervorzuheben, und dann auf Komplexe Eigenschaft hinzufügen klicken.

    Eine komplexe Eigenschaft ist eine Eigenschaft, der mehrere Werte zugewiesen werden können. Komplexe Eigenschaften werden in einer Tabelle in Ansicht 'Eigenschaften' angezeigt, in der Sie Werte hinzufügen, bearbeiten und löschen sowie die Reihenfolge der Werte in der Tabelle ändern können.

    Die neue Eigenschaft wird als untergeordnetes Element der Eigenschaftsgruppe zur Hierarchie hinzugefügt. Ihr Name wird hervorgehoben, so dass Sie ihn ändern können. Im Bereich 'Details' werden mehrere Felder angezeigt, in denen die komplexe Eigenschaft konfiguriert werden kann.

    1. Geben Sie einen benutzerdefinierten Compiler für die komplexe Eigenschaft an.
    2. Geben Sie den Namen des benutzerdefinierten Eigenschafteneditors für die komplexe Eigenschaft ein, oder wählen Sie den Namen eines integrierten Editors in der Dropdown-Liste aus.
      • Standardwert
      • XPath Property editor: Stellt XPath-Ausdrücke bereit.
      • All Output Terminals Property editor: Stellt alle Ausgangsterminals bereit, die dem Knoten zugeordnet sind.
      • All Input Terminals Property editor: Stellt alle Eingangsterminals bereit, die dem Knoten zugeordnet sind.
      • Dynamic Output Terminals Property editor: Stellt alle dynamischen Ausgangsterminals bereit, die dem Knoten zugeordnet sind.
      • Dynamic Input Terminals Property editor: Stellt alle dynamischen Eingangsterminals bereit, die dem Knoten zugeordnet sind.
    3. Geben Sie die Systemeigenschaft an:
      • Verdeckt: Die Eigenschaft wird in der Ansicht 'Eigenschaften' oder im Dialogfenster 'Eigenschaft übergeben' nicht angezeigt.
      • Lesezugriff: Die Eigenschaft wird angezeigt, kann jedoch nicht geändert werden, d. h., Sie können im Nachrichtenflusseditor keine Zeile hinzufügen, bearbeiten oder löschen.
      • Obligatorisch: Die Tabelle muss mindestens eine Zeile enthalten.
    4. Sie können eine Spalte zu einer komplexen Eigenschaft hinzufügen, indem Sie in der Eigenschaftenhierarchie auf die komplexe Eigenschaft klicken, um sie hervorzuheben, und dann auf Skalare Eigenschaft hinzufügen klicken.

      Die hinzugefügten skalaren Eigenschaften werden als untergeordnete Elemente der komplexen Eigenschaften in der Hierarchie angezeigt. Definieren Sie deren Eigenschaften im Bereich 'Details' (siehe Beschreibung in Schritt 5).

  6. Optional: Ziehen Sie die Eigenschaften in die Eigenschaftenhierarchie, um die Reihenfolge zu ändern, in der sie auf der Eigenschaftenseite aufgelistet werden.
  7. Schließen Sie die Datei Knotenname.msgnode.
  8. Optional: Sie können den Text anpassen, der in der Ansicht 'Knoteneigenschaften' für jede einzelne Eigenschaft angezeigt wird. Legen Sie den Text fest, indem Sie die Datei Knotenname.properties öffnen und folgende Zeile bearbeiten: Property.Eigenschaftenname = Beschreibender Text.

Weitere Schritte:

Die folgenden Aufgaben sind optional:

Sie können jetzt Ihren Knoten testen. Wählen Sie nacheinander Run > Run as > Runtime Workbench (Ausführen > Ausführen als > Laufzeit-Workbench) aus, um eine weitere Instanz der Workbench zu starten. Weitere Informationen zum Testen mit der Laufzeit-Workbench finden Sie unter PDE-Laufzeitfunktionen aktivieren und im PDE Guide.

Zugehörige Verweise
Benutzerdefinierte Erweiterungen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as04496_