Field Mapping

Internal reference for the HCHS America-250 digitization project metadata model. Click any cell in the first three columns to expand its explanation. Click again to collapse.

Our Field Source Schema PP Field PP Screen
Structural (ST) — How this item relates to others; identifiers and hierarchy
item_id VRA Core 4 — work.refid; local app primary key Object ID# Main screen
PP generates its own sequence; reconciliation needed at import
accession_no VRA Core 4 — work.refid (accession context); local YYYY.NNN.NNNNN convention Accession# Main screen
legacy_accession_no Local (pre-2026 crosswalk identifier) Old# Main screen
series_code Local organizational code (A, B, D, MU…) Other# or custom field Main screen
41.7% filled; internal HCHS code
item_number Local (two-part subseries.item-variant) Other# or custom field Main screen
41.7% filled
item_number_parsed Local (derived/normalized app key; do not edit) Object ID# (app natural key; same reconciliation as item_id) Main screen
System-derived; never manually edited
side Local structural field; PREMIS objectCharacteristics context Custom field required User-defined fields
PP has no native recto/verso field; Relations subscreen handles linking
related_item_id VRA Core 4 — relation element; PREMIS linkingObjectIdentifier Relations subscreen Relations subscreen
PP Relations links records; field stays in HCHS DB as primary
relationship_type VRA Core 4 — relation@type attribute HCHS DB only N/A
No PP equivalent; relationship type managed in HCHS system
sequence_no Local structural ordering; VRA Core 4 relation.rank context Other# or custom field Main screen
Only relevant for known ordered series
Descriptive (D) — What this item is and what it is about
title VRA Core 4 — titleSet/title; CCO title construction rules Title Main screen
PP distinguishes Title from Description — same distinction as the target model
description VRA Core 4 — descriptionSet/description; CCO scope note rules Description Main screen
creator VRA Core 4 — agentSet/agent; CCO creator rules; LCNAF Photographer / Studio Main screen
PP has two separate fields: Photographer (individual) and Studio (corporate creator)
date_created VRA Core 4 — dateSet/date; EDTF Level 1 Year Range (Earliest / Latest) Main screen
PP has two year fields for ranges; EDTF normalized form maps to these
date_created_display VRA Core 4 — date@dataDate display companion; CCO date display rules Date Main screen
subject_topical LCSH / TGM (Thesaurus for Graphical Materials); VRA Core 4 — subjectSet/subject Subject People, Subjects, Classification subscreen
PP’s Subject field is controlled by its own authority file; TGM terms map directly
subject_person VRA Core 4 — subjectSet/subject with person type; LCNAF People People, Subjects, Classification subscreen
PP has a dedicated People field separate from Subject
subject_place VRA Core 4 — locationSet/location (subject); Getty TGN Place Main screen
‘Place’ in PP = geographic subject (where depicted), NOT storage location
collection VRA Core 4 — work.source; DACS collection-level context; local authority Collection Main screen
Direct mapping; PP Collection field is controlled by authority file
category Local controlled vocabulary; People/Subjects Classification context Classification People, Subjects, Classification subscreen
PP’s Classification field on the People/Subjects subscreen is the closest match
subcategory Local controlled vocabulary (extension of category) Custom field required User-defined fields
PP has no second-level classification field; custom field needed
format_medium VRA Core 4 — materialSet/material; Getty AAT Object Name / Processing Method Main screen
PP uses two fields: Object Name (format type) and Processing Method (photographic process)
dimensions VRA Core 4 — measurementsSet/measurements; CCO dimensions rules Print Size / Dimension Details Main screen
PP has a Print Size lexicon field plus free-text Dimension Details
notes VRA Core 4 — descriptionSet/description (notes type); D/AP pillar Notes Notes & Legal subscreen
Catch-all for unstructured content that doesn’t fit other fields
Administrative – Technical (AT) — Facts about the digital file
digital_format PREMIS objectCharacteristics/format; IANA media type / PRONOM Custom field required User-defined fields
PP does not have a native digital format field; technical metadata lives in HCHS DB
file_size PREMIS objectCharacteristics/size Custom field required User-defined fields
100% filled in source data; stored in HCHS DB primarily
digital_filename PREMIS originalName; local technical reference Media File (via MultiMedia module) MultiMedia subscreen
PP links files by path via MultiMedia; filename is implicit in the linked path
digital_file_path PREMIS storage/contentLocation; local technical reference HCHS DB only N/A
Full Drive path; useful for HCHS system, not exported to PP
digital_object_id PREMIS objectIdentifier; Google Drive file ID Other# or custom field Main screen
Google Drive file ID; drives the thumbnail proxy in the curation app
drive_folder_path Local technical reference (Drive folder hierarchy) HCHS DB only N/A
Drive folder hierarchy (levels 1–5); internal use only
date_digitized PREMIS creationEvent/eventDateTime; DCMI Terms created Custom field required User-defined fields
PP has Catalog Date (when record was entered) but no separate digitization date
digitizer PREMIS creationEvent/linkingAgentIdentifier (type: creator); VRA Core 4 agent Custom field required User-defined fields
No native PP scanner-credit field; custom field or Source subscreen note
scanning_equipment PREMIS creationEvent/eventDetail (equipment context); local technical Custom field required User-defined fields
Optional; record going forward; backfill not realistic
missing_flag Local technical status; PREMIS objectCharacteristics context Status (via ‘Missing’ value) Main screen
PP uses Status field for Missing; 163 items currently flagged
item_status Local controlled vocabulary; PREMIS objectCharacteristics context Status Main screen
PP Status field is controlled by authority file; 5 source values map cleanly
Administrative – Rights (AR) — Who can use this item and under what conditions
copyright_status RightsStatements.org standardized statements; PREMIS rightsStatement Copyrights Notes & Legal subscreen
PP’s Copyrights field accepts rights text; RightsStatements.org URIs can be stored here
credit_line Local institutional standard; DCMI Terms publisher context; CCO credit line rules Credit Line Source subscreen
Standard text; same value for every HCHS item
donor_restrictions Local rights field; DACS conditions governing access context Notes (Notes & Legal subscreen) Notes & Legal subscreen
PP has no dedicated donor restrictions field; Notes subscreen is the fallback
reproduction_rights Local rights field; PREMIS rightsStatement (reproduction context) Copyrights Notes & Legal subscreen
Shares PP Copyrights field with copyright_status; label clearly
Administrative – Provenance (AP) — Where this came from and who has touched it
donor_provenance DACS immediate source of acquisition; VRA Core 4 sourceSet/source; LCNAF Source Source subscreen
PP Source field on Source subscreen; controlled by PP People Authority File
custodial_history DACS custodial history (Element 5.1); PREMIS significantProperties context Provenance Source subscreen
PP has a dedicated Provenance field for ownership history narrative
storage_location Local administrative field; DACS physical access context Home Location Location subscreen
‘Location’ in PP = physical storage, NOT geographic subject; entirely separate from PP ‘Place’
print_present Local physical condition indicator Condition / Notes Condition subscreen / Notes & Legal
1.9% filled; indicates whether a physical print exists alongside the negative or scan
negative_present Local physical condition indicator Condition / Notes Condition subscreen / Notes & Legal
1.0% filled; indicates whether a physical negative is held
copy_count Local administrative field Copy# / Number of Objects Main screen
0.4% filled; PP has a copy count field natively
date_cataloged DCMI Terms dcterms:created (for the record); PREMIS creationEvent (record creation) Catalog Date Main screen
PP Catalog Date records when the PP record was entered, not when the item was first cataloged in any system
Scroll to Top