UpdateIncident Message
The UpdateIncident Message is an update type message that sends updates to the bonded record.
Last updated
The UpdateIncident Message is an update type message that sends updates to the bonded record.
Last updated
After submitting the 'Response' Message, you were redirected to the Messages page (note: the three previously configured messages are now visible in the list):
1) Click New.
The fields to be configured for the UpdateIncident New Message modal are as follows:
# | Field | Description | Value |
2 | Message name | The message name that is unique for this integration. | 'UpdateIncident' |
3 | Type | The primary purpose of the message. | 'Update' |
4 | Direction | The direction(s) this message is configured to support. | 'Outbound' |
Your UpdateIncident New Message modal should look like this:
5) Submit and view to further configure the Message.
Navigate to Message > Response.
The Response fields to be configured are as follows:
# | Field | Description | Value |
6 | Response | The immediate synchronous response to this message. | <lookup: 'Response'> |
7* | Async | Turn this option on if you want inbound processing to occur asynchronously or this message is the first of an asynchronous message pair. | <false> |
*This field is automatically defaulted to true.
Your Response form should look like this:
8) Navigate to Message > Bond.
The Bond fields to be configured are as follows:
# | Field | Description | Value |
* | Bond ownership | Determine if the sender should own the bond or not in order for this message to be processed? Use 'Ignore' to process regardless of the owner flag. (Choices: Ignore, Must own, Must not own.) | 'Ignore' |
* | Bond condition type | The type of conditional check made on the bond. (None: no checks are made. State: checks against the state are made using the conditional checkboxes. Scripted: the 'Bond condition' script is used.) | 'State' |
9 | Bond open | Process this message when the bond state is Open. | <true> |
*These fields are automatically populated.
Your Bond form should look like this:
10) Navigate to Outbound > Trigger.
The Outbound Trigger fields to be configured (as required)* are as follows:
# | Field | Description | Value |
11 | Outbound condition* | The condition that the ServiceNow record must meet to trigger this message being processed. | <Your condition> e.g. 'Work notes changes' OR 'Additional comments changes' |
*Outbound condition (as required):
It is not necessary for you to enter a condition. The value given is an example. You may create any condition (or not) to align with your business process requirements.
Your Outbound Trigger form should look like this:
12) Navigate to Outbound > Settings.
The Outbound Settings fields to be configured are as follows:
# | Field | Description | Value |
13 | Path* | A path to append to the URL defined in the connection. Specify a full URL to override the connection. Define inline scripts to reference Stage to Request script variables by wrapping code in braces {}, e.g. /{transaction.message_id}. | '/table/incident/{bond.getValue("external_reference")}' |
14 | Action method | The SOAP Action or the REST Method to use for this message. If this field is empty the SOAP Action will default to the message name and the REST Method will default to POST. | 'PUT' |
*Path
Only include the /table/incident element of this value if you have used the truncated Endpoint URL in the Connection. If you have used the full Endpoint URL, do not include that element of it here.
Your Outbound Settings form should look like this:
15) Click Save.
We are now ready to configure the Fields for our UpdateIncident Message.
