Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Field Families

This is a navigation index for the 20 concrete field families defined by the spec. Each row links to the family’s four principal productions in grammar.md:

  • Field artifact — the family’s XxxField, a standalone reusable artifact.
  • Field spec — the family’s XxxFieldSpec, carried by the standalone Field artifact.
  • Value — the family’s instance-value production (XxxValue), carried by a FieldValue in a TemplateInstance.
  • Embedded form — the family’s EmbeddedXxxField, used inside a Template’s members to reference the standalone field.

The conformance fixture column points at the per-family Template + Instance pair under normative-tests/valid/ and the standalone Field artifact.

Scalar text and numeric

Temporal

FamilyField artifactField specValueEmbedded formFixtures
DateDateFieldDateFieldSpecDateValue (three arms: FullDateValue, YearValue, YearMonthValue)EmbeddedDateField1318, 54
TimeTimeFieldTimeFieldSpecTimeValueEmbeddedTimeField1920, 55
Date-timeDateTimeFieldDateTimeFieldSpecDateTimeValueEmbeddedDateTimeField2122, 56

Controlled vocabulary

Reference and contact

External-authority identifiers

Open-ended

FamilyField artifactField specValueEmbedded formFixtures
Attribute valueAttributeValueFieldAttributeValueFieldSpecAttributeValueEmbeddedAttributeValueField4748, 72

Notes on the groupings

The groupings above are presentational, not normative. The spec does not partition field families into categories at the grammar level; every family is structurally a peer of every other under FieldSpec. The groupings here exist only to make this index easier to scan.

The four §9-of-serialization.md family-specific deviations are worth recalling at the embedding site:

  • EmbeddedBooleanField and EmbeddedSingleValuedEnumField omit cardinality (single-valued by construction).
  • EmbeddedMultiValuedEnumField.defaultValue is EnumValue* (a sequence).
  • EmbeddedAttributeValueField omits defaultValue.

The six external-authority identifier families (ORCID, ROR, DOI, PubMed, RRID, NIH grant) all share an identical XxxFieldSpec shape — { "kind": "<Family>FieldSpec" } with no per-family slots — but distinct value productions carrying typed IRIs.