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 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

177 lines
9.5 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
- ../slots/contact_point
- ../slots/has_or_had_description
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_score
- ../slots/has_or_had_staff_member
- ../slots/has_or_had_type
- ../slots/is_or_was_dissolved_by
- ../slots/is_or_was_established_by
- ../slots/is_or_was_managed_by
- ../slots/located_at
- ../slots/mandate
- ../slots/parent_department
- ../slots/refers_to_custodian
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
- located_at
- mandate
- parent_department
- refers_to_custodian
- has_or_had_staff_member
- has_or_had_score
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/dept/nationaal-archief-colonial-records
has_or_had_label:
range: Label
inlined: true
multivalued: true
required: true
examples:
- value:
has_or_had_text: Colonial Records Department
has_or_had_type: DepartmentName
- value:
has_or_had_text: CRD
has_or_had_type: DepartmentCode
- value:
has_or_had_text: Paintings Department
has_or_had_type: DepartmentName
- value:
has_or_had_text: PNTG
has_or_had_type: DepartmentCode
has_or_had_type:
range: LabelType
inlined: true
required: false
has_or_had_description:
range: string
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.
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
is_or_was_managed_by:
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
has_or_had_staff_member:
range: PersonObservation
multivalued: true
inlined_as_list: true
located_at:
examples:
- value: https://nde.nl/ontology/hc/aux-place/nationaal-archief-building-b
contact_point:
range: string
examples:
- value: colonial-records@nationaalarchief.nl
- value: https://www.nationaalarchief.nl/onderzoeken/colonial-records
is_or_was_dissolved_by:
range: DissolutionEvent
inlined: true
refers_to_custodian:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-zh-hag-a-na
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'
contact_point: colonial-records@nationaalarchief.nl
refers_to_custodian: https://nde.nl/ontology/hc/nl-zh-hag-a-na
- 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
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm
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