kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/Department.yaml
kempersc 7cf10084b4 Implement scripts for schema modifications and ontology verification 
- Added `fix_dual_class_link.py` to remove dual class link references from specified YAML files.
- Created `fix_specific_ghosts.py` to apply specific replacements in YAML files based on defined mappings.
- Introduced `migrate_staff_count.py` to migrate staff count references to a new structure in specified YAML files.
- Developed `migrate_type_slots.py` to replace type-related slots with new identifiers across YAML files.
- Implemented `scan_ghost_references.py` to identify and report ghost references to archived slots and classes in YAML files.
- Added `verify_ontology_terms.py` to verify the presence of ontology terms in specified ontology files against schema definitions.
2026-01-29 17:10:25 +01:00

291 lines
14 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/Department
name: department_class
title: Department 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#
schema: http://schema.org/
org: http://www.w3.org/ns/org#
dcterms: http://purl.org/dc/terms/
wd: http://www.wikidata.org/entity/
rico: https://www.ica.org/standards/RiC/ontology#
default_prefix: hc
imports:
- linkml:types
- ./Custodian
- ./OrganizationalStructure
- ./Collection
- ./PersonObservation
- ../slots/has_or_had_staff_member
- ../slots/contact_point
- ../slots/located_at
- ../slots/refers_to_custodian
- ../slots/has_or_had_label
- ./Label
- ../slots/has_or_had_type
- ./LabelType
- ./LabelTypes
- ../slots/has_or_had_description
- ./Description
- ../slots/is_or_was_managed_by
- ./Manager
- ../slots/has_or_had_identifier
- ./Identifier
- ../slots/is_or_was_dissolved_by
- ./DissolutionEvent
- ../slots/is_or_was_established_by
- ./EstablishmentEvent
- ../slots/has_or_had_manages_collection
- ../slots/mandate
- ../slots/parent_department
- ../slots/specificity_annotation
- ../slots/has_or_had_sub_department
- ../slots/has_or_had_score
- ./AuxiliaryPlace
- ./SpecificityAnnotation
- ./TemplateSpecificityScore
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
classes:
Department:
class_uri: org:OrganizationalUnit
description: "Formal department within a heritage custodian organization.\n\n**DEFINITION**:\n\nDepartment represents a FORMAL organizational unit within a heritage\ninstitution, often with regulatory, legal, or governance significance.\nDepartments typically have:\n- Official mandate or charter\n- Defined responsibilities\n- Budget allocation\n- Reporting structure\n- Staff positions with formal titles\n\n**DISTINCTION FROM OrganizationalStructure**:\n\n| Department | OrganizationalStructure |\n|------------|-------------------------|\n| Formal, often codified | Informal, operational |\n| Legal/regulatory basis | Pragmatic organization |\n| Budget line items | Ad-hoc groupings |\n| Charter/mandate | Flexible scope |\n| \"Archives Department\" | \"Digital Preservation Team\" |\n\nBoth use `org:OrganizationalUnit` but represent different levels of formality.\n\n**ARCHIVE CONTEXT**:\n\nIn archival institutions, \"department\" often refers to:\n- Record groups managed (e.g., \"Colonial\
\ Records Department\")\n- Functional areas (e.g., \"Preservation Department\")\n- Public service units (e.g., \"Reference Department\")\n\nArchiveTypeEnum value \"DEPARTMENT\" (Q107679962) maps to this class when\nused to describe archival organizational units.\n\n**Wikidata Alignment**:\n- Q2366457 (department - organizational unit)\n- Q107679962 (archival unit)\n\n**W3C ORG Alignment**:\n\n`org:OrganizationalUnit` - \"An Organization such as a University Support Unit\nwhich is part of some larger FormalOrganization and only has full recognition\nwithin the context of that FormalOrganization.\"\n\n**RELATIONSHIP TO OTHER CLASSES**:\n\n```\nCustodian (hub)\n \u2502\n \u251C\u2500\u2500 organizational_structure \u2192 OrganizationalStructure[] (informal)\n \u2502\n \u2514\u2500\u2500 departments \u2192 Department[] (THIS CLASS - formal)\n \u251C\u2500\u2500 department_head \u2192 PersonObservation\n \u251C\u2500\u2500 manages_collections \u2192 Collection[]\n \
\ \u251C\u2500\u2500 parent_department \u2192 Department\n \u251C\u2500\u2500 sub_departments \u2192 Department[]\n \u2514\u2500\u2500 located_at \u2192 AuxiliaryPlace\n```\n\n**USE CASES**:\n\n1. **National Archive Department**:\n - department_name: \"Colonial Records Department\"\n - mandate: \"Preserves and provides access to colonial-era government records\"\n - manages_collections: [Colonial Administration Fonds, Trade Company Records]\n \n2. **Museum Department**:\n - department_name: \"Paintings Department\"\n - department_head: \"Dr. Jane Smith, Curator of Dutch Paintings\"\n - manages_collections: [Dutch Golden Age Collection, Flemish Baroque]\n \n3. **Library Department**:\n - department_name: \"Special Collections Department\"\n - mandate: \"Acquires, preserves, and provides access to rare materials\"\n - manages_collections: [Rare Books, Manuscripts, Maps]\n\n**LINK TO ArchiveTypeEnum**:\n\nThe ArchiveTypeEnum value \"DEPARTMENT\"\
\ (Q107679962) describes archives\norganized as departments within larger institutions. This class provides\nthe structural representation for such organizational units.\n"
exact_mappings:
- org:OrganizationalUnit
- wikidata:Q2366457
close_mappings:
- rico:Agent
- schema:Organization
related_mappings:
- crm:E74_Group
- wikidata:Q107679962
slots:
- contact_point
- has_or_had_label
- has_or_had_type
- has_or_had_description
- is_or_was_managed_by
- has_or_had_identifier
- is_or_was_dissolved_by
- established_date
- located_at
- has_or_had_manages_collection
- mandate
- parent_department
- refers_to_custodian
- specificity_annotation
- has_or_had_staff_member
- has_or_had_sub_department
- has_or_had_score
slot_usage:
has_or_had_identifier:
description: 'MIGRATED from department_id per slot_fixes.yaml (Rule 53, 2026-01-25).
Unique identifier for this department.
Format: URI following NDE Heritage Custodian ontology conventions.
'
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/dept/nationaal-archief-colonial-records
description: Colonial Records Department at National Archives
department_name:
description: 'DEPRECATED 2026-01-25: Migrated to has_or_had_label slot with Label class
using has_or_had_type: "DepartmentName" for type discrimination.
See has_or_had_label slot_usage for current pattern.
'
deprecated: Use has_or_had_label with Label(has_or_had_type='DepartmentName')
has_or_had_label:
description: 'MIGRATED from department_code AND department_name per slot_fixes.yaml (Rule 53, 2026-01-25).
This slot now covers BOTH department codes AND department names.
Uses Label class with has_or_had_type for discrimination:
- has_or_had_type: "DepartmentCode" - Short code for department
- has_or_had_type: "DepartmentName" - Official name of department
'
range: Label
inlined: true
multivalued: true
required: true
examples:
- value:
has_or_had_text: Colonial Records Department
has_or_had_type: DepartmentName
description: Department name (migrated from department_name)
- value:
has_or_had_text: CRD
has_or_had_type: DepartmentCode
description: Department code (migrated from department_code)
- value:
has_or_had_text: Paintings Department
has_or_had_type: DepartmentName
description: Department name
- value:
has_or_had_text: PNTG
has_or_had_type: DepartmentCode
description: Department code
has_or_had_type:
description: 'Type classification for labels (used with has_or_had_label).
MIGRATED from department_code per slot_fixes.yaml (Rule 53, 2026-01-25).
'
range: LabelType
inlined: true
required: false
has_or_had_description:
description: 'MIGRATED from department_description per slot_fixes.yaml (Rule 53, 2026-01-25).
Detailed description of the department''s purpose and holdings.
Uses Description class for structured representation.
'
range: Description
inlined: true
required: false
examples:
- value:
has_or_had_text: The Colonial Records Department preserves and provides access to government records from the Dutch colonial period (1602-1949). Holdings include VOC archives, colonial administration files, and diplomatic correspondence.
description: Department description (migrated from department_description)
mandate:
range: string
examples:
- value: Established by Royal Decree of 1891 to manage and preserve records of the Dutch East Indies administration. Mandate expanded in 1950 to include all colonial-era records.
parent_department:
range: Department
examples:
- value: https://nde.nl/ontology/hc/dept/nationaal-archief-collections
description: Parent Collections Division
has_or_had_sub_department:
range: Department
multivalued: true
inlined_as_list: true
examples:
- value:
- https://nde.nl/ontology/hc/dept/na-colonial-voc
- https://nde.nl/ontology/hc/dept/na-colonial-wic
description: VOC and WIC sub-departments
is_or_was_managed_by:
description: 'MIGRATED from department_head per slot_fixes.yaml (Rule 53, 2026-01-25).
Person responsible for managing this department.
Uses Manager class for structured representation.
'
range: Manager
inlined: true
required: false
examples:
- value:
has_or_had_name: Dr. Maria van der Berg
has_or_had_title: Head of Colonial Records Department
description: Department head (migrated from department_head)
has_or_had_staff_member:
range: PersonObservation
multivalued: true
inlined_as_list: true
has_or_had_manages_collection:
range: Collection
multivalued: true
inlined_as_list: true
examples:
- value:
- https://nde.nl/ontology/hc/collection/na-voc-archives
- https://nde.nl/ontology/hc/collection/na-colonial-maps
description: Collections managed by Colonial Records Dept
located_at:
examples:
- value: https://nde.nl/ontology/hc/aux-place/nationaal-archief-building-b
description: Department located in Building B
contact_point:
range: string
examples:
- value: colonial-records@nationaalarchief.nl
- value: https://www.nationaalarchief.nl/onderzoeken/colonial-records
established_date:
range: date
examples:
- value: '1891-06-15'
description: Colonial Records Dept established by Royal Decree
is_or_was_dissolved_by:
range: DissolutionEvent
inlined: true
description: Dissolution event for the department. MIGRATED from dissolved_date per slot_fixes.yaml (Rule 53, 2026-01-26).
refers_to_custodian:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-zh-hag-a-na
description: Department of National Archives
comments:
- Department represents FORMAL organizational units (vs informal OrganizationalStructure)
- Often has legal/regulatory basis (charter, mandate, decree)
- Maps to ArchiveTypeEnum DEPARTMENT (Q107679962) concept
- Hierarchical structure via parent_department/sub_departments
- Links to Collections via manages_collections (rico:isManagerOf)
- Links to staff via department_head and staff_members
see_also:
- https://www.wikidata.org/wiki/Q2366457
- https://www.wikidata.org/wiki/Q107679962
- https://www.w3.org/ns/org#OrganizationalUnit
- https://www.ica.org/standards/RiC/ontology#Agent
examples:
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/dept/nationaal-archief-colonial-records
has_or_had_label:
- has_or_had_text: Colonial Records Department
has_or_had_type: DepartmentName
- has_or_had_text: CRD
has_or_had_type: DepartmentCode
has_or_had_description:
has_or_had_text: Preserves and provides access to government records from the Dutch colonial period (1602-1949). Holdings include VOC archives, colonial administration files, and diplomatic correspondence.
mandate: Established by Royal Decree of 1891 to manage and preserve records of the Dutch East Indies administration.
is_or_was_established_by:
temporal_extent:
begin_of_the_begin: '1891-06-15'
has_or_had_manages_collection:
- https://nde.nl/ontology/hc/collection/na-voc-archives
- https://nde.nl/ontology/hc/collection/na-wic-archives
contact_point: colonial-records@nationaalarchief.nl
refers_to_custodian: https://nde.nl/ontology/hc/nl-zh-hag-a-na
description: National Archives Colonial Records Department
- value:
has_or_had_identifier: https://nde.nl/ontology/hc/dept/rijksmuseum-paintings
has_or_had_label:
- has_or_had_text: Paintings Department
has_or_had_type: DepartmentName
- has_or_had_text: PNTG
has_or_had_type: DepartmentCode
has_or_had_description:
has_or_had_text: Responsible for the museum's collection of paintings from the Middle Ages to the 20th century. Includes Dutch Golden Age masterpieces, Flemish Baroque, and European paintings.
is_or_was_managed_by:
has_or_had_name: Dr. Pieter Roelofs
has_or_had_title: Head of Paintings Department
has_or_had_manages_collection:
- https://nde.nl/ontology/hc/collection/rm-dutch-paintings
- https://nde.nl/ontology/hc/collection/rm-flemish-paintings
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm
description: Rijksmuseum Paintings Department
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept
Reference in a new issue View git blame Copy permalink