glam/frontend/public/schemas/20251121/linkml/modules/classes/EncompassingBody.yaml
kempersc 6bb8ac20ba feat: Add MainPart and OutputData classes with detailed specifications
- Introduced MainPart class to represent principal portions with quantified values, including attributes for part type and currency code.
- Added OutputData class to specify output characteristics from devices/services, including format, description, and destination URL.
- Created canonical_value, capacity, capacity_type, and capacity_value slots for enhanced data representation.
- Archived and migrated various slots related to data sensitivity, dataset descriptions, and titles to align with new structures.
- Implemented has_or_had_caption and has_or_had_main_part slots to support media accessibility and primary portion representation.
- Enhanced data license policy slot to define custodian data licensing and openness policies.
2026-01-23 11:04:15 +01:00

264 lines
12 KiB
YAML

id: https://nde.nl/ontology/hc/class/EncompassingBody
name: EncompassingBody
imports:
- linkml:types
- ../enums/EncompassingBodyTypeEnum
- ./DataLicensePolicy
- ./Project
- ./Country
- ./Subregion
- ./Settlement
- ./Jurisdiction
- ./TimeSpan
- ../slots/id
- ../slots/dissolution_date
- ../slots/has_or_had_policy # was: data_license_policy - migrated per Rule 53 (2026-01-22)
- ../slots/funding_source
- ../slots/description
- ../slots/has_or_had_url # was: website - migrated per Rule 53 (2025-01-15)
- ./URL
- ../slots/legal_jurisdiction
- ../slots/external_identifier
- ../slots/has_or_had_area_served
# MIGRATED 2026-01-22: founding_date → is_or_was_founded_through + FoundingEvent (Rule 53)
- ../slots/is_or_was_founded_through
- ./FoundingEvent
- ../slots/funding_focus
- ../slots/funding_scheme
- ../slots/governance_authority
- ../slots/implements_agenda
- ../slots/issued_call
- ../slots/has_or_had_member_custodian
- ../slots/membership_criteria
- ../slots/organization_legal_form
- ../slots/organization_name
- ../slots/organization_type
- ../slots/programme_period
- ../slots/has_or_had_project
- ../slots/service_offering
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/has_or_had_budget # was: total_annual_budget - migrated per Rule 53 (2026-01-15)
- ./Budget # for has_or_had_budget range
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
# NOTE: Duplicate imports removed during data_license_policy migration (2026-01-22)
- ../slots/organization_legal_form
- ../slots/organization_name
- ../slots/organization_type
- ../slots/service_offering
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
org: http://www.w3.org/ns/org#
skos: http://www.w3.org/2004/02/skos/core#
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
tooi: https://identifier.overheid.nl/tooi/def/ont/
cpov: http://data.europa.eu/m8g/
foaf: http://xmlns.com/foaf/0.1/
odrl: http://www.w3.org/ns/odrl/2/
gleif_base: https://www.gleif.org/ontology/Base/
lcc_cr: https://www.omg.org/spec/LCC/Countries/CountryRepresentation/
default_prefix: hc
classes:
EncompassingBody:
class_uri: org:Organization
abstract: true
description: "An extra-organizational governance entity that encompasses, oversees, or coordinates\nheritage custodian\
\ organizations. Represents the broader organizational context in which\ncustodians operate, extending beyond internal\
\ organizational structure (OrganizationalStructure)\nand legal registration (CustodianLegalStatus.governance_structure).\n\
\n**SIX TYPES OF ENCOMPASSING BODIES**:\n\n 1. **UmbrellaOrganisation** - LEGAL parent organizations\n - Defined in\
\ articles of association, foundation statutes, or legislation\n - Permanent hierarchical legal structure\n - Example:\
\ Ministry of OCW governing National Archives\n \n2. **NetworkOrganisation** - SERVICE provider networks\n - Temporary\
\ agreements/treaties providing services to members\n - NOT legally imposed, members choose to participate\n - Example:\
\ Digital Heritage Network providing preservation services\n \n3. **Consortium** - MUTUAL assistance bodies\n -\
\ Temporary collaborative agreements for mutual benefit\n - Members help each other (peer-to-peer)\n - Example:\
\ Library Consortium for shared cataloging\n \n4. **Cooperative** - MEMBER-OWNED organizations\n - Permanent legal\
\ structure with member governance\n - Members are owners, contributors, AND consumers\n - Typically MIXED or CLOSED\
\ data policy\n - Example: OCLC (library cooperative)\n \n5. **SocialMovement** - VALUE-DRIVEN movements\n - Open\
\ participation based on shared ideological values\n - Typically FULLY OPEN data policy (openness as core value)\n\
\ - Example: Wikimedia Foundation/Movement\n \n6. **FundingOrganisation** - GRANT-GIVING organizations\n - Provides\
\ financial resources (grants, subsidies) to custodians\n - No governance authority over recipients\n - Example:\
\ Mondriaan Fund, European Research Council\n\n**Key Distinction from GovernanceStructure**:\n- **GovernanceStructure**\
\ (on CustodianLegalStatus): Internal structure of the legal entity itself\n (board of trustees, directors, departments)\n\
- **EncompassingBody**: External parent/umbrella organizations that govern or coordinate\n multiple custodians\n\n\
**Key Distinction from OrganizationalStructure**:\n- **OrganizationalStructure** (on Custodian): Internal operational\
\ units\n (departments, teams, divisions)\n- **EncompassingBody**: External organizations that custodian is part of\
\ or member of\n\n**Ontological Alignment**:\n- W3C ORG: `org:Organization` (parent class for all organizational entities)\n\
- TOOI: `tooi:Samenwerkingsorganisatie` (Dutch collaborative organizations)\n- Schema.org: `schema:Organization`, `schema:Consortium`,\
\ `schema:FundingAgency`\n- CPOV: `cpov:PublicOrganisation` (for public sector umbrella bodies)\n- FOAF: `foaf:Organization`\n\
\n**Relationship Properties**:\nUses `org:subOrganizationOf` from Custodian → EncompassingBody to express:\n- \"National\
\ Archives is sub-organization of Ministry OCW\" (UmbrellaOrganisation)\n- \"Museum is member of Digital Heritage Network\"\
\ (NetworkOrganisation)\n- \"Library participates in Cataloging Consortium\" (Consortium)\n- \"Museum received grant\
\ from Mondriaan Fund\" (FundingOrganisation - via schema:funder)\n"
slots:
- has_or_had_area_served
- has_or_had_policy # was: data_license_policy - migrated per Rule 53 (2026-01-22)
- description
- dissolution_date
- external_identifier
- is_or_was_founded_through # was: founding_date - migrated per Rule 53 (2026-01-22)
- governance_authority
- id
- legal_jurisdiction
- has_or_had_member_custodian
- membership_criteria
- organization_legal_form
- organization_name
- organization_type
- has_or_had_project
- service_offering
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- has_or_had_url # was: website - migrated per Rule 53 (2025-01-15)
slot_usage:
id:
identifier: true
required: true
range: uriorcurie
pattern: ^https://nde\.nl/ontology/hc/encompassing-body/[a-z-]+/[a-z0-9-]+$
examples:
- value: https://nde.nl/ontology/hc/encompassing-body/umbrella/nl-ministry-ocw
description: URI for Ministry OCW as umbrella organization
- value: https://nde.nl/ontology/hc/encompassing-body/network/digital-heritage-nl
description: URI for Digital Heritage Network
organization_name:
required: true
range: string
examples:
- value: Ministerie van Onderwijs, Cultuur en Wetenschap
description: Dutch Ministry of Education, Culture and Science
- value: Digital Heritage Network
description: Service network for digital preservation
organization_type:
required: true
range: EncompassingBodyTypeEnum
examples:
- value: UMBRELLA
description: Legal parent organization
- value: NETWORK
description: Service provider network
description:
range: string
examples:
- value: The Ministry of OCW oversees national cultural heritage institutions including the National Archives, Rijksmuseum,
and National Library.
organization_legal_form:
range: string
examples:
- value: Government ministry
- value: Non-profit foundation
- value: Professional association
# MIGRATED 2026-01-22: founding_date → is_or_was_founded_through + FoundingEvent (Rule 53)
is_or_was_founded_through:
description: |
The founding event for this encompassing body.
Migrated from founding_date per slot_fixes.yaml revision.
range: FoundingEvent
inlined: true
examples:
- value:
temporal_extent:
begin_of_the_begin: "1965-07-01"
end_of_the_begin: "1965-07-01"
founding_description: "Ministry established July 1965"
description: Ministry founding event (exact date)
dissolution_date:
range: date
examples:
- value: '2020-12-31'
description: Consortium dissolved end of 2020
has_or_had_member_custodian:
range: uriorcurie
multivalued: true
inlined_as_list: true
examples:
- value: https://nde.nl/ontology/hc/nl/nationaal-archief
description: URI reference to National Archives
governance_authority:
range: string
examples:
- value: Ministry exercises budgetary oversight and appoints institutional directors.
description: Umbrella authority example
- value: Network coordinates digital preservation services but members retain autonomy.
description: Network authority example
service_offering:
range: string
multivalued: true
examples:
- value: Digital preservation infrastructure
- value: Shared cataloging platform
- value: Professional development training
- value: Bulk licensing negotiations
membership_criteria:
range: string
examples:
- value: Dutch government heritage institutions established by law
description: Umbrella criteria (non-voluntary)
- value: Museums with digitization programs seeking preservation services
description: Network criteria (voluntary)
external_identifier:
range: uriorcurie
multivalued: true
inlined_as_list: true
examples:
- value: http://www.wikidata.org/entity/Q2294910
description: Wikidata URI for Dutch Ministry OCW
has_or_had_url:
range: URL
inlined: true
multivalued: false
description: |
Official website of the encompassing body.
MIGRATED from website slot per slot_fixes.yaml (Rule 53, 2025-01-15).
examples:
- value:
url_value: https://www.rijksoverheid.nl/ministeries/ministerie-van-onderwijs-cultuur-en-wetenschap
url_type: website
description: Ministry OCW website
has_or_had_project:
range: Project
multivalued: true
inlined_as_list: true
examples:
- value:
- project_id: https://nde.nl/ontology/hc/project/nde/versnellen-2024
project_name: Versnellen 2024
project_status: IN_PROGRESS
- project_id: https://nde.nl/ontology/hc/project/nde/versnellen-2023
project_name: Versnellen 2023
project_status: COMPLETED
description: NDE's acceleration programs
has_or_had_area_served:
range: string
multivalued: true
inlined_as_list: true
examples:
- value: NL
description: Netherlands national coverage
- value: EU
description: European Union coverage
- value: GLOBAL
description: Worldwide operation
legal_jurisdiction:
range: Jurisdiction
exact_mappings:
- org:Organization
close_mappings:
- tooi:Samenwerkingsorganisatie
- schema:Organization
- cpov:PublicOrganisation
- foaf:Organization
comments:
- EncompassingBody is abstract - use one of six concrete subclasses
- Extends governance modeling BEYOND internal structure to external relationships
- Complements but does not replace GovernanceStructure or OrganizationalStructure
- 'Six types reflect different relationship models: legal (umbrella), service (network), collaborative (consortium), ownership
(cooperative), ideological (social movement), financial (funding)'