glam/schemas/20251121/linkml/modules/classes/Identifier.yaml
kempersc f30b1777f4 Enhance schema definitions and introduce new classes for DigitalPlatformV2
- Added detailed descriptions for slots: collecting_scope, collection_access, custody_history, education_level, membership_size, and publication_activity to improve clarity and usability.
- Removed the publication_date slot due to migration to a new structure.
- Updated slot fixes with migration notes and adjustments for various slots, ensuring alignment with new ontology standards.
- Introduced new classes for DigitalPlatformV2, including DigitalPlatformV2DataQualityNotes, DigitalPlatformV2DataSource, DigitalPlatformV2KeyContact, DigitalPlatformV2OrganizationProfile, DigitalPlatformV2OrganizationStatus, DigitalPlatformV2PrimaryPlatform, DigitalPlatformV2Provenance, DigitalPlatformV2ServiceDetails, and DigitalPlatformV2TransformationMetadata, each with comprehensive attributes and descriptions.
- Added classes for EnrichmentProvenance and EnrichmentProvenanceEntry to track provenance for enrichment sources, including detailed attributes for verification and source tracking.
- Created LogoClaim, LogoEnrichment, and LogoEnrichmentSummary classes to manage logo and favicon data extracted from web scraping, with attributes for claims and summary statistics.
- Archived the publication_date slot to maintain historical records.
2026-01-18 00:59:51 +01:00

210 lines
7.3 KiB
YAML

id: https://nde.nl/ontology/hc/class/Identifier
name: identifier_classes
title: Identifier Classes (Generic and Custodian-Specific)
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
dcterms: http://purl.org/dc/terms/
adms: http://www.w3.org/ns/adms#
prov: http://www.w3.org/ns/prov#
imports:
- linkml:types
- ../metadata
- ../slots/identifier_scheme
- ../slots/identifier_value
- ../slots/identifies_custodian
- ../slots/defined_by_standard
- ../slots/is_or_was_allocated_by
- ../slots/identifier_format_used
- ../slots/canonical_value
- ../slots/has_or_had_secondary_label
- ../slots/has_allocation_date
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ./AllocationAgency
- ./Custodian
- ./CustodianName
- ./Label
- ./SpecificityAnnotation
- ./Standard
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
default_prefix: hc
classes:
# Generic Identifier class - base for all identifier types
Identifier:
class_uri: schema:PropertyValue
description: |
A generic identifier consisting of a scheme and value pair.
**Purpose**:
Base identifier class for any entity (not just heritage custodians).
Used when a simple scheme + value identifier is needed.
**For heritage custodian identifiers**: Use `CustodianIdentifier` which
extends this class with provenance tracking (allocation agency, standard, etc.)
**Schema.org Alignment**:
Maps to schema:PropertyValue which represents a property-value pair.
- propertyID → identifier_scheme
- value → identifier_value
exact_mappings:
- schema:PropertyValue
- dcterms:identifier
close_mappings:
- adms:Identifier
- skos:notation
slots:
- identifier_scheme
- identifier_value
slot_usage:
identifier_scheme:
range: string
required: true
description: |
The identifier scheme or namespace (e.g., ISIL, Wikidata, URI, INTERNAL_CODE).
examples:
- value: ISIL
description: ISIL identifier scheme
- value: Wikidata
description: Wikidata entity ID
- value: URI
description: Uniform Resource Identifier
- value: EU_FUNDING_TENDERS
description: EU Funding & Tenders portal ID
identifier_value:
range: string
required: true
description: |
The identifier value within the scheme.
examples:
- value: NL-AsdAM
description: ISIL code for Amsterdam Museum
- value: Q190804
description: Wikidata ID for Rijksmuseum
attributes:
identifier_url:
range: uri
description: |
URL form of the identifier (e.g., full Wikidata URL, website URL).
examples:
- value: https://www.wikidata.org/wiki/Q190804
description: Full Wikidata URL for Rijksmuseum
examples:
- value:
identifier_scheme: ISIL
identifier_value: NL-AsdAM
description: Amsterdam Museum ISIL code
- value:
identifier_scheme: Wikidata
identifier_value: Q190804
description: Rijksmuseum Wikidata ID
- value:
identifier_scheme: URI
identifier_value: https://nde.nl/ontology/hc/call/ec/cl2-2025-heritage-01
description: Funding call URI identifier
annotations:
specificity_score: 0.25
specificity_rationale: |
Low specificity - identifiers are broadly useful across all queries
involving entity lookup and cross-referencing.
# Heritage custodian-specific identifier with provenance tracking
CustodianIdentifier:
is_a: Identifier
class_uri: crm:E42_Identifier
description: |
An external identifier assigned to a heritage custodian entity by an authority.
Extends the generic Identifier class with provenance tracking:
- Which authority allocated the identifier
- Under what standard it was assigned
- When it was allocated
- Canonical/normalized form for matching
Connected to the Custodian hub via inverse property crm:P48i_is_preferred_identifier_of
(the Custodian has this Identifier as a preferred identifier).
CIDOC-CRM E42_Identifier: Formal symbols or reference codes for unique identification.
CIDOC-CRM P48_has_preferred_identifier: Links E1_CRM_Entity (Custodian) to E42_Identifier.
**Use for**:
- External authority identifiers (ISIL, Wikidata, VIAF, KvK, ROR)
- Registration numbers and codes
- Persistent identifiers from registries
**Connection to Hub**:
- The Custodian hub uses crm:P48_has_preferred_identifier to point to CustodianIdentifier
- This CustodianIdentifier uses crm:P48i_is_preferred_identifier_of to point back to the Custodian hub
- Enables multiple identifiers per custodian (from different authorities)
**Extended Provenance (v2)**:
The identifier now tracks its full lineage:
- defined_by_standard: Which Standard defines this identifier type (ISIL → ISO 15511)
- allocated_by: Which AllocationAgency assigned this specific identifier
- identifier_format_used: Which format variant is used in identifier_value
- canonical_value: Normalized form for deduplication and matching
- allocation_date: When the identifier was assigned
**Dual-Purpose Identifiers**:
Some identifiers (ISNI, VIAF) also identify name authority records:
- has_or_had_secondary_label: Links to the CustodianName record this identifier also identifies (as a Label)
**Enables**:
- External identifier management (scheme + value)
- Cross-reference to authority registries
- Persistent identifier resolution
- Inter-dataset linking
- Full provenance tracking (who allocated, when, under what standard)
- Name authority linkage (for ISNI, VIAF)
exact_mappings:
- crm:E42_Identifier
close_mappings:
- schema:identifier
- adms:Identifier
- skos:notation
related_mappings:
- owl:sameAs
slots:
- is_or_was_allocated_by
- has_allocation_date
- has_or_had_secondary_label
- canonical_value
- defined_by_standard
- identifier_format_used
- identifies_custodian
- specificity_annotation
- has_or_had_score
slot_usage:
identifies_custodian:
range: Custodian
required: false
defined_by_standard:
required: false
is_or_was_allocated_by:
required: false
identifier_format_used:
required: false
canonical_value:
required: false
has_or_had_secondary_label:
description: |
For dual-purpose identifiers (ISNI, VIAF), links to the name authority
record this identifier also identifies.
range: Label
required: false
has_allocation_date:
required: false
annotations:
specificity_score: 0.30
specificity_rationale: |
Slightly higher specificity than generic Identifier due to
heritage custodian-specific provenance tracking.