Description
Classify a recorded screening-invitation response using two supplied codes.
Public-health data distinguishes assigned case definitions, invitation responses, missing codes, repeat attendances and population denominators. A display-suppression rule changes visible text without necessarily preventing re-identification. Administrative labels and local summaries require verified study, privacy and clinical context before they can support population-health decisions.
Classify a recorded screening-invitation response using two supplied codes.
When to use this tool
Use Screening Invitation Response Code when you already have invitationId, responseCode, acceptedCode, declinedCode and need to classify a recorded screening-invitation response using two supplied codes.
How to use the tool and how it works
- Enter invitationId, responseCode, acceptedCode, declinedCode. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read status. Use the output convention below.
Require invitationId nonempty and acceptedCode!=declinedCode. Return recorded-accepted, recorded-declined or other-or-unrecorded by literal equality.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| invitationId | Invitation Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| responseCode | Response Code | Required. Text; maximum UTF-16 length 8192. |
| acceptedCode | Must differ from declinedCode; empty tokens are not independently forbidden by this comparator. | Required. Text; maximum UTF-16 length 8192. |
| declinedCode | Declined Code | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| status | Status | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"invitationId": "I17",
"responseCode": "Y",
"acceptedCode": "Y",
"declinedCode": "N"
},
"output": {
"status": "recorded-accepted"
}
}Limitations and assumptions
- Codes may be empty when otherwise allowed; an invitation response does not establish valid consent, attendance or screening suitability.
- 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 the surveillance definition, survey codebook and population frame for actual counts and classifications. Assess disclosure controls across the full released dataset, including linked totals and repeated queries, rather than relying on one small-cell display rule.
References
Similar or alternative tools
- Health Survey Nonresponse Code
Distinguish missing and refused survey response codes.
- Psychiatric Questionnaire Missing Code
Check a psychiatric questionnaire response against supplied missing codes.