Workflow, SLAs, and automation¶
Administrators can shape the lifecycle, set time targets, and automate repeatable actions. These changes affect day-to-day work across the organization, so validate them in a controlled environment and document the reason.
Change the workflow¶
The Workflow Designer can enable or disable states, define transitions, set required claims, control editable fields, and set prerequisites.
- Open Administration > Workflow Designer.
- Review the current diagram before changing anything.
- Select the state or transition to change.
- Update its availability, destination, required permission, editable fields, or required fields.
- Save the draft configuration.
- Test with representative creator, analyst, approver, and view-only accounts.
- Confirm both successful and rejected transitions.
- Activate according to your change-control process.
Image needed: Workflow Designer diagram with one state, one transition, and the field-permission editor labeled.
Configure SLAs¶
An SLA sets how long a risk should remain in a state and when it becomes at risk.
- Open the SLA administration page.
- Choose the workflow state.
- Set the total days allowed.
- Set the at-risk threshold.
- Add rating-specific rules when needed.
- Save and confirm badges on a test risk.
Dashboard queues, digest email, and trend snapshots also depend on their feature switches and background jobs.
Create a workflow rule¶
- Open Workflow Rules and create a rule or start from a template.
- Choose a trigger, such as a state change or external event.
- Build conditions using all, any, and not groups.
- Add actions such as a notification, field update, webhook call, or Jira-related action.
- Test against sample risks.
- Review integrations, referenced records, secrets, and endpoints required at run time.
- Save and enable the rule.
- Monitor its first real executions.
Rules can be cloned, disabled, edited, and deleted. A valid-looking rule can still fail later if a dependency is unavailable.
Call a webhook from a rule¶
- Create the outbound endpoint first under Integrations.
- Add the Call Webhook action to the rule.
- Select the endpoint or enter its exact key.
- Add an event-type label when the receiver uses one.
- Build the JSON body template from allowed risk values.
- Test, save, and enable the rule.
A missing, disabled, or wrong-environment endpoint is skipped. Check the endpoint list and Webhook Monitor when no delivery appears.
Understand rule triggers and conditions¶
Choose the narrowest trigger that reflects the business event. Then use condition groups to prevent unnecessary runs.
For example, a rule that alerts on a Critical risk entering Treatment should combine the relevant state-change trigger with a rating condition. An all group requires every child condition; an any group needs one; not reverses the contained result.
Before enabling, test a matching risk, a near-match that should not run, and a record the rule creator cannot access.
Understand the execution identity¶
Automation does not run outside authorization. Connected inbound events can run as the person who created the channel, and other automation uses the identity and rules defined by the application. If that account becomes inactive or loses record access, an otherwise correct rule can stop acting on a risk.
Document service ownership and avoid tying long-lived automation to a person likely to leave the responsibility without a handover.
Pause and revise safely¶
- Disable the rule before making a high-impact change.
- Review recent executions and failures.
- Clone the rule when you need a safe comparison or replacement.
- Change one logical concern at a time.
- Retest matching and non-matching records.
- Enable the revised rule and monitor early executions.
Monitor failures¶
Check rule history, risk activity, notifications, and the relevant integration monitor. Common causes include a disabled endpoint, expired or rotated secret, missing referenced record, invalid JSON template, deactivated execution user, changed permission, or state that no longer permits the intended action.
Do not repeatedly replay an action until you know whether the receiving system uses the event ID or idempotency key to reject duplicates.
Workflow change checklist¶
Before activating a workflow change, confirm:
- every enabled state has an intended entry and exit path;
- transitions lead to the expected phase and state;
- required claims exist in the intended policies;
- editable and required fields do not contradict one another;
- creators, reviewers, owners, approvers, and view-only users see the correct actions;
- existing in-flight risks still have a valid route forward;
- SLAs, rules, notifications, reports, and integrations that reference changed states were reviewed;
- support documentation and user communication are ready.