Skip to content

Main content

Historical Person Name Variant Link Tool

Encode a supplied person-record/name-variant/source association without resolving identity from a name.

Loading tool…

Description

Require nonempty personRecordId, nameVariant, and sourceId and serialize the tuple as linkToken.

Archival records often contain bounded dates, editions, and source identifiers. Arithmetic on supplied coordinates can check consistency while leaving historical interpretation and authenticity unresolved.

Require nonempty personRecordId, nameVariant, and sourceId and serialize the tuple as linkToken.

When to use this tool

Use Historical Person Name Variant Link when you need a precise date-span or source-record bookkeeping step.

How to use the tool and how it works

  1. Enter personRecordId, nameVariant, sourceId. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read linkToken. Use the output convention below.

Require nonempty personRecordId, nameVariant, and sourceId and serialize the tuple as linkToken.1

Input fieldMeaning and unitsAccepted input
personRecordIdPerson Record IdRequired. Text; maximum UTF-16 length 8192.
nameVariantName VariantRequired. Text; maximum UTF-16 length 8192.
sourceIdIdentifier used to retain the supplied source context.Required. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
linkTokenLink TokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "personRecordId": "P12",
    "nameVariant": "Johannes",
    "sourceId": "S7"
  },
  "output": {
    "linkToken": "[\"P12\",\"Johannes\",\"S7\"]"
  }
}

Limitations and assumptions

  • This preserves an asserted variant link without determining personal identity, language equivalence, preferred naming, or source accuracy.
  • 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 catalog and documented calendar or dating convention when historical interpretation matters.

References

  1. Calculation and input contract: history/historical-person-name-variant-link — tool.io

Similar or alternative tools