glam/schemas/20251121/linkml/modules/classes/OrganizationBranch.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

201 lines
10 KiB
YAML

id: https://nde.nl/ontology/hc/class/organization-branch
name: organization_branch_class
title: OrganizationBranch Class
imports:
- linkml:types
- ../enums/OrganizationBranchTypeEnum
- ../slots/20260202_matang/new/contact_point
- ../slots/20260202_matang/has_branch
- ../slots/20260202_matang/has_description
- ../slots/20260202_matang/headed_by
- ../slots/20260202_matang/identified_by
- ../slots/20260202_matang/has_label
- ../slots/20260202_matang/has_quantity
- ../slots/20260202_matang/has_score
- ../slots/20260202_matang/has_type
- ../slots/20260202_matang/new/is_branch_of
- ../slots/20260202_matang/derive_from
- ../slots/20260202_matang/generated_by
- ../slots/20260202_matang/located_at
- ../slots/20260202_matang/new/refers_to_custodian
- ../slots/20260202_matang/temporal_extent
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
skos: http://www.w3.org/2004/02/skos/core#
foaf: http://xmlns.com/foaf/0.1/
vcard: http://www.w3.org/2006/vcard/ns#
classes:
OrganizationBranch:
is_a: ReconstructedEntity
class_uri: org:OrganizationalUnit
description: "Formal organizational branch or sub-organization of a heritage custodian\nthat operates at a specific physical location (AuxiliaryPlace).\n\n**CRITICAL DISTINCTION FROM OrganizationalStructure**:\n\n| OrganizationBranch | OrganizationalStructure |\n|-------------------|------------------------|\n| **Formal** branches with administrative status | **Informal** operational units |\n| Tied to PHYSICAL LOCATION (AuxiliaryPlace) | May or may not have fixed location |\n| Semi-autonomous (may have own budget, staff) | Part of main organizational hierarchy |\n| Examples: Regional archive, branch library | Examples: Department, team, division |\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\nKey properties:\n- `org:unitOf` - links unit to parent organization\n- `org:hasSite` - links organization\
\ to physical site\n- `org:hasSubOrganization` - links to sub-branches\n\n**THREE-TIER ORGANIZATIONAL MODEL**:\n\n1. **Custodian** (hub): The main heritage institution\n2. **OrganizationBranch** (formal sub-organization): \n - Located at AuxiliaryPlace\n - Semi-autonomous branch\n3. **OrganizationalStructure** (informal units):\n - Departments, teams within branch or main org\n - Can be assigned to branch via has_operational_unit\n\n**RELATIONSHIP PATTERN**:\n\n```\nCustodian (hub)\n \u2502\n \u251C\u2500\u2500 place_designation \u2192 CustodianPlace (main headquarters)\n \u2502 \u2514\u2500\u2500 auxiliary_places \u2192 AuxiliaryPlace (branch sites)\n \u2502 \u2514\u2500\u2500 hosts_branch \u2192 OrganizationBranch (THIS CLASS)\n \u2502 \u2514\u2500\u2500 has_operational_unit \u2192 OrganizationalStructure\n \u2502\n \u2514\u2500\u2500 organizational_structure \u2192 OrganizationalStructure (main org units)\n```\n\n**USE CASES**:\n\n1. **Regional Archive\
\ Branches**:\n - National Archives \u2192 Regional Office Noord-Holland\n - Regional office has own staff, reading room, collections\n \n2. **University Library Branches**:\n - Main library \u2192 Science Library \u2192 Medical Library\n - Each branch at different campus location\n \n3. **Museum Satellite Galleries**:\n - Main museum \u2192 Contemporary Art Wing (off-site)\n - Separate building, curated exhibitions\n \n4. **Conservation/Research Centers**:\n - Main institution \u2192 Conservation Lab (different building)\n - Specialized facility with own staff\n\n**Example - National Archives Branch**:\n```yaml\nAuxiliaryPlace:\n place_name: \"Regionaal Historisch Centrum Noord-Holland\"\n auxiliary_place_type: BRANCH_OFFICE\n hosts_branch:\n - identified_by: \"https://nde.nl/ontology/hc/branch/na-rhc-noord-holland\"\n has_label: \"RHC Noord-Holland\"\n branch_type: REGIONAL_OFFICE\n has_operational_unit:\n - unit_name:\
\ \"Reading Room Services\"\n - unit_name: \"Digitization Team\"\n is_branch_of: \"https://nde.nl/ontology/hc/nl-na\"\n```\n\n**DISTINCTION FROM schema:branchOf**:\n\nSchema.org `branchOf` links commercial branches (e.g., bank branches).\n`org:unitOf` is more appropriate for heritage institutions as it:\n- Models public sector organizational hierarchies\n- Allows for semi-autonomous units\n- Integrates with formal organizational structures\n"
exact_mappings:
- org:OrganizationalUnit
close_mappings:
- schema:Organization
- foaf:Organization
related_mappings:
- org:subOrganizationOf
- schema:branchOf
- schema:department
slots:
- has_description
- headed_by
- identified_by
- has_label
- has_type
- contact_point
- has_branch
- is_branch_of
- located_at
- refers_to_custodian
- has_quantity
- has_score
- temporal_extent
- derived_from
- generated_by
slot_usage:
identified_by:
# range: string # uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/branch/rm-schiphol-exhibition
has_label:
# range: string
required: true
multivalued: false
examples:
- value: Rijksmuseum Schiphol
- value: Conservation Division - Amersfoort
has_type:
# range: string # uriorcurie
required: true
examples:
- value: ExhibitionSpaceUnit
- value: ConservationLabUnit
has_description:
# range: string
examples:
- value: Small exhibition space at Schiphol Airport featuring rotating highlights from the Rijksmuseum collection.
- value: Off-site collection storage facility managing overflow objects and art storage.
located_at:
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
is_branch_of:
# range: string # uriorcurie
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_branch:
range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
has_label: Schiphol Terminal 2 Kiosk
headed_by:
range: Person
examples:
- value: https://nde.nl/ontology/hc/person/dr-maria-van-der-berg
- value:
full_name: Dr. Maria van der Berg
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
contact_point:
# range: string
examples:
- value: schiphol@rijksmuseum.nl
temporal_extent:
range: TimeSpan
inlined: true
required: false
examples:
- value:
begin_of_the_begin: '2002-10-01'
- value:
begin_of_the_begin: '2002-10-01'
end_of_the_end: '2020-03-15'
derived_from:
# range: string # CustodianObservation
multivalued: true
required: false
generated_by:
range: ReconstructionActivity
required: false
refers_to_custodian:
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
comments:
- OrganizationBranch models FORMAL branches with administrative status
- OrganizationalStructure models INFORMAL operational units
- Branches are LOCATED AT AuxiliaryPlace (physical sites)
- Branches CONTAIN OrganizationalStructure (internal departments/teams)
- W3C ORG org:OrganizationalUnit for semi-autonomous sub-organizations
- Temporal validity tracks branch lifecycle (opened/closed/merged)
- 'Hierarchical: branches can have sub-branches via has_branch'
see_also:
- https://www.w3.org/TR/vocab-org/#org:OrganizationalUnit
- https://www.w3.org/TR/vocab-org/#org:hasSite
- https://www.w3.org/TR/vocab-org/#org:unitOf
- https://www.w3.org/TR/vcard-rdf/
examples:
- value:
identified_by: https://nde.nl/ontology/hc/branch/rm-schiphol
has_label: Rijksmuseum Schiphol
branch_type: EXHIBITION_SPACE
has_description: Small exhibition space at Schiphol Airport featuring rotating highlights from the collection.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
- unit_name: Exhibition Curation Team
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
contact_point: schiphol@rijksmuseum.nl
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
identified_by: https://nde.nl/ontology/hc/branch/rm-depot-operations
has_label: Collection Storage Operations - Amersfoort
branch_type: STORAGE_MANAGEMENT
has_description: Off-site collection storage facility managing overflow objects and art storage.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
- unit_name: Storage Management Team
- unit_name: Climate Control Monitoring
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
- value:
identified_by: https://nde.nl/ontology/hc/branch/na-rhc-nh
has_label: Regionaal Historisch Centrum Noord-Holland
branch_type: REGIONAL_OFFICE
has_description: Regional archives center serving Noord-Holland province, providing reading room services and archival research support.
is_branch_of: https://nde.nl/ontology/hc/nl-na
has_quantity:
range: integer
inlined: false # Fixed invalid inline for primitive type
refers_to_custodian: https://nde.nl/ontology/hc/nl-na
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"