Struct ValidationIssue 

#[non_exhaustive]
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>,
    pub segment_group: Option<Arc<str>>,
}

A structured validation issue.

Marked #[non_exhaustive] so that new diagnostic fields (e.g. segment_group) can be added in future releases without breaking downstream code that constructs issues via struct literals. Always use ValidationIssue::new + builder methods (with_*) rather than constructing directly.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

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).

segment_group: Option<Arc<str>>

Segment group (e.g. "SG6") in which the issue occurred, if known.

Populated by group-aware rule functions when they evaluate sub-slices of a crate::group::SegmentGroupIndexed tree. None for flat-segment rules that do not have group context.

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 with_segment_group(self, group: impl Into<Arc<str>>) -> Self

Set the segment group (e.g. "SG6") in which this issue occurred.

Use this from group-aware rule functions that evaluate a sub-slice of a crate::group::SegmentGroupIndexed tree so that consumers can identify the exact group occurrence without re-reading the raw message.

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

Short label for the severity level, suitable for display.

pub fn error_code(&self) -> Option<&'static str>

Stable error code, if available.

pub fn offset(&self) -> Option<usize>

Byte offset in the source, if available.

pub fn segment_tag(&self) -> Option<&str>

Segment tag involved in this issue, if known.

pub fn rule_id(&self) -> Option<&str>

Profile/MIG rule identifier, if applicable.

pub fn element_index(&self) -> Option<u8>

Zero-based element index, if known.

pub fn component_index(&self) -> Option<u8>

Zero-based component index, if known.

pub fn segment_occurrence(&self) -> Option<u16>

Zero-based occurrence index among same-tag segments, if known.

pub fn message_ref(&self) -> Option<&str>

Message reference (UNH element 0), if set.

pub fn suggestion(&self) -> Option<&str>

Suggested remediation, if available.

pub fn segment_group(&self) -> Option<&str>

Segment group (e.g. "SG6") in which the issue occurred, if known.

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 Serialize for ValidationIssue

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ValidationIssue