Description
Build an unambiguous specimen catalogue key from supplied institutional fields while preserving leading zeros.
Taxonomic records preserve author wording, publication sources, parent assignments and nomenclatural context. Parenthesizing an author is a formatting choice, and a supplied year field need not be restricted to modern calendar years. A source-qualified relationship does not establish accepted classification, valid publication or identity.
Build an unambiguous specimen catalogue key from supplied institutional fields while preserving leading zeros.
When to use this tool
Use Type Specimen Catalogue ID when you already have institutionCode, collectionCode, catalogueNumber and need to build an unambiguous specimen catalogue key from supplied institutional fields while preserving leading zeros.
How to use the tool and how it works
- Enter institutionCode, collectionCode, catalogueNumber. 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 institutionCode, collectionCode, catalogueNumber 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 |
|---|---|---|
| institutionCode | Institution Code | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| collectionCode | Collection Code | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| catalogueNumber | Catalogue Number | 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": {
"institutionCode": "INST17",
"collectionCode": "COL2",
"catalogueNumber": "00042"
},
"output": {
"token": "[\"INST17\",\"COL2\",\"00042\"]"
}
}Limitations and assumptions
- The record preserves supplied identifiers, wording and provenance; it does not authenticate the source, resolve an identifier, retrieve evidence or verify the asserted relationship.
- 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 relevant specimens, original publications and controlled nomenclatural sources. Use complete taxonomic evidence and applicable codes for a classification decision; local formatting and keys do not adjudicate names or relationships.
References
Similar or alternative tools
- Specimen Original Determination Label
Qualify an explicit original specimen determination by record source.
- Nomenclature Type Status Code
Qualify an explicit nomenclatural type-status code by source.