Skip to content

Main content

American Newspaper Edition Letter Token

Qualify an explicit newspaper edition-letter transcription by issue without resolving publication history.

Loading tool…

Description

Qualify an explicit newspaper edition-letter transcription by issue.

American archival and publication records preserve source editions, numbering, place/date wording and documentary roles. A quarter-quarter locator describes a supplied hierarchy without resolving a parcel, and an oral-history purpose record does not verify release rights. Historical context remains part of the original source.

Qualify an explicit newspaper edition-letter transcription by issue.

When to use this tool

Use American Newspaper Edition Letter Token when you already have newspaperId, issueDateText, suppliedEditionLetter and need to qualify an explicit newspaper edition-letter transcription by issue.

How to use the tool and how it works

  1. Enter newspaperId, issueDateText, suppliedEditionLetter. 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 token. Use the output convention below.

Enter newspaperId, issueDateText, suppliedEditionLetter 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 fieldMeaning and unitsAccepted input
newspaperIdNewspaper IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
issueDateTextIssue Date TextRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
suppliedEditionLetterSupplied Edition LetterRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "newspaperId": "NEWS17",
    "issueDateText": "1950-01-02",
    "suppliedEditionLetter": "B"
  },
  "output": {
    "token": "[\"NEWS17\",\"1950-01-02\",\"B\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without resolving publication history. 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

Consult original archives, surveys, publications and permission records. Verify editions, chronology and source meanings before using local reference tokens for historical, bibliographic or legal interpretation.

References

  1. Calculation and input contract: american-studies/american-newspaper-edition-letter-token — tool.io

Similar or alternative tools