PREPROD
ReaderAuthor

piper

Import Validation Issue

An ImportValidationIssue is a record of a specific problem Piper found on a row within an ImportBatch during parsing and validation. It captures the rowIndex, field, original value, severity, issueType, a human-readable message, and an optional suggestion or overrideValue to resolve the issue before committing the batch.

1 min read · 2 depth levelsstratum-piper · vdevMatches production
Everyday

When Piper parses a lab file, it validates each row against expected formats, known analyte codes, required fields, and unit consistency. Any problem becomes an ImportValidationIssue linked to the batch via importBatchId. The severity tells you how urgent the issue is — error-level issues block the row from committing; warning-level issues allow commit but flag the row for review. The field and value fields identify exactly what was wrong in the original data, and the message explains it in plain language. If Piper can propose a fix, it records it in suggestion. A reviewer can accept that suggestion or enter their own overrideValue, then mark the issue resolved. Resolved issues record resolvedAt and resolvedBy for audit.

Technical section
Data model, API, and internals — visible to developers.
View as developer →
Was this helpful?