0463 Governance Actions¶
A Governance action describes some processing that is part of the governance of an organization's asset or the metadata tht describes them.
GovernanceAction¶
A GovernanceAction entity is used to control the execution of a single governance action instance.
The creation of a GovernanceAction entity typically triggers the execution of a governance service in a governance engine. As the governance service runs, the governance engine adds information to the GovernanceAction describing the status of the governance service and the actions taken against specific resources (see TargetForAction). Once the action is complete, the GovernanceAction acts as an audit record for the actions taken.
TargetForAction¶
The TargetForAction relationship links the governance action to the action targets for the governance service that will run. The governance service can update the status of its processing of the action targets in the properties of each TargetForAction relationship.
GovernanceActionRequestSource¶
The GovernanceActionRequestSource relationship links the first GovernanceAction in a process to the cause/originator of the action. This could be, for example, a governance action process, another governance action or a RequestForActionAnnotation.
GovernanceActionStatus¶
The GovernanceActionStatus indicates the execution status of the governance action.
| Enumeration | Value | Name | Description |
|---|---|---|---|
| REQUESTED | 0 | Requested | The governance action has been created and is pending. |
| APPROVED | 1 | Approved | The governance action is approved to run. |
| WAITING | 2 | Waiting | The governance action is waiting for its start time or the right conditions to run. |
| ACTIVATING | 3 | Activating | The governance action service for the governance action is being initialized in the governance engine. |
| IN_PROGRESS | 4 | In Progress | The governance engine is running the associated governance action service for the governance action. |
| ACTIONED | 10 | Actioned | The governance action service for the governance action has successfully completed processing. |
| INVALID | 11 | Invalid | The governance action has not been run because it is not appropriate (for example, a false positive). |
| IGNORED | 12 | Ignored | The governance action has not been run because a different governance action was chosen. |
| FAILED | 13 | Failed | The governance action service for the governance action failed to execute. |
| OTHER | 99 | Other | Undefined or unknown governance action status. |
NextGovernanceAction¶
The GovernanceAction is also linked to any follow-on activities through the NextGovernanceAction relationship, so it is possible to trace through a chain of actions. The guard describes the output guard produced by the previous action(s) that will trigger (or triggered) the next action(s).
If the guard is mandatory (ie mandatoryGuard = true), a next governance action can not run until a previous governance action has produced this guard.
Deprecated types
The following relationship types were deprecated in favour of attributes in the GovernanceAction to reduce the processing load in maintaining these relationships.
- GovernanceActionExecutor - Use executorEngineGUID, executorEngineName, requestType and requestParameters properties in GovernanceAction entity to identify the governance engine that will run the service that will execute the action. The specific service is identified by the requestType property. The governance engine is typically either a DiscoveryEngine or a GovernanceActionEngine.
- GovernanceActionTypeUse - Use governanceActionTypeGUID, governanceActionTypeName and processName properties in GovernanceAction entity to identify the governance action type (and any associated governance action process) that acted as a template when this governance action was initiated.
The ignoreMultipleTriggers attribute in the NextGovernanceAction has been deprecated.
Raise an issue or comment below