If you want to create a business event to be triggered by a message, first create and set up a message business event. A message business event is a business event definition that is used to create a business event in D365 FO.

For each message, you can only create one message business event.
The business event is triggered when the message run is done, taking into account the 'Send business event' setting.


Standard procedure

1. Click Connectivity studio Integration Design.
2. On the Message tab, in the list, find and select the desired message.
3. Click Edit.
4. On the Action Pane, click Design.
5. Click Message business event.
6. Click New.
7. The business event ID is composed by a prefix and the target connector type: [prefix]_[target connector type].
You can use the same prefix for several message business events. In this way you can link an existing business event to the message business event.
In this field define the prefix.
  In the Prefix field, type a value.
 

Note: The target connector type as used in the business event ID can be:
- D365FO: If the target connector is of type 'D365 FO'.
- File: If the target connector is of type 'Windows folder' or 'Azure Blob Storage'.
- Database: If the target connector is of type 'Database'.
- Staging: If the target connector is of type 'Staging journal'.
Business events are not supported for target connectors of type 'Web service' and 'Upload and download'.

8. Define the name for the business event.
The default name is composed of the project ID and the message ID: [project ID]_[message ID].
You can change the event name as desired.
  In the Event name field, type a value.
9. Enter a meaningful description for the business event.
The default description of the business event is: "Event triggered after run of message [message ID] of project [project ID]"
You can change the description as desired.
  In the Description field, type a value.
10. Define when the business event is processed:
- Never: The business event is not processed.
- Error: The business event is only processed if an error occurs during the message run.
- Finished: The business event is only processed if the message has run successfully.
- Always: The business event is processed when the message has run.
  In the Send business event field, select an option.
11. Sub-task: Define additional content from target document.
  11.1 You can define additional content from the target document to be sent with the business event.
  Expand the Target field section.
  11.2 Click Add line.
  11.3 In the Response field field, enter or select a value.
12. Sub-task: Define additional content from source document.
  12.1 You can define additional content from the source document to be sent with the business event.
  Expand the Source field section.
  12.2 Click Add line.
  12.3 In the Response field field, enter or select a value.
13. Sub-task: Create Connectivity business event in Business events catalog.
  13.1 If the message business event definition is set up, create a business event in the Business events catalog. The business event is created based on the message business event definition and gets the category 'Connectivity'.
  Click Create connectivity events.
 

Note:
- If for the message business event the 'Send business event' field is set to 'Never', no business event is created.
- You can view a created 'Connectivity' business event in the Business events catalog. To do so, on the Action Pane, click Business events catalog.

14. Close the page.

Notes

You can also view message business events in these ways:

  • View all message business events for a specific project: On the Project page, on the Action Pane, on the Design tab, click Message business events.
  • View all message business events in a D365 FO environment: On the Connectivity studio menu, click Inquiries, Message business events.
 

Provide feedback