fcd1c21c63
- 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.
141 lines
No EOL
5.1 KiB
YAML
141 lines
No EOL
5.1 KiB
YAML
id: https://nde.nl/ontology/hc/class/Overview
|
|
name: overview_class
|
|
title: Overview Class
|
|
description: >-
|
|
A comprehensive collection of links and resources.
|
|
Represents a structured overview or collection of web links and related
|
|
resources. Used to aggregate multiple WebLink instances into a coherent
|
|
collection with shared context or purpose.
|
|
**ONTOLOGY ALIGNMENT**:
|
|
- Dublin Core: dcterms:Collection (collection of resources)
|
|
- Schema.org: schema:ItemList (list of items)
|
|
- RiC-O: rico:RecordSet (archival collection concept)
|
|
**USE CASES**:
|
|
1. All links from a finding aid page
|
|
2. Comprehensive resource listings
|
|
3. Navigation link collections
|
|
4. Related resource aggregations
|
|
**MIGRATION NOTE** (2026-01-14):
|
|
Created as part of slot migration from `all_links` to
|
|
`has_overview` with `Overview` and `WebLink` typed classes.
|
|
See slot_fixes.yaml for migration specification.
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
dcterms: http://purl.org/dc/terms/
|
|
schema: http://schema.org/
|
|
rico: https://www.ica.org/standards/RiC/ontology#
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
imports:
|
|
- linkml:types
|
|
- ../slots/has_description
|
|
- ../slots/has_label # was: title
|
|
- ../slots/has_score # was: template_specificity
|
|
- ../slots/include
|
|
- ../slots/retrieved_at # was: date_retrieved
|
|
- ../slots/has_quantity
|
|
- ../slots/has_name
|
|
- ../slots/has_url
|
|
- ../slots/temporal_extent # was: valid_from + valid_to
|
|
default_prefix: hc
|
|
# default_range: string
|
|
classes:
|
|
Overview:
|
|
class_uri: dcterms:Collection
|
|
description: >-
|
|
A comprehensive collection of links and resources.
|
|
**DEFINITION**:
|
|
An aggregation of WebLink instances representing all links or resources
|
|
from a particular source or context. Enables structured representation
|
|
of comprehensive link collections from web pages or other sources.
|
|
**DUBLIN CORE ALIGNMENT**:
|
|
Maps to `dcterms:Collection` as it represents a collection of related
|
|
resources gathered together for a purpose.
|
|
**TEMPORAL SEMANTICS**:
|
|
Overview collections can change over time:
|
|
- New links may be added
|
|
- Existing links may be removed or updated
|
|
- The collection scope may change
|
|
**RELATIONSHIP TO INCLUDES_OR_INCLUDED**:
|
|
Uses the generic `include` slot to link to WebLink
|
|
instances, following RiC-O hierarchical patterns.
|
|
**EXAMPLE**:
|
|
```yaml
|
|
overview:
|
|
id: hc:overview/findingaid-familyhistory-links
|
|
title: "Family History Research Links"
|
|
description: "All links from the family history finding aid page"
|
|
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
|
|
retrieved_at:
|
|
has_timestamp: "2025-01-14"
|
|
has_level: day
|
|
include:
|
|
- id: hc:link/civil-registry
|
|
url: https://example.org/civil-registry
|
|
link_text: "Civil Registry"
|
|
- id: hc:link/notarial-records
|
|
url: https://example.org/notarial
|
|
link_text: "Notarial Records"
|
|
```
|
|
exact_mappings:
|
|
- dcterms:Collection
|
|
close_mappings:
|
|
- schema:ItemList
|
|
- rico:RecordSet
|
|
slots:
|
|
- has_name
|
|
- has_label # was: title
|
|
- has_description
|
|
- include
|
|
- has_url
|
|
- retrieved_at # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
- link_count
|
|
- temporal_extent # was: valid_from + valid_to
|
|
- has_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
|
|
slot_usage:
|
|
has_name:
|
|
# range: string
|
|
has_label: # was: title
|
|
# range: string
|
|
include:
|
|
# range: string
|
|
multivalued: true
|
|
inlined_as_list: false # Fixed invalid inline for primitive type
|
|
has_url:
|
|
range: uri
|
|
retrieved_at: # was: date_retrieved - migrated per Rule 53/56/57 (2026-01-23)
|
|
range: Timestamp
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
has_timestamp: "2025-01-14"
|
|
has_level: day
|
|
link_count:
|
|
range: integer
|
|
annotations:
|
|
custodian_types: '["*"]'
|
|
custodian_types_rationale: >-
|
|
Applicable to all heritage custodian types as comprehensive
|
|
link collections are universal navigation patterns.
|
|
custodian_types_primary: "*"
|
|
specificity_score: 0.30
|
|
specificity_rationale: >-
|
|
Low specificity - broadly applicable for link collection
|
|
and navigation modeling.
|
|
comments:
|
|
- Collection of WebLink instances
|
|
- Used with has_overview slot
|
|
- Created from slot_fixes.yaml migration (2026-01-14)
|
|
see_also:
|
|
- http://purl.org/dc/terms/Collection
|
|
- http://schema.org/ItemList
|
|
examples:
|
|
- value:
|
|
id: hc:overview/findingaid-001-links
|
|
source_url: https://www.nationaalarchief.nl/onderzoeken/zoekhulpen/familiegeschiedenis
|
|
retrieved_at: # was: date_retrieved
|
|
has_timestamp: "2025-01-14"
|
|
has_level: day
|
|
link_count: 15
|
|
# REMOVED inline slots 2026-01-16 - Rule 48 violation
|
|
# Slots are imported from ../slots/ - do not define inline |