Struct ValidationIssue 

pub struct ValidationIssue {
    pub error_code: Option<&'static str>,
    pub severity: ValidationSeverity,
    pub message: String,
    pub offset: Option<usize>,
    pub segment_tag: Option<String>,
    pub rule_id: Option<String>,
    pub element_index: Option<u8>,
    pub component_index: Option<u8>,
    pub segment_occurrence: Option<u16>,
    pub message_ref: Option<String>,
    pub suggestion: Option<String>,
}

A structured validation issue.

Fields

error_code: Option<&'static str>

Stable error code, if known.

severity: ValidationSeverity

The severity of this issue.

message: String

The error or warning message.

offset: Option<usize>

Byte offset in the source (if available).

segment_tag: Option<String>

Segment tag involved (if known).

rule_id: Option<String>

Profile/MIG rule identifier, if applicable.

element_index: Option<u8>

Element index (0-based), if known.

u8 is sufficient: EDIFACT segments have at most 99 data elements per the UN/EDIFACT standard, so an index fits comfortably in one byte.

component_index: Option<u8>

Component index (0-based), if known.

u8 is sufficient: composite data elements have at most 99 components per the UN/EDIFACT standard.

segment_occurrence: Option<u16>

Zero-based occurrence index among segments with the same tag in the message.

When multiple segments share the same tag (e.g. repeated DTM lines), this field indicates which occurrence (0 = first) was the source of this issue. None when occurrence tracking is not available for this rule.

message_ref: Option<String>

Message reference (UNH element 0, DE 0062) that this issue belongs to.

Populated automatically when the context was built with ValidationContextBuilder::with_message_ref. Useful in batch processing where many messages are validated and issues from different messages must be correlated back to the originating UNH/UNT envelope.

suggestion: Option<String>

Suggested remediation (if available).

Implementations

impl ValidationIssue

pub fn new(severity: ValidationSeverity, message: impl Into<String>) -> Self

Create a new validation issue.

pub fn with_error_code(self, code: &'static str) -> Self

Set stable error code metadata.

pub fn with_offset(self, offset: usize) -> Self

Set the offset for this issue.

pub fn with_segment(self, tag: impl Into<String>) -> Self

Set the segment tag for this issue.

pub fn with_rule_id(self, rule_id: impl Into<String>) -> Self

Set the profile/MIG rule identifier for this issue.

pub fn with_element_index(self, element_index: u8) -> Self

Set the element index (0-based) for this issue.

pub fn with_component_index(self, component_index: u8) -> Self

Set the component index (0-based) for this issue.

pub fn with_suggestion(self, suggestion: impl Into<String>) -> Self

Set a suggestion for resolving this issue.

pub fn with_segment_occurrence(self, occurrence: u16) -> Self

Set the zero-based occurrence index for this issue.

Use this when the same segment tag appears multiple times in a message and you want to identify which occurrence is affected.

pub fn with_message_ref(self, message_ref: impl Into<String>) -> Self

Set the message reference (UNH element 0) for this issue.

Use this to correlate an issue back to a specific message in a multi-message interchange.

pub fn severity_label(&self) -> &'static str

Short label for the severity level, suitable for display.

Trait Implementations

impl Clone for ValidationIssue

fn clone(&self) -> ValidationIssue

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ValidationIssue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ValidationIssue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ValidationIssue

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for ValidationIssue

fn eq(&self, other: &ValidationIssue) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ValidationIssue