Page History
With the AQ_ThrowMessageEvent service call you can throw Message event towards the process engine. You can select a message event which you have previously defined in the process module. For every defined data field, you can define an expression to fill the field with information. The context of this expression is the module in which you place this service.
How the process engine behaves when receiving a message event is completely dependent on what was modeled in the process module. There is no default action executed when receiving a message event. Examples of behavior that you can model include: Starting a new case or making a task available to the worklist, canceling a case, or placing information in the domain of the case.
Parameters
| Name | Description | Type | Required | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Send to specific Case Id: | If you want to send the message to (a) specific case(s), and not broadcast it to all running cases, then you can supply the id(s) of the receiving case(s) here. The specific caseId(s) do not have to be part of the message, but could be.
| Expression | false | ||||||||||||
| Case Ids Target Attribute | The case ids of the case affected by the message event are placed in the selected attribute. This attribute must be multivalued and of the type integer. | Multivalued integer | false | ||||||||||||
| Message event | The name of the message event that will be triggered. | Message event | true | ||||||||||||
| Values | These elements represent the content of the message. You have to specify what the result attributes will be. | Elements | false |
AQ_ThrowMessageEvent vs DCM_ThrowAsyncMessageEvent
| Info | ||
|---|---|---|
| ||
The DCM_ThrowAsyncMessageEvent service call type is only available when you use the Case Engine setup, which is still in development. |
Next to this service, the DCM_ThrowAsyncMessageEvent is also available. As the name suggests, that service works asynchronously as opposed to this service which is synchronous. The benefit of using the asynchronous service is that a user does not have to wait for the message event to be processed, which could take some time if the message event is broadcast to a lot (if not all) cases. The downside of the asynchronous service is that you no longer receive the affected case ids, as you do not have to wait. So assess carefully which service you need for your use case.
Migrate to DCM_ThrowAsyncMessageEvent
If you want to migrate to the DCM_ThrowAsyncMessageEvent service, you can do this using the migrate button in Studio in the service call definition. It will automatically migrate the service and its parameters to the new definition, provided that:
...
Overview
Content Tools