glam/schemas/20251121/linkml/modules/classes/MissionStatement.yaml
kempersc b34992b1d3 Migrate all 293 class files to ontology-aligned slots
Extends migration to all class types (museums, libraries, galleries, etc.)

New slots added to class_metadata_slots.yaml:
- RiC-O: rico_record_set_type, rico_organizational_principle,
  rico_has_or_had_holder, rico_note
- Multilingual: label_de, label_es, label_fr, label_nl, label_it, label_pt
- Scope: scope_includes, scope_excludes, custodian_only,
  organizational_level, geographic_restriction
- Notes: privacy_note, preservation_note, legal_note

Migration script now handles 30+ annotation types.
All migrated schemas pass linkml-validate.

Total: 387 class files now use proper slots instead of annotations.
2026-01-06 12:24:54 +01:00

302 lines
12 KiB
YAML

id: https://nde.nl/ontology/hc/class/MissionStatement
name: MissionStatement
title: MissionStatement Class - Organizational Purpose Documentation
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
pav: http://purl.org/pav/
org: http://www.w3.org/ns/org#
xsd: http://www.w3.org/2001/XMLSchema#
oa: http://www.w3.org/ns/oa#
imports:
- linkml:types
- ../slots/source_url
- ../slots/retrieved_on
- ../slots/content_hash
- ../slots/supersedes
- ../slots/effective_date
- ../slots/extraction_agent
- ../slots/extraction_notes
- ../slots/xpath
- ../slots/css_selector
- ../slots/html_file
- ../slots/extraction_timestamp
- ../slots/extraction_confidence
- ../slots/class_metadata_slots
default_prefix: hc
enums:
StatementTypeEnum:
description: |
Types of organizational purpose statements.
Heritage custodians often publish distinct mission, vision, and goal statements,
each serving different communicative functions.
permissible_values:
mission:
description: |
Core purpose statement - why the organization exists.
Answers: "What do we do and for whom?"
Often includes: scope, audience, unique value proposition.
Dutch: "missie"
meaning: org:purpose
comments:
- Primary statement of organizational raison d'être
- Usually 1-3 sentences
- Present-tense, action-oriented
vision:
description: |
Aspirational future state - what the organization aims to achieve.
Answers: "What will the world look like if we succeed?"
Dutch: "visie"
meaning: schema:seeks
comments:
- Forward-looking, inspirational
- Often begins with 'To be...' or 'We envision...'
- Longer time horizon than mission
goal:
description: |
Specific measurable objective - concrete aims.
Answers: "What specific outcomes do we pursue?"
Dutch: "doelstelling", "doel"
meaning: schema:seeks
comments:
- More specific than mission/vision
- Often time-bound or measurable
- May have multiple goals listed
value:
description: |
Core organizational values - guiding principles.
Answers: "What principles guide our work?"
Dutch: "waarden", "kernwaarden"
meaning: schema:ethicsPolicy
comments:
- Often expressed as single words or phrases
- 'Examples: integrity, accessibility, inclusivity'
motto:
description: |
Short memorable phrase encapsulating purpose.
Often used in branding/marketing.
Dutch: "motto", "slagzin"
meaning: schema:slogan
comments:
- Very brief (3-10 words typically)
- May be poetic or alliterative
- 'Example: ''Waar komt ons voedsel écht vandaan'''
slots:
statement_id:
identifier: true
range: uriorcurie
description: Unique identifier for this mission statement record
statement_type:
range: StatementTypeEnum
required: true
description: |
Type of organizational purpose statement (mission, vision, goal, value, motto).
Determines semantic interpretation and ontology mapping.
statement_text:
range: string
required: true
description: |
The actual statement text as extracted from the source.
Should preserve original language and formatting where practical.
For Dutch heritage custodians, typically in Dutch.
statement_language:
range: string
description: |
ISO 639-1 language code for the statement text.
Examples: "nl" (Dutch), "en" (English), "de" (German)
pattern: ^[a-z]{2}$
statement_summary:
range: string
description: |
Optional English summary/translation for non-English statements.
Useful for international discoverability.
page_section:
range: string
description: |
Section or heading on the web page where statement was found.
Examples: "Onze Missie", "Vision Statement", "About Us"
text_fragment:
range: uri
description: |
W3C Text Fragment URL pointing to exact text in the source page.
Format: {source_url}#:~:text={encoded_text}
Enables direct deep-linking to the statement.
archive_memento_uri:
range: uri
description: |
Wayback Machine or other web archive memento URI.
Ensures long-term accessibility of source evidence.
Format: https://web.archive.org/web/{timestamp}/{url}
adoption_context:
range: string
description: |
Context in which the statement was adopted (if documented).
Examples: "Annual report 2024", "Board meeting 2023-06-15"
classes:
MissionStatement:
class_uri: org:purpose
description: "A structured record of an organizational purpose statement (mission,\
\ vision,\ngoals, values, or motto) extracted from a heritage custodian's website\
\ with\nfull provenance documentation.\n\n**PURPOSE**:\n\nHeritage custodians\
\ publish mission and vision statements that articulate:\n- Why they exist (mission)\n\
- What future state they aspire to (vision)\n- What specific outcomes they pursue\
\ (goals)\n- What principles guide their work (values)\n- Memorable phrases\
\ encapsulating their purpose (mottos)\n\nThese statements are valuable for:\n\
- Understanding organizational identity and purpose\n- Comparing institutions\
\ within and across sectors\n- Tracking organizational evolution over time\n\
- Research on heritage sector discourse and priorities\n\n**PROVENANCE REQUIREMENTS**:\n\
\nFollowing the WebObservation pattern, every MissionStatement MUST have:\n\n\
1. **Source documentation**: source_url + retrieved_on\n2. **Location evidence**:\
\ xpath OR css_selector + html_file\n3. **Integrity verification**: content_hash\
\ (SHA-256)\n4. **Archive link**: archive_memento_uri (recommended)\n\nStatements\
\ without verifiable provenance are rejected.\n\n**ONTOLOGY ALIGNMENT**:\n\n\
W3C Organization Ontology `org:purpose`:\n- \"Indicates the purpose of this\
\ Organization\"\n- \"There can be many purposes at different levels of abstraction\"\
\n- \"It is recommended that the purpose be denoted by a controlled term\"\n\
\nWe extend this by:\n- Distinguishing statement types (mission, vision, goal,\
\ value, motto)\n- Adding temporal tracking (effective_date, supersedes)\n-\
\ Full provenance chain (source_url, xpath, content_hash, archive)\n\n**MULTILINGUAL\
\ SUPPORT**:\n\nHeritage custodians publish statements in their native language.\n\
For Dutch institutions, statements are typically in Dutch.\nThe statement_language\
\ field captures the ISO 639-1 code,\nand statement_summary can provide English\
\ translation.\n\n**TEMPORAL TRACKING**:\n\nOrganizations revise their mission\
\ statements over time.\nThe `supersedes` field links to previous statements,\n\
enabling tracking of how organizational purpose evolves.\n\n**EXAMPLES**:\n\n\
1. **Dutch Agricultural Museum Mission**\n - statement_type: mission\n -\
\ statement_text: \"Waar komt ons voedsel écht vandaan.\"\n - statement_language:\
\ nl\n - source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie\n\
\ \n2. **Rijksmuseum Vision**\n - statement_type: vision\n - statement_text:\
\ \"Het Rijksmuseum verbindt mensen met kunst en geschiedenis.\"\n - statement_language:\
\ nl\n - statement_summary: \"The Rijksmuseum connects people with art and\
\ history.\"\n"
exact_mappings:
- org:purpose
close_mappings:
- schema:description
- prov:Entity
related_mappings:
- schema:slogan
- schema:ethicsPolicy
- schema:seeks
slots:
- adoption_context
- archive_memento_uri
- content_hash
- css_selector
- effective_date
- extraction_agent
- extraction_confidence
- extraction_notes
- extraction_timestamp
- html_file
- page_section
- retrieved_on
- source_url
- specificity_annotation
- statement_id
- statement_language
- statement_summary
- statement_text
- statement_type
- supersedes
- template_specificity
- text_fragment
- xpath
slot_usage:
statement_type:
required: true
description: |
Type of statement. Required to determine semantic interpretation.
- mission: Core purpose (why we exist)
- vision: Aspirational future (what we aim for)
- goal: Specific objectives (what we pursue)
- value: Guiding principles (how we work)
- motto: Memorable phrase (brand identity)
statement_text:
required: true
description: |
The actual statement text. Required - this is the core content.
Preserve original language and formatting.
source_url:
required: true
description: |
URL of the web page where statement was found. Required for provenance.
retrieved_on:
required: true
description: |
When the page was retrieved. Required for temporal provenance.
ISO 8601 format with timezone (UTC preferred).
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
rules:
- preconditions:
slot_conditions:
statement_type:
equals_string: motto
postconditions:
description: Mottos should be brief - typically under 50 characters
comments:
- MissionStatement maps to org:purpose from W3C Organization Ontology
- Requires source_url and retrieved_on for provenance
- Strongly recommend xpath/css_selector + html_file for verification
- content_hash enables integrity checking
- archive_memento_uri ensures long-term source accessibility
- Supports tracking statement evolution via supersedes field
- statement_language uses ISO 639-1 codes (nl, en, de, etc.)
see_also:
- https://www.w3.org/TR/vocab-org/#org:purpose
- https://www.w3.org/TR/prov-o/
- https://wicg.github.io/scroll-to-text-fragment/
- https://www.w3.org/TR/SRI/
examples:
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/mission-2025
statement_type: mission
statement_text: Waar komt ons voedsel écht vandaan.
statement_language: nl
statement_summary: Where does our food really come from.
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Onze Missie
content_hash: sha256-abc123...
extraction_agent: claude-opus-4.5
extraction_confidence: 0.95
description: Mission statement from Dutch agricultural museum
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/vision-2025
statement_type: vision
statement_text: |
Het Landbouwmuseum Tiengemeten voelt zich onderdeel van een belangrijke
agrarische ontwikkeling, de mechanisatie tussen 1920 en 1955. De collectie
is relevant en de presentatie verbindt generaties.
statement_language: nl
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Onze visie
content_hash: sha256-def456...
extraction_agent: claude-opus-4.5
extraction_confidence: 0.9
description: Vision statement from Dutch agricultural museum
- value:
statement_id: https://nde.nl/ontology/hc/mission/nl-zh-zui-m-lmt/goals-2025
statement_type: goal
statement_text: |
Onze ambitie en doelstellingen hebben wij geformuleerd rondom de volgende punten:
- Het Landbouwmuseum Tiengemeten laat de ontwikkeling van het boerenbedrijf
in de periode 1920 tot 1955 zien d.m.v. een prachtige collectie.
- Voor onze bezoekers een gewaardeerd en gastvrij museum te zijn.
- De collecties welke wij beheren toegankelijk maken voor nu en voor
volgende generaties.
statement_language: nl
source_url: https://www.landbouwmuseumtiengemeten.nl/het-museum/missie-en-visie
retrieved_on: '2025-12-29T10:00:00Z'
page_section: Doelstellingen
extraction_agent: claude-opus-4.5
description: Goals/objectives from Dutch agricultural museum