glam/frontend/public/schemas/20251121/linkml/modules/classes/Currency.yaml
kempersc 853419d6c2 feat: Introduce MeasureUnitEnum for standardized measurement units
- Added MeasureUnitEnum.yaml to define standard measurement units for area, length, and related quantities, compliant with ISO 80000-1, QUDT, and UCUM.
- Included units such as square meters, hectares, acres, meters, kilometers, and their conversions.

feat: Create applies_or_applied_to_call slot for funding requirements

- Introduced applies_or_applied_to_call.yaml to track funding calls related to requirements, following RiC-O naming conventions.

chore: Archive and migrate annual_participants slot

- Archived annual_participants_archived_20260115.yaml, replaced by has_or_had_annual_participant_count for better temporal naming.

chore: Archive applies_to_call slot and migrate to new naming

- Archived applies_to_call_archived_20260115.yaml, replaced by applies_or_applied_to_call for compliance with RiC-O conventions.

chore: Archive area_hectares slot and migrate to has_area_in_hectare

- Archived area_hectares_archived_20260115.yaml, replaced by has_area_in_hectare for standardized area measurement.

chore: Archive arrangement_notes slot and migrate to has_arrangement_note

- Archived arrangement_notes_archived_20260115.yaml, replaced by has_arrangement_note for improved naming consistency.

chore: Archive available_caption_languages slot and migrate to has_available_caption_language

- Archived available_caption_languages_archived_20260115.yaml, replaced by has_available_caption_language for better naming.

chore: Archive beneficiary_group slot and migrate to has_or_had_beneficiary

- Archived beneficiary_group_archived_20260115.yaml, replaced by has_or_had_beneficiary for compliance with naming conventions.

chore: Archive branch_head slot and migrate to has_or_had_head

- Archived branch_head_archived_20260114.yaml, replaced by has_or_had_head for better semantic alignment.

chore: Archive budget_currency slot

- Archived budget_currency_archived_20260114.yaml for future migration.

chore: Archive building_floor_area_sqm slot and migrate to has_or_had_area

- Archived building_floor_area_sqm_archived_20260115.yaml, replaced by has_or_had_area for standardized area measurement.

chore: Archive has_area_in_hectare slot and migrate to has_or_had_area

- Archived has_area_in_hectare_archived_20260115.yaml, replaced by has_or_had_area for compliance with naming conventions.

feat: Introduce has_or_had_area slot for area measurements

- Added has_or_had_area.yaml as the authoritative slot for area measurements, compliant with Rule 53.

feat: Introduce has_or_had_beneficiary slot for beneficiary tracking

- Added has_or_had_beneficiary.yaml to identify beneficiaries of organizational programs, following RiC-O naming conventions.

feat: Introduce has_or_had_currency slot for monetary values

- Added has_or_had_currency.yaml to associate currencies with monetary amounts, compliant with ISO 4217.

feat: Introduce has_or_had_head slot for organizational heads

- Added has_or_had_head.yaml to link organizational units with their heads, following W3C ORG standards.

feat: Introduce has_or_had_unit slot for measurement units

- Added has_or_had_unit.yaml to associate measurements with their units, compliant with Rule 53.
2026-01-14 17:28:38 +01:00

173 lines
5.2 KiB
YAML

id: https://nde.nl/ontology/hc/class/Currency
name: Currency
title: Currency Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
qudt: http://qudt.org/schema/qudt/
dcterms: http://purl.org/dc/terms/
imports:
- linkml:types
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ../slots/has_or_had_description
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
default_prefix: hc
classes:
Currency:
class_uri: schema:Currency
description: >-
A currency used for monetary values.
**SCHEMA.ORG ALIGNMENT**:
Maps to `schema:Currency` - "A currency as defined by ISO 4217."
**ISO 4217 STANDARD**:
ISO 4217 defines three-letter currency codes:
| Code | Currency | Symbol |
|------|----------|--------|
| EUR | Euro | € |
| USD | US Dollar | $ |
| GBP | British Pound | £ |
| JPY | Japanese Yen | ¥ |
| CHF | Swiss Franc | CHF |
**WHY NOT JUST USE STRING?**
Simple string fields like `budget_currency: "EUR"` lose important context:
- Symbol for display purposes
- Full name for accessibility
- Historical validity (currencies change over time)
- Link to authoritative ISO 4217 standard
The Currency class captures this richness while remaining simple for basic use.
**HISTORICAL CURRENCIES**:
Heritage institutions often deal with historical currencies:
- NLG (Dutch Guilder) - replaced by EUR in 2002
- DEM (German Mark) - replaced by EUR in 2002
- FRF (French Franc) - replaced by EUR in 2002
The temporal naming pattern (has_or_had_currency) accommodates this.
**EXAMPLE**:
```yaml
Currency:
currency_code: EUR
currency_name: Euro
currency_symbol: €
```
exact_mappings:
- schema:Currency
close_mappings:
- qudt:CurrencyUnit
slots:
- has_or_had_identifier
- currency_code
- has_or_had_label
- currency_symbol
- has_or_had_description
- specificity_annotation
- template_specificity
slot_usage:
has_or_had_identifier:
range: uriorcurie
required: false
identifier: true
description: >-
Optional identifier for this currency.
examples:
- value: https://nde.nl/ontology/hc/currency/EUR
description: Euro currency identifier
currency_code:
range: string
required: true
pattern: "^[A-Z]{3}$"
description: >-
ISO 4217 three-letter currency code.
examples:
- value: EUR
description: Euro
- value: USD
description: US Dollar
- value: GBP
description: British Pound
- value: NLG
description: Dutch Guilder (historical)
has_or_had_label:
range: string
required: false
description: >-
Full name of the currency.
examples:
- value: Euro
- value: US Dollar
- value: Dutch Guilder
currency_symbol:
range: string
required: false
description: >-
Currency symbol for display.
examples:
- value:
description: Euro symbol
- value: $
description: Dollar symbol
- value: £
description: Pound symbol
- value: ƒ
description: Guilder symbol (historical)
has_or_had_description:
range: string
required: false
description: >-
Additional information about the currency, such as historical context.
examples:
- value: Official currency of the Eurozone since 1999
- value: Dutch national currency until replaced by Euro in 2002
comments:
- Currency models monetary unit with ISO 4217 code and metadata
- Replaces simple string currency fields with structured data
- Uses Schema.org Currency as primary ontology mapping
- Supports both current and historical currencies
see_also:
- https://schema.org/Currency
- https://www.iso.org/iso-4217-currency-codes.html
examples:
- value:
currency_code: EUR
has_or_had_label: Euro
currency_symbol:
has_or_had_description: Official currency of the Eurozone
description: Euro currency
- value:
currency_code: NLG
has_or_had_label: Dutch Guilder
currency_symbol: ƒ
has_or_had_description: Dutch national currency until replaced by Euro in 2002
description: Historical Dutch Guilder
- value:
currency_code: USD
has_or_had_label: US Dollar
currency_symbol: $
description: US Dollar currency
slots:
currency_code:
description: >-
ISO 4217 three-letter currency code.
range: string
slot_uri: schema:currency
currency_symbol:
description: >-
Currency symbol for display purposes.
range: string
slot_uri: hc:currencySymbol