Description
Return the preferred name with consent or participant code otherwise.
Identity and survey records can preserve a person's stated wording, display preference, source, and missing-value convention. A formatter should not infer an identity or turn a recorded label into permission for publication.
Return the preferred name with consent or participant code otherwise.
When to use this tool
Use Survey Name Field Display Choice when you need to organize supplied identity-related record fields while preserving their stated scope.
How to use the tool and how it works
- Enter preferredDisplayName, participantCode, displayConsent. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read displayLabel. Use the output convention below.
Require nonempty participantCode and, when displayConsent, a preferredDisplayName containing nonwhitespace text. Return the preferred name with consent or participant code otherwise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| preferredDisplayName | Preferred Display Name | Required. Text; maximum UTF-16 length 8192. |
| participantCode | Participant Code | Required. Text; maximum UTF-16 length 8192. |
| displayConsent | Display Consent | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| displayLabel | Display Label | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"preferredDisplayName": "Alex",
"participantCode": "P-17",
"displayConsent": true
},
"output": {
"displayLabel": "Alex"
}
}Limitations and assumptions
- This uses supplied display consent without verifying identity, current authorization, privacy risk, or whether the preferred name is correct.
- 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
Confirm preferences, consent, source wording, and the purpose of collection before displaying or combining personal records.
References
Similar or alternative tools
- Selfidentified Gender Response Literal Preserver
Return response unchanged and count its Unicode code points.
- Community Approved Name Capitalization Rule
Accept preserve, upper, or lower and return name unchanged or JavaScript uppercase/lowercase respectively.