Description
Check whether a supplied occurrence voucher reference is nonblank.
Biodiversity records distinguish surveyed sites, nondetection, counts, sampling units, voucher references and source-qualified taxonomic states. A coordinate-precision label changes metadata rather than protecting a location. Relative abundance and mean count per represented unit depend on their supplied denominators and survey scope.
Check whether a supplied occurrence voucher reference is nonblank.
When to use this tool
Use Species Voucher Link Presence when you already have occurrenceId, voucherReference and need to check whether a supplied occurrence voucher reference is nonblank.
How to use the tool and how it works
- Enter occurrenceId, voucherReference. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read voucherLinked, label. Inspect voucherLinked before interpreting the associated values.
Require occurrenceId nonempty; trim only to test voucher presence, returning the original reference in the linked display or not linked otherwise.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| occurrenceId | Occurrence Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| voucherReference | Voucher Reference | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| voucherLinked | Voucher Linked | Required. Boolean. |
| label | Label | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"occurrenceId": "O17",
"voucherReference": "MUS-0017"
},
"output": {
"voucherLinked": true,
"label": "O17; voucher=MUS-0017"
}
}Limitations and assumptions
- A nonblank string does not establish a valid link, repository, specimen, identity or authenticated voucher.
- 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 specimens, original observations, sampling design and controlled taxonomic sources. Use complete detection, population and spatial methods when a local count fraction, source label or precision bin cannot answer the ecological or disclosure question.
References
Similar or alternative tools
- Biodiversity Voucher Duplicate Marker
Link supplied duplicate biodiversity voucher identifiers and repository.
- Biodiversity Taxon ID Namespace
Encode an exact supplied taxon identifier with its namespace.