• A connector of type Service bus queue.
• A project and therefore included in project exports and project version management.
• The environment types of the related connector.

On the Service Bus queue search definition setup, these fields are inherited from the linked connector and not editable:

• Service Bus namespace: The name of the applicable Service Bus namespace.
• Entity name: The name of the applicable Service Bus queue or Service Bus topic.
• Subscription: If the entity is a topic, the name of the applicable Service Bus topic subscription.

Standard procedure

1.	Click Connectivity studio - Integration design.
2.	Click the Connectors tab.
3.	In the list, find and select the desired connector of type Service Bus queue.
4.	Click Edit.
5.	On the Action Pane, click Development.
6.	Click Service bus search definitions.
	Note: You can open this page from the Projects page as well.
7.	Click New.
8.	In the Connector field, enter or select a value.
9.	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 F&SCM. - Service Bus dead letter queue (Dead letter = Yes). The assigned messages are used to further process the dead letter data into D365 F&SCM. 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.
10.	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.
11.	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.
12.	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.
13.	In the Subject info field, enter the value based on which to filter the search definition.
14.	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.
15.	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.
16.	Close the page.

Notes

To view all existing Service Bus search definitions, click Connectivity studio > Inquiries > Service Bus queue > Service bus search definitions. You can use this read-only page for informational purposes.

See also

• Service Bus search definitions
• Monitor and troubleshoot Service Bus import
• Monitor and troubleshoot Service Bus dead letter data