glam/frontend/public/schemas/20251121/linkml/modules/classes/FindingAid.yaml
kempersc a4184cb805 feat(infra): add webhook-based schema deployment pipeline
- Add FastAPI webhook receiver for Forgejo push events
- Add setup script for server deployment
- Add Caddy snippet for webhook endpoint
- Add local sync-schemas.sh helper script
- Sync frontend schemas with source (archived deprecated slots)

Infrastructure scripts staged for optional webhook deployment.
Current deployment uses: ./infrastructure/deploy.sh --frontend
2026-01-10 21:45:02 +01:00

1525 lines
44 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
- ../slots/valid_from
- ../slots/valid_to
- ../slots/id
- ../slots/description
- ../slots/temporal_coverage
- ../slots/has_or_had_access_restriction
- ../slots/has_or_had_web_claim
- ../slots/language
- ../slots/supersede
- ../slots/superseded_by
- ../slots/revision_date
- ../slots/served_by
- ../slots/retrieval_agent
- ../slots/extraction_note
- ../slots/extraction_method
- ../slots/xpath
- ../slots/css_selector
- ../slots/confidence
- ../slots/html_file
- ../slots/claim_id
- ../slots/claim_type
- ../slots/claim_value
- ../slots/source_url
- ../slots/title
- ../slots/date
- ../slots/note
- ../slots/creator
- ../slots/publisher
- ../slots/publication_date
- ../slots/isbn
- ../slots/has_or_had_access_condition
- ../slots/is_or_was_access_restricted
- ../slots/all_links
- ../slots/card_description
- ../slots/card_description_en
- ../slots/card_image_url
- ../slots/card_title
- ../slots/card_title_en
- ../slots/card_url
- ../slots/claims_count
- ../slots/colonial
- ../slots/content_block
- ../slots/crawler_version
- ../slots/custodian
- ../slots/date_retrieved
- ../slots/de
- ../slots/ead_id
- ../slots/en
- ../slots/end
- ../slots/has_or_had_external_resource
- ../slots/has_or_had_featured_item
- ../slots/finding_aid_note
- ../slots/finding_aid_scope_note
- ../slots/finding_aid_type
- ../slots/format
- ../slots/fr
- ../slots/full_name
- ../slots/geographic_coverage
- ../slots/ghcid
- ../slots/heading_level
- ../slots/heading_text
- ../slots/heading_text_en
- ../slots/historical_region
- ../slots/html_snapshot_path
- ../slots/inbound_from
- ../slots/international
- ../slots/is_sub_guide
- ../slots/isil
- ../slots/has_or_had_key_archive
- ../slots/has_or_had_key_date
- ../slots/has_or_had_key_period
- ../slots/link_context
- ../slots/link_text
- ../slots/link_type
- ../slots/link_url
- ../slots/list_item
- ../slots/location
- ../slots/major_city
- ../slots/name
- ../slots/nl
- ../slots/outbound_to
- ../slots/has_or_had_page_section
- ../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/has_or_had_related_archive
- ../slots/has_or_had_related_guide
- ../slots/relationship
- ../slots/resource_description
- ../slots/restriction_description
- ../slots/restriction_type
- ../slots/scope
- ../slots/secondary
- ../slots/section_id
- ../slots/has_or_had_section_link
- ../slots/slug
- ../slots/specificity_annotation
- ../slots/start
- ../slots/sub_guide_description
- ../slots/sub_guide_temporal_coverage
- ../slots/sub_guide_type
- ../slots/has_or_had_sub_guide
- ../slots/has_or_had_sub_section
- ../slots/template_specificity
- ../slots/title_en
- ../slots/title_nl
- ../slots/topic
- ../slots/type
- ../slots/url
- ../slots/validation_status
- ../slots/wikidata
- ../slots/wikidata_class
- ../slots/years_restricted
- ./ArchiveReference
- ./CustodianReference
- ./ExternalResource
- ./FeaturedCard
- ./FindingAidProvenance
- ./GeographicCoverage
- ./KeyDate
- ./PageLink
- ./PageSection
- ./PersonWebClaim
- ./RelatedGuideReference
- ./SpecificityAnnotation
- ./SubGuideReference
- ./TemplateSpecificityScores
- ./TemporalPeriod
- ./TimeSpan
enums:
ExternalResourceTypeEnum:
description: |
Types of external resources linked from finding aids.
permissible_values:
database:
description: Searchable online database
organization:
description: Related organization or society
portal:
description: Discovery portal or aggregator
archive:
description: External archive holding related materials
library:
description: Library with related holdings
museum:
description: Museum with related collections
website:
description: General website resource
api:
description: API endpoint for programmatic access
reference:
description: Reference material or documentation
research_institute:
description: Research institution or academic center
aggregator:
description: Data aggregator or harvesting service
SubGuideTypeEnum:
description: |
Types of sub-guide references within a repository guide.
permissible_values:
sub_guide:
description: Direct sub-guide within same repository
cross_reference:
description: Cross-reference to another main guide
thematic:
description: Thematic sub-collection
regional:
description: Regional sub-guide
RelationshipTypeEnum:
description: |
Types of relationships between finding aids.
permissible_values:
cross_reference:
description: Related guide on related topic
parent:
description: Parent guide containing this guide
child:
description: Child guide within this guide
see_also:
description: See also reference
predecessor:
description: Previous version of this guide
successor:
description: Newer version of this guide
LinkTypeEnum:
description: |
Types of hyperlinks extracted from pages.
permissible_values:
internal:
description: Link within same domain
external:
description: Link to external domain
anchor:
description: Same-page anchor link
download:
description: Link to downloadable file
sub_guide:
description: Link to a sub-guide finding aid
featured:
description: Featured/highlighted link
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:
- rico:FindingAid
close_mappings:
- dcterms:BibliographicResource
- schema:CreativeWork
- crm:E31_Document
- bf:Work
slots:
- finding_aid_access_restriction
- all_links
- creator
- custodian
- finding_aid_description
- ead_id
- has_or_had_external_resource
- finding_aid_note
- finding_aid_type
- format
- geographic_coverage
- id
- isbn
- has_or_had_key_archive
- language
- note
- has_or_had_page_section
- provenance
- publication_date
- publisher
- has_or_had_related_archive
- has_or_had_related_guide
- revision_date
- finding_aid_scope_note
- served_by
- slug
- specificity_annotation
- has_or_had_sub_guide
- superseded_by
- supersede
- template_specificity
- finding_aid_temporal_coverage
- title
- topic
- url
- valid_from
- valid_to
- has_or_had_web_claim
- wikidata_class
slot_usage:
id:
identifier: true
required: true
slug:
required: true
finding_aid_type:
required: true
title:
required: true
url:
required: true
custodian:
required: true
finding_aid_description:
slot_uri: dcterms:description
range: MultilingualText
inlined: true
description: Multilingual description of the finding aid
finding_aid_temporal_coverage:
slot_uri: dcterms:temporal
range: TemporalCoverage
inlined: true
description: Time period covered by the finding aid materials
finding_aid_access_restriction:
slot_uri: dcterms:accessRights
range: AccessRestriction
multivalued: true
inlined_as_list: true
description: Access restrictions for materials covered
has_or_had_web_claim:
slot_uri: prov:wasGeneratedBy
range: WebClaim
multivalued: true
inlined_as_list: true
description: Web claims with XPath provenance
language:
slot_uri: dcterms:language
multivalued: true
description: Language(s) of the finding aid (ISO 639-1 codes)
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- Root class for finding aid metadata YAML files
- Designed for validation with linkml-validate
- Supports Nationaal Archief zoekhulpen structure
- Merged from FindingAidMetadata.yaml (slot names) and FindingAid.yaml (bibliographic
slots)
see_also:
- https://www.ica.org/standards/RiC/ontology#FindingAid
- https://www.nationaalarchief.nl/onderzoeken/zoekhulpen
- http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E31
- http://id.loc.gov/ontologies/bibframe/
MultilingualText:
class_uri: skos:Concept
description: |
Container for multilingual text values (titles, descriptions).
Supports any ISO 639-1 language code as a slot name.
Common slots: nl (Dutch), en (English), de (German), fr (French).
slots:
- de
- en
- fr
- nl
- specificity_annotation
- template_specificity
slot_usage:
nl:
description: Dutch text
en:
description: English text
de:
description: German text
fr:
description: French text
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- At least one language slot should be populated
- nl is primary for Dutch archives
CustodianReference:
class_uri: rico:Agent
description: |
Reference to the heritage custodian that created/maintains this finding aid.
Uses standard identifiers: GHCID, ISIL, Wikidata ID.
slots:
- ghcid
- isil
- name
- specificity_annotation
- template_specificity
- wikidata
slot_usage:
ghcid:
description: Global Heritage Custodian Identifier
required: true
pattern: ^[A-Z]{2}-[A-Z]{2}-[A-Z]{3}-[A-Z]-[A-Z0-9]+$
isil:
description: International Standard Identifier for Libraries (ISO 15511)
pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
name:
description: Human-readable name of custodian
required: true
wikidata:
description: Wikidata entity ID (Q-number)
pattern: ^Q[0-9]+$
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- rico:Agent
- schema:Organization
TemporalCoverage:
class_uri: dcterms:PeriodOfTime
description: |
Time period covered by the finding aid's materials.
Supports both numeric years and special values like "present".
Can include named periods (key_periods) and significant dates (key_dates).
slots:
- end
- has_or_had_key_date
- has_or_had_key_period
- note
- has_or_had_period
- specificity_annotation
- start
- template_specificity
slot_usage:
start:
description: Start year of coverage
range: TemporalValue
required: true
end:
description: End year of coverage (use "present" for ongoing)
range: TemporalValue
required: true
note:
description: Additional notes about temporal coverage
has_or_had_period:
description: Named periods within coverage
range: TemporalPeriod
multivalued: true
inlined_as_list: true
has_or_had_key_period:
description: Named historical periods (alias for periods)
range: TemporalPeriod
multivalued: true
inlined_as_list: true
has_or_had_key_date:
description: Significant historical dates
range: KeyDate
multivalued: true
inlined_as_list: true
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- dcterms:PeriodOfTime
- schema:temporalCoverage
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
- template_specificity
slot_usage:
period_name:
description: Name of the period
range: string
required: true
aliases:
- name
period:
description: Period as single string (e.g., "1945-1965")
range: string
period_start:
description: Start year
range: TemporalValue
aliases:
- start
period_end:
description: End year
range: TemporalValue
aliases:
- end
period_description:
description: Description of the period
range: string
aliases:
- description
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
KeyDate:
class_uri: schema:Event
description: |
A significant historical date with event description.
Used for key_dates within TemporalCoverage.
attributes:
date_value:
description: ISO 8601 date (YYYY-MM-DD or YYYY)
range: string
required: true
aliases:
- date
event:
description: Description of what happened (Dutch or original)
range: string
required: true
event_en:
description: English translation of event description
range: string
slots:
- specificity_annotation
- template_specificity
slot_usage:
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
GeographicCoverage:
class_uri: dcterms:Location
description: |
Geographic area covered by the finding aid's materials.
Supports primary areas, secondary/related areas, and migration patterns.
slots:
- colonial
- historical_region
- inbound_from
- international
- major_city
- outbound_to
- primary
- related
- scope
- secondary
- specificity_annotation
- template_specificity
slot_usage:
primary:
description: Primary geographic areas covered
multivalued: true
scope:
description: Description of geographic scope
secondary:
description: Secondary geographic areas (less prominent coverage)
multivalued: true
related:
description: Related geographic areas (e.g., for WWII - Germany, Japan)
multivalued: true
historical_region:
description: Historical region names (may no longer exist)
multivalued: true
colonial:
description: Colonial territories covered
multivalued: true
international:
description: International scope descriptions
multivalued: true
major_city:
description: Major cities within coverage area
multivalued: true
inbound_from:
description: Migration origin countries/regions (for migration guides)
multivalued: true
outbound_to:
description: Migration destination countries/regions
multivalued: true
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: 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
- sub_guide_description
- sub_guide_temporal_coverage
- sub_guide_type
- template_specificity
- title_en
- title_nl
- url
slot_usage:
slug:
description: URL slug identifier
required: true
title_nl:
description: Dutch title
required: true
title_en:
description: English title
url:
description: Relative or absolute URL to sub-guide
required: true
sub_guide_temporal_coverage:
description: Time period covered (free text, e.g., "1811-1935", "before 1811")
sub_guide_description:
description: Brief description of the sub-guide content
sub_guide_type:
description: Type of sub-guide reference
range: SubGuideTypeEnum
is_or_was_access_restricted:
description: Whether access to this sub-guide is restricted
range: boolean
note:
description: Additional notes about this sub-guide reference
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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
- isil
- location
- name
- resource_description
- specificity_annotation
- sub_guide_temporal_coverage
- template_specificity
- url
slot_usage:
name:
description: Short name or has_or_had_abbreviation
required: true
full_name:
description: Full official name
resource_description:
description: Description of the archive's relevance
location:
description: Physical location (city, country)
url:
description: URL to archive website
range: uri
required: false
isil:
description: ISIL code of the archive (ISO 15511)
pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
sub_guide_temporal_coverage:
description: Time period of holdings (free text)
has_or_had_access_condition:
description: Access restrictions or requirements
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- rico:RecordSet
- schema:ArchiveOrganization
RelatedGuideReference:
class_uri: rico:FindingAid
description: |
Reference to a related finding aid guide within the same repository.
Different from sub_guides: these are peer-level guides on related topics,
not hierarchically nested guides.
slots:
- relationship
- slug
- specificity_annotation
- template_specificity
- title_en
- title_nl
slot_usage:
slug:
description: URL slug identifier
required: true
title_nl:
description: Dutch title
required: true
title_en:
description: English title
relationship:
description: Type of relationship
range: RelationshipTypeEnum
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
AccessRestriction:
class_uri: dcterms:RightsStatement
description: |
Access restriction information for materials.
slots:
- permission_required
- restriction_description
- restriction_type
- specificity_annotation
- template_specificity
- years_restricted
slot_usage:
restriction_type:
description: Type of restriction (privacy, cabr, closed, etc.)
required: true
restriction_description:
description: Description of the restriction
years_restricted:
description: Number of years materials are restricted
range: integer
permission_required:
description: Whether explicit permission is required
range: boolean
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
ExternalResource:
class_uri: foaf:Document
description: |
Reference to an external resource (database, organization, portal).
Used to link finding aids to related external resources that complement
the archive's holdings (e.g., genealogical databases, historical societies).
slots:
- name
- resource_description
- specificity_annotation
- template_specificity
- type
- url
slot_usage:
name:
description: Name of external resource
required: true
url:
description: URL to external resource
range: uri
required: true
type:
description: Type of resource
range: ExternalResourceTypeEnum
resource_description:
description: Brief description of the resource
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- foaf:Document
- schema:WebPage
FindingAidProvenance:
class_uri: prov:Activity
description: |
Provenance metadata for web-harvested finding aid information.
Tracks when and how the metadata was retrieved, enabling data freshness
assessment and re-crawling decisions.
slots:
- claims_count
- crawler_version
- date_retrieved
- extraction_method
- extraction_note
- html_snapshot_path
- note
- retrieval_agent
- source_url
- specificity_annotation
- template_specificity
- validation_status
slot_usage:
date_retrieved:
description: ISO 8601 date when data was retrieved
range: date
required: true
retrieval_agent:
description: Tool/method used for retrieval
required: true
source_url:
description: Original source URL
range: uri
extraction_note:
description: Notes about extraction process or quality
extraction_method:
description: Method used (manual, automated, hybrid)
crawler_version:
description: Version of crawling tool used
html_snapshot_path:
description: Relative path to archived HTML snapshot
claims_count:
description: Number of web claims extracted
range: integer
validation_status:
description: Status of validation (validated, pending, failed)
note:
description: Additional provenance notes or remarks
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
exact_mappings:
- prov:Activity
PageSection:
class_uri: schema:WebPageElement
description: |
A section of a finding aid page with heading and content.
Captures the hierarchical structure of web pages for preservation
and semantic understanding.
slots:
- content_block
- has_or_had_featured_item
- heading_level
- heading_text
- heading_text_en
- list_item
- section_id
- has_or_had_section_link
- specificity_annotation
- has_or_had_sub_section
- template_specificity
- xpath
slot_usage:
section_id:
description: Unique identifier for this section
heading_level:
description: Heading level (1-6 for h1-h6)
range: integer
minimum_value: 1
maximum_value: 6
heading_text:
description: Text of the section heading (original language)
required: true
heading_text_en:
description: English translation of heading
content_block:
description: Paragraph content within this section
multivalued: true
has_or_had_sub_section:
description: Nested sub-sections
range: PageSection
multivalued: true
inlined_as_list: true
has_or_had_section_link:
description: Links within this section
range: PageLink
multivalued: true
inlined_as_list: true
has_or_had_featured_item:
description: Featured cards/items in this section
range: FeaturedCard
multivalued: true
inlined_as_list: true
list_item:
description: List items (bulleted/numbered) in this section
multivalued: true
xpath:
description: XPath to this section element
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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
- template_specificity
- xpath
slot_usage:
link_text:
description: Visible text of the link
required: true
link_url:
description: URL of the link
range: uri
required: true
link_type:
description: Type of link
range: LinkTypeEnum
link_context:
description: Parent section or surrounding context
is_sub_guide:
description: Whether this is a link to a sub-guide
range: boolean
xpath:
description: XPath to link element
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
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:
- card_description
- card_description_en
- card_image_url
- card_title
- card_title_en
- card_url
- specificity_annotation
- template_specificity
- xpath
slot_usage:
card_title:
description: Title of the card (original language)
required: true
card_title_en:
description: English translation of title
card_description:
description: Description text (original language)
card_description_en:
description: English translation of description
card_url:
description: URL the card links to
range: uri
card_image_url:
description: URL of card image/icon
range: uri
xpath:
description: XPath to card element
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
slots:
slug:
slot_uri: schema:identifier
description: URL-friendly slug identifier
range: string
required: true
pattern: ^[a-z0-9-]+$
examples:
- value: familiegeschiedenis
finding_aid_type:
slot_uri: rico:hasRecordSetType
description: |
Type classification referencing FindingAidType class hierarchy.
Use UPPER_SNAKE_CASE class names derived from the class hierarchy in FindingAidType.yaml.
**VALID VALUES** (28 concrete types with Wikidata mappings):
INVENTORY Branch:
- INVENTORY (Q65769447) - General inventory
- ARCHIVAL_INVENTORY (Q108809848) - Archival materials inventory
- CALENDAR (Q25221891) - Chronological abstracts
- ANALYTICAL_INVENTORY (Q116872592) - Detailed item descriptions
- MUSEUM_INVENTORY (Q6059909) - Museum objects inventory
- LOGISTICS_INVENTORY (Q815410) - Storage/access management
- PERIODIC_INVENTORY (Q7168640) - Regular interval counts
- PERPETUAL_INVENTORY (Q7169552) - Continuous updates
- PHANTOM_INVENTORY (Q7180610) - Missing item tracking
- PHYSICAL_INVENTORY (Q475356) - Hands-on verification
- VENDOR_MANAGED_INVENTORY (Q609498) - External party managed
CATALOGUE Branch:
- CATALOGUE (Q2352616) - Organized structured listing
- LIBRARY_CATALOG (Q856638) - Library holdings (OPAC)
- LOCATION_CATALOG (Q19309479) - Shelf/topographic list
GUIDE Branch:
- GUIDE (Q116767694) - High-level overview
- REPOSITORY_GUIDE (Q117649202) - Institution-wide guide
- SUMMARY_GUIDE (Q117833265) - Collection-level summary
LIST Branch:
- LIST (Q12139612) - Simple enumeration
- SPECIAL_LIST (Q116972118) - Subject/format focused
- BIBLIOGRAPHY (Q1631107) - Published works listing
DATABASE Branch:
- BIBLIOGRAPHIC_DATABASE (Q1789476) - Searchable bibliographic records
- LITERATURE_DATABASE (Q1865123) - Scholarly literature
REVIEW Branch:
- LITERATURE_REVIEW (Q2412849) - Scholarly survey
- BIBLIOGRAPHIC_REVIEW (Q59156132) - Bibliographic essay
INDEX Branch:
- INDEX (Q873506) - Alphabetical/systematic reference
- BIBLIOGRAPHIC_INDEX (Q2033233) - Subject/author index
- LOCATION_INDEX (Q117311578) - Geographic/place index
INSTRUCTIONAL Branch:
- INSTRUCTIONAL_MATERIALS (Q1348645) - Educational resources
- REFERENCE_WORK (Q13136) - Encyclopedias, handbooks
See FindingAidType.yaml for complete class definitions and ontology alignments.
range: string
required: true
pattern: ^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$
examples:
- value: REPOSITORY_GUIDE
description: Institution-wide repository guide (wd:Q117649202)
- value: ARCHIVAL_INVENTORY
description: Detailed archival materials inventory (wd:Q108809848)
- value: LIBRARY_CATALOG
description: Library holdings catalog/OPAC (wd:Q856638)
wikidata_class:
slot_uri: skos:exactMatch
description: Wikidata class ID for this finding aid type
range: string
pattern: ^Q[0-9]+$
examples:
- value: Q117649202
description: Wikidata ID for RepositoryGuide
url:
slot_uri: schema:url
description: URL to the finding aid
range: uri
required: true
custodian:
slot_uri: rico:hasOrHadHolder
description: Heritage custodian that created/maintains this finding aid
range: CustodianReference
required: true
inlined: true
topic:
slot_uri: dcterms:subject
description: Subject topics covered by this finding aid
range: string
multivalued: true
examples:
- value: genealogy
- value: civil_registry
- value: notarial_records
geographic_coverage:
slot_uri: dcterms:spatial
description: Geographic area covered by the finding aid
range: GeographicCoverage
inlined: true
has_or_had_sub_guide:
slot_uri: rico:includes
description: Sub-guides or related finding aids within this repository
range: SubGuideReference
multivalued: true
inlined_as_list: true
has_or_had_external_resource:
slot_uri: dcterms:references
description: External resources related to this finding aid
range: ExternalResource
multivalued: true
inlined_as_list: true
has_or_had_key_archive:
slot_uri: rico:hasOrHadConstituent
description: Key archives relevant to this finding aid topic
range: ArchiveReference
multivalued: true
inlined_as_list: true
has_or_had_related_archive:
slot_uri: rico:isRelatedTo
description: External archives with related holdings
range: ArchiveReference
multivalued: true
inlined_as_list: true
has_or_had_related_guide:
slot_uri: rico:isRelatedTo
description: Related finding aid guides (peer-level, not hierarchical)
range: RelatedGuideReference
multivalued: true
inlined_as_list: true
finding_aid_note:
slot_uri: skos:note
description: General notes about this finding aid
range: string
multivalued: true
finding_aid_description:
slot_uri: dcterms:description
description: Multilingual description of the finding aid content and coverage
range: MultilingualText
inlined: true
finding_aid_temporal_coverage:
slot_uri: dcterms:temporal
description: Time period covered by the finding aid materials
range: TemporalCoverage
inlined: true
finding_aid_access_restriction:
slot_uri: dcterms:accessRights
description: Access restrictions for materials covered by this finding aid
range: AccessRestriction
multivalued: true
inlined_as_list: true
has_or_had_page_section:
slot_uri: schema:hasPart
description: Hierarchical page sections extracted from web page
range: PageSection
multivalued: true
inlined_as_list: true
has_link:
slot_uri: schema:relatedLink
description: All links extracted from the page
range: PageLink
multivalued: true
inlined_as_list: true
provenance:
slot_uri: prov:wasGeneratedBy
description: Provenance information for this metadata record
range: FindingAidProvenance
inlined: true
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)
range: string
multivalued: true
ead_id:
slot_uri: rico:identifier
description: |
EAD identifier (EADID) for Encoded Archival Description finding aids.
range: string
examples:
- value: NL-HaNA_1.04.02
finding_aid_scope_note:
slot_uri: skos:scopeNote
description: |
Additional notes on the scope, coverage, or limitations of the finding aid.
range: string
nl:
description: Dutch language text
range: string
en:
description: English language text
range: string
de:
description: German language text
range: string
fr:
description: French language text
range: string
ghcid:
slot_uri: hc:ghcid
description: Global Heritage Custodian Identifier
range: string
isil:
slot_uri: dcterms:identifier
description: ISIL code (ISO 15511)
range: string
name:
slot_uri: schema:name
description: Human-readable name
range: string
wikidata:
slot_uri: skos:exactMatch
description: Wikidata entity ID
range: string
start:
slot_uri: schema:startDate
description: Start of temporal coverage
range: string
end:
slot_uri: schema:endDate
description: End of temporal coverage
range: string
primary:
slot_uri: dcterms:spatial
description: Primary geographic areas
range: string
multivalued: true
scope:
slot_uri: dcterms:description
description: Scope description
range: string
secondary:
slot_uri: dcterms:spatial
description: Secondary geographic areas
range: string
multivalued: true
related:
slot_uri: dcterms:spatial
description: Related geographic areas
range: string
multivalued: true
historical_region:
slot_uri: dcterms:spatial
description: Historical region names
range: string
multivalued: true
colonial:
slot_uri: dcterms:spatial
description: Colonial territories
range: string
multivalued: true
international:
slot_uri: dcterms:spatial
description: International scope
range: string
multivalued: true
major_city:
slot_uri: dcterms:spatial
description: Major cities
range: string
multivalued: true
inbound_from:
slot_uri: dcterms:spatial
description: Migration origin countries/regions
range: string
multivalued: true
outbound_to:
slot_uri: dcterms:spatial
description: Migration destination countries/regions
range: string
multivalued: true
title_nl:
slot_uri: dcterms:title
description: Dutch title
range: string
title_en:
slot_uri: dcterms:title
description: English title
range: string
type:
slot_uri: dcterms:type
description: Resource type
range: string
date_retrieved:
slot_uri: prov:endedAtTime
description: Date when data was retrieved
range: date
crawler_version:
slot_uri: prov:wasAssociatedWith
description: Version of crawler used
range: string
html_snapshot_path:
slot_uri: prov:used
description: Path to HTML snapshot
range: string
claims_count:
slot_uri: schema:numberOfItems
description: Number of claims extracted
range: integer
validation_status:
slot_uri: schema:status
description: Validation status
range: string
sub_guide_temporal_coverage:
slot_uri: dcterms:temporal
description: Time period covered by sub-guide (free text)
range: string
examples:
- value: 1811-1935
- value: before 1811
- value: 1811-present
sub_guide_description:
slot_uri: dcterms:description
description: Brief description of sub-guide content
range: string
sub_guide_type:
slot_uri: dcterms:type
description: Type of sub-guide reference
range: SubGuideTypeEnum
is_or_was_access_restricted:
slot_uri: dcterms:accessRights
description: Whether access is restricted
range: boolean
resource_description:
slot_uri: dcterms:description
description: Brief description of an external resource
range: string
examples:
- value: Dutch genealogical database aggregator
- value: Center for Family History
full_name:
slot_uri: schema:legalName
description: Full official name
range: string
location:
slot_uri: schema:location
description: Physical location
range: string
has_or_had_access_condition:
slot_uri: dcterms:accessRights
description: Access restrictions or requirements
range: string
relationship:
slot_uri: dcterms:relation
description: Type of relationship
range: RelationshipTypeEnum
restriction_type:
slot_uri: dcterms:type
description: Type of access restriction
range: string
restriction_description:
slot_uri: dcterms:description
description: Description of restriction
range: string
years_restricted:
slot_uri: schema:duration
description: Years restricted
range: integer
permission_required:
slot_uri: dcterms:accessRights
description: Whether permission is required
range: boolean
period_name:
slot_uri: skos:prefLabel
description: Name of the period
range: string
period:
slot_uri: dcterms:temporal
description: Period as string
range: string
period_start:
slot_uri: schema:startDate
description: Start of period
range: string
period_end:
slot_uri: schema:endDate
description: End of period
range: string
period_description:
slot_uri: dcterms:description
description: Description of period
range: string
event:
slot_uri: schema:description
description: Event description
range: string
event_en:
slot_uri: schema:description
description: Event description in English
range: string
claim_source_url:
slot_uri: prov:used
description: Source URL of claim
range: uri
section_id:
slot_uri: dcterms:identifier
description: Section identifier
range: string
heading_level:
slot_uri: hc:headingLevel
description: Heading level (1-6)
range: integer
heading_text:
slot_uri: dcterms:title
description: Heading text
range: string
heading_text_en:
slot_uri: dcterms:title
description: Heading text in English
range: string
content_block:
slot_uri: schema:text
description: Content paragraphs
range: string
multivalued: true
has_or_had_sub_section:
slot_uri: schema:hasPart
description: Nested sections
range: PageSection
multivalued: true
has_or_had_section_link:
slot_uri: schema:relatedLink
description: Links in section
range: PageLink
multivalued: true
has_or_had_featured_item:
slot_uri: schema:hasPart
description: Featured items
range: FeaturedCard
multivalued: true
list_item:
slot_uri: schema:itemListElement
description: List items
range: string
multivalued: true
link_text:
slot_uri: schema:name
description: Link text
range: string
link_url:
slot_uri: schema:url
description: Link URL
range: uri
link_type:
slot_uri: dcterms:type
description: Type of link
range: LinkTypeEnum
link_context:
slot_uri: hc:context
description: Link context
range: string
is_sub_guide:
slot_uri: hc:isSubGuide
description: Whether link is to sub-guide
range: boolean
card_title:
slot_uri: dcterms:title
description: Card title
range: string
card_title_en:
slot_uri: dcterms:title
description: Card title in English
range: string
card_description:
slot_uri: dcterms:description
description: Card description
range: string
card_description_en:
slot_uri: dcterms:description
description: Card description in English
range: string
card_url:
slot_uri: schema:url
description: Card link URL
range: uri
card_image_url:
slot_uri: schema:image
description: Card image URL
range: uri
has_or_had_key_period:
slot_uri: dcterms:temporal
description: Named historical periods
range: TemporalPeriod
multivalued: true
has_or_had_key_date:
slot_uri: dcterms:date
description: Significant historical dates
range: KeyDate
multivalued: true
has_or_had_period:
slot_uri: dcterms:temporal
description: Named periods within coverage (uses TemporalPeriod class)
range: TemporalPeriod
multivalued: 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"