1145 lines
38 KiB
YAML
1145 lines
38 KiB
YAML
id: https://nde.nl/ontology/hc/class/FindingAid
|
|
name: finding_aid_class
|
|
title: FindingAid Class
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
rico: https://www.ica.org/standards/RiC/ontology#
|
|
crm: http://www.cidoc-crm.org/cidoc-crm/
|
|
bf: http://id.loc.gov/ontologies/bibframe/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
dcterms: http://purl.org/dc/terms/
|
|
schema: http://schema.org/
|
|
wd: http://www.wikidata.org/entity/
|
|
prov: http://www.w3.org/ns/prov#
|
|
foaf: http://xmlns.com/foaf/0.1/
|
|
xsd: http://www.w3.org/2001/XMLSchema#
|
|
default_prefix: hc
|
|
default_range: string
|
|
imports:
|
|
- linkml:types
|
|
- ./FindingAidType
|
|
- ./WebClaim
|
|
- ./Overview
|
|
- ./WebLink
|
|
- ../slots/temporal_extent # was: valid_from + valid_to - migrated per Rule 53
|
|
- ./TimeSpan
|
|
# REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
|
|
- ../slots/id
|
|
- ../slots/description
|
|
- ../slots/has_or_had_content # was: temporal_coverage - migrated per Rule 53/56 (2026-01-16)
|
|
- ./Content
|
|
- ../slots/has_or_had_access_restriction
|
|
- ../slots/has_or_had_web_claim
|
|
- ../slots/language
|
|
- ../slots/supersedes_or_superseded # was: supersede - migrated per Rule 53/56 (2026-01-17)
|
|
- ../slots/is_or_was_superseded_by # was: superseded_by - migrated per Rule 53/56 (2026-01-16)
|
|
- ../slots/revision_date
|
|
- ../slots/served_by
|
|
- ../slots/retrieval_agent
|
|
- ../slots/extraction_note
|
|
- ../slots/extraction_method
|
|
# REMOVED: ../slots/xpath - migrated to has_or_had_provenance_path with XPath class (2026-01-15, Rule 53)
|
|
- ../slots/has_or_had_provenance_path
|
|
- ./XPath
|
|
- ../slots/css_selector
|
|
# REMOVED 2026-01-19: ../slots/confidence - migrated to is_or_was_generated_by + GenerationEvent + ConfidenceScore (Rule 53)
|
|
- ../slots/is_or_was_generated_by
|
|
- ./GenerationEvent
|
|
- ./ConfidenceScore
|
|
- ./ConfidenceMethod
|
|
- ../slots/html_file
|
|
# REMOVED 2026-01-18: ../slots/claim_id - migrated to has_or_had_identifier + Identifier (Rule 53)
|
|
- ../slots/has_or_had_identifier
|
|
- ./Identifier
|
|
# REMOVED 2026-01-19: ../slots/claim_type - migrated to has_or_had_type + ClaimType (Rule 53)
|
|
# REMOVED 2026-01-18: ../slots/claim_value - migrated to has_or_had_content + Content (Rule 53) - import via WebClaim
|
|
- ../slots/source_url
|
|
- ../slots/has_or_had_label # was: title - migrated per Rule 53
|
|
- ../slots/date
|
|
- ../slots/note
|
|
- ../slots/creator
|
|
# REMOVED 2026-01-17: ../slots/publisher - migrated to has_or_had_publisher + Publisher (Rule 53/56)
|
|
- ../slots/has_or_had_publisher
|
|
- ./Publisher
|
|
# - ../slots/publication_date # ARCHIVED 2026-01-17 - migrated per Rule 53/56
|
|
- ../slots/is_or_was_published_at # was: publication_date - migrated per Rule 53/56 (2026-01-17)
|
|
- ./PublicationEvent # for is_or_was_published_at range
|
|
- ./Quantity # for has_or_had_quantity range (was: claims_count) - added 2026-01-19
|
|
- ../slots/isbn
|
|
- ../slots/has_or_had_access_condition
|
|
- ../slots/is_or_was_access_restricted
|
|
- ../slots/has_or_had_comprehensive_overview
|
|
# REMOVED 2026-01-22: card_description, card_description_en → has_or_had_description + Description (with language tag) per slot_fixes.yaml
|
|
# MIGRATED 2026-01-22: card_image_url → has_or_had_image + Image per slot_fixes.yaml
|
|
- ../slots/has_or_had_image
|
|
- ./Image
|
|
# MIGRATED 2026-01-22: card_title, card_title_en → has_or_had_label + Label (multivalued with language) per slot_fixes.yaml
|
|
# NOTE: has_or_had_label already imported elsewhere in this file
|
|
# MIGRATED 2026-01-22: card_url → has_or_had_url + URL per slot_fixes.yaml
|
|
# NOTE: has_or_had_url already imported elsewhere in this file
|
|
- ../slots/has_or_had_quantity # was: claims_count - migrated per Rule 53 (2026-01-19)
|
|
# REMOVED 2026-01-22: ../slots/colonial - migrated to includes_or_included + GeoSpatialPlace + is_or_was_categorized_as + ColonialStatus (Rule 53)
|
|
- ../slots/includes_or_included
|
|
- ./GeoSpatialPlace
|
|
- ../slots/is_or_was_categorized_as
|
|
- ./ColonialStatus
|
|
- ../slots/content_block
|
|
- ../slots/crawler_version
|
|
- ../slots/custodian
|
|
- ../slots/was_retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
- ./Timestamp
|
|
- ../slots/de
|
|
# MIGRATED 2026-01-25: ead_id → has_or_had_identifier + EADIdentifier (Rule 53)
|
|
- ../slots/has_or_had_identifier
|
|
- ./Identifier
|
|
- ./EADIdentifier
|
|
- ../slots/ead_id
|
|
- ../slots/en
|
|
- ../slots/end
|
|
- ../slots/has_or_had_external_resource
|
|
- ../slots/has_or_had_featured_item
|
|
- ../slots/finding_aid_note
|
|
- ../slots/finding_aid_scope_note
|
|
- ../slots/has_or_had_type
|
|
# MIGRATED 2026-01-22: format → has_or_had_format + Format (Rule 53)
|
|
- ../slots/has_or_had_format
|
|
- ./Format
|
|
# MIGRATED 2026-01-22: fr → has_or_had_language + Language (Rule 53)
|
|
- ../slots/has_or_had_language
|
|
- ./Language
|
|
- ../slots/full_name
|
|
- ../slots/geographic_coverage
|
|
- ../slots/ghcid
|
|
- ../slots/heading_level
|
|
- ../slots/heading_text
|
|
- ../slots/heading_text_en
|
|
- ../slots/historical_region
|
|
- ../slots/html_snapshot_path
|
|
- ../slots/inbound_from
|
|
- ../slots/international
|
|
- ../slots/is_sub_guide
|
|
- ../slots/isil
|
|
- ../slots/has_or_had_key_archive
|
|
- ../slots/has_or_had_key_date
|
|
- ../slots/has_or_had_key_period
|
|
- ../slots/link_context
|
|
- ../slots/link_text
|
|
- ../slots/link_type
|
|
- ../slots/link_url
|
|
- ../slots/list_item
|
|
- ../slots/location
|
|
- ../slots/major_city
|
|
- ../slots/name
|
|
- ../slots/nl
|
|
- ../slots/outbound_to
|
|
- ../slots/has_or_had_page_section
|
|
- ../slots/period
|
|
- ../slots/period_description
|
|
- ../slots/period_end
|
|
- ../slots/period_name
|
|
- ../slots/period_start
|
|
- ../slots/has_or_had_period
|
|
- ../slots/permission_required
|
|
- ../slots/primary
|
|
- ../slots/provenance
|
|
- ../slots/related
|
|
- ../slots/has_or_had_related_archive
|
|
- ../slots/has_or_had_related_guide
|
|
- ../slots/relationship
|
|
- ../slots/resource_description
|
|
- ../slots/restriction_description
|
|
- ../slots/restriction_type
|
|
- ../slots/scope
|
|
- ../slots/secondary
|
|
- ../slots/section_id
|
|
- ../slots/has_or_had_section_link
|
|
- ../slots/slug
|
|
- ../slots/specificity_annotation
|
|
- ../slots/start
|
|
- ../slots/has_or_had_description # was: sub_guide_description - migrated per Rule 53
|
|
- ./Description
|
|
# REMOVED: ../slots/sub_guide_temporal_coverage - migrated to has_or_had_content (2026-01-17, Rule 53/56)
|
|
- ./SubGuideType
|
|
- ../slots/has_or_had_sub_guide
|
|
- ../slots/has_or_had_sub_section
|
|
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
# REMOVED: ../slots/title_en - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
|
|
# REMOVED: ../slots/title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
|
|
- ../slots/has_or_had_label
|
|
- ./Label
|
|
# REMOVED: ../slots/topic - migrated to is_or_was_categorized_as with Topic class (2026-01-15, Rule 53)
|
|
- ../slots/is_or_was_categorized_as
|
|
- ./Topic
|
|
- ./TopicType
|
|
- ./TopicTypes
|
|
# REMOVED: ../slots/type - migrated to has_or_had_type (2026-01-15, Rule 53)
|
|
- ../slots/has_or_had_type # was: type - migrated per Rule 53 (2026-01-15)
|
|
# REMOVED: ../slots/url - migrated to has_or_had_url with URL class (2025-01-15, Rule 53)
|
|
- ../slots/has_or_had_url
|
|
- ./URL
|
|
# REMOVED 2026-01-14: ../slots/validation_status - migrated to has_or_had_status with ValidationStatus
|
|
- ../slots/has_or_had_status
|
|
- ./ValidationStatus
|
|
- ../slots/is_or_was_instance_of # was: ../slots/wikidata - migrated per Rule 53 (2026-01-15)
|
|
# REMOVED: ../slots/wikidata_class - migrated to is_or_was_instance_of with WikiDataEntry (2026-01-14, Rule 53)
|
|
- ../slots/is_or_was_instance_of
|
|
- ./WikiDataEntry
|
|
- ../slots/has_or_had_restriction
|
|
- ./Restriction
|
|
- ./FindingAid
|
|
- ./PersonWebClaim
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
|
|
|
|
- ./TemplateSpecificityType
|
|
|
|
- ./TemplateSpecificityTypes
|
|
- ./TimeSpan
|
|
- ../slots/finding_aid_description
|
|
- ../slots/finding_aid_temporal_coverage
|
|
- ../slots/finding_aid_access_restriction
|
|
- ../slots/has_link
|
|
# REMOVED 2026-01-26: event, event_en - migrated to has_or_had_description + Description (Rule 53)
|
|
# - ../slots/event
|
|
# - ../slots/event_en
|
|
# REMOVED 2026-01-18: ../slots/claim_source_url - unused import, slot migrated to has_or_had_url + URL (Rule 53)
|
|
- ../enums/ExternalResourceTypeEnum
|
|
- ../enums/SubGuideTypeEnum
|
|
- ../enums/RelationshipTypeEnum
|
|
- ../enums/LinkTypeEnum
|
|
classes:
|
|
FindingAid:
|
|
class_uri: rico:FindingAid
|
|
description: 'A finding aid - a descriptive tool that establishes intellectual and physical
|
|
|
|
control over heritage materials by describing them and facilitating access.
|
|
|
|
|
|
**DEFINITION** (RiC-O):
|
|
|
|
|
|
"A finding aid is a set of descriptions that identifies, locates, summarizes,
|
|
|
|
and indexes materials in a record-holding organization, typically archives,
|
|
|
|
libraries, or museums."
|
|
|
|
|
|
This class captures the descriptive metadata for finding aids produced by
|
|
|
|
heritage custodians to facilitate access to their collections. It supports:
|
|
|
|
|
|
- Multilingual titles and descriptions (nl, en, etc.)
|
|
|
|
- Classification via FindingAidType hierarchy
|
|
|
|
- Custodian linkage via GHCID, ISIL, Wikidata
|
|
|
|
- Topic/subject indexing
|
|
|
|
- Temporal and geographic coverage
|
|
|
|
- References to sub-guides and external resources
|
|
|
|
- Key archives and related archives
|
|
|
|
- Related guides within the repository
|
|
|
|
- Provenance tracking for web-harvested data
|
|
|
|
- Page structure with web claims and XPath provenance
|
|
|
|
|
|
- RiC-O: rico:FindingAid
|
|
|
|
- Dublin Core: dcterms:BibliographicResource
|
|
|
|
- Schema.org: schema:CreativeWork
|
|
|
|
- CIDOC-CRM: crm:E31_Document
|
|
|
|
- BIBFRAME: bf:Work
|
|
|
|
|
|
**EXAMPLE FILES**:
|
|
|
|
|
|
See data/custodian/findingaid/NL-ZH-DHA-A-NA/guide/repository_guide/metadata/
|
|
|
|
'
|
|
exact_mappings:
|
|
- rico:FindingAid
|
|
close_mappings:
|
|
- dcterms:BibliographicResource
|
|
- schema:CreativeWork
|
|
- crm:E31_Document
|
|
- bf:Work
|
|
slots:
|
|
- finding_aid_access_restriction
|
|
- has_or_had_comprehensive_overview
|
|
- creator
|
|
- custodian
|
|
- finding_aid_description
|
|
# MIGRATED 2026-01-25: ead_id → has_or_had_identifier (Rule 53)
|
|
- has_or_had_identifier
|
|
- has_or_had_external_resource
|
|
- finding_aid_note
|
|
- has_or_had_type
|
|
- has_or_had_format # was: format - migrated per Rule 53 (2026-01-22)
|
|
- geographic_coverage
|
|
- id
|
|
- isbn
|
|
- has_or_had_key_archive
|
|
- language
|
|
- note
|
|
- has_or_had_page_section
|
|
- provenance
|
|
- is_or_was_published_at # was: publication_date - migrated per Rule 53/56 (2026-01-17)
|
|
- has_or_had_publisher # was: publisher - migrated per Rule 53/56 (2026-01-17)
|
|
- has_or_had_related_archive
|
|
- has_or_had_related_guide
|
|
- revision_date
|
|
- finding_aid_scope_note
|
|
- served_by
|
|
- slug
|
|
- specificity_annotation
|
|
- has_or_had_sub_guide
|
|
- is_or_was_superseded_by # was: superseded_by - migrated per Rule 53/56 (2026-01-16)
|
|
- supersedes_or_superseded # was: supersede - migrated per Rule 53/56 (2026-01-17)
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- finding_aid_temporal_coverage
|
|
- has_or_had_label # was: title
|
|
- is_or_was_categorized_as # was: topic - migrated per Rule 53 (2026-01-15)
|
|
- has_or_had_url # was: url - migrated per Rule 53 (2025-01-15)
|
|
- temporal_extent # was: valid_from + valid_to - migrated per Rule 53
|
|
- has_or_had_web_claim
|
|
# REMOVED: wikidata_class - migrated to is_or_was_instance_of with WikiDataEntry (2026-01-14, Rule 53)
|
|
- is_or_was_instance_of
|
|
slot_usage:
|
|
id:
|
|
identifier: true
|
|
required: true
|
|
slug:
|
|
required: true
|
|
# MIGRATED 2026-01-25: ead_id → has_or_had_identifier (Rule 53)
|
|
has_or_had_identifier:
|
|
range: EADIdentifier
|
|
description: |
|
|
EAD Identifier for the finding aid.
|
|
MIGRATED from ead_id (string) to EADIdentifier class per Rule 53.
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
identifier_value: "NL-HaNA_2.21.006.50"
|
|
identifier_scheme: "EAD"
|
|
description: National Archives EAD identifier
|
|
has_or_had_type:
|
|
required: true
|
|
range: FindingAidType
|
|
description: |
|
|
The type classification of this finding aid.
|
|
Uses FindingAidType class hierarchy.
|
|
has_or_had_label: # was: title
|
|
required: true
|
|
has_or_had_url:
|
|
range: URL
|
|
inlined: true
|
|
required: true
|
|
description: |
|
|
URL of the finding aid web resource.
|
|
MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
|
|
custodian:
|
|
required: true
|
|
finding_aid_description:
|
|
range: MultilingualText
|
|
inlined: true
|
|
finding_aid_temporal_coverage:
|
|
range: TemporalCoverage
|
|
inlined: true
|
|
finding_aid_access_restriction:
|
|
range: AccessRestriction
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
has_or_had_web_claim:
|
|
range: WebClaim
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
language:
|
|
multivalued: true
|
|
has_or_had_comprehensive_overview:
|
|
range: Overview
|
|
inlined: true
|
|
description: |
|
|
Comprehensive collection of all links from this finding aid.
|
|
Replaces previous all_links slot with typed Overview class.
|
|
is_or_was_categorized_as:
|
|
range: Topic
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
description: |
|
|
Subject topics covered by this finding aid.
|
|
MIGRATED from topic slot per slot_fixes.yaml (Rule 53, 2026-01-15).
|
|
|
|
Uses Topic class with TopicType classification.
|
|
examples:
|
|
- value: |
|
|
- has_or_had_type: GenealogyTopic
|
|
has_or_had_label:
|
|
- label_value: "Genealogy"
|
|
language_code: "en"
|
|
description: Genealogy topic assignment
|
|
has_or_had_publisher: # was: publisher - migrated per Rule 53/56 (2026-01-17)
|
|
range: Publisher
|
|
inlined: true
|
|
multivalued: true
|
|
required: false
|
|
description: |
|
|
Publisher of the finding aid publication.
|
|
MIGRATED from publisher slot per Rule 53/56 (2026-01-17).
|
|
|
|
Uses Publisher class for structured representation including:
|
|
- Publisher name (required)
|
|
- Publisher type (institutional, commercial, academic)
|
|
- Location
|
|
- Identifiers
|
|
examples:
|
|
- value:
|
|
has_or_had_label: Nationaal Archief
|
|
has_or_had_type: institutional
|
|
has_or_had_location: Den Haag
|
|
description: National archive as institutional publisher
|
|
- value:
|
|
has_or_had_label: Rijksarchiefdienst
|
|
has_or_had_type: government
|
|
has_or_had_location: Den Haag
|
|
description: Government archival service publisher
|
|
comments:
|
|
- Root class for finding aid metadata YAML files
|
|
- Designed for validation with linkml-validate
|
|
- Supports Nationaal Archief zoekhulpen structure
|
|
- Merged from FindingAidMetadata.yaml (slot names) and FindingAid.yaml (bibliographic slots)
|
|
see_also:
|
|
- https://www.ica.org/standards/RiC/ontology#FindingAid
|
|
- https://www.nationaalarchief.nl/onderzoeken/zoekhulpen
|
|
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E31
|
|
- http://id.loc.gov/ontologies/bibframe/
|
|
MultilingualText:
|
|
class_uri: skos:Concept
|
|
description: |
|
|
Container for multilingual text values (titles, descriptions).
|
|
|
|
**MIGRATED 2026-01-22**: Language-specific slots (de, en, fr, nl) migrated to
|
|
unified `has_or_had_language` slot with `Language` class per Rule 53.
|
|
|
|
**Old Pattern** (deprecated):
|
|
```yaml
|
|
nl: "Nederlandse tekst"
|
|
en: "English text"
|
|
fr: "Texte français"
|
|
```
|
|
|
|
**New Pattern**:
|
|
```yaml
|
|
has_or_had_language:
|
|
- iso_639_1: "nl"
|
|
language_name: "Dutch"
|
|
text_content: "Nederlandse tekst"
|
|
- iso_639_1: "en"
|
|
language_name: "English"
|
|
text_content: "English text"
|
|
- iso_639_1: "fr"
|
|
language_name: "French"
|
|
text_content: "Texte français"
|
|
```
|
|
slots:
|
|
# MIGRATED 2026-01-22: de, en, fr, nl → has_or_had_language + Language (Rule 53)
|
|
- has_or_had_language
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
has_or_had_language:
|
|
range: Language
|
|
multivalued: true
|
|
inlined: true
|
|
inlined_as_list: true
|
|
description: |
|
|
Language-tagged text content.
|
|
MIGRATED from de/en/fr/nl slots per slot_fixes.yaml (Rule 53, 2026-01-22).
|
|
|
|
Use Language class with iso_639_1, language_name, and text_content.
|
|
examples:
|
|
- value: |
|
|
- iso_639_1: "nl"
|
|
language_name: "Dutch"
|
|
text_content: "Nederlandse tekst"
|
|
- iso_639_1: "en"
|
|
language_name: "English"
|
|
text_content: "English text"
|
|
description: Multilingual text with Dutch and English versions
|
|
comments:
|
|
- At least one language entry should be populated
|
|
- nl is primary for Dutch archives
|
|
- MIGRATED 2026-01-22 from separate de/en/fr/nl slots to unified has_or_had_language
|
|
CustodianReference:
|
|
class_uri: rico:Agent
|
|
description: 'Reference to the heritage custodian that created/maintains this finding aid.
|
|
|
|
|
|
Uses standard identifiers: GHCID, ISIL, Wikidata ID.
|
|
|
|
'
|
|
slots:
|
|
- ghcid
|
|
- isil
|
|
- name
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- is_or_was_instance_of # was: wikidata - migrated per Rule 53 (2026-01-15)
|
|
slot_usage:
|
|
ghcid:
|
|
required: true
|
|
pattern: ^[A-Z]{2}-[A-Z]{2}-[A-Z]{3}-[A-Z]-[A-Z0-9]+$
|
|
isil:
|
|
pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
|
|
name:
|
|
required: true
|
|
is_or_was_instance_of: # was: wikidata - migrated per Rule 53 (2026-01-15)
|
|
range: WikiDataEntry
|
|
description: |
|
|
MIGRATED 2026-01-15: Replaces wikidata slot per Rule 53.
|
|
Wikidata Q-number for the custodian.
|
|
examples:
|
|
- value:
|
|
entity_id: Q190804
|
|
label: Rijksmuseum
|
|
description: Wikidata identifier for Rijksmuseum
|
|
exact_mappings:
|
|
- rico:Agent
|
|
- schema:Organization
|
|
TemporalCoverage:
|
|
class_uri: dcterms:PeriodOfTime
|
|
description: 'Time period covered by the finding aid''s materials.
|
|
|
|
|
|
Supports both numeric years and special values like "present".
|
|
|
|
Can include named periods (key_periods) and significant dates (key_dates).
|
|
|
|
'
|
|
slots:
|
|
- end
|
|
- has_or_had_key_date
|
|
- has_or_had_key_period
|
|
- note
|
|
- has_or_had_period
|
|
- specificity_annotation
|
|
- start
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
start:
|
|
range: TemporalValue
|
|
required: true
|
|
end:
|
|
range: TemporalValue
|
|
required: true
|
|
has_or_had_period:
|
|
range: TemporalPeriod
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
has_or_had_key_period:
|
|
range: TemporalPeriod
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
has_or_had_key_date:
|
|
range: KeyDate
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
exact_mappings:
|
|
- dcterms:PeriodOfTime
|
|
- schema:temporalCoverage
|
|
TemporalPeriod:
|
|
class_uri: dcterms:PeriodOfTime
|
|
description: A named historical period with optional start/end dates and description.
|
|
slots:
|
|
- period
|
|
- period_description
|
|
- period_end
|
|
- period_name
|
|
- period_start
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
period_name:
|
|
range: string
|
|
required: true
|
|
aliases:
|
|
- name
|
|
period:
|
|
range: string
|
|
period_start:
|
|
range: TemporalValue
|
|
aliases:
|
|
- start
|
|
period_end:
|
|
range: TemporalValue
|
|
aliases:
|
|
- end
|
|
period_description:
|
|
range: string
|
|
aliases:
|
|
- description
|
|
KeyDate:
|
|
class_uri: schema:Event
|
|
description: 'A significant historical date with event description.
|
|
|
|
|
|
Used for key_dates within TemporalCoverage.
|
|
|
|
'
|
|
slots:
|
|
- date
|
|
- has_or_had_description
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
date:
|
|
description: ISO 8601 date (YYYY-MM-DD or YYYY)
|
|
range: string
|
|
required: true
|
|
has_or_had_description:
|
|
description: Description of what happened (multilingual support)
|
|
range: Description
|
|
multivalued: true
|
|
inlined: true
|
|
required: true
|
|
GeographicCoverage:
|
|
class_uri: dcterms:Location
|
|
description: 'Geographic area covered by the finding aid''s materials.
|
|
|
|
|
|
Supports primary areas, secondary/related areas, and migration patterns.
|
|
|
|
'
|
|
slots:
|
|
# MIGRATED 2026-01-22: colonial → includes_or_included + GeoSpatialPlace + is_or_was_categorized_as + ColonialStatus (Rule 53)
|
|
- includes_or_included
|
|
- is_or_was_categorized_as
|
|
- historical_region
|
|
- inbound_from
|
|
- international
|
|
- major_city
|
|
- outbound_to
|
|
- primary
|
|
- related
|
|
- scope
|
|
- secondary
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
primary:
|
|
multivalued: true
|
|
secondary:
|
|
multivalued: true
|
|
related:
|
|
multivalued: true
|
|
historical_region:
|
|
multivalued: true
|
|
# MIGRATED 2026-01-22: colonial → includes_or_included + is_or_was_categorized_as (Rule 53)
|
|
includes_or_included:
|
|
description: |
|
|
MIGRATED from colonial per slot_fixes.yaml (Rule 53, 2026-01-22).
|
|
Geographic territories included in this coverage area.
|
|
Use GeoSpatialPlace for structured geographic data.
|
|
range: GeoSpatialPlace
|
|
multivalued: true
|
|
inlined: true
|
|
inlined_as_list: true
|
|
examples:
|
|
- value:
|
|
geospatial_id: https://nde.nl/ontology/hc/geo/dutch-east-indies
|
|
latitude: -6.2
|
|
longitude: 106.8
|
|
geometry_type: POLYGON
|
|
description: Dutch East Indies territory
|
|
is_or_was_categorized_as:
|
|
description: |
|
|
MIGRATED from colonial per slot_fixes.yaml (Rule 53, 2026-01-22).
|
|
Colonial status categorization for this geographic coverage.
|
|
Use ColonialStatus for structured colonial relationship data.
|
|
range: ColonialStatus
|
|
multivalued: true
|
|
inlined: true
|
|
inlined_as_list: true
|
|
examples:
|
|
- value:
|
|
territory_name: "Dutch East Indies"
|
|
colonizing_power: "Netherlands"
|
|
modern_equivalent: ["ID"]
|
|
temporal_extent:
|
|
begin_of_the_begin: "1602-01-01"
|
|
end_of_the_end: "1949-12-27"
|
|
description: Dutch colonial Indonesia
|
|
international:
|
|
multivalued: true
|
|
major_city:
|
|
multivalued: true
|
|
inbound_from:
|
|
multivalued: true
|
|
outbound_to:
|
|
multivalued: true
|
|
exact_mappings:
|
|
- dcterms:spatial
|
|
- schema:spatialCoverage
|
|
SubGuideReference:
|
|
class_uri: rico:FindingAid
|
|
description: 'Reference to a sub-guide or related finding aid within the same repository.
|
|
|
|
|
|
Sub-guides are more specific finding aids linked from a repository guide.
|
|
|
|
For example, a "Family History" repository guide links to specific sub-guides
|
|
|
|
for "Civil Registry", "Notarial Records", etc.
|
|
|
|
'
|
|
slots:
|
|
- is_or_was_access_restricted
|
|
- note
|
|
- slug
|
|
- specificity_annotation
|
|
- has_or_had_description # was: sub_guide_description - migrated per Rule 53
|
|
- has_or_had_content # was: sub_guide_temporal_coverage - migrated per Rule 53/56 (2026-01-17)
|
|
- has_or_had_type
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
# REMOVED: title_en, title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
|
|
- has_or_had_label
|
|
- has_or_had_url # was: url - migrated per Rule 53 (2025-01-15)
|
|
slot_usage:
|
|
slug:
|
|
required: true
|
|
has_or_had_label:
|
|
range: Label
|
|
required: true
|
|
multivalued: true
|
|
inlined: true
|
|
description: |
|
|
Multilingual titles for this sub-guide.
|
|
MIGRATED from title_nl/title_en slots (2026-01-14) per Rule 53.
|
|
|
|
Uses Label class with language_code to support any language.
|
|
examples:
|
|
- value: |
|
|
label_value: "Burgerlijke Stand"
|
|
language_code: "nl"
|
|
description: Dutch title
|
|
- value: |
|
|
label_value: "Civil Registry"
|
|
language_code: "en"
|
|
description: English title
|
|
has_or_had_url:
|
|
range: URL
|
|
inlined: true
|
|
required: true
|
|
description: |
|
|
URL of the sub-guide web resource.
|
|
MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
|
|
has_or_had_type:
|
|
range: SubGuideType
|
|
description: |
|
|
The type classification of this sub-guide.
|
|
Uses SubGuideType class hierarchy.
|
|
is_or_was_access_restricted:
|
|
range: boolean
|
|
has_or_had_content:
|
|
range: string
|
|
description: |
|
|
Time period covered by this sub-guide (free text).
|
|
MIGRATED from sub_guide_temporal_coverage (2026-01-17) per Rule 53/56.
|
|
|
|
Examples: "1811-1935", "before 1811", "1811-present"
|
|
examples:
|
|
- value: "1811-1935"
|
|
description: Date range
|
|
- value: "before 1811"
|
|
description: Open-ended historical period
|
|
exact_mappings:
|
|
- rico:isOrWasPartOf
|
|
ArchiveReference:
|
|
class_uri: rico:RecordSet
|
|
description: 'Reference to an archive collection or institution.
|
|
|
|
|
|
Used for key_archives (main archives for a topic) and related_archives
|
|
|
|
(external archives with related holdings).
|
|
|
|
'
|
|
slots:
|
|
- has_or_had_access_condition
|
|
- full_name
|
|
- isil
|
|
- location
|
|
- name
|
|
- resource_description
|
|
- specificity_annotation
|
|
- has_or_had_content # was: sub_guide_temporal_coverage - migrated per Rule 53/56 (2026-01-17)
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_url # was: url - migrated per Rule 53 (2025-01-15)
|
|
slot_usage:
|
|
name:
|
|
required: true
|
|
has_or_had_url:
|
|
range: URL
|
|
inlined: true
|
|
required: false
|
|
description: |
|
|
URL of the archive reference.
|
|
MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
|
|
isil:
|
|
pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
|
|
has_or_had_content:
|
|
range: string
|
|
description: |
|
|
Time period covered by this archive reference (free text).
|
|
MIGRATED from sub_guide_temporal_coverage (2026-01-17) per Rule 53/56.
|
|
|
|
Examples: "1811-1935", "before 1811", "1811-present"
|
|
exact_mappings:
|
|
- rico:RecordSet
|
|
- schema:ArchiveOrganization
|
|
RelatedGuideReference:
|
|
class_uri: rico:FindingAid
|
|
description: 'Reference to a related finding aid guide within the same repository.
|
|
|
|
|
|
Different from sub_guides: these are peer-level guides on related topics,
|
|
|
|
not hierarchically nested guides.
|
|
|
|
'
|
|
slots:
|
|
- relationship
|
|
- slug
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
# REMOVED: title_en, title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
|
|
- has_or_had_label
|
|
slot_usage:
|
|
slug:
|
|
required: true
|
|
has_or_had_label:
|
|
range: Label
|
|
required: true
|
|
multivalued: true
|
|
inlined: true
|
|
description: |
|
|
Multilingual titles for this related guide.
|
|
MIGRATED from title_nl/title_en slots (2026-01-14) per Rule 53.
|
|
|
|
Uses Label class with language_code to support any language.
|
|
relationship:
|
|
range: RelationshipTypeEnum
|
|
AccessRestriction:
|
|
class_uri: dcterms:RightsStatement
|
|
description: 'Access restriction information for materials.
|
|
|
|
'
|
|
slots:
|
|
- permission_required
|
|
- restriction_description
|
|
- restriction_type
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_restriction
|
|
slot_usage:
|
|
restriction_type:
|
|
required: true
|
|
has_or_had_restriction:
|
|
range: Restriction
|
|
description: |
|
|
Structured restriction with temporal extent.
|
|
Replaces years_restricted (integer) with Restriction class.
|
|
permission_required:
|
|
range: boolean
|
|
ExternalResource:
|
|
class_uri: foaf:Document
|
|
description: 'Reference to an external resource (database, organization, portal).
|
|
|
|
|
|
Used to link finding aids to related external resources that complement
|
|
|
|
the archive''s holdings (e.g., genealogical databases, historical societies).
|
|
|
|
'
|
|
slots:
|
|
- name
|
|
- resource_description
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_type # was: type - migrated per Rule 53 (2026-01-15)
|
|
- has_or_had_url # was: url - migrated per Rule 53 (2025-01-15)
|
|
slot_usage:
|
|
name:
|
|
required: true
|
|
has_or_had_url:
|
|
range: URL
|
|
inlined: true
|
|
required: true
|
|
description: |
|
|
URL of the external resource.
|
|
MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
|
|
has_or_had_type: # was: type - migrated per Rule 53 (2026-01-15)
|
|
range: ExternalResourceTypeEnum
|
|
exact_mappings:
|
|
- foaf:Document
|
|
- schema:WebPage
|
|
FindingAidProvenance:
|
|
class_uri: prov:Activity
|
|
description: 'Provenance metadata for web-harvested finding aid information.
|
|
|
|
|
|
Tracks when and how the metadata was retrieved, enabling data freshness
|
|
|
|
assessment and re-crawling decisions.
|
|
|
|
'
|
|
slots:
|
|
- has_or_had_quantity # was: claims_count - migrated per Rule 53 (2026-01-19)
|
|
- crawler_version
|
|
- was_retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
- extraction_method
|
|
- extraction_note
|
|
- html_snapshot_path
|
|
- note
|
|
- retrieval_agent
|
|
- source_url
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
# REMOVED 2026-01-14: validation_status - migrated to has_or_had_status with ValidationStatus
|
|
- has_or_had_status
|
|
slot_usage:
|
|
was_retrieved_at: # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
range: Timestamp
|
|
inlined: true
|
|
required: true
|
|
description: >-
|
|
Timestamp when data was retrieved from the source.
|
|
Uses Timestamp class for structured temporal data.
|
|
examples:
|
|
- value:
|
|
has_or_had_timestamp: "2025-12-15T10:30:00Z"
|
|
has_or_had_precision: second
|
|
description: Full datetime retrieval timestamp
|
|
retrieval_agent:
|
|
required: true
|
|
source_url:
|
|
range: uri
|
|
has_or_had_quantity: # was: claims_count - migrated per Rule 53 (2026-01-19)
|
|
range: Quantity
|
|
inlined: true
|
|
description: |
|
|
Number of claims extracted during this retrieval.
|
|
MIGRATED 2026-01-19: Replaces claims_count integer with structured Quantity.
|
|
Use quantity_type: CLAIM_COUNT for claim counts.
|
|
examples:
|
|
- value:
|
|
quantity_value: 47
|
|
quantity_type: CLAIM_COUNT
|
|
has_or_had_description: "Web claims extracted from finding aid page"
|
|
description: Claim count with structured quantity
|
|
has_or_had_status:
|
|
range: ValidationStatus
|
|
required: false
|
|
inlined: true
|
|
description: |
|
|
Validation status of this finding aid retrieval.
|
|
MIGRATED 2026-01-14: Replaces validation_status slot.
|
|
examples:
|
|
- value:
|
|
status_type: VALIDATED
|
|
status_date: "2026-01-14"
|
|
description: Validated finding aid data
|
|
exact_mappings:
|
|
- prov:Activity
|
|
PageSection:
|
|
class_uri: schema:WebPageElement
|
|
description: 'A section of a finding aid page with heading and content.
|
|
|
|
|
|
Captures the hierarchical structure of web pages for preservation
|
|
|
|
and semantic understanding.
|
|
|
|
'
|
|
slots:
|
|
- content_block
|
|
- has_or_had_featured_item
|
|
- heading_level
|
|
- heading_text
|
|
- heading_text_en
|
|
- list_item
|
|
- section_id
|
|
- has_or_had_section_link
|
|
- specificity_annotation
|
|
- has_or_had_sub_section
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_provenance_path # was: xpath - migrated per Rule 53 (2026-01-15)
|
|
slot_usage:
|
|
heading_level:
|
|
range: integer
|
|
minimum_value: 1
|
|
maximum_value: 6
|
|
heading_text:
|
|
required: true
|
|
content_block:
|
|
multivalued: true
|
|
has_or_had_sub_section:
|
|
range: PageSection
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
has_or_had_section_link:
|
|
range: PageLink
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
has_or_had_featured_item:
|
|
range: FeaturedCard
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
list_item:
|
|
multivalued: true
|
|
has_or_had_provenance_path:
|
|
range: XPath
|
|
inlined: true
|
|
description: |
|
|
XPath provenance path documenting the exact location of the section in the source HTML.
|
|
MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
|
|
exact_mappings:
|
|
- schema:WebPageElement
|
|
PageLink:
|
|
class_uri: schema:WebPage
|
|
description: 'A hyperlink extracted from a page.
|
|
|
|
'
|
|
slots:
|
|
- is_sub_guide
|
|
- link_context
|
|
- link_text
|
|
- link_type
|
|
- link_url
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_provenance_path # was: xpath - migrated per Rule 53 (2026-01-15)
|
|
slot_usage:
|
|
link_text:
|
|
required: true
|
|
link_url:
|
|
range: uri
|
|
required: true
|
|
link_type:
|
|
range: LinkTypeEnum
|
|
is_sub_guide:
|
|
range: boolean
|
|
has_or_had_provenance_path:
|
|
range: XPath
|
|
inlined: true
|
|
description: |
|
|
XPath provenance path documenting the exact location of the link in the source HTML.
|
|
MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
|
|
FeaturedCard:
|
|
class_uri: schema:CreativeWork
|
|
description: 'A featured content card (often with image/icon).
|
|
|
|
|
|
Common on archive websites to highlight important sub-guides or resources.
|
|
|
|
'
|
|
slots:
|
|
# MIGRATED 2026-01-22: card_description, card_description_en → has_or_had_description + Description (multivalued with language tag)
|
|
- has_or_had_description
|
|
# MIGRATED 2026-01-22: card_image_url → has_or_had_image + Image
|
|
- has_or_had_image
|
|
# MIGRATED 2026-01-22: card_title, card_title_en → has_or_had_label + Label (multivalued with language tag)
|
|
- has_or_had_label
|
|
# MIGRATED 2026-01-22: card_url → has_or_had_url + URL
|
|
- has_or_had_url
|
|
- specificity_annotation
|
|
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
- has_or_had_provenance_path # was: xpath - migrated per Rule 53 (2026-01-15)
|
|
slot_usage:
|
|
has_or_had_description:
|
|
range: Description
|
|
multivalued: true
|
|
inlined: true
|
|
description: |
|
|
Card description(s) with language tagging.
|
|
MIGRATED 2026-01-22: Replaces card_description and card_description_en.
|
|
Use description_type: "card" and language: "nl"/"en" to distinguish.
|
|
examples:
|
|
- value:
|
|
description_text: "Kaart beschrijving in het Nederlands"
|
|
description_type: card
|
|
language: nl
|
|
description: Dutch card description
|
|
- value:
|
|
description_text: "Card description in English"
|
|
description_type: card
|
|
language: en
|
|
description: English card description
|
|
has_or_had_image:
|
|
range: Image
|
|
multivalued: true
|
|
inlined: true
|
|
description: |
|
|
Card thumbnail/preview image(s).
|
|
MIGRATED 2026-01-22: Replaces card_image_url with structured Image class.
|
|
examples:
|
|
- value:
|
|
has_or_had_url:
|
|
has_or_had_value: "https://archive.org/images/card.jpg"
|
|
image_format: JPEG
|
|
description: Card thumbnail image
|
|
has_or_had_label:
|
|
range: Label
|
|
multivalued: true
|
|
inlined: true
|
|
required: true
|
|
description: |
|
|
Card title(s) with language tagging.
|
|
MIGRATED 2026-01-22: Replaces card_title and card_title_en.
|
|
Use Label.language to distinguish Dutch/English titles.
|
|
examples:
|
|
- value:
|
|
has_or_had_text: "Kaart titel"
|
|
language: nl
|
|
description: Dutch card title
|
|
- value:
|
|
has_or_had_text: "Card title"
|
|
language: en
|
|
description: English card title
|
|
has_or_had_url:
|
|
range: URL
|
|
inlined: true
|
|
description: |
|
|
URL the card links to.
|
|
MIGRATED 2026-01-22: Replaces card_url with structured URL class.
|
|
examples:
|
|
- value:
|
|
has_or_had_value: "https://archive.org/page"
|
|
description: Card destination URL
|
|
has_or_had_provenance_path:
|
|
range: XPath
|
|
inlined: true
|
|
description: |
|
|
XPath provenance path documenting the exact location of the card in the source HTML.
|
|
MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
|
|
types:
|
|
TemporalValue:
|
|
typeof: string
|
|
uri: xsd:string
|
|
description: 'A temporal value that can be either a year (integer) or special value like "present".
|
|
|
|
Examples: 1572, 1811, "present", "ongoing"
|
|
|
|
'
|