Description
Preserve explicit result-return preference wording.
Biomonitoring records distinguish specimen and collection provenance, observation states, source-qualified results and supplied exposure labels. A local comparison or normalized value depends on its stated reference and measurement basis. Recorded observations do not by themselves establish exposure history, biological harm or an appropriate intervention.
Preserve explicit result-return preference wording.
When to use this tool
Use Biomonitoring Result Return Preference when you already have participantId, returnPreference, preferenceSource and need to preserve explicit result-return preference wording.
How to use the tool and how it works
- Enter participantId, returnPreference, preferenceSource. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read token. Use the output convention below.
Enter participantId, returnPreference, preferenceSource using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| participantId | Participant Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| returnPreference | Return Preference | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| preferenceSource | Preference Source | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| token | Token | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"participantId": "P17",
"returnPreference": "return requested",
"preferenceSource": "Participant form"
},
"output": {
"token": "[\"P17\",\"return requested\",\"Participant form\"]"
}
}Limitations and assumptions
- The result records supplied values without communicating results or assessing consent. Sources and asserted relationships are not independently authenticated.
- 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
Review original specimen, laboratory, collection and exposure records with the full assessment method. Verify comparability and provenance before drawing health or environmental conclusions from local flags, labels or arithmetic.
References
Similar or alternative tools
- Biomonitoring Lipid Basis Label
Preserve an explicit biomonitoring lipid-basis label.
- Biomonitoring Creatinine Basis Label
Preserve an explicit biomonitoring creatinine-basis label.