sendAssignedToIncident
A Workflow Engine function that sends a request to the corresponding outbound integration workflow to assign the incident for the named service. By default, the function takes the user name from the Situation moderator or alert owner but you can use the moderatorName argument to assign a different user name.
This function is available as a feature of the Add-ons v2.2 download and later.
This function is available for alert and Situation workflows.
Back to Workflow Engine Functions Reference.
Arguments
Workflow Engine function sendAssignedToIncident takes the following arguments:
Name | Required | Type | Description |
|---|---|---|---|
| yes | string | The name of the incident integration; has the value alertops. |
| no | string | An instance name for integrations supporting multiple instances; defaults to the first instance. |
| no | string | The moderator name to use. |
| no | object | A JavaScript object that passes any additional arguments as context to the workflow and adds them to the existing workflow context. |
Example
Within a Situation Delta workflow, this action can be preceded by a sigActionFilter action with the actionTypes set to '["Assigned Moderator"]'. The function returns true if the workflow receives an "Assigned Moderator" Situation action.
If the forwarding behavior of the sigActionFilter function is set to “Stop This Workflow”, the subsequent sendAssignedToIncident function only runs when the workflow receives an "Assigned Moderator" Situation action.
To forward the moderator assignment to AlertOps, give the following arguments to the sendAssignedToIncident function:
Argument Name | Argument Value |
|---|---|
| alertops |
| |
| |
|
Which the UI translates to:
{"serviceName":"alertops" }This sends a Situation Inform to the “Assign AlertOps Incident” workflow in the Situation Integration WFE. This workflow contains a sendAssignedToAlertOpsIncident function which uses the moderator_id of the in-scope situation to retrieve the name of the new moderator and forward a message to AlertOps.
Alternatively, if the sendAssignedToIncident action is given the following arguments:
Argument Name | Argument Value |
|---|---|
| alertops |
| |
| $EXPAND(moderator_id) |
|
Which the UI translates to:
{"serviceName":"alertops", "moderatorName":"$EXPAND(moderator_id)" }The function sends a Situation Inform to the “Assign AlertOps Incident” workflow in the Situation Integration WFE. This workflow contains a sendAssignedToAlertOpsIncident function which uses the moderator workflowContext key to retrieve the name of the new moderator and forward a message to AlertOps.