Severity Rationale
Objective
Capture and validate the severity rationale element within the Severity Scoring layer.
UAIF requirement
The incident record should implement the canonical severity_rationale field using the defined UAIF data type, validation constraints, and conditional rules.
Business impact
Supports consistent severity communication while preserving the analytical score, presentation score and calculation rationale separately.
Validation approach
Validate severity_rationale for declared JSON type and applicable conditional rules. Then review semantic consistency against the source incident evidence and the selected conformance profile.
Expected evidence
Retain the source record or analyst input for severity_rationale, schema-validation output, transformation history, selected profile, schema version and reviewer rationale where judgement is involved.
Mapping and source
UAIF Schema Specification; UAIF Technical Specification; JSON pointer /properties/severity_rationale.
Implementation guidance
Populate severity_rationale from an identified source or documented analyst decision. Enforce the schema constraints at record creation and update, preserve the original value and provenance, and surface validation failures without silently coercing data.
Assessment considerations
Sample records across normal, boundary and invalid conditions. Confirm that severity_rationale is populated only when applicable, conditional rules are enforced, provenance is retained and downstream systems do not change its meaning or precision.
Canonical schema definition
| JSON property | severity_rationale |
|---|---|
| Required in core profile | No |
| Type | "object" |
Source: UAIF Schema Specification and UAIF Core JSON Schema.