567 lines
20 KiB
YAML
567 lines
20 KiB
YAML
# FindingAid Class - Descriptive tools for accessing heritage collections
|
|
#
|
|
# A FindingAid is a published document (digital or physical) that describes
|
|
# the contents of a collection and facilitates researcher access.
|
|
#
|
|
# This class replaces the simple finding_aid_url slot with a rich object
|
|
# that captures finding aid type, format, publication details, and digital access.
|
|
#
|
|
# Key ontology alignments:
|
|
# - RiC-O: rico:FindingAid - "A set of descriptions identifying and locating materials"
|
|
# - CIDOC-CRM: crm:E31_Document - Document serving as finding aid
|
|
# - BIBFRAME: bf:Work / bf:Instance - Intellectual content and manifestation
|
|
#
|
|
# NOTE: All slots are prefixed with "finding_aid_" to avoid conflicts with
|
|
# global slots defined in other modules (e.g., Budget defines revision_date).
|
|
#
|
|
# Generation date: 2025-12-09
|
|
|
|
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/
|
|
dcterms: http://purl.org/dc/terms/
|
|
schema: http://schema.org/
|
|
skos: http://www.w3.org/2004/02/skos/core#
|
|
prov: http://www.w3.org/ns/prov#
|
|
wd: http://www.wikidata.org/entity/
|
|
|
|
default_prefix: hc
|
|
|
|
imports:
|
|
- linkml:types
|
|
- ./FindingAidType
|
|
- ../slots/valid_from
|
|
- ../slots/valid_to
|
|
|
|
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."
|
|
|
|
**WHY THIS CLASS EXISTS**:
|
|
|
|
Previously, Collection had a simple `finding_aid_url` slot (just a URI).
|
|
This was insufficient because:
|
|
|
|
1. **Finding aids have types**: Inventories differ from guides differ from catalogs
|
|
2. **Finding aids have publication histories**: Dates, authors, revisions
|
|
3. **Finding aids exist in multiple formats**: Print, PDF, online database, EAD XML
|
|
4. **Finding aids may be served by digital platforms**: A finding aid can BE a portal
|
|
5. **Finding aids change over time**: Superseded by new versions
|
|
|
|
**ONTOLOGY ALIGNMENT**:
|
|
|
|
1. **RiC-O (Records in Contexts)**:
|
|
- `rico:FindingAid` - Core class for archival finding aids
|
|
- `rico:isDescribedBy` - Links RecordSet to FindingAid
|
|
- `rico:describesOrDescribed` - Links FindingAid to RecordSet
|
|
|
|
2. **CIDOC-CRM**:
|
|
- `crm:E31_Document` - Conceptual object embodying description
|
|
- `crm:E33_Linguistic_Object` - Textual content
|
|
- `crm:P70_documents` - Documents relationship
|
|
|
|
3. **BIBFRAME**:
|
|
- `bf:Work` - Intellectual content of finding aid
|
|
- `bf:Instance` - Specific manifestation (print edition, online version)
|
|
- `bf:Item` - Physical copy
|
|
|
|
4. **Schema.org**:
|
|
- `schema:CreativeWork` - Published finding aid
|
|
- `schema:Dataset` - Structured data form
|
|
- `schema:DigitalDocument` - Digital format
|
|
|
|
**RELATIONSHIP TO COLLECTION**:
|
|
|
|
```
|
|
Collection
|
|
│
|
|
└── finding_aids: FindingAid[]
|
|
│
|
|
├── finding_aid_type_ref → FindingAidType
|
|
│ (Inventory, Catalogue, Guide, etc.)
|
|
│
|
|
├── finding_aid_url → URI (online access)
|
|
│
|
|
├── finding_aid_served_by → DigitalPlatform (optional)
|
|
│ (Portal that hosts/serves the finding aid)
|
|
│
|
|
└── finding_aid_format → (EAD, PDF, HTML, database, etc.)
|
|
```
|
|
|
|
**RELATIONSHIP TO DIGITAL PLATFORMS**:
|
|
|
|
Finding aids can be:
|
|
1. **Served BY** a digital platform (e.g., PDF on institutional website)
|
|
2. **Implemented AS** a digital platform (e.g., searchable online database)
|
|
|
|
The `finding_aid_served_by` slot links to DigitalPlatform, AuxiliaryDigitalPlatform, or WebPortal
|
|
when the finding aid is hosted on a specific platform.
|
|
|
|
**USE CASES**:
|
|
|
|
1. **Archival Inventory (EAD)**:
|
|
```yaml
|
|
FindingAid:
|
|
finding_aid_id: "https://nde.nl/finding-aid/nationaal-archief-voc-inventory"
|
|
finding_aid_title: "Inventory of the Records of the VOC"
|
|
finding_aid_type_ref: ArchivalInventory
|
|
finding_aid_format: EAD
|
|
finding_aid_url: "https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02"
|
|
finding_aid_publication_date: "2020-03-15"
|
|
finding_aid_language: "nl"
|
|
```
|
|
|
|
2. **Library Catalog (Online)**:
|
|
```yaml
|
|
FindingAid:
|
|
finding_aid_id: "https://nde.nl/finding-aid/kb-special-collections-catalog"
|
|
finding_aid_title: "Special Collections Catalog"
|
|
finding_aid_type_ref: LibraryCatalog
|
|
finding_aid_format: ONLINE_DATABASE
|
|
finding_aid_url: "https://www.kb.nl/search"
|
|
finding_aid_served_by: "https://nde.nl/platform/kb-discovery"
|
|
```
|
|
|
|
3. **Museum Guide (Print + PDF)**:
|
|
```yaml
|
|
FindingAid:
|
|
finding_aid_id: "https://nde.nl/finding-aid/rijksmuseum-collection-guide"
|
|
finding_aid_title: "Guide to the Rijksmuseum Collection"
|
|
finding_aid_type_ref: RepositoryGuide
|
|
finding_aid_format: PDF
|
|
finding_aid_url: "https://www.rijksmuseum.nl/collection-guide.pdf"
|
|
finding_aid_publication_date: "2022-01-01"
|
|
finding_aid_isbn: "978-90-71450-XX-X"
|
|
```
|
|
|
|
exact_mappings:
|
|
- rico:FindingAid
|
|
|
|
close_mappings:
|
|
- crm:E31_Document
|
|
- bf:Work
|
|
- schema:CreativeWork
|
|
|
|
related_mappings:
|
|
- crm:E33_Linguistic_Object
|
|
- bf:Instance
|
|
- schema:Dataset
|
|
|
|
slots:
|
|
- finding_aid_id
|
|
- finding_aid_title
|
|
- finding_aid_type_ref
|
|
- finding_aid_description
|
|
- finding_aid_format
|
|
- finding_aid_url
|
|
- finding_aid_ead_id
|
|
- finding_aid_language
|
|
- finding_aid_creator
|
|
- finding_aid_publisher
|
|
- finding_aid_publication_date
|
|
- finding_aid_revision_date
|
|
- finding_aid_isbn
|
|
- finding_aid_served_by
|
|
- finding_aid_supersedes
|
|
- finding_aid_superseded_by
|
|
- finding_aid_scope_note
|
|
- valid_from
|
|
- valid_to
|
|
|
|
slot_usage:
|
|
finding_aid_id:
|
|
slot_uri: dcterms:identifier
|
|
description: |
|
|
Unique identifier for this finding aid.
|
|
Format: URI following NDE Heritage Custodian ontology conventions.
|
|
range: uriorcurie
|
|
required: true
|
|
identifier: true
|
|
examples:
|
|
- value: "https://nde.nl/finding-aid/nationaal-archief-voc-inventory"
|
|
description: "VOC inventory at Nationaal Archief"
|
|
|
|
finding_aid_title:
|
|
slot_uri: dcterms:title
|
|
description: |
|
|
Title of the finding aid.
|
|
|
|
Dublin Core: title for the name of the resource.
|
|
range: string
|
|
required: true
|
|
examples:
|
|
- value: "Inventory of the Records of the Dutch East India Company (VOC)"
|
|
description: "Archival inventory title"
|
|
- value: "Guide to the Special Collections"
|
|
description: "Library guide title"
|
|
|
|
finding_aid_type_ref:
|
|
slot_uri: rico:hasRecordSetType
|
|
description: |
|
|
Classification of this finding aid from FindingAidType hierarchy.
|
|
|
|
Links to FindingAidType class (Inventory, Catalogue, Guide, etc.)
|
|
providing semantic classification of the finding aid.
|
|
range: FindingAidType
|
|
required: true
|
|
examples:
|
|
- value: "ArchivalInventory"
|
|
description: "Detailed archival inventory"
|
|
- value: "LibraryCatalog"
|
|
description: "Library OPAC"
|
|
- value: "RepositoryGuide"
|
|
description: "Institution-wide guide"
|
|
|
|
finding_aid_description:
|
|
slot_uri: dcterms:description
|
|
description: |
|
|
Brief description of the finding aid's scope and contents.
|
|
range: string
|
|
examples:
|
|
- value: >-
|
|
Comprehensive inventory of VOC records (1602-1799) with box/folder
|
|
level descriptions, name index, and subject guide.
|
|
|
|
finding_aid_format:
|
|
slot_uri: dcterms:format
|
|
description: |
|
|
Format/media type of the finding aid.
|
|
|
|
Common values:
|
|
- EAD (Encoded Archival Description XML)
|
|
- PDF (Portable Document Format)
|
|
- HTML (Web page)
|
|
- ONLINE_DATABASE (Searchable database)
|
|
- PRINT (Physical publication)
|
|
- MARC (MARC21 records)
|
|
- CSV (Spreadsheet export)
|
|
|
|
Multiple formats may exist for the same finding aid.
|
|
range: string
|
|
multivalued: true
|
|
examples:
|
|
- value: "EAD"
|
|
description: "EAD XML finding aid"
|
|
- value: "PDF"
|
|
description: "PDF document"
|
|
- value: "ONLINE_DATABASE"
|
|
description: "Searchable web database"
|
|
|
|
finding_aid_url:
|
|
slot_uri: schema:url
|
|
description: |
|
|
URL for online access to the finding aid.
|
|
|
|
This is the primary access point for digital finding aids.
|
|
May link to:
|
|
- EAD XML file
|
|
- PDF document
|
|
- Web catalog interface
|
|
- Discovery portal
|
|
range: uri
|
|
examples:
|
|
- value: "https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02"
|
|
description: "VOC finding aid URL"
|
|
|
|
finding_aid_ead_id:
|
|
slot_uri: rico:identifier
|
|
description: |
|
|
EAD identifier (EADID) for Encoded Archival Description finding aids.
|
|
|
|
The unique identifier within the EAD file, typically matching
|
|
the archive/fonds code.
|
|
range: string
|
|
examples:
|
|
- value: "NL-HaNA_1.04.02"
|
|
description: "VOC EAD identifier"
|
|
|
|
finding_aid_language:
|
|
slot_uri: dcterms:language
|
|
description: |
|
|
Language(s) of the finding aid.
|
|
|
|
Use ISO 639-1 codes (e.g., "en", "nl", "de").
|
|
range: string
|
|
multivalued: true
|
|
examples:
|
|
- value: "nl"
|
|
description: "Dutch"
|
|
- value: "en"
|
|
description: "English"
|
|
|
|
finding_aid_creator:
|
|
slot_uri: dcterms:creator
|
|
description: |
|
|
Person or organization that created the finding aid.
|
|
|
|
Often the archivist, curator, or cataloger responsible for description.
|
|
range: string
|
|
multivalued: true
|
|
examples:
|
|
- value: "Nationaal Archief, Afdeling Toegangen"
|
|
description: "Organizational creator"
|
|
- value: "Dr. J. de Hullu"
|
|
description: "Individual creator"
|
|
|
|
finding_aid_publisher:
|
|
slot_uri: dcterms:publisher
|
|
description: |
|
|
Publisher of the finding aid (for published guides, printed catalogs).
|
|
range: string
|
|
examples:
|
|
- value: "Nationaal Archief"
|
|
description: "Institutional publisher"
|
|
- value: "Brill Publishers"
|
|
description: "Commercial publisher"
|
|
|
|
finding_aid_publication_date:
|
|
slot_uri: dcterms:issued
|
|
description: |
|
|
Date the finding aid was published or made available.
|
|
range: date
|
|
examples:
|
|
- value: "2020-03-15"
|
|
description: "Publication date"
|
|
|
|
finding_aid_revision_date:
|
|
slot_uri: dcterms:modified
|
|
description: |
|
|
Date of most recent revision/update.
|
|
|
|
Finding aids are living documents that may be updated as collections
|
|
are processed, reprocessed, or new materials are added.
|
|
range: date
|
|
examples:
|
|
- value: "2024-11-01"
|
|
description: "Last revision date"
|
|
|
|
finding_aid_isbn:
|
|
slot_uri: schema:isbn
|
|
description: |
|
|
ISBN for published finding aids (printed guides, catalogs).
|
|
range: string
|
|
pattern: "^(97[89])?[0-9]{9}[0-9X]$"
|
|
examples:
|
|
- value: "9789071450123"
|
|
description: "ISBN-13"
|
|
|
|
finding_aid_served_by:
|
|
slot_uri: schema:provider
|
|
description: |
|
|
Digital platform that hosts/serves this finding aid.
|
|
|
|
Links to DigitalPlatform, AuxiliaryDigitalPlatform, or WebPortal
|
|
when the finding aid is accessible through a specific platform.
|
|
|
|
**Use case**: An EAD finding aid served through a discovery portal,
|
|
or a catalog accessible via institutional website.
|
|
range: uriorcurie
|
|
examples:
|
|
- value: "https://nde.nl/platform/nationaal-archief-portal"
|
|
description: "Served by Nationaal Archief portal"
|
|
- value: "https://nde.nl/platform/archieven-nl"
|
|
description: "Served by Archieven.nl aggregator"
|
|
|
|
finding_aid_supersedes:
|
|
slot_uri: dcterms:replaces
|
|
description: |
|
|
Previous version of this finding aid that this one replaces.
|
|
|
|
Used to track finding aid revision history.
|
|
range: FindingAid
|
|
examples:
|
|
- value: "https://nde.nl/finding-aid/voc-inventory-v1"
|
|
description: "Superseded previous version"
|
|
|
|
finding_aid_superseded_by:
|
|
slot_uri: dcterms:isReplacedBy
|
|
description: |
|
|
Newer version of this finding aid that replaces it.
|
|
|
|
Used when a finding aid is no longer current.
|
|
range: FindingAid
|
|
examples:
|
|
- value: "https://nde.nl/finding-aid/voc-inventory-v3"
|
|
description: "Superseded by newer version"
|
|
|
|
finding_aid_scope_note:
|
|
slot_uri: skos:scopeNote
|
|
description: |
|
|
Additional notes on the scope, coverage, or limitations of the finding aid.
|
|
|
|
May include:
|
|
- Processing notes
|
|
- Restrictions on access
|
|
- Known gaps or omissions
|
|
- Future revision plans
|
|
range: string
|
|
examples:
|
|
- value: >-
|
|
This inventory covers boxes 1-500. Boxes 501-750 are pending
|
|
processing and will be added in a future revision.
|
|
|
|
comments:
|
|
- "FindingAid replaces the simple finding_aid_url slot in Collection"
|
|
- "Links to FindingAidType for classification (Inventory, Catalogue, Guide, etc.)"
|
|
- "Can be finding_aid_served_by a DigitalPlatform, AuxiliaryDigitalPlatform, or WebPortal"
|
|
- "Supports versioning via finding_aid_supersedes/finding_aid_superseded_by relationships"
|
|
- "Aligns with RiC-O FindingAid, CIDOC-CRM E31_Document, BIBFRAME Work"
|
|
- "All slots prefixed with 'finding_aid_' to avoid global slot conflicts"
|
|
|
|
see_also:
|
|
- "https://www.ica.org/standards/RiC/ontology#FindingAid"
|
|
- "http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E31"
|
|
- "http://id.loc.gov/ontologies/bibframe/"
|
|
- "https://www.loc.gov/ead/"
|
|
|
|
examples:
|
|
- value:
|
|
finding_aid_id: "https://nde.nl/finding-aid/nationaal-archief-voc-inventory"
|
|
finding_aid_title: "Inventory of the Records of the Dutch East India Company (VOC)"
|
|
finding_aid_type_ref: "ArchivalInventory"
|
|
finding_aid_description: >-
|
|
Comprehensive inventory of VOC records (1602-1799) with series
|
|
descriptions, box/folder listings, name index, and subject guide.
|
|
finding_aid_format:
|
|
- "EAD"
|
|
- "HTML"
|
|
finding_aid_url: "https://www.nationaalarchief.nl/onderzoeken/archief/1.04.02"
|
|
finding_aid_ead_id: "NL-HaNA_1.04.02"
|
|
finding_aid_language:
|
|
- "nl"
|
|
- "en"
|
|
finding_aid_creator:
|
|
- "Nationaal Archief"
|
|
finding_aid_publication_date: "2020-03-15"
|
|
finding_aid_revision_date: "2024-11-01"
|
|
finding_aid_served_by: "https://nde.nl/platform/nationaal-archief-portal"
|
|
finding_aid_scope_note: "Includes digital surrogates for approximately 30% of the collection."
|
|
description: "VOC archival inventory finding aid"
|
|
|
|
- value:
|
|
finding_aid_id: "https://nde.nl/finding-aid/kb-special-collections"
|
|
finding_aid_title: "Guide to the Special Collections of the Koninklijke Bibliotheek"
|
|
finding_aid_type_ref: "RepositoryGuide"
|
|
finding_aid_description: >-
|
|
Overview of the KB's special collections including medieval manuscripts,
|
|
early printed books, maps, and personal archives.
|
|
finding_aid_format:
|
|
- "PDF"
|
|
- "HTML"
|
|
finding_aid_url: "https://www.kb.nl/en/research/special-collections"
|
|
finding_aid_language:
|
|
- "en"
|
|
- "nl"
|
|
finding_aid_publisher: "Koninklijke Bibliotheek"
|
|
finding_aid_publication_date: "2022-01-01"
|
|
description: "KB special collections guide"
|
|
|
|
# ============================================================================
|
|
# SLOT DEFINITIONS
|
|
# All slots prefixed with "finding_aid_" to avoid conflicts with global slots
|
|
# ============================================================================
|
|
|
|
slots:
|
|
finding_aid_id:
|
|
description: Unique identifier for the finding aid
|
|
range: uriorcurie
|
|
slot_uri: dcterms:identifier
|
|
|
|
finding_aid_title:
|
|
description: Title of the finding aid
|
|
range: string
|
|
slot_uri: dcterms:title
|
|
|
|
finding_aid_type_ref:
|
|
description: Classification from FindingAidType hierarchy
|
|
range: FindingAidType
|
|
slot_uri: rico:hasRecordSetType
|
|
|
|
finding_aid_description:
|
|
description: Description of finding aid scope and contents
|
|
range: string
|
|
slot_uri: dcterms:description
|
|
|
|
finding_aid_format:
|
|
description: Format/media type of the finding aid
|
|
range: string
|
|
multivalued: true
|
|
slot_uri: dcterms:format
|
|
|
|
finding_aid_url:
|
|
description: URL for online access
|
|
range: uri
|
|
slot_uri: schema:url
|
|
|
|
finding_aid_ead_id:
|
|
description: EAD identifier for Encoded Archival Description
|
|
range: string
|
|
slot_uri: rico:identifier
|
|
|
|
finding_aid_language:
|
|
description: Language(s) of the finding aid (ISO 639-1)
|
|
range: string
|
|
multivalued: true
|
|
slot_uri: dcterms:language
|
|
|
|
finding_aid_creator:
|
|
description: Creator of the finding aid
|
|
range: string
|
|
multivalued: true
|
|
slot_uri: dcterms:creator
|
|
|
|
finding_aid_publisher:
|
|
description: Publisher of the finding aid
|
|
range: string
|
|
slot_uri: dcterms:publisher
|
|
|
|
finding_aid_publication_date:
|
|
description: Publication date
|
|
range: date
|
|
slot_uri: dcterms:issued
|
|
|
|
finding_aid_revision_date:
|
|
description: Most recent revision date
|
|
range: date
|
|
slot_uri: dcterms:modified
|
|
|
|
finding_aid_isbn:
|
|
description: ISBN for published finding aids
|
|
range: string
|
|
slot_uri: schema:isbn
|
|
|
|
finding_aid_served_by:
|
|
description: Digital platform hosting the finding aid
|
|
range: uriorcurie
|
|
slot_uri: schema:provider
|
|
|
|
finding_aid_supersedes:
|
|
description: Previous version replaced by this one
|
|
range: FindingAid
|
|
slot_uri: dcterms:replaces
|
|
|
|
finding_aid_superseded_by:
|
|
description: Newer version that replaces this one
|
|
range: FindingAid
|
|
slot_uri: dcterms:isReplacedBy
|
|
|
|
finding_aid_scope_note:
|
|
description: Notes on scope, coverage, or limitations
|
|
range: string
|
|
slot_uri: skos:scopeNote
|