Universal Messaging 10.11 | Developer Guide | Enterprise APIs | Enterprise Developer's Guide for C++ | General Features | Event Dictionaries
 
Event Dictionaries
Universal Messaging Event Dictionaries (nEventProperties) provide an accessible and flexible way to store any number of message properties for delivery within an event (for related information, see Universal Messaging Events).
Event Dictionaries are quite similar to a hash table, supporting primitive types, arrays, and nested dictionaries.
Universal Messaging filtering allows subscribers to receive only specific subsets of a channel's events by applying the server's advanced filtering capabilities to the contents of each event's dictionary.
Event dictionaries can facilitate the automated purging of data from channels through the use of Publish Keys.
Constructing an Event
In this code snippet, we assume we want to publish an event containing the definition of a bond, say, with a name of "bond1":

nEventProperties *props = new nEventProperties();
props->put("bondname", "bond1");
props->put("price", 100.00);
nConsumeEvent *evt = new nConsumeEvent(props, "atag");
channel->publish(evt);
Note that in this example code, we also create a new Universal Messaging Event object (nConsumeEvent, see Universal Messaging Events) to make use of our Event Dictionary (nEventProperties).