Skip to content

Main content

Reference Dataset Version Suffix

Encode an exact supplied dataset reference and version as an ordered record without selecting the latest version.

Loading tool…

Description

Encode an exact supplied dataset reference and version as an ordered record.

Bibliographic records distinguish editions, publication states, author identifiers, dates and fractional-credit conventions. A DOI-shaped string may not resolve, and an ORCID-shaped string can fail its checksum. Supplied status and source labels organize evidence without establishing authorship, publication validity or a complete impact measure.

Encode an exact supplied dataset reference and version as an ordered record.

When to use this tool

Use Reference Dataset Version Suffix when you already have datasetId, versionText and need to encode an exact supplied dataset reference and version as an ordered record.

How to use the tool and how it works

  1. Enter datasetId, versionText. 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 datasetId, versionText 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
datasetIdDataset IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
versionTextVersion TextRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "datasetId": "D17",
    "versionText": "v2.1"
  },
  "output": {
    "token": "[\"D17\",\"v2.1\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without selecting the latest version. 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

Check original publications, authoritative identifier records and current publisher notices. Define counting scope, credit allocation and date meaning before combining local labels or author overlaps into a bibliometric analysis.

References

  1. Calculation and input contract: bibliometrics/reference-dataset-version-suffix — tool.io

Similar or alternative tools