kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/CustodianAdministration.yaml
kempersc 69a22e2b5a Refactor and expand LinkML slot definitions 
- Deleted the `rights_statement_url` slot definition as it is no longer needed.
- Added multiple new slots including `has_legal_basis`, `has_statement`, `impose`, `pose_condition`, and `reviewed_through` with detailed descriptions and ontology alignments.
- Updated existing slots to improve clarity and consistency, including renaming `close_mappings` to `related_mappings` in several definitions.
- Enhanced the `require` slot with additional aliases for better usability.
- Improved documentation and comments across all slot definitions to clarify their purpose and usage.
2026-02-08 23:37:44 +01:00

335 lines
18 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/CustodianAdministration
name: custodian_administration_class
title: CustodianAdministration Class
imports:
- linkml:types
- ../slots/20260202_matang/contain
- ../slots/20260202_matang/new/creating_function
- ../slots/20260202_matang/new/estimates_or_estimated
- ../slots/20260202_matang/has_description
- ../slots/20260202_matang/has_label
- ../slots/20260202_matang/has_level
- ../slots/20260202_matang/has_quantity
- ../slots/20260202_matang/has_roadmap
- ../slots/20260202_matang/has_score
- ../slots/20260202_matang/has_status
- ../slots/20260202_matang/active_since
- ../slots/20260202_matang/derive_from
- ../slots/20260202_matang/generated_by
- ../slots/20260202_matang/new/managing_unit
- ../slots/20260202_matang/new/primary_system
- ../slots/20260202_matang/new/record_type
- ../slots/20260202_matang/new/refers_to_custodian
- ../slots/20260202_matang/new/retention_period_year
- ../slots/20260202_matang/new/retention_schedule
- ../slots/20260202_matang/temporal_extent
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
crm: http://www.cidoc-crm.org/cidoc-crm/
dcterms: http://purl.org/dc/terms/
rico: https://www.ica.org/standards/RiC/ontology#
prov: http://www.w3.org/ns/prov#
time: http://www.w3.org/2006/time#
org: http://www.w3.org/ns/org#
schema: http://schema.org/
classes:
CustodianAdministration:
is_a: ReconstructedEntity
class_uri: rico:RecordResource
description: "Represents ACTIVE documents, files, data, and records currently in daily use\nby the heritage custodian. These are LIVING records actively referenced,\nmodified, and used in ongoing institutional operations.\n\n**CRITICAL DISTINCTION - NOT ARCHIVES**:\n\nCustodianAdministration is fundamentally DIFFERENT from archives:\n\n| CustodianAdministration | CustodianArchive | CustodianCollection |\n|-------------------------|------------------|---------------------|\n| **ACTIVE** - in daily use | **INACTIVE** - awaiting processing | **HERITAGE** - cultural value |\n| Business tool | Processing backlog | Research resource |\n| Modified regularly | Static (until processed) | Preserved permanently |\n| Managed by business units | Managed by archives | Managed by collections |\n| Current reference value | Future historical value | Proven historical value |\n| Retention period active | Retention period ended | Permanently retained |\n\n**LIFECYCLE POSITION**:\n\n```\n\u250C\u2500\u2500\
\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 CustodianAdministration (THIS CLASS) \u2502\n\u2502 \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 \u2502\n\u2502 ACTIVE records in daily use NOW \u2502\n\u2502 \u2502\n\u2502 Examples: \
\ \u2502\n\u2502 - Current year's correspondence \u2502\n\u2502 - Open project files \u2502\n\u2502 - Active personnel records \u2502\n\u2502 - Current financial year invoices \u2502\n\u2502 - Live databases and email \u2502\n\u2502 - Shared drive documents being edited \u2502\n\u2502 - CRM/ERP system data \u2502\n\u2502 - Active vendor contracts \u2502\n\u2502 \u2502\n\u2502 Characteristics: \u2502\n\u2502 - Actively referenced and modified \u2502\n\u2502 - Managed by creating business unit \
\ \u2502\n\u2502 - Subject to retention schedule \u2502\n\u2502 - May contain personal data (GDPR active) \u2502\n\u2502 - Business continuity critical \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2193\n (Retention period ends, business use ceases,\n records closed and transferred to archives)\n \u2193\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\
\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 CustodianArchive \u2502\n\u2502 (Inactive archives awaiting processing) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2193\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\
\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 CustodianCollection \u2502\n\u2502 (Processed heritage collection) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n**WHY MODEL\
\ THIS?**:\n\nUnderstanding a custodian's active administration is valuable for:\n\n1. **Records Management Planning**: What will become archives in 5-10 years?\n2. **Digital Preservation**: Born-digital records requiring future migration\n3. **Capacity Planning**: Volume of future archival transfers\n4. **Compliance**: GDPR, FOI, audit requirements on active records\n5. **Business Continuity**: Critical records identification\n6. **System Dependencies**: What systems hold institutional memory?\n\n**NOT FOR DETAILED MODELING**:\n\nThis class provides HIGH-LEVEL metadata about administrative record systems.\nIt is NOT intended to catalog individual documents (that's the CMS's job).\n\nModel at the SYSTEM or FUNCTION level:\n- \u2705 \"HR Department Personnel Files System\"\n- \u2705 \"Director's Office Correspondence\" \n- \u2705 \"Financial Administration SAP System\"\n- \u274C Individual invoices, emails, memos (too granular)\n\n**RiC-O ALIGNMENT**:\n\n- **rico:RecordResource**:\
\ Base class for record resources\n- **rico:hasCreator**: Creating unit/department\n- **rico:hasOrHadManager**: Unit managing the records\n- **rico:isAssociatedWithActivity**: Business activity generating records\n"
exact_mappings:
- rico:RecordResource
close_mappings:
- schema:CreativeWork
- crm:E73_Information_Object
related_mappings:
- rico:hasCreator
- rico:isAssociatedWithActivity
- org:Organization
slots:
- active_since
- has_description
- has_label
- has_status
- creating_function
- has_level
- has_quantity
- has_roadmap
- contain
- estimates_or_estimated
- managing_unit
- primary_system
- record_type
- refers_to_custodian
- retention_period_year
- retention_schedule
- has_score
- temporal_extent
- derived_from
- generated_by
slot_usage:
has_label:
# range: string
required: true
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
label_text: Director's Office Correspondence
has_description:
# range: string
required: false
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
description_text: Incoming and outgoing correspondence of the museum director
record_type:
# range: string
multivalued: true
required: false
examples:
- value:
- Correspondence
- Reports
- Meeting minutes
managing_unit:
range: OrganizationalStructure
required: false
creating_function:
# range: string
required: false
examples:
- value: Collection acquisition
active_since:
range: date
required: false
examples:
- value: '2015-01-01'
has_quantity:
range: integer
multivalued: true
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
has_measurement_unit:
has_symbol: documents
is_estimate: true
- value:
has_measurement_unit:
has_symbol: GB
is_estimate: true
estimates_or_estimated:
range: GrowthRate
inlined: true
required: false
examples:
- value:
has_description: ~30,000 documents/year
primary_system:
range: DigitalPlatform
required: false
examples:
- value: https://nde.nl/ontology/hc/platform/rm-sharepoint
retention_schedule:
# range: string
required: false
examples:
- value: Selectielijst Gemeenten 2020, categorie 4.2.3
retention_period_year:
range: integer
required: false
examples:
- value: 7
- value: 20
has_level:
# range: string
inlined: false # Fixed invalid inline for primitive type
required: false
description: 'Data sensitivity classification level. Standard codes: PUBLIC, INTERNAL, CONFIDENTIAL, STRICTLY_CONFIDENTIAL, PERSONAL_DATA, SPECIAL_CATEGORY'
examples:
- value:
has_label: Confidential
has_code: CONFIDENTIAL
has_description: Personnel data - need-to-know basis
contain:
range: PersonalData
inlined: true
multivalued: true
required: false
examples:
- value:
has_sensitivity_level:
has_label: GDPR Sensitive
has_code: SPECIAL_CATEGORY
has_description: Contains employee personal data
- value:
has_label: MEDIUM
has_description: Historical project files - reference only
has_status:
range: BackupStatus
required: false
examples:
- value:
has_type:
- has_code: DAILY_AUTOMATED
- has_code: CLOUD_AZURE
has_description: Daily backup to Azure, 30-day retention
refers_to_custodian:
range: Custodian
required: true
derived_from:
range: CustodianObservation
multivalued: true
required: false
generated_by:
range: ReconstructionActivity
required: false
temporal_extent:
range: TimeSpan
inlined: true
required: false
comments:
- Represents ACTIVE administrative records in current daily use
- NOT archives - these are living business records
- High-level metadata about record systems, not individual documents
- Feeds into archives capacity planning and digital preservation
- RiC-O rico:RecordResource as primary ontology class
- 'RiC-O property alignment: rico:documents (creating_function), rico:isOrWasRegulatedBy (retention_schedule), rico:hasOrHadManager (managing_unit)'
see_also:
- https://www.ica.org/standards/RiC/ontology#RecordResource
- https://nde.nl/ontology/hc/class/CustodianArchive
- https://nde.nl/ontology/hc/class/CustodianCollection
examples:
- value:
id: https://nde.nl/ontology/hc/administration/rm/directors-correspondence
has_label:
label_text: Director's Office Correspondence
has_description:
description_text: Incoming and outgoing correspondence of the museum director including policy discussions, strategic partnerships, and institutional communications.
record_type:
- Correspondence
- Reports
- Meeting minutes
- Policy documents
creating_function: Executive management
active_since: '2018-01-01'
has_quantity:
- quantity_value: 25000
has_measurement_unit:
has_symbol: documents
is_estimate: true
- quantity_value: 150
has_measurement_unit:
has_symbol: GB
is_estimate: true
estimates_or_estimated:
has_description: ~5,000 documents/year
primary_system: https://nde.nl/ontology/hc/platform/rm-sharepoint
retention_schedule: Museum Retention Schedule 2020, cat. 1.1
retention_period_years: 10
has_roadmap:
- contain:
- has_label: Transfer to National Archives
temporal_extent:
end_of_the_end: '2028-01-01'
has_level:
has_label: Confidential
has_code: CONFIDENTIAL
has_description: Confidential correspondence - need-to-know basis
contain:
- has_sensitivity_level:
has_label: GDPR Sensitive
has_code: PERSONAL_DATA
has_description: Contains personal correspondence
has_status:
has_type:
- has_code: DAILY_AUTOMATED
- has_code: CLOUD_AZURE
has_description: Daily backup to Azure, replicated to secondary site
access_control: 'AD Group: RM-Directors-Staff'
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
id: https://nde.nl/ontology/hc/administration/rm/hr-personnel
has_label:
label_text: Human Resources Personnel Files
has_description:
description_text: Employee personnel records including contracts, performance reviews, training records, and employment documentation.
record_type:
- Personnel files
- Contracts
- Performance reviews
- Training records
creating_function: Human resource management
active_since: '2010-01-01'
has_quantity:
- quantity_value: 2000
has_measurement_unit:
has_symbol: files
has_description: employee files
is_estimate: true
- quantity_value: 500
has_measurement_unit:
has_symbol: GB
is_estimate: true
estimates_or_estimated:
has_description: ~100 files/year (new hires)
primary_system: https://nde.nl/ontology/hc/platform/rm-workday
retention_schedule: Museum Retention Schedule 2020, cat. 3.2
retention_period_years: 20
has_level:
has_label: Special Category Data
has_code: SPECIAL_CATEGORY
has_description: Personnel data - GDPR Article 9 sensitive personal data
contain:
- has_sensitivity_level:
has_label: GDPR Sensitive
has_code: SPECIAL_CATEGORY
has_description: Contains employee personal data
has_status:
has_type:
- has_code: REALTIME_REPLICATION
- has_code: ENCRYPTED_AT_REST
has_description: Real-time replication, encrypted at rest
access_control: HR Department only, individual file permissions
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
identified_by: https://nde.nl/ontology/hc/administration/rm/conservation-lab
has_label:
label_text: Conservation Treatment Records
has_description:
description_text: Documentation of conservation treatments performed on collection objects including condition reports, treatment proposals, and completed treatment records.
active_since: '2005-01-01'
has_quantity:
- quantity_value: 45000
has_measurement_unit:
has_symbol: files
has_description: treatment files
is_estimate: true
- quantity_value: 2
has_measurement_unit:
has_symbol: TB
has_description: high-res images
is_estimate: true
estimates_or_estimated:
has_description: ~2,000 treatments/year
has_level:
has_label: Internal
has_code: INTERNAL
has_description: For internal staff use only
has_status:
has_type:
- has_code: DAILY_AUTOMATED
- has_code: LONG_RETENTION
has_description: Daily backup, 10-year retention, linked to object records
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
Reference in a new issue View git blame Copy permalink