Skip to content

Main content

Public Register Volume Token Tool

Preserve a supplied public register volume token without interpreting numbering systems.

Loading tool…

Description

Serialize repository, series and volumeToken as a JSON-array source key, and flag volume presence by trimmed nonempty text.

Historical and public-register references combine repositories, series, titles and local identifiers. A syntactic token or hierarchy count helps organize records without authenticating the source or establishing a document's historical or legal meaning.

Serialize repository, series and volumeToken as a JSON-array source key, and flag volume presence by trimmed nonempty text.

When to use this tool

Use Public Register Volume Token when you need a literal archival or public-register record operation.

How to use the tool and how it works

  1. Enter volumeToken, series, repository. 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 sourceKey, hasVolume. Inspect hasVolume before interpreting the associated values.

Serialize repository, series and volumeToken as a JSON-array source key, and flag volume presence by trimmed nonempty text.1

Input fieldMeaning and unitsAccepted input
volumeTokenVolume TokenRequired. Text; maximum UTF-16 length 8192.
seriesSeriesRequired. Text; maximum UTF-16 length 8192.
repositoryRepositoryRequired. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
sourceKeyJSON-array serialization of the stated supplied reference components.Required. Text; maximum UTF-16 length 8192.
hasVolumeHas VolumeRequired. Boolean.
json
{
  "input": {
    "volumeToken": "IV",
    "series": "births",
    "repository": "archive-A"
  },
  "output": {
    "sourceKey": "[\"archive-A\",\"births\",\"IV\"]",
    "hasVolume": true
  }
}

Limitations and assumptions

  • The original volume spelling, including whitespace, stays in the key. No repository source, catalog entry, access rights or historical identity is verified.
  • 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 source repository's catalog and description conventions for identity and interpretation. Preserve original references and resolve language, hierarchy and identifier rules before treating a token match as an authenticated record.

References

  1. Calculation and input contract: european-studies/public-register-volume-token — tool.io

Similar or alternative tools

  • Public Register Series Depth

    Count collectionParts and seriesParts and add one to combinedDepth only when includeCollectionRoot.

  • Public Register Folio Token

    Accept exactly one matching suffix whose preceding tail is a positive integer without leading zero, and return folio number and side token.