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.
75 lines
3.4 KiB
YAML
75 lines
3.4 KiB
YAML
id: https://nde.nl/ontology/hc/class/OAIPMHEndpoint
|
|
name: oai_pmh_endpoint
|
|
title: OAIPMHEndpoint Class
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
dcat: http://www.w3.org/ns/dcat#
|
|
dcterms: http://purl.org/dc/terms/
|
|
schema: http://schema.org/
|
|
xsd: http://www.w3.org/2001/XMLSchema#
|
|
imports:
|
|
- linkml:types
|
|
- ../enums/OAIDeletedRecordPolicyEnum
|
|
- ../enums/OAIGranularityEnum
|
|
- ../metadata
|
|
- ../slots/has_score
|
|
- ../slots/has_format
|
|
classes:
|
|
OAIPMHEndpoint:
|
|
is_a: DataServiceEndpoint
|
|
class_uri: hc:OAIPMHEndpoint
|
|
description: "OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting)\
|
|
\ endpoint.\n\n**Purpose:**\n\nModels OAI-PMH endpoints for automated metadata\
|
|
\ harvesting from heritage repositories.\nOAI-PMH is the dominant protocol for\
|
|
\ metadata aggregation in the GLAM sector.\n\n**Protocol Overview:**\n\nOAI-PMH\
|
|
\ defines six verbs:\n1. **Identify** - Repository information\n2. **ListMetadataFormats**\
|
|
\ - Available metadata formats\n3. **ListSets** - Collection/set hierarchy\n\
|
|
4. **ListIdentifiers** - Record identifiers\n5. **ListRecords** - Full records\
|
|
\ with metadata\n6. **GetRecord** - Single record by identifier\n\n**Example\
|
|
\ - Nationaal Archief OAI-PMH:**\n\n```yaml\noai_pmh_endpoint:\n endpoint_name:\
|
|
\ \"Nationaal Archief OAI-PMH\"\n base_url: \"https://www.nationaalarchief.nl/onderzoeken/oai-pmh\"\
|
|
\n protocol_version: \"2.0\"\n repository_name: \"Nationaal Archief\"\n admin_email:\
|
|
\ \"helpdesk@nationaalarchief.nl\"\n earliest_datestamp: \"2010-01-01\"\n \
|
|
\ deleted_record_policy: NO\n granularity: YYYY_MM_DD\n metadata_prefixes:\n\
|
|
\ - oai_dc\n - ese\n - edm\n sets:\n - name: \"Fotografische documenten\"\
|
|
\n spec: \"foto\"\n - name: \"Kaarten en tekeningen\"\n spec: \"\
|
|
kaarten\"\n```\n\n**Harvesting Workflow:**\n\n1. Call Identify to get repository\
|
|
\ info\n2. Call ListMetadataFormats to discover available formats\n3. Call ListSets\
|
|
\ to understand collection structure\n4. Call ListRecords with resumptionToken\
|
|
\ for incremental harvesting\n\n**See Also:**\n\n- OAI-PMH Specification: http://www.openarchives.org/OAI/openarchivesprotocol.html\n\
|
|
- Europeana Harvesting: https://pro.europeana.eu/page/harvesting-and-downloads\n"
|
|
slot_usage:
|
|
has_format:
|
|
ifabsent: string(application/xml)
|
|
comments:
|
|
- Primary protocol for metadata harvesting in heritage sector
|
|
- All compliant repositories MUST support oai_dc (Dublin Core) format
|
|
- Use incremental harvesting with from/until parameters for efficiency
|
|
see_also:
|
|
- http://www.openarchives.org/OAI/openarchivesprotocol.html
|
|
- https://www.openarchives.org/OAI/2.0/guidelines.htm
|
|
slots:
|
|
- has_score
|
|
- has_version
|
|
annotations:
|
|
specificity_score: 0.1
|
|
specificity_rationale: Generic utility class/slot created during migration
|
|
custodian_types: '[''*'']'
|
|
OAIPMHSet:
|
|
class_uri: hc:OAIPMHSet
|
|
description: 'Represents an OAI-PMH Set (collection) available for selective harvesting.
|
|
|
|
|
|
Sets provide hierarchical organization of records, allowing harvesters
|
|
|
|
to request records from specific collections.
|
|
|
|
|
|
Set hierarchies use colon separator: "category:subcategory:item"
|
|
|
|
'
|
|
slots:
|
|
- has_score
|
|
- has_name
|
|
- record_count
|