Creating a Logical Consumer

[This is preliminary documentation and subject to change.]

A logical consumer is an instance of a class that is derived from the __EventConsumer system class. The logical consumer class is designed by a developer to describe the action to be taken upon receipt of an event notification. As class designer, the developer can define as many properties as are appropriate. For example, to forward events to all of the employees of a particular building, the following class with the e-mail address of the employees can be defined:

class EMailConsumer : __EventConsumer
{
    [key] string EmailAddress;
}

Creating instances of the logical consumer class is up to the administrator. The administrator creates one instance of the EMailConsumer class for each employee to receive the event notification:

instance of  EMailConsumer 
{
    EmailAddress = "mike@anywhere.com";
}

instance of  EMailConsumer 
{
    EmailAddress = "susan@somewhere.com";
}

Note  Permanent consumers that receive events generated with the HyperMedia Management Protocol (HMMP) must define their logical consumers to be instances of a class derived from the __HMMPEventConsumer system class, a subclass of __EventConsumer. The __HMMPEventConsumer class has one property: URLToFinalConsumer. The administrator sets this property to the object path of the consumer.