Description
Preserve an observation-state flag without treating an unobserved research task as failure.
Pediatric research records use chronological age, visit windows, measurement resolution, task observations, and caregiver reports. Missing observation differs from noncompletion, and a completeness share depends on its denominator. Arithmetic on supplied records is separate from a developmental or clinical assessment.
Preserve an observation-state flag without treating an unobserved research task as failure.
When to use this tool
Use Child Task Unobserved State Token when you need this age, observation, visit, measurement, or record-completeness calculation with supplied inputs.
How to use the tool and how it works
- Enter observed, completed. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read status, completionKnown. Inspect completionKnown before interpreting the associated values.
Return status=unobserved when observed=false, otherwise completed or not-completed according to completed; completionKnown equals observed.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| observed | Observed | Required. Boolean. |
| completed | Completed | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| status | Status | Required. Text; maximum UTF-16 length 8192. |
| completionKnown | Equals observed; false means completed is not interpreted. | Required. Boolean. |
{
"input": {
"observed": false,
"completed": false
},
"output": {
"status": "unobserved",
"completionKnown": false
}
}Limitations and assumptions
- Completed is ignored on the unobserved branch. These flags distinguish missing observation from task noncompletion without assessing developmental ability, task validity, or a child's health.
- 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
Use verified dates, measurement protocols, and observation definitions for the intended research question. A clinical interpretation needs the relevant age-specific assessment and context beyond the arithmetic record check.
References
Similar or alternative tools
- Child Task Response Support Share
Count distinct valid trial IDs and distinct IDs with at least one valid response-present row; return their share when nonempty, otherwise zero with defined=false.
- Caregiver Report Window Base Flag
Coverage bookkeeping for disjoint supplied direct, proxy-only and unknown reporting days.