Description
Return literal membership of label and its zero-based index, or -1 when absent.
Gynecologic research and care records can contain specimen labels, questionnaire states, source keys, and consent flags. A local metadata check preserves a supplied convention without determining a clinical finding or verifying permission.
Return literal membership of label and its zero-based index, or -1 when absent.
When to use this tool
Use Specimen Site Label Token when you need one explicit research-record or permission-metadata component.
How to use the tool and how it works
- Enter label, suppliedLabels. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read recognized, index. Inspect recognized before interpreting the associated values.
Require distinct suppliedLabels. Return literal membership of label and its zero-based index, or -1 when absent.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| label | Formatted representation of the supplied record; not independent verification. | Required. Text; maximum UTF-16 length 8192. |
| suppliedLabels | Supplied Labels | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| recognized | Whether the token matches the supplied vocabulary or supported mapping. | Required. Boolean. |
| index | Zero-based position under the stated lookup convention, including any -1 sentinel. | Required. Safe integer. |
{
"input": {
"label": "A",
"suppliedLabels": [
"A",
"B"
]
},
"output": {
"recognized": true,
"index": 0
}
}Limitations and assumptions
- The supplied vocabulary does not establish anatomical correctness, specimen identity, site verification, or a clinical finding.
- 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 verified records, privacy and consent requirements, and appropriate professional interpretation before clinical or contact decisions.
References
Similar or alternative tools
- Specimen Side Clockface Source Pair
Map clock position to degrees clockwise from twelve, reverse the angle when mirrored, compare views literally, and serialize side, view, and clock position as sourceKey.
- Gynecologic Record Original Collection Key
Compare original with parent and return JSON-array keys for original/collection and original/collection/revision.