1. To-Increase Dynamics 365 for Finance & Operations
  2. Connectivity studio
  3. Activities

Set up Service Bus search definition
Application task

You can use Service Bus search definitions to automatically assign Connectivity studio messages to received data records from a Service Bus.


Standard procedure

1. Go to Service Bus search definitions.
 

Note: You can open this page from the Connectivity studio menu or from the Connector page.
2. Click New.
3. You can indicate to which source of received data records a search definition is applied:
- Service Bus queue or topic subscription (Dead letter = No). The assigned messages are used to import the received data into D365 FO.
- Service Bus dead letter queue (Dead letter = Yes). The assigned messages are used to further process the dead letter data into D365 FO. For example, you can set a Production order 'On hold' when a dead letter is received on the export of a production order.
  In the Dead letter field, select the applicable option.
4. In the Service Bus namespace field, enter the name of the applicable Service Bus namespace.
5. In the Entity name field, enter the name of the applicable Service Bus queue or Service Bus topic.
6. In the Subscription field, if the entity is a topic, enter the name of the applicable Service Bus topic subscription.
7. You can define the priority of the search definition. This priority is applied if several matching search definitions exist. If so, these rules are applied:
- If no priority is defined (Priority = 0), the first found matching search definition is applied.
- If priorities are defined (Priority > 0), the matching search definition with the lowest priority is applied.
  In the Priority field, enter the desired priority number.
8. A Service Bus queue or topic message has a Content field, which value is available on the received data record. You can use the content value as filter option to find the applicable search definition.
  In the Content info field, enter the value based on which to filter the search definition.
9. A Service Bus queue or topic message has a Subject field, which value is available on the received data record. You can use the subject value as filter option to find the applicable search definition.
Indicate how the value in the Subject field is applied.
  In the Subject filter field, select an option.
10. In the Subject info field, enter the value based on which to filter the search definition.
11. Define the message to be assigned to the received data records that match the search definition.
  In the Message field, enter or select a value.
 

Note: The defined message must have the 'Service Bus queue' connector as source connector.
12. Define the company to be assigned to the received data records that match the search definition.
The assigned message is run in this company only. If no company is defined, the message is run in the active company or in the company as defined by the message.
  In the Company field, enter or select a value.
13. Close the page.
Related to Notes

Set up Service Bus queue connector

 		 

Monitor and troubleshoot Service Bus dead letter data

 		 

Monitor and troubleshoot Service Bus import

 		 

See also

Provide feedback