712 lines
18 KiB
YAML
712 lines
18 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
|
|
- ./TimeSpan
|
|
- ../slots/id
|
|
- ../slots/description
|
|
- ../slots/has_or_had_content
|
|
- ./Content
|
|
- ../slots/has_or_had_access_restriction
|
|
- ../slots/has_or_had_web_claim
|
|
- ../slots/language
|
|
- ../slots/supersedes_or_superseded
|
|
- ../slots/is_or_was_superseded_by
|
|
- ../slots/revision_date
|
|
- ../slots/served_by
|
|
- ../slots/retrieval_agent
|
|
- ../slots/extraction_note
|
|
- ../slots/extraction_method
|
|
- ../slots/has_or_had_provenance_path
|
|
- ./XPath
|
|
- ../slots/css_selector
|
|
- ../slots/is_or_was_generated_by
|
|
- ./GenerationEvent
|
|
- ./ConfidenceScore
|
|
- ./ConfidenceMethod
|
|
- ../slots/html_file
|
|
- ../slots/has_or_had_identifier
|
|
- ./Identifier
|
|
- ../slots/source_url
|
|
- ../slots/has_or_had_label
|
|
- ../slots/date
|
|
- ../slots/note
|
|
- ../slots/creator
|
|
- ../slots/has_or_had_publisher
|
|
- ./Publisher
|
|
- ../slots/is_or_was_published_at
|
|
- ./PublicationEvent
|
|
- ./Quantity
|
|
- ../slots/isbn
|
|
- ../slots/has_or_had_access_condition
|
|
- ../slots/is_or_was_access_restricted
|
|
- ../slots/has_or_had_overview
|
|
- ../slots/has_or_had_image
|
|
- ./Image
|
|
- ../slots/has_or_had_quantity
|
|
- ../slots/includes_or_included
|
|
- ./GeoSpatialPlace
|
|
- ../slots/is_or_was_categorized_as
|
|
- ./ColonialStatus
|
|
- ../slots/content_block
|
|
- ../slots/crawler_version
|
|
- ../slots/custodian
|
|
- ../slots/was_retrieved_at
|
|
- ./Timestamp
|
|
- ../slots/de
|
|
- ../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/has_or_had_note
|
|
- ./Note
|
|
- ../slots/has_or_had_scope
|
|
- ./Scope
|
|
- ../slots/has_or_had_type
|
|
- ../slots/has_or_had_format
|
|
- ./Format
|
|
- ../slots/has_or_had_language
|
|
- ./Language
|
|
- ../slots/full_name
|
|
- ../slots/has_or_had_geographic_extent
|
|
- ../slots/has_or_had_identifier
|
|
- ./GHCIdentifier
|
|
- ../slots/contains_or_contained
|
|
- ../slots/contains_or_contained
|
|
- ../slots/contains_or_contained_en
|
|
- ../slots/is_or_was_located_in
|
|
- ./HistoricalRegion
|
|
- ../slots/html_snapshot_path
|
|
- ../slots/inbound_from
|
|
- ../slots/international
|
|
|
|
- ../slots/is_sub_guide
|
|
- ../slots/isil
|
|
- ../slots/has_or_had_key_archive
|
|
- ../slots/includes_or_included
|
|
- ./KeyDate
|
|
- ./KeyPeriod
|
|
- ./PageSection
|
|
- ../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/is_or_was_related_to
|
|
- ../slots/is_or_was_related_to
|
|
- ../slots/relationship
|
|
- ../slots/resource_description
|
|
- ../slots/restriction_description
|
|
- ../slots/restriction_type
|
|
- ../slots/scope
|
|
- ../slots/secondary
|
|
- ../slots/section_id
|
|
- ../slots/contains_or_contained
|
|
- ../slots/slug
|
|
- ../slots/specificity_annotation
|
|
- ../slots/start
|
|
- ../slots/has_or_had_description
|
|
- ./Description
|
|
- ./SubGuideType
|
|
- ../slots/contains_or_contained
|
|
- ../slots/contains_or_contained
|
|
- ../slots/has_or_had_score
|
|
- ../slots/has_or_had_label
|
|
- ./Label
|
|
- ../slots/is_or_was_categorized_as
|
|
- ./Topic
|
|
- ./TopicType
|
|
- ./TopicTypes
|
|
- ../slots/has_or_had_type
|
|
- ../slots/has_or_had_url
|
|
- ./URL
|
|
- ../slots/has_or_had_status
|
|
- ./ValidationStatus
|
|
- ../slots/is_or_was_instance_of
|
|
- ../slots/is_or_was_instance_of
|
|
- ./WikiDataEntry
|
|
- ../slots/has_or_had_restriction
|
|
- ./Restriction
|
|
- ./FindingAid
|
|
- ./PersonWebClaim
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScore
|
|
- ./TemplateSpecificityType
|
|
- ./TemplateSpecificityTypes
|
|
- ./TimeSpan
|
|
- ../slots/has_or_had_description
|
|
- ../slots/temporal_extent
|
|
- ../slots/has_or_had_policy
|
|
- ./AccessPolicy
|
|
- ../slots/has_link
|
|
- ../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:
|
|
- dcterms:PeriodOfTime
|
|
- schema:temporalCoverage
|
|
close_mappings:
|
|
- dcterms:BibliographicResource
|
|
- schema:CreativeWork
|
|
- crm:E31_Document
|
|
- bf:Work
|
|
slots:
|
|
- has_or_had_policy
|
|
- has_or_had_overview
|
|
- creator
|
|
- custodian
|
|
- has_or_had_description
|
|
- has_or_had_identifier
|
|
- has_or_had_external_resource
|
|
- has_or_had_note
|
|
- has_or_had_type
|
|
- has_or_had_format
|
|
- has_or_had_geographic_extent
|
|
- id
|
|
- isbn
|
|
- has_or_had_key_archive
|
|
- language
|
|
- note
|
|
- includes_or_included
|
|
- contains_or_contained
|
|
- note
|
|
- has_or_had_period
|
|
- specificity_annotation
|
|
- start
|
|
- has_or_had_score
|
|
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
|
|
annotations:
|
|
specificity_score: 0.1
|
|
specificity_rationale: Generic utility class/slot created during migration
|
|
custodian_types:
|
|
- '*'
|
|
custodian_types_rationale: Universal utility concept
|
|
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
|
|
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
|
|
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
|
|
GeographicExtent:
|
|
class_uri: dcterms:Location
|
|
description: 'Geographic area covered by the finding aid''s materials.
|
|
|
|
|
|
Supports primary areas, secondary/related areas, and migration patterns.
|
|
|
|
'
|
|
slots:
|
|
- 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
|
|
slot_usage:
|
|
primary:
|
|
multivalued: true
|
|
secondary:
|
|
multivalued: true
|
|
related:
|
|
multivalued: true
|
|
historical_region:
|
|
multivalued: true
|
|
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
|
|
- has_or_had_content
|
|
- has_or_had_type
|
|
- has_or_had_score
|
|
- has_or_had_label
|
|
- has_or_had_url
|
|
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
|
|
- geographic_coverage
|
|
- has_or_had_identifier
|
|
- contains_or_contained
|
|
- contains_or_contained
|
|
- contains_or_contained_en
|
|
- list_item
|
|
- section_id
|
|
- contains_or_contained
|
|
- specificity_annotation
|
|
- contains_or_contained
|
|
- has_or_had_score
|
|
- has_or_had_provenance_path
|
|
slot_usage:
|
|
contains_or_contained:
|
|
range: integer
|
|
minimum_value: 1
|
|
maximum_value: 6
|
|
contains_or_contained:
|
|
required: true
|
|
content_block:
|
|
multivalued: true
|
|
contains_or_contained:
|
|
range: PageSection
|
|
multivalued: true
|
|
inlined_as_list: true
|
|
contains_or_contained:
|
|
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
|
|
- has_or_had_provenance_path
|
|
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:
|
|
- has_or_had_description
|
|
- has_or_had_image
|
|
- has_or_had_label
|
|
- has_or_had_url
|
|
- specificity_annotation
|
|
- has_or_had_score
|
|
- has_or_had_provenance_path
|
|
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"
|
|
|
|
'
|