kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/OrganizationBranch.yaml
kempersc 0393b321c9 refactor(schema): unify custodian_type slots into has_or_had_custodian_type (Rule 39, 43) 
- Migrate 236+ class files from custodian_types to has_or_had_custodian_type
- Archive deprecated slots: custodian_type, custodian_types, custodian_type_broader/narrower/related
- Update main schema and manifest imports
- Fix Custodian.yaml class to use new slot
- Fix annotation format (list→scalar) in has_or_had_custodian_type.yaml

Rules applied:
- Rule 39: RiC-O naming convention (hasOrHad pattern)
- Rule 43: Slot nouns must be singular (multivalued:true for cardinality)
- Rule 38: Slot centralization with semantic URI
2026-01-09 10:55:21 +01:00

447 lines
18 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/organization-branch
name: organization_branch_class
title: OrganizationBranch Class
imports:
- linkml:types
- ./Custodian
- ./CustodianObservation
- ./ReconstructionActivity
- ./OrganizationalStructure
- ./TimeSpan
- ../enums/OrganizationBranchTypeEnum
- ./ReconstructedEntity
- ../slots/located_at
- ../slots/branch_description
- ../slots/branch_head
- ../slots/branch_id
- ../slots/branch_name
- ../slots/branch_type
- ../slots/contact_point
- ../slots/has_operational_unit
- ../slots/has_sub_branch
- ../slots/is_branch_of
- ../slots/refers_to_custodian
- ../slots/specificity_annotation
- ../slots/staff_count
- ../slots/template_specificity
- ../slots/temporal_extent
- ../slots/valid_from
- ../slots/valid_to
- ../slots/was_derived_from
- ../slots/was_generated_by
- ./AuxiliaryPlace
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
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\n\
that 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 │\n ├── place_designation → CustodianPlace (main\
\ headquarters)\n │ └── auxiliary_places → AuxiliaryPlace (branch sites)\n\
\ │ └── hosts_branch → OrganizationBranch (THIS CLASS)\n │ \
\ └── has_operational_unit → OrganizationalStructure\n │\n └── organizational_structure\
\ → OrganizationalStructure (main org units)\n```\n\n**USE CASES**:\n\n1. **Regional\
\ Archive Branches**:\n - National Archives → Regional Office Noord-Holland\n\
\ - Regional office has own staff, reading room, collections\n \n2. **University\
\ Library Branches**:\n - Main library → Science Library → Medical Library\n\
\ - Each branch at different campus location\n \n3. **Museum Satellite Galleries**:\n\
\ - Main museum → Contemporary Art Wing (off-site)\n - Separate building,\
\ curated exhibitions\n \n4. **Conservation/Research Centers**:\n - Main\
\ institution → 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 - branch_id: \"https://nde.nl/ontology/hc/branch/na-rhc-noord-holland\"\
\n branch_name: \"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:
- branch_description
- branch_head
- branch_id
- branch_name
- branch_type
- contact_point
- has_operational_unit
- has_sub_branch
- is_branch_of
- located_at
- refers_to_custodian
- specificity_annotation
- staff_count
- template_specificity
- temporal_extent
- valid_from
- valid_to
- was_derived_from
- was_generated_by
slot_usage:
branch_id:
slot_uri: dcterms:identifier
description: |
Unique identifier for this organizational branch.
Format: URI following NDE Heritage Custodian ontology conventions.
range: uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/branch/rm-schiphol-exhibition
description: Rijksmuseum Schiphol exhibition branch
branch_name:
slot_uri: skos:prefLabel
description: |
Official name of this organizational branch.
SKOS: prefLabel for preferred name.
This is the formal name of the branch as used in official documents.
range: string
required: true
examples:
- value: Rijksmuseum Schiphol
description: Airport branch name
- value: Conservation Division - Amersfoort
description: Off-site conservation facility
branch_type:
slot_uri: dcterms:type
description: |
Type of organizational branch using OrganizationBranchTypeEnum.
Types include:
- REGIONAL_OFFICE: Geographic regional branch
- BRANCH_LIBRARY: Library at satellite location
- SATELLITE_GALLERY: Museum exhibition space
- CONSERVATION_LAB: Specialized conservation facility
- DIGITIZATION_CENTER: Digital production facility
- RESEARCH_CENTER: Research/scholarly unit
- EDUCATION_CENTER: Education/outreach facility
- ADMINISTRATIVE_OFFICE: Non-public administration
- STORAGE_MANAGEMENT: Collection storage operations
- EXHIBITION_SPACE: Exhibition-focused branch
Dublin Core: type for classification.
range: OrganizationBranchTypeEnum
required: true
examples:
- value: EXHIBITION_SPACE
description: Exhibition branch type
- value: CONSERVATION_LAB
description: Conservation facility type
branch_description:
slot_uri: dcterms:description
description: |
Free-text description of this organizational branch.
Include:
- Mission/purpose of branch
- Services provided
- Collections managed
- Relationship to main organization
range: string
examples:
- value: Small exhibition space at Schiphol Airport featuring rotating highlights
from the Rijksmuseum collection.
description: Branch purpose description
located_at:
slot_uri: org:hasSite
description: |
Physical location (AuxiliaryPlace) where this branch operates.
W3C ORG: org:hasSite links organization to physical site.
This is the inverse of AuxiliaryPlace.hosts_branch:
- OrganizationBranch → located_at → AuxiliaryPlace
- AuxiliaryPlace → hosts_branch → OrganizationBranch
A branch may operate at multiple locations (rare but possible).
range: AuxiliaryPlace
multivalued: true
inlined_as_list: true
examples:
- value: https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
description: Airport location
has_operational_unit:
slot_uri: org:hasUnit
description: |
OrganizationalStructure units (departments, teams) within this branch.
W3C ORG: org:hasUnit links organization to sub-units.
Branches can have their own internal departmental structure:
- Branch → Reading Room Services (team)
- Branch → Digitization Team
- Branch → Public Programs Department
These are INFORMAL units within the formal branch.
range: OrganizationalStructure
multivalued: true
inlined_as_list: true
examples:
- value:
unit_name: Exhibition Curation Team
unit_type: TEAM
description: Team within branch
is_branch_of:
slot_uri: org:unitOf
description: |
Parent Custodian or OrganizationBranch that this branch belongs to.
W3C ORG: org:unitOf - "Indicates an Organization of which this Unit is a part"
Can link to:
- Custodian (direct branch of main institution)
- OrganizationBranch (sub-branch of another branch)
Enables hierarchical branch structures:
- National Archives → Regional Branch → Local Office
range: uriorcurie
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Branch of Rijksmuseum
has_sub_branch:
slot_uri: org:hasSubOrganization
description: |
Sub-branches of this organizational branch.
W3C ORG: org:hasSubOrganization for hierarchical organization.
Inverse of is_branch_of when linking branches to sub-branches.
range: OrganizationBranch
multivalued: true
inlined_as_list: true
examples:
- value:
branch_name: Schiphol Terminal 2 Kiosk
description: Sub-branch of Schiphol exhibition
branch_head:
slot_uri: org:headOf
description: |
Person heading this branch (if known).
W3C ORG: org:headOf - links person to headed organization.
Can be name string or PersonObservation reference.
range: string
examples:
- value: Dr. Maria van der Berg
description: Branch director name
staff_count:
slot_uri: org:hasMember
description: |
Approximate number of staff (FTE) working at this branch.
W3C ORG: hasMember property (count rather than list).
range: integer
examples:
- value: 8
description: Small branch staff
contact_point:
slot_uri: vcard:hasEmail
description: |
Contact information for this branch.
vCard: hasEmail for organizational contact.
Also compatible with Schema.org contactPoint.
Can be email, phone, or URL.
range: string
examples:
- value: schiphol@rijksmuseum.nl
description: Branch email
valid_from:
slot_uri: schema:validFrom
description: |
Date when this branch was established.
Track when branches opened, organizations restructured.
range: date
examples:
- value: '2002-10-01'
description: Branch opened October 2002
valid_to:
slot_uri: schema:validThrough
description: |
Date when this branch was closed or merged.
NULL if still active.
range: date
examples:
- value: '2020-03-15'
description: Branch closed March 2020
temporal_extent:
slot_uri: crm:P4_has_time-span
description: |
Temporal period during which this branch was operational.
CIDOC-CRM: P4_has_time-span for fuzzy temporal boundaries.
range: TimeSpan
examples:
- value:
begin_of_the_begin: '2000-01-01'
end_of_the_begin: '2002-12-31'
description: Established sometime 2000-2002
was_derived_from:
slot_uri: prov:wasDerivedFrom
description: |
CustodianObservation(s) documenting this branch.
PROV-O: wasDerivedFrom for observation provenance.
range: CustodianObservation
multivalued: true
required: false
was_generated_by:
slot_uri: prov:wasGeneratedBy
description: |
ReconstructionActivity that generated this branch record.
PROV-O: wasGeneratedBy for generation activity.
range: ReconstructionActivity
required: false
refers_to_custodian:
slot_uri: org:unitOf
description: |
The Custodian hub that this branch is part of.
W3C ORG: org:unitOf - links unit back to parent organization.
All branches MUST reference the main custodian hub,
even if they are sub-branches of another branch.
range: Custodian
required: true
examples:
- value: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum custodian hub
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
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_sub_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:
branch_id: https://nde.nl/ontology/hc/branch/rm-schiphol
branch_name: Rijksmuseum Schiphol
branch_type: EXHIBITION_SPACE
branch_description: Small exhibition space at Schiphol Airport featuring rotating
highlights from the collection.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-schiphol
has_operational_unit:
- unit_name: Exhibition Curation Team
unit_type: TEAM
staff_count: 3
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
staff_count: 8
contact_point: schiphol@rijksmuseum.nl
valid_from: '2002-10-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum Schiphol exhibition branch
- value:
branch_id: https://nde.nl/ontology/hc/branch/rm-depot-operations
branch_name: Collection Storage Operations - Amersfoort
branch_type: STORAGE_MANAGEMENT
branch_description: Off-site collection storage facility managing overflow
objects and art storage.
located_at:
- https://nde.nl/ontology/hc/aux-place/rijksmuseum-depot-amersfoort
has_operational_unit:
- unit_name: Storage Management Team
unit_type: TEAM
- unit_name: Climate Control Monitoring
unit_type: SERVICE
is_branch_of: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
staff_count: 12
valid_from: '1995-06-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-nh-ams-m-rm-q190804
description: Rijksmuseum off-site storage operations branch
- value:
branch_id: https://nde.nl/ontology/hc/branch/na-rhc-nh
branch_name: Regionaal Historisch Centrum Noord-Holland
branch_type: REGIONAL_OFFICE
branch_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
staff_count: 25
valid_from: '2001-01-01'
refers_to_custodian: https://nde.nl/ontology/hc/nl-na
description: Regional historical center branch of National Archives
slots:
branch_id:
description: Unique identifier for organizational branch
range: uriorcurie
branch_name:
description: Official branch name
range: string
branch_type:
description: Type of organizational branch
range: OrganizationBranchTypeEnum
branch_description:
description: Description of branch
range: string
has_operational_unit:
description: OrganizationalStructure units within branch
range: OrganizationalStructure
is_branch_of:
description: Parent organization (Custodian or OrganizationBranch)
range: uriorcurie
has_sub_branch:
description: Sub-branches of this branch
range: OrganizationBranch
branch_head:
description: Person heading this branch
range: string
Reference in a new issue View git blame Copy permalink