Receive Message from Queue
This activity allows an author to configure a message to be received from a queue, which was sent via the Send Message to Queue activity, in order to coordinate work between workflows and activities.
This activity interacts with a WorkflowQueue using the WorkflowQueuingService.
Note: The following restrictions apply:
- The message queue name cannot be null or empty, and you cannot use workflow instance ID, task instance ID, or task step instance ID as a queue name, because doing so causes the activities to fault at run time.
- Empty GUIDs are not allowed.
- Leading and trailing spaces are trimmed in the queue name; otherwise, the queue name is invalid.
- A queue must be created before sending a message.
- The workflow instance should be running before sending a message. If it is not running, the instance is not loaded/restarted.
Queue Configuration Properties
Property | Value | Description |
---|---|---|
Queue Name | User-defined; GUID; String |
Specifies the name of the message queue, which is scoped to this workflow instance. This value can be configured using a literal value, expression, or bind. |
Time Out | User-defined | Specifies the duration that the message is in the queue before it is no longer valid. If this activity times out, it will be cancelled. As the default value is zero, if this property is not configured, this activity does not end; it will wait forever. |
Message Input Properties
Property | Value | Description |
---|---|---|
Message Type | User-defined | Specifies the data type of the message received, which is scoped to the Send Message to Queue activity. |
Message Output Properties
Property | Value | Description |
---|---|---|
Message | Read Only; Object |
Specifies the message being received from another queue, which is bound to the Send Message from Queue activity. This value can be configured using a literal value, expression, or bind. |
Message Received | Read Only; Boolean | Specifies whether the sent message has been received. |
Timed Out | Boolean | Specifies whether the received message is no longer valid because the allotted pre-set time to view the message has expired. |