Description
Compare parent and aliquot labels exactly and combine both flags into matches; serialize expectedParent, sampleId, and recordedAliquot as a JSON array key.
Exact label matching answers whether supplied strings agree under a chosen vocabulary. It preserves a useful distinction between missing, unknown, ambiguous, and unrecognized records.
Compare parent and aliquot labels exactly and combine both flags into matches; serialize expectedParent, sampleId, and recordedAliquot as a JSON array key.
When to use this tool
Use Newborn Sample Parent Label Check when you need an explicit record-label comparison or deterministic key.
How to use the tool and how it works
- Enter sampleId, labelParent, expectedParent, labelAliquot, recordedAliquot. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read parentMatches, aliquotMatches, matches, key. Inspect parentMatches, aliquotMatches, matches before interpreting the associated values.
Require nonempty identifiers. Compare parent and aliquot labels exactly and combine both flags into matches; serialize expectedParent, sampleId, and recordedAliquot as a JSON array key.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| sampleId | Sample Id | Required. Text; maximum UTF-16 length 8192. |
| labelParent | Label Parent | Required. Text; maximum UTF-16 length 8192. |
| expectedParent | Expected Parent | Required. Text; maximum UTF-16 length 8192. |
| labelAliquot | Label Aliquot | Required. Text; maximum UTF-16 length 8192. |
| recordedAliquot | Recorded Aliquot | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| parentMatches | Parent Matches | Required. Boolean. |
| aliquotMatches | Aliquot Matches | Required. Boolean. |
| matches | Matches | Required. Boolean. |
| key | JSON-array serialization of the stated identifying fields, preserving exact strings. | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"sampleId": "S1",
"labelParent": "P1",
"expectedParent": "P1",
"labelAliquot": "A2",
"recordedAliquot": "A2"
},
"output": {
"parentMatches": true,
"aliquotMatches": true,
"matches": true,
"key": "[\"P1\",\"S1\",\"A2\"]"
}
}Limitations and assumptions
- A matching string is not proof of biological identity, correct sampling, or custody.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Normalize or reconcile identifiers only under a documented policy, then verify the underlying source records separately.
References
Similar or alternative tools
- Neonatal Questionnaire Proxy Role Key
Serialize them with role into a JSON array key; proxy is true for parent, guardian, or staff and false for self.
- Birth Record Duplicate Event Key
Serialize source, eventId, dayIndex, and minute as eventKey; append version for revisionKey.