Description
Preserve an explicitly supplied community preferred-name and period label.
Community-supplied names, credits, permissions and source versions carry their own authority and context. A recorded access or precision label does not itself grant permission or hide a location. Preserving requested wording and attribution order is distinct from authenticating rights, community approval or adequate protection.
Preserve an explicitly supplied community preferred-name and period label.
When to use this tool
Use Community Preferred Name Period Label when you already have communityRecordId, suppliedPreferredName, applicablePeriodText and need to preserve an explicitly supplied community preferred-name and period label.
How to use the tool and how it works
- Enter communityRecordId, suppliedPreferredName, applicablePeriodText. 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 communityRecordId, suppliedPreferredName, applicablePeriodText 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 |
|---|---|---|
| communityRecordId | Community Record Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| suppliedPreferredName | Supplied Preferred Name | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| applicablePeriodText | Applicable Period Text | 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": {
"communityRecordId": "C17",
"suppliedPreferredName": "Preferred name A",
"applicablePeriodText": "Period A"
},
"output": {
"token": "[\"C17\",\"Preferred name A\",\"Period A\"]"
}
}Limitations and assumptions
- The result records supplied values without choosing a name or asserting present usage. 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
Consult the original community-provided permissions, attribution instructions and controlled records for actual use. Apply access and location protection to the underlying material, rather than treating a display mask or status label as the complete safeguard.
References
Similar or alternative tools
- Community Resource Explicit Access Date
Preserve explicit community-resource access-date and permission-reference metadata.
- Community Supplied Metadata Namespace Code
Qualify an explicit community-supplied metadata field code by namespace and version.