Skip to main content
Version: 1.10.1

Create Known Errors and Produce Workarounds

tip

Role required: problem_manager.

You can reduce or eliminate the impact of a problem that cannot be resolved by creating a known error record with a workaround. The created workaround can also be useful for resolving related problems and incidents.

Create a known error


If you cannot resolve a problem, create a known error record in the Known Error Database (KEDB) and assign to it a workaround suited for the problem.

To create a known error, follow the steps below:

  1. Navigate to Problem Management → All Problems and select the problem you need to create a known error from.
  2. In the top right corner, click the Create Known Error button.
  3. Fill in the form.
  4. Click Save or Save and exit to apply the changes.

Reference to the created known error is automatically inserted into the Known error field on the Related Records tab of the problem form.

Known Error form fields

The Number field is populated automatically and has the KEXXXXXXX format.

FieldMandatoryDescription
NameYSpecify a name for the known error.
DescriptionNAdd a detailed description of the known error.
Content DBYDefines the content type of the Knowledge Database. It is automatically filled with the KEDB value.
KB CategoryNAutomatically filled with the Known error value.
Content Item ClassYAutomatically filled with the Known error value.
WorkaroundYAdd a detailed workaround for resolving the problem.
MetainfoNFill in the field with the metadata.
StateYSpecify the current state of the known error by selecting one of the possible values:
  • Draft – the known error is created but is not approved yet.
  • Waiting for approval – the known error was sent for approval to the service owner.
  • Actual – the known error is approved by the service owner and can be used to process problems and incidents.
  • Fixed – the problem has been resolved, so the workaround is no longer needed.
  • Retired – this state is assigned to a known error if the related problem was created erroneously or could not be reproduced.
ServiceNSelect the service that the known error is related to. This field is automatically filled when a known error is created from a particular problem.
ProblemYThe field is automatically populated with a reference to the problem, the known error is created from. It is read-only.
Responsible groupYSpecify the group assigned to work on the known error.
When a known error is assigned to a group, the Responsible user field becomes non-mandatory.
Responsible userYSpecify the person assigned to work on the known error.
When a known error is assigned to a group, the Responsible group field becomes non-mandatory.

Add an existing known error


To relate the problem to an existing known error, follow the steps below:

  1. Navigate to Problem Management → All Problems and select the required problem.
  2. On the Related Records tab, click the magnifier icon next to the Known Error field.
  3. In the window that appears, select the required known error record.
  4. In the problem form, click Save or Save and exit to apply the changes.

Known error approval


Before a problem can be classified as a known error, it must be approved by the service owner. A newly created Known Error record has the Draft state. When the state is changed to Waiting for approval, an approval ticket is automatically created and sent to the service owner. Before a Known Error record is approved, the state of the problem remains the same. If the known error is approved, the state of the problem is automatically changed to Known error. If the service owner rejects the known error, a notification is sent to the known error creator with a reason of rejection. If there is no service owner, the approval is skipped.

Known error state model


The following diagram illustrates the state model of known errors.

The following table lists and describes the available state transitions for known errors.

StateDescriptionAvailable transitions
DraftThis state is assigned to a known error after it is created or to a known error rejected by the Service Owner.Waiting for approval
Waiting for approvalThis state is assigned to a known error when a user submits it for approval to the service owner.
  • Actual (automatic after approval)
  • Draft (automatic after rejection)
ActualThe known error automatically transitions into this state when approved by the service owner.
  • Fixed
  • Draft
  • Retired
FixedThe known error automatically transitions into this state from the Actual state when the related problem is closed with either of the following closure codes:
  • Solved 1st level
  • Solved 2nd level
  • Actual
  • Draft
  • Retired
RetiredThe known error automatically transitions into this state from the Actual or Fixed state when the related problem is closed with either of the following closure codes:
  • Not solved (Refused)
  • Not solved (Dropped)
  • Actual
  • Fixed
  • Draft