Microsoft Azure Service Bus QueueReceiver
The QueueReceiver trigger is used to poll a particular queue for any messages that may be posted by one or more publishers in a one-to-one message delivery pattern. Messages posted to the queue by publishers are received by polling Queue receivers in a First In First Out format and only one queue receiver can retrieve any one message. All queue receivers to a particular queue within a namespace compete with each other to retrieve messages from the head of the queue. When creating a queue, you can check the box to specify whether to enable sessions.
You can enable Application properties for some fields by turning on the toggle if one is available. Application properties allow you to provide values for configuration fields.
Trigger Settings
The Configuration tab has the following fields.
Field | Description |
---|---|
AzureServiceBus Connection | The AzureServiceBus Connection chosen for the QueueReceiver while creating the trigger is displayed here automatically.
If you wish to choose a different AzureServiceBus Connection than what was chosen in the settings page of Trigger creation, you can click the dropdown and choose a different one. |
Queue | Name of the queue to poll continuously for messages. A queue by that name must exist in the namespace of the broker.
Application Properties has been enabled for this field. |
DeadLetter Subscription |
The possible values are true or false. When you set the DeadLetter Subscription value as "true", the unsuccessfully processed messages are stored in the dead letter queue and can be retrieved as needed. |
SessionId | Name of the session from which to receive messages. When enabled, allows the QueueReceiver to listen for messages from the specified SessionID.
If a queue is session-enabled, but a SessionID is not specified, then the QueueReceiver does not send any message. |
Receive Mode |
Determines the quality of service while receiving messages from a queue.
|
Timeout | Timeout in milliseconds for the operation of an activity. |
Retry Count |
The number of times the flow attempts to run the trigger. Default: 0 Note: The Retry Count value can also be set from the connections details, but the value set here are preferred.
|
Retry Interval |
The time (in milliseconds) to wait in between each attempt to run the trigger. Default: 0 milliseconds Note: The Retry Interval value can also be set from the connections details, but the value set here are preferred.
|
Output Settings
The Output Settings tab has the following field:
Field | Description |
---|---|
Custom Properties | User can add the custom properties while receiving the messages. |
Output
The Output tab displays the schema in a tree format. The output is read-only. The following elements are present in the output schema:
- output: The root of the output
- messageString: The string representation of the byte array of the received message.
- brokerProperties: A complex object that acts as a container for broker properties of the received message. The QueueReceiver trigger displays the following broker properties of a received message if available:
- ContentType
- CorrelationId
- Label
- PartitionKey
- ReplyTo
- SessionId
- TimeToLive
- To
- DeliveryCount
Note: For more information aboutbrokerproperties
, see the Microsoft Azure Service Bus documentation. - customProperties: These properties are populated when you add custom properties on the Output Settings tab of the QueueReceiver trigger.