Skip to main content

MGCLatticeWorkflowStalledOrFailedBusinessEvent

Business event raised for a workflow that needs administrator attention: a faulted instance or a work item that has stalled (sat unactioned past a configured age). Raised by the detector batch MGCLatticeWorkflowStalledAlertBatch, not by a live transition - "stalled" is the absence of an action, which only a periodic scan can detect. Lets admins be alerted via Power Automate/Teams instead of users discovering stuck approvals days later. Each condition is reported once and again only when it changes: the scan remembers what it reported in MGCLatticeWorkflowAlertState, keyed by the alert kinds below and fingerprinted by faultedAlertState / stalledAlertState. This is distinct from the workflow approval lifecycle events: those fire on approve/reject/submit actions; this fires on the lack of one, or on a fault.

  • Event id: MGCLatticeWorkflowStalledOrFailedBusinessEvent
  • Contract class: MGCLatticeWorkflowStalledOrFailedBusinessEventContract

Payload fields​

NameTypeDescription
eventSequenceint64Gets or sets the ordering sequence of this emission.
correlationIdstrGets or sets the identifier grouping emissions that belong to one logical run or flow.
schemaVersionintGets or sets the payload schema version of the emitting contract.
alertReasonstrGets or sets the reason the workflow needs attention (Stalled, Faulted, or Unrecoverable).
workflowCorrelationIdstrGets or sets the correlation id of the workflow instance.
workflowIdstrGets or sets the workflow's ID, as shown in the ID column of the workflows list.
workflowConfigurationstrGets or sets the name of the workflow configuration.
workflowTypeintGets or sets the workflow type (WorkflowTrackingStatusWorkflowType value); 0 when a stalled work item has no instance status row.
workflowTypeNamestrGets or sets the kind of workflow instance (workflow or sub-workflow).
workItemTypestrGets or sets the kind of work item (for a stalled work item; empty for a faulted instance).
legalEntitystrGets or sets the company of the workflow document, in lower case.
documentTableNamestrGets or sets the table name of the workflow document.
documentRecIdint64Gets or sets the RecId of the workflow document.
currentStepstrGets or sets the name of the workflow step the stalled work item is waiting on.
currentStepIdstrGets or sets the id of the workflow step the stalled work item is waiting on; unique where step names can repeat.
assignedUserstrGets or sets the assigned user or workflow owner.
ageHoursintGets or sets the age of the workflow condition in hours.
detailTextstrGets or sets the synthesized human-readable detail message.
trackingStatusintGets or sets the workflow instance status (WorkflowTrackingStatus value) of a faulted workflow; 0 for a stalled work item.
trackingStatusNamestrGets or sets the workflow instance status symbol of a faulted workflow; empty for a stalled work item.
workItemStatusintGets or sets the work item status (WorkflowWorkItemStatus value) of a stalled work item; 0 for a faulted workflow.
workItemStatusNamestrGets or sets the work item status symbol of a stalled work item; empty for a faulted workflow.