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.Workflow Engine Functions Reference

Arguments

Workflow Engine function sendAssignedToIncident takes the following arguments:

Name

Required

Type

Description

serviceName

yes

string

The name of the incident integration; has the value alertops.

instanceName

no

string

An instance name for integrations supporting multiple instances; defaults to the first instance.

moderatorName

no

string

The moderator name to use.

arguments

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

serviceName

alertops

instanceName

moderatorName

arguments

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

serviceName

alertops

instanceName

moderatorName

$EXPAND(moderator_id)

arguments

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.