About the Digital Event Services Transport

Software AG Digital Event Services is a messaging system for communicating between different Software AG products using events. Digital Event Services allows event definitions to be converted between a product's internal event or document definition to digital event types and vice versa, so participating products can share a set of event definitions. When you develop Apama applications that make use of Digital Event Services, the digital event type definitions are automatically translated to Apama event types. When digital events are sent to or received from Digital Event Services, they are converted to or from Apama events.

For details of the event mapping, see the .mon source file that is generated into the autogenerated node of your Apama project in Software AG Designer. Note that digital event types that contain nested events (or sequences of nested events) are converted to Apama event definitions that have an optional member (or sequence of optionals) for that event type. See the description of the optional type for more information. When digital events are converted to Apama events, fields of other types with no value set are set to the default value for that type (see also Default values for types).

Note:

In this release, it is not possible to turn your own Apama event types into digital event types. At the moment, digital event types can only be added to the system by other Software AG products (for example, webMethods Integration Server).

To use digital event types in your Apama application, proceed as follows:

3. Use Software AG Designer to add the Digital Event Services connectivity bundle to your Apama project. For detailed information, see Using the Digital Event Services connectivity bundle.

4. In the Apama Digital Event Types editor, select all digital event types that you want to use in your application. You use the digital event types just like ordinary Apama events. You can create digital events, create event expressions for them, set and get their contents, pass them around internally between monitors and contexts, and much more. See the above-mentioned topic for more information.

5. Edit the DESConnectivity.properties file to configure the Digital Event Services connectivity plug-in which defines the Apama connection to Digital Event Services. See the above-mentioned topic for more information.