glam/schemas/20251121/linkml/modules/classes/FindingAid.yaml
kempersc fcd1c21c63 Add aliases and enhance slot definitions across various modules
- Added new aliases for existing slots to improve clarity and usability, including:
  - has_deadline: has_embargo_end_date
  - has_extent: has_extent_text
  - has_fonds: has_fond
  - has_laboratory: conservation_lab
  - has_language: has_iso_code639_1, has_iso_code639_3
  - has_legal_basis: legal_basis
  - has_light_exposure: max_light_lux
  - has_measurement_unit: has_unit
  - has_note: has_custodian_observation
  - has_occupation: occupation
  - has_operating_hours: has_operating_hours
  - has_position: position
  - has_quantity: has_artwork_count, link_count
  - has_roadmap: review_date
  - has_skill: skill
  - has_speaker: speaker_label
  - has_specification: specification_url
  - has_statement: rights_statement_url, rights_statement
  - has_type: custodian_only
  - has_user_category: serves_visitors_only
  - hold_record_set: record_count
  - identified_by: has_index_number
  - in_period: has_period
  - in_place: has_place
  - in_series: has_series
  - measure: has_measurement
  - measured_on: measurement_date
  - organized_by: has_organizer
  - originate_from: has_origin
  - part_of: suborganization_of
  - published_on: has_publication_date
  - receive_investment: has_investment
  - related_to: connection_heritage_type
  - require: preservation_requirement
  - safeguarded_by: current_keeper, record_holder_note
  - state: states_or_stated
  - take_comission: takes_or_took_comission
  - take_place_at: takes_or_took_place_at
  - transmit_through: transmits_or_transmitted_through
  - warrant: warrants_or_warranted

- Introduced a new slot definition for evaluated_through to capture evaluation methodologies and review statuses.
2026-02-14 14:41:49 +01:00

342 lines
9.3 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
- ../enums/ExternalResourceTypeEnum
- ../enums/LinkTypeEnum
- ../enums/RelationshipTypeEnum
- ../enums/SubGuideTypeEnum
- ../slots/contain
- ../slots/created_by
- ../slots/has_selector
- ../slots/managed_by
- ../slots/has_date
- ../slots/has_content
- ../slots/has_description
- ../slots/has_file_location
- ../slots/has_format
- ../slots/geographic_extent
- ../slots/identified_by
- ../slots/has_image
- ../slots/has_label
- ../slots/has_level
- ../slots/has_note
- ../slots/in_period
- ../slots/has_policy
- ../slots/has_provenance
- ../slots/restricted_by
- ../slots/has_score
- ../slots/has_status
- ../slots/has_type
- ../slots/has_url
- ../slots/originate_from
- ../slots/include
- ../slots/has_scope
- ../slots/access_restricted
- ../slots/categorized_as
- ../slots/generated_by
- ../slots/instance_of
- ../slots/located_in
- ../slots/related_to
- ../slots/retrieved_through
- ../slots/superseded_by
- ../slots/auxiliary_of
- ../slots/in_language
- ../slots/has_context
- ../slots/has_text
- ../slots/list
- ../slots/has_locality
- ../slots/outbound_to
- ../slots/temporal_extent
- ../slots/end_of_the_end
- ../slots/begin_of_the_begin
- ../slots/require
- ../slots/primary
- ../slots/has_access_policy
- ../slots/retrieved_by
- ../slots/updated_at
- ../slots/has_geographic_subdivision
- ../slots/has_section
- ../slots/provided_by
- ../slots/has_slug
- ../slots/supersede
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
close_mappings:
- schema:temporalCoverage
- dcterms:BibliographicResource
- schema:CreativeWork
- crm:E31_Document
- bf:Work
slots:
- has_policy
- created_by
- managed_by
- has_description
- identified_by
- has_note
- has_type
- has_format
- geographic_extent
- identified_by
- in_language
- include
- contain
- has_note
- in_period
- begin_of_the_begin
- has_score
slot_usage:
begin_of_the_begin:
range: TemporalValue
required: true
in_period:
range: TemporalPeriod
multivalued: true
inlined_as_list: true
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
TemporalPeriod:
class_uri: dcterms:PeriodOfTime
description: A named historical period with optional start/end dates and description.
slots:
- temporal_extent
- has_description
- end_of_the_end
- has_label
- begin_of_the_begin
- has_score
slot_usage:
has_label:
# range: string
required: true
aliases:
- name
temporal_extent:
# range: string
begin_of_the_begin:
range: TemporalValue
aliases:
- start
end_of_the_end:
range: TemporalValue
aliases:
has_description:
# range: string
aliases:
- has_description
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:
- access_restricted
- has_note
- has_slug
- has_description
- has_content
- has_type
- has_score
- has_label
- has_url
slot_usage:
has_slug:
required: true
has_label:
# range: string
required: true
multivalued: true
inlined: false # Fixed invalid inline for primitive type
examples:
- value: 'label_value: "Burgerlijke Stand"
language_code: "nl"
'
- value: 'label_value: "Civil Registry"
language_code: "en"
'
has_url:
range: uri
inlined: false # Fixed invalid inline for primitive type
required: true
has_type:
# range: string # uriorcurie
access_restricted:
range: boolean
has_content:
# range: string
examples:
- value: 1811-1935
- value: before 1811
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_label
- identified_by
- has_level
- contain
- list
- has_section
- has_score
- has_provenance
slot_usage:
has_level:
range: integer
minimum_value: 1
maximum_value: 6
contain:
multivalued: true
inlined_as_list: false # Fixed invalid inline for primitive type
any_of:
- range: PageSection
- range: PageLink
list:
multivalued: true
has_provenance:
range: XPath
inlined: true
exact_mappings:
- schema:WebPageElement
PageLink:
class_uri: schema:WebPage
description: 'A hyperlink extracted from a page.
'
slots:
- auxiliary_of
- has_context
- has_text
- has_type
- has_url
- has_score
- has_provenance
slot_usage:
has_text:
required: true
has_url:
range: uri
required: true
has_type:
range: LinkTypeEnum
auxiliary_of:
range: boolean
has_provenance:
range: XPath
inlined: true
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_description
- has_image
- has_label
- has_url
- has_score
- has_provenance
slot_usage:
has_description:
# range: string
multivalued: true
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
description_text: Kaart beschrijving in het Nederlands
description_type: card
language: nl
- value:
description_text: Card description in English
description_type: card
language: en
has_image:
range: Image
multivalued: true
inlined: true
examples:
- value:
has_url:
has_value: https://archive.org/images/card.jpg
has_label:
# range: string
multivalued: true
inlined: false # Fixed invalid inline for primitive type
required: true
examples:
- value:
has_text: Kaart titel
language: nl
- value:
has_text: Card title
language: en
has_url:
range: uri
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
has_value: https://archive.org/page
has_provenance:
range: XPath
inlined: true
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"
'