Bei einer benutzerdefinierten Eigenschaft (User-Defined Property; UDP) handelt es sich um eine Variable, die im ESQL-Programm in einer DECLARE-Anweisung unter Angabe des Schlüsselwortes EXTERNAL definiert wird. So wird mit der ESQL-Anweisung DECLARE today EXTERNAL CHARACTER 'monday' beispielsweise die benutzerdefinierte Eigenschaft 'today' mit dem Ausgangswert 'money' definiert.
Damit eine benutzerdefinierte Eigenschaft verwendet werden kann, muss diese Eigenschaft auch bei der Erstellung eines Nachrichtenflusses definiert werden, der diese Eigenschaft verwendet. Dies erfolgt über den Nachrichtenflusseditor.
Bei der Definition einer UDP über den Nachrichtenflusseditor werden außerdem ein Wert und ein Eigenschaftentyp definiert. Bei dem Wert kann es sich um einen Standardwert handeln, der je nach UDP-Typ variiert. Der Wert, der der UPD im Nachrichtenflusseditor zugewiesen wird, hat eine Vorrangstellung gegenüber allen anderen Werten, die der UDP im ESQL-Programm zugeordnet werden.
Der Wert der der UDP kann über den Brokerarchiveditor vor der Implementierung des Nachrichtenflusses, der diese UDP verwendet, geändert werden. Wird ein Nachrichtenfluss mit einer UDP implementiert, der kein Wert zugeordnet wurde, schlägt die Implementierung fehl.
Weitere Informationen finden Sie im Abschnitt Nachrichtenfluss zur Implementierungszeit unter Verwendung von benutzerdefinierten Eigenschaften konfigurieren.
Unter Verwendung von UDPs lassen sich Konfigurationsdaten ohne großen Aufwand festlegen und wie normale Konstanten verwenden. Da keine externen Aufrufe von benutzerdefinierten Plug-ins oder das Parsing von Umgebungsbäumen involviert sind, ist der ESQL-Code einfacher zu schreiben und zu pflegen und lässt sich besser ausführen. Zudem entfallen die Parsing-Kosten für das Herauslesen der Daten aus den Bäumen. Der Wert der benutzerdefinierten Eigenschaft wird bei der Implementierung in der Variablen markiert, damit ein rascherer Zugriff möglich ist.
UDPs können nur in Modulen oder Schemas deklariert werden.
Unter Aus dem Java-Rechenknoten auf benutzerdefinierte Eigenschaften zugreifen wird beschrieben, wie über einen Java-Rechenknoten auf eine UDP zugegriffen werden kann.