Manage notifications for CMDB Data Manager
The CMDB Data Manager supports several types of notifications that alert administrators, task assignees, and approvers about policy execution outcomes, task life-cycle events, and pending actions. All notifications are delivered via email using ServiceNow® event-driven email actions.
The following system properties control different behaviors of notifications:
- cmdb.data.manager.stale.tasks.notifications.frequency
- sn_cmdb_ws.cmdb.dm.policy_types.due_date_notification
- sn_cmdb_ws.glide.cmdb.data_manager.rejected.task.notifications.group
- cmdb.data.manager.stale.task.life.in.days
For information about these properties, see Components related to CMDB Data Manager.
Most notifications don't require special configuration and trigger automatically when their specified conditions are met. Recipients are determined by role (such as data_manager_admin), task assignment, approval group membership, or a configurable user group. For information about the Run policy scheduled job as, Run as, and other policy setting, see Create a CMDB Data Manager policy.
Notifications
These are the notifications generated by the CMDB Data Manager, listed by the respective subject line of each notification email:
- FAILED: A CMDB Data Manager policy has failed to run
| Trigger conditions | Evaluation of a CMDB Data Manager policy encountered an error during execution. |
| Recipients | - Users with data\_manager\_admin role - The policy's Run as user |
| Configuration | None |
FAILED: A CMDB Data Manager task has failed
The notification email includes a link to the policy and failure details from the task close notes.
| Trigger conditions | A task's associated subflow failed during execution. |
| Recipients | - Users with data\_manager\_admin role - The policy's Run as user |
| Configuration | None |
ACTION REQUIRED: A CMDB Data Manager task needs review
The periodic (based on settings) email reminders contain the task number, creation date, and a link to the task.
| Trigger conditions | A task is open with no recent notifications within the configured frequency window. |
| Recipients | The task's approval approvers, based on records in the Approvals [sysapproval_approver] table, where State=Requested. |
| Configuration | Properties in the CMDB Data Manager Settings page:
|
cmdb_data_management_task {task number} Approval Request
Sending this notification depends on whether the policy type is configured to require a review. For information about the Needs review field, see Create a CMDB Data Manager policy.
| Trigger conditions | Task ready for approvals. |
| Recipients | Approval group members determined by the policy configuration. |
| Configuration | None |
- Due date is approaching for ${number}
| Trigger conditions | An active task that has a due date, and which is assigned. Sends reminder notifications at milestone intervals before due date. |
| Recipients | The assigned_to user. |
| Configuration | Property in the CMDB Data Manager Settings page: sn_cmdb_ws.cmdb.dm.policy_types.due_date_notification. |
- Due date breached for ${number}
| Trigger conditions | An open task with a due date that has passed. |
| Recipients | - assigned\_to user - assigned\_to.manager |
| Configuration | Property in the CMDB Data Manager Settings page: sn_cmdb_ws.cmdb.dm.policy_types.due_date_notification. |
CMDB Attestation task ${number} completed
Email notification includes a CI summary (total, attested, rejected counts), who completed the task, and when.
| Trigger conditions | User closes/submits an attestation task in the workspace. |
| Recipients | Users with data\_manager\_admin role. |
| Configuration | None |
CMDB Data Manager task ${number} rejected
Email notification includes rejection reason/comments and task link. This notification applies to all policy types.
| Trigger conditions | User rejects a task during a review in the workspace. |
| Recipients |
|
| Configuration | System property sn_cmdb_ws.glide.cmdb.data_manager.rejected.task.notifications.group. |
CMDB Data Manager task {task_number} has been assigned to you/to a group you belong to
The notification email lists the newly created task with links to the task details view in CMDB Workspace or Service Graph Workspace.
| Trigger conditions | Policy execution is completed and tasks are created with assignment or reassignment. |
| Recipients | Users that are assigned to this task and which belong to the assignment group. |
| Configuration | None |
An unassigned CMDB Data Manager task {task_number} has been created
The notification email lists the newly created task with links to the task detail view in CMDB Workspace or Service Graph Workspace. The 'Data Manager Admin' is an empty placeholder group which has data manager admin role and the user is requested to assign the task by adding the intended recipient users to this group.
| Trigger conditions | Policy execution completes and tasks are created without assignment. |
| Recipients | Users in the 'Data Manager Admin' group, as specified in the base system. |
| Configuration | None |