505 lines
18 KiB
YAML
505 lines
18 KiB
YAML
# Heritage Organization Branch Class
|
|
# Represents formal organizational branches/sub-organizations of a heritage custodian
|
|
# W3C Org: org:Organization subclass for formal branches
|
|
|
|
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
|
|
# Import global slots
|
|
- ../slots/located_at
|
|
|
|
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
|
|
that operates at a specific physical location (AuxiliaryPlace).
|
|
|
|
**CRITICAL DISTINCTION FROM OrganizationalStructure**:
|
|
|
|
| OrganizationBranch | OrganizationalStructure |
|
|
|-------------------|------------------------|
|
|
| **Formal** branches with administrative status | **Informal** operational units |
|
|
| Tied to PHYSICAL LOCATION (AuxiliaryPlace) | May or may not have fixed location |
|
|
| Semi-autonomous (may have own budget, staff) | Part of main organizational hierarchy |
|
|
| Examples: Regional archive, branch library | Examples: Department, team, division |
|
|
|
|
**W3C ORG ALIGNMENT**:
|
|
|
|
`org:OrganizationalUnit` - "An Organization such as a University Support Unit
|
|
which is part of some larger FormalOrganization and only has full recognition
|
|
within the context of that FormalOrganization."
|
|
|
|
Key properties:
|
|
- `org:unitOf` - links unit to parent organization
|
|
- `org:hasSite` - links organization to physical site
|
|
- `org:hasSubOrganization` - links to sub-branches
|
|
|
|
**THREE-TIER ORGANIZATIONAL MODEL**:
|
|
|
|
1. **Custodian** (hub): The main heritage institution
|
|
2. **OrganizationBranch** (formal sub-organization):
|
|
- Located at AuxiliaryPlace
|
|
- Semi-autonomous branch
|
|
3. **OrganizationalStructure** (informal units):
|
|
- Departments, teams within branch or main org
|
|
- Can be assigned to branch via has_operational_unit
|
|
|
|
**RELATIONSHIP PATTERN**:
|
|
|
|
```
|
|
Custodian (hub)
|
|
│
|
|
├── place_designation → CustodianPlace (main headquarters)
|
|
│ └── auxiliary_places → AuxiliaryPlace (branch sites)
|
|
│ └── hosts_branch → OrganizationBranch (THIS CLASS)
|
|
│ └── has_operational_unit → OrganizationalStructure
|
|
│
|
|
└── organizational_structure → OrganizationalStructure (main org units)
|
|
```
|
|
|
|
**USE CASES**:
|
|
|
|
1. **Regional Archive Branches**:
|
|
- National Archives → Regional Office Noord-Holland
|
|
- Regional office has own staff, reading room, collections
|
|
|
|
2. **University Library Branches**:
|
|
- Main library → Science Library → Medical Library
|
|
- Each branch at different campus location
|
|
|
|
3. **Museum Satellite Galleries**:
|
|
- Main museum → Contemporary Art Wing (off-site)
|
|
- Separate building, curated exhibitions
|
|
|
|
4. **Conservation/Research Centers**:
|
|
- Main institution → Conservation Lab (different building)
|
|
- Specialized facility with own staff
|
|
|
|
**Example - National Archives Branch**:
|
|
```yaml
|
|
AuxiliaryPlace:
|
|
place_name: "Regionaal Historisch Centrum Noord-Holland"
|
|
auxiliary_place_type: BRANCH_OFFICE
|
|
hosts_branch:
|
|
- branch_id: "https://nde.nl/ontology/hc/branch/na-rhc-noord-holland"
|
|
branch_name: "RHC Noord-Holland"
|
|
branch_type: REGIONAL_OFFICE
|
|
has_operational_unit:
|
|
- unit_name: "Reading Room Services"
|
|
- unit_name: "Digitization Team"
|
|
is_branch_of: "https://nde.nl/ontology/hc/nl-na"
|
|
```
|
|
|
|
**DISTINCTION FROM schema:branchOf**:
|
|
|
|
Schema.org `branchOf` links commercial branches (e.g., bank branches).
|
|
`org:unitOf` is more appropriate for heritage institutions as it:
|
|
- Models public sector organizational hierarchies
|
|
- Allows for semi-autonomous units
|
|
- Integrates with formal organizational structures
|
|
|
|
exact_mappings:
|
|
- org:OrganizationalUnit
|
|
|
|
close_mappings:
|
|
- schema:Organization
|
|
- foaf:Organization
|
|
|
|
related_mappings:
|
|
- org:subOrganizationOf
|
|
- schema:branchOf
|
|
- schema:department
|
|
|
|
slots:
|
|
- branch_id
|
|
- branch_name
|
|
- branch_type
|
|
- branch_description
|
|
- located_at
|
|
- has_operational_unit
|
|
- is_branch_of
|
|
- has_sub_branch
|
|
- branch_head
|
|
- staff_count
|
|
- contact_point
|
|
- valid_from
|
|
- valid_to
|
|
- temporal_extent
|
|
- was_derived_from
|
|
- was_generated_by
|
|
- refers_to_custodian
|
|
|
|
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"
|
|
|
|
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"
|
|
|
|
# Slot definitions (basic - detailed in class slot_usage)
|
|
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
|
|
|
|
# NOTE: located_at imported from global slot ../slots/located_at.yaml
|
|
|
|
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
|