| Step Details | |
| Introduced in Version | 4.0.0 |
| Last Modified in Version | 7.12.0 |
| Location | Integration > Message Queues |
Similar to the Post Message step, the Post String Message step allows a string to be sent to a message queue, avoiding the need to encode the string before sending the message.
Prerequisites
This Step requires Users to install the About Messaging Module before it will be available in the toolbox.
In V9 a dependency must be established before the steps will be available in the toolbox.
Properties
Settings
| Property | Description | Data Type |
|---|---|---|
| Queue Name | Name of queue to post string message. | String |
| Get Queue from Flow | If enabled, the queue will be pulled from a connected queue in the flow. This option requires the flow to be created as a message queue handler. | Boolean |
Inputs
| Property | Description | Data Type |
|---|---|---|
| Always Override Id | If enabled, this will override the given Id always. | Boolean |
| Message Text | The main part of the message to be posted. | String |
| Override Message Id | Message Id that overrides the original Id. | String |
Outputs
| Property | Description | Data Type | |
|---|---|---|---|
| Done | |||
| Message Id | Id of posted message string. | String | |
Example Inputs and Outputs
| Always Override Id (Even if Null of Empty) | Message Text | Override Message Id | Output |
|---|---|---|---|
| False | Hello, World! | False | Message Id: 08dadf96-196b-42aa-c360-f149cc047f0d |
| False | Hello, World! | New Test ID | Message Id: New Test ID |
| True | Hello, World! | NULL | Message Id: NULL |
Common Errors
Missing Queue Selection
If a message queue is not selected under the SETTINGS category for the step, the step will throw an error. Ensure that a queue has been selected before running the step.
Exception Message:
Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Post Message 1[PostMessage] in flow [Testing]: Object reference not set to an instance of an object. ---> System.NullReferenceException: Object reference not set to an instance of an object. at DecisionsFramework.Data.Messaging.MessageServerEndpoint.GetQueueByName(String queueName) at DecisionsFramework.Data.Messaging.MessagingService.GetQueueByName(String queueName) at DecisionsFramework.Data.Messaging.BaseMessagingStep.GetQueue(StepStartData stepData) at DecisionsFramework.Data.Messaging.PostMessage.Run(StepStartData data) at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData) at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
--- End of inner exception stack trace ---