Set status color coding for samples, characteristics, and results
- Last UpdatedJan 21, 2025
- 3 minute read
The Sample Viewer uses colors to indicate:
-
The overall sample status, by the sample row color.
-
Whether each characteristic of a sample is out of control, by the characteristic row color.
-
Whether results are out of specification, by the color of the result row. If any of a characteristic's results are out of specification, the cells for those specifications in the characteristic row are also highlighted in this color.
These colors are defined by Sample system parameters in MES Client, in the Display group of the General Parameters module.
Set the sample, characteristic, and result status color codes
-
From the Main Data Config group in MES Client, open the General Parameters module.
The Sample Result and Sample Status color code parameters are listed in the Display group.
The following figure shows the relation between some of the Sample parameter colors and their appearance in an example list of samples in Sample Viewer.

Note that if you click a cell in a sample's characteristic row:
-
The characteristic row is highlighted in light blue
-
The background color of the selected cell is the color used to indicate the characteristic's out-of-control status or, for specification columns, the characteristic's out-of-specification status

The following table includes a description of each sample status and its default color.
|
Sample Status |
Description |
Default Color |
|---|---|---|
|
Future |
Requested for a future time |
White |
|
Ready |
The current time is greater than or equal to the requested time, less than or equal to the expiration time, and the warning interval is not Null. If the current time value is less than the sample requested time and the warning interval, the sample pulled time is NULL, and there are no results. |
Light grey |
|
Ready Warning |
The current time is less than or equal to the expiration time, the sample pulled time is Null, the current time is greater than the sample requested time and the warning interval, and there are no results. |
Dark grey |
|
Missed |
The current time is greater than the sample expiration time, the sample pulled time is Null, and there are no results. |
Orange |
|
In Progress |
The current time is greater than or equal to the requested time and less than or equal to the expiration time, there are not enough results for at least one characteristic, and either the sample pulled time is not Null or there is at least one result. |
Blue grey |
|
Late |
The current time is greater than the expiration time, there are not enough results for every characteristic, and either the sample pulled time is not Null or there is at least one result. |
Purple |
|
Complete |
The time at which the minimum number of original results in the sample is recorded (using the earliest created_at time for each value_no), is less than or equal to the sample expiration time and there are enough results for every characteristic. |
Blue |
|
Complete Late |
The time at which at least one original result in the sample at or below the minimum number is recorded, is greater than the expiration time and there are enough results for every characteristic. |
Dark blue |
|
Canceled |
The user decided not to make measurements for this sample. |
Brown |
The following table includes a description of each characteristic status and its default color.
|
Characteristic Status |
Description |
Default Color |
|---|---|---|
|
Good |
No SPC run rule violations |
Green |
|
OOC |
Out of control for non key characteristic |
Light yellow |
|
OOC Key |
Out of control for key characteristic |
Yellow |
|
OOC Critical |
Out of control for critical characteristic |
Dark yellow |
|
None |
No data yet |
White |
|
Pending |
Some variables and data are waiting to be collected and all that have been collected are within the normal range. |
Light grey |
The following table includes a description of each result out-of-specification status and its default color.
|
Result Status |
Description |
Default Color |
|---|---|---|
|
OOS |
Out of specification for non-key characteristic |
Light pink |
|
OOS Key |
Out of specification for key characteristic |
Red |
|
OOS Critical |
Out of specification for critical characteristic |
Crimson |