glam/schemas/20251121/linkml/modules/classes/CanonicalForm.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

58 lines
2.2 KiB
YAML

id: https://nde.nl/ontology/hc/class/CanonicalForm
name: canonical_form_class
title: Canonical Form Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
skos: http://www.w3.org/2004/02/skos/core#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../slots/has_or_had_label
- ./Label
default_prefix: hc
classes:
CanonicalForm:
class_uri: skos:Concept
description: 'Represents the canonical/normalized form of an identifier or value.
**PURPOSE**:
While original values may vary in format (spaces, prefixes, case), CanonicalForm provides a standardized representation for: - Consistent storage - Deduplication and matching - Database joins and lookups - Cross-system interoperability
**NORMALIZATION RULES BY STANDARD**:
| Standard | Original | Canonical | |----------|----------|-----------| | ISNI | "0000 0001 2146 5765" | "0000000121465765" | | Wikidata | "http://wikidata.org/entity/Q190804" | "Q190804" | | VIAF | "viaf.org/viaf/148691498" | "148691498" | | DOI | "https://doi.org/10.1234/Ex" | "10.1234/ex" | | ISIL | "NL-AmRMA" | "NL-AmRMA" (already canonical) |
**ONTOLOGY ALIGNMENT**:
| Ontology | Mapping | Rationale | |----------|---------|-----------| | SKOS | skos:Concept | Conceptual representation | | Schema.org | schema:PropertyValue | Name-value pair |
MIGRATED 2026-01-22: Created per slot_fixes.yaml feedback to replace simple canonical_value string with structured class.'
exact_mappings:
- skos:Concept
close_mappings:
- schema:PropertyValue
slots:
- has_or_had_label
slot_usage:
has_or_had_label:
range: string
required: true
inlined: true
attributes:
examples:
- value:
has_or_had_label:
has_or_had_text: '0000000121465765'
- value:
has_or_had_label:
has_or_had_text: Q190804
- value:
has_or_had_label:
has_or_had_text: 10.1234/example
annotations:
specificity_score: 0.3
specificity_rationale: Canonical forms are relevant for identifier lookup across all heritage sectors.
custodian_types: "['*']"