glam/schemas/20251121/linkml/modules/classes/OrganizationalChangeEvent.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

201 lines
9.1 KiB
YAML

id: https://nde.nl/ontology/hc/class/OrganizationalChangeEvent
name: organizational_change_event_class
title: OrganizationalChangeEvent Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
prov: http://www.w3.org/ns/prov#
rico: https://www.ica.org/standards/RiC/ontology#
org: http://www.w3.org/ns/org#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
geosparql: http://www.opengis.net/ont/geosparql#
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_description
- ../slots/has_or_had_documentation
- ../slots/has_or_had_origin
- ../slots/has_or_had_rationale
- ../slots/has_or_had_score
- ../slots/has_or_had_type
- ../slots/has_or_had_url
- ../slots/is_or_was_transferred_to
- ../slots/staff_impact
- ../slots/temporal_extent
- ../enums/OrganizationalChangeEventTypeEnum
classes:
OrganizationalChangeEvent:
class_uri: crm:E5_Event
description: 'An event documenting organizational change in a heritage custodian''s structure.
Tracks:
- Mergers (multiple units combining into one)
- Splits (one unit dividing into multiple)
- Dissolutions (unit ceasing to exist)
- Reorganizations (structural changes, reporting line shifts)
- Renamings (unit name changes without functional change)
- Transfers (unit moving between parent departments)
- Relocations (physical location changes)
**Why OrganizationalChangeEvent?**:
- Provides structured provenance for organizational history
- Documents rationale for changes (budget cuts, strategic reorganization, etc.)
- Links dissolved units to successor units
- Tracks affected staff, collections, and functions
- Records geographic/territorial impacts (jurisdiction changes)
**Integration with Place Classes**:
| Slot | Class | Purpose |
|------|-------|---------|
| is_or_was_located_at | CustodianPlace | Where event occurred (board meeting, ceremony) |
| from_location | CustodianPlace | Previous location (RELOCATION) |
| to_location | CustodianPlace | New location (RELOCATION) |
| has_or_had_affected_territory | GeoSpatialPlace | Geographic areas affected (jurisdictions, boundaries) |
CustodianPlace provides nominal references ("the boardroom"), while
GeoSpatialPlace provides precise coordinates (lat/lon, WKT polygons).
**TOOI Alignment**:
Following TOOI pattern where organizational events (Wijzigingsgebeurtenis)
can affect administrative territories (BestuurlijkeRuimte).
**Integration with OrganizationalStructure**:
- OrganizationalStructure.valid_to date = OrganizationalChangeEvent.event_date (for dissolved units)
- OrganizationalStructure.valid_from date = OrganizationalChangeEvent.event_date (for created units)
- Change event provides the "why" (rationale), temporal validity provides the "when" (dates)
'
exact_mappings:
- crm:E5_Event
close_mappings:
- prov:Activity
- rico:Event
- org:changeEvent
- schema:Event
related_mappings:
- crm:E10_Transfer_of_Custody
- crm:E12_Production
- crm:E64_End_of_Existence
- crm:E9_Move
- geosparql:Feature
slots:
- has_or_had_rationale
- has_or_had_documentation
- temporal_extent
- has_or_had_description
- has_or_had_type
- has_or_had_origin
- staff_impact
- has_or_had_score
- is_or_was_transferred_to
slot_usage:
has_or_had_type:
required: true
range: OrganizationalChangeEventTypeEnum
examples:
- value: MERGER
- value: REORGANIZATION
temporal_extent:
required: true
range: TimeSpan
inlined: true
examples:
- value:
begin_of_the_begin: '2013-04-01'
has_or_had_description:
required: true
range: string
examples:
- value: Merger of Restoration Department (12 FTE, founded 1885) and Research Department (16 FTE) to form Conservation and Research Department (28 FTE). Implemented as part of museum renovation and reopening strategy. Combined conservation lab facilities and integrated scientific research with conservation practice.
has_or_had_rationale:
range: string
inlined: true
examples:
- value:
has_or_had_description: Part of 10-year museum renovation (2003-2013). Reorganization aimed to integrate conservation science with practice.
staff_impact:
range: string
examples:
- value: 28 FTE total (12 from Restoration + 16 from Research). All existing staff retained. 5 new positions created for scientific imaging and digital conservation. 3 staff retirements (planned succession).
has_or_had_origin:
range: CustodianPlace
required: false
examples:
- value:
place_name: Stadhouderskade 42
place_specificity: BUILDING
is_or_was_transferred_to:
range: CustodianPlace
required: false
examples:
- value:
place_name: Museumstraat 1
place_specificity: BUILDING
has_or_had_documentation:
range: string
inlined: true
multivalued: true
examples:
- value:
has_or_had_url:
url_value: https://www.rijksmuseum.nl/en/about-us/annual-report-2013
comments:
- OrganizationalChangeEvent provides structured provenance for organizational history
- Links to OrganizationalStructure via affected_units and resulting_units
- event_date should match valid_to (dissolved units) or valid_from (created units)
- Use PROV-O generated property for successor units
- Use CIDOC-CRM P11_had_participant for affected units
- 'Place integration: is_or_was_located_at (where event occurred), from/to_location (RELOCATION)'
- 'Territorial integration: has_or_had_affected_territory links to GeoSpatialPlace for jurisdiction changes'
- 'Follows TOOI pattern: Wijzigingsgebeurtenis affects BestuurlijkeRuimte'
see_also:
- https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E5
- https://cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E9
- https://www.w3.org/TR/prov-o/#Activity
- https://www.w3.org/community/reports/orgs/#change-events
- http://www.opengis.net/ont/geosparql
- https://identifier.overheid.nl/tooi/def/ont/
examples:
- value:
id: https://nde.nl/ontology/hc/event/rijks-conservation-merger-2013
has_or_had_type: MERGER
temporal_extent:
begin_of_the_begin: '2013-04-01'
has_or_had_description: "Merger of Restoration Department and Research Department to form \nConservation and Research Department during museum renovation.\n"
has_or_had_rationale:
has_or_had_description: Strategic reorganization during 10-year renovation to integrate conservation science with practice and modernize facilities.
staff_impact: 28 FTE (12+16), all staff retained, 5 new positions
has_or_had_documentation:
- has_or_had_url:
url_value: https://www.rijksmuseum.nl/en/about-us/annual-report-2013
- value:
id: https://nde.nl/ontology/hc/event/na-digital-preservation-founding-2008
has_or_had_type: FOUNDING
temporal_extent:
begin_of_the_begin: '2008-01-01'
has_or_had_description: "Creation of Digital Preservation Department to address born-digital \narchival challenges and e-government records.\n"
affected_units: []
has_or_had_rationale:
has_or_had_description: Government mandate to preserve electronic records from ministries and agencies. Growing volume of born-digital materials requiring specialized expertise.
staff_impact: 15 FTE, all new hires with digital archiving expertise
has_or_had_documentation:
- has_or_had_url:
url_value: https://www.nationaalarchief.nl/onderzoeken/archief/2.24.17.07
- value:
id: https://nde.nl/ontology/hc/event/amsterdam-museum-relocation-2025
has_or_had_type: RELOCATION
temporal_extent:
begin_of_the_begin: '2025-06-01'
has_or_had_description: "Amsterdam Museum relocates from historic Burgerweeshuis building to \nnew purpose-built facility. Move required due to structural concerns \nand accessibility improvements.\n"
has_or_had_rationale:
has_or_had_description: Historic Burgerweeshuis building requires major renovation. New facility offers better accessibility, climate control, and exhibition space.
has_or_had_origin:
place_name: Burgerweeshuis, Kalverstraat 92
place_specificity: BUILDING
is_or_was_transferred_to:
place_name: Amstel Campus, Building A
place_specificity: BUILDING
staff_impact: All 45 FTE relocating to new facility. No redundancies.
has_or_had_documentation:
- has_or_had_url:
url_value: https://www.amsterdam.nl/nieuws/museum-verhuizing-2025
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"