Description
Qualify a literal controlled metadata value by its supplied vocabulary source.
Information records distinguish identifiers, controlled vocabularies, language fallbacks, assertion times and valid times. A supplied inverse predicate differs from an inferred semantic relation. Text offsets require an explicit code-point or code-unit basis, and a metadata count check does not validate field content or an entire schema.
Qualify a literal controlled metadata value by its supplied vocabulary source.
When to use this tool
Use Metadata Controlled Value Source Key when you already have fieldCode, recordedValue, vocabularySource and need to qualify a literal controlled metadata value by its supplied vocabulary source.
How to use the tool and how it works
- Enter fieldCode, recordedValue, vocabularySource. 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 fieldCode, recordedValue, vocabularySource 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 |
|---|---|---|
| fieldCode | Field Code | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| recordedValue | Recorded Value | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| vocabularySource | Vocabulary 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": {
"fieldCode": "SUBJ",
"recordedValue": "V17",
"vocabularySource": "Vocabulary A v2"
},
"output": {
"token": "[\"SUBJ\",\"V17\",\"Vocabulary A v2\"]"
}
}Limitations and assumptions
- The result records supplied values without validating membership. 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
Use the actual record, vocabulary authority and complete metadata schema for semantic or conformance questions. Apply the identifier scheme's real comparison rules and the intended language/offset policy rather than inferring them from a local string operation.
References
Similar or alternative tools
- Metadata Language Script Pair
Preserve explicit metadata language and script tags.
- Information Source Edition Tag
Qualify explicit source-edition wording.