Verwenden Sie die CMP-API, um
zur Ausführungszeit benutzerdefinierte Nachrichtenflusseigenschaften abzufragen, zu erkennen und
festzulegen. Über die CMP-API können Sie Eigenschaften mit einem
Zeichendatentyp festlegen.
Damit benutzerdefinierte Eigenschaften in einem Nachrichtenfluss erkannt werden können, muss der Nachrichtenfluss folgende Bedingungen erfüllen:
- Der Nachrichtenfluss muss mindestens einen der folgenden Knoten enthalten:
- JavaCompute
- Compute
- Datenbank
- Filter
- PHPCompute
- Der Nachrichtenfluss muss die relevante benutzerdefinierte Eigenschaft definieren und einen neuen Wert bereitstellen.
Tipp: Geben Sie für die Namen und Werte der von Ihnen definierten Eigenschaften aussagekräftige Bezeichnungen ein, damit ihr Zweck auf einen Blick ersichtlich ist. Die benutzerdefinierte Eigenschaft Eigenschaft01 mit dem Anfangswert WertA ist beispielsweise nicht so aufschlussreich wie die Eigenschaft WeiterleitungAnAoderB mit dem Anfangswert RouteA.
Verwenden Sie die CMP-API zur Ausgabe der folgenden Aufrufe, wenn Sie benutzerdefinierte Eigenschaften in einem Nachrichtenfluss abfragen, erkennen und festlegen möchten. In der Dokumentation zur CMP-API (Message Broker-API) finden Sie ausführliche Informationen zu den Aufrufen, zur erforderlichen Syntax und zu den Parametern.
- Geben Sie einen MessageFlowProxy.getUserDefinedPropertyNames()-Aufruf aus, um eine Liste aller benutzerdefinierter Eigenschaften abzurufen, die vom Nachrichtenflusseditor im Nachrichtenfluss oder den untergeordneten Flüssen definiert wurden.
Ein Zeichenfolgebereich wird geliefert, der die Eigenschaftsnamen enthält.
- Geben Sie einen MessageFlowProxy.getUserDefinedProperty()-Aufruf aus, um den Wert der angegebenen benutzerdefinierten Eigenschaft abzurufen.
Der Wert der Eigenschaft wird als Java.lang.String-Wert zurückgegeben.
- Geben Sie einen MessageFlowProxy.setUserDefinedProperty()-Aufruf aus, um einen neuen Wert für die angegebene benutzerdefinierte Eigenschaft festzulegen.
Die Eigenschaft muss vorhanden sein. Da Sie den Datentyp der bestehenden
benutzerdefinierten Eigenschaft (Java.lang.String) nicht ändern können, müssen Sie sicherstellen,
dass der neue Wert dem bestehenden Datentyp entspricht.
Der von Ihnen mit dem MessageFlowProxy.setUserDefinedProperty()-Aufruf festgelegte Wert wird an alle relevanten Knoten im Nachrichtenfluss (und in den untergeordneten Flüssen) weitergegeben, wo er dann aufgenommen wird.