kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
glam/schemas/20251121/linkml/modules/classes/FindingAid.yaml
kempersc f3c0586d09 Refactor schema and slots for improved clarity and organization 
- Updated `has_or_had_url` slot to allow a broader range of values by changing its range from `uriorcurie` to `Any`.
- Removed obsolete slots: `house_number`, `html_file`, `html_snapshot_path`, and `http_status_code`.
- Introduced new classes: `CeasingEvent`, `FileLocation`, `FilePath`, `HTMLFile`, `HTTPStatusCode`, `HouseNumber`, `MaximumHumidity`, `MinimumHumidity`, `TargetHumidity`, and `WKT` to better represent various concepts.
- Migrated existing slots to new structures, ensuring alignment with RiC-O naming conventions.
- Added new slots: `ceases_or_ceased_through`, `has_or_had_file_location`, `has_or_had_file_path`, `has_or_had_http_status`, and `is_or_was_observed_by` to capture additional metadata.
- Enhanced descriptions and annotations for clarity and context.
2026-01-28 10:49:49 +01:00

720 lines
18 KiB
YAML
Raw Blame History

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/has_or_had_file_location
- ./FileLocation
- ../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
- has_or_had_identifier
- id
- isbn
- has_or_had_key_archive
- language
- note
- includes_or_included
- contains_or_contained
- 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
- is_or_was_located_in
- 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
is_or_was_located_in:
range: HistoricalRegion
multivalued: true
description: Historical regions covered by this geographic extent. Replaces historical_region (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
- 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"
'
Reference in a new issue View git blame Copy permalink