| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Detor will validate both orders and results and alert the Public Health Laboratory (PHL) of any errors or warnings.
Errors occur when a message does not pass structural validation. For example, an HL7 format is expected but a CSV is received.
Warnings occur if data that has been deemed required is missing or invalid. For example, ‘Collection Facility’ is missing from the order message.
...
Note this validation occurs after APHL receives, transforms and translates the message to the middle-ground format.
See APHL Detor Message Validation Rules for more details.
The PHL will need to establish a process for managing these errors and warnings.
S3 Bucket
The PHL S3 Bucket is organized to “alert” on:
receipt of a new order;
receipt of an error/warning message related to an order;
receipt of an error/warning message related to a result.
The S3 bucket will be organized in a standard way for each use case, the example to the left depicts a Newborn Screening (NBS) example.
Within the Use Case parent folder, there will be a child folder for:
📁 Order: this folder contains all received order messages…
📁 Error: this folder is further divided between
📁 Order: Warning, Error and Message files related to received Orders
📁 Result: Warning, Error and Message files related to sent Results
Sample Order .err message:
{
"errorName": "JavaException",
"errorMessage": "java.net.SocketTimeoutException: Read timed out",
"stackTrace": "\tat 4cbace1a-e827-455f-846a-1e189c11291f_JavaScript_Writer_2:4916 (GetTranscodings)\n\tat 4cbace1a-e827-455f-846a-1e189c11291f_JavaScript_Writer_2:4966 (PerformTranscoding)\n\tat 4cbace1a-e827-455f-846a-1e189c11291f_JavaScript_Writer_2:1548 (ChannelOperations_InOrderMapRequest)\n\tat 4cbace1a-e827-455f-846a-1e189c11291f_JavaScript_Writer_2:6022 (doScript)\n\tat 4cbace1a-e827-455f-846a-1e189c11291f_JavaScript_Writer_2:6024\n"
}
Sample Order .warn message: