kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/AllocationAgency.yaml
kempersc 095a3f949c refactor(linkml): apply RiC-O slot naming conventions to /schemas/ (Rule 39) 
Apply same RiC-O-style slot naming refactor to /schemas/20251121/linkml/
that was previously applied to frontend/public/schemas/:

- Add 'has_' prefix for possession predicates
- Add 'is_or_was_' prefix for temporal inverse relationships
- Add 'has_or_had_' for bidirectional temporal relations
- Add new slots: is_or_was_aggregated_by, is_or_was_allocated_by, etc.
- Update count slots with proper descriptions

This ensures consistency between the source schema directory and the
frontend-served schemas.

514 files changed, +6,325 insertions, -4,255 deletions
2026-01-10 12:55:45 +01:00

290 lines
10 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/AllocationAgency
name: allocation_agency
title: Allocation Agency Class
prefixes:
linkml: https://w3id.org/linkml/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
gleif_base: https://www.gleif.org/ontology/Base/
imports:
- linkml:types
- ../metadata
- ./Standard
- ./RegistrationAuthority
- ./Country
- ./Subregion
- ../slots/description
- ../slots/website
- ../slots/contact_email
- ../slots/specificity_annotation
- ../slots/template_specificity
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
classes:
AllocationAgency:
class_uri: org:FormalOrganization
description: "An organization that allocates identifiers within a specific geographic\
\ area \nand/or domain of heritage institutions.\n\n**Key Distinction from RegistrationAuthority:**\n\
\n- **RegistrationAuthority**: Maintains the GLOBAL registry for a standard\n\
\ - Example: Danish Agency for Culture and Palaces maintains global ISIL registry\n\
\ - Example: ISNI International Agency (WIPO) maintains global ISNI database\n\
\n- **AllocationAgency**: Allocates identifiers LOCALLY within constraints\n\
\ - Example: Koninklijke Bibliotheek allocates ISIL for Dutch public libraries\n\
\ - Example: OCLC allocates ISIL for Dutch academic libraries\n - Example:\
\ Nationaal Archief allocates ISIL for Dutch archives\n\n**Multi-Dimensional\
\ Scope:**\n\nAllocationAgencies have both:\n1. **Geographic scope**: Which\
\ country/region they serve\n2. **Domain scope**: Which types of institutions\
\ they serve\n\nThis allows multiple agencies per country, each serving different\
\ domains:\n- NL public libraries → KB\n- NL academic libraries → OCLC\n- NL\
\ archives → Nationaal Archief\n\n**Relationship to Standard:**\n\nAn AllocationAgency\
\ allocates for one or more Standards:\n- AllocationAgency.allocates_for → Standard[]\n\
- Standard can have multiple AllocationAgencies (one per country/domain)\n\n\
**Examples:**\n\n| Agency | Country | Domain | Standard |\n|--------|---------|--------|----------|\n\
| Koninklijke Bibliotheek | NL | Public libraries | ISIL |\n| OCLC | NL | Academic\
\ libraries | ISIL |\n| Nationaal Archief | NL | Archives | ISIL |\n| British\
\ Library | GB | All | ISIL |\n| Library of Congress | US | All | ISIL |\n|\
\ OCLC | Global | Academic | VIAF |\n| Deutsche Nationalbibliothek | DE | All\
\ | ISNI |\n\n**Ontology Alignment:**\n\n- org:FormalOrganization - W3C Organization\
\ Ontology\n- Extends gleif_base:RegistrationAuthority concept (but for allocation,\
\ not registration)\n"
exact_mappings:
- org:FormalOrganization
close_mappings:
- gleif_base:RegistrationAuthority
- schema:Organization
attributes:
id:
identifier: true
slot_uri: schema:identifier
description: |
Unique identifier for this allocation agency.
Recommended format: {country}-{abbreviation} or {abbreviation}
Examples: "nl-kb", "nl-oclc", "nl-na", "gb-bl", "us-loc"
range: uriorcurie
required: true
name:
slot_uri: schema:name
description: |
Official full name of the allocation agency.
Examples:
- "Koninklijke Bibliotheek"
- "Nationaal Archief"
- "British Library"
- "Library of Congress"
range: string
required: true
name_local:
slot_uri: schema:alternateName
description: |
Name in local language (if different from English name).
Examples:
- "Koninklijke Bibliotheek" (Dutch)
- "Deutsche Nationalbibliothek" (German)
- "Bibliothèque nationale de France" (French)
range: string
has_or_had_abbreviation:
slot_uri: schema:alternateName
description: |
Common abbreviation.
Examples: "KB", "NA", "BL", "LOC", "BnF", "DNB"
range: string
country_scope:
slot_uri: gleif_base:hasCoverageArea
description: |
Geographic area(s) where this agency allocates identifiers.
Usually a single country, but can be multiple countries or subregions.
Examples:
- [NL] for Koninklijke Bibliotheek
- [GB] for British Library
- [US] for Library of Congress
- [DE-BY, DE-BW] for regional German agency
range: Country
multivalued: true
required: true
inlined: false
subregion_scope:
slot_uri: schema:areaServed
description: |
Subregion-level geographic scope (if more specific than country).
For agencies that only serve specific regions within a country.
Examples:
- Staatsarchiv München: [DE-BY] (Bavaria only)
range: Subregion
multivalued: true
inlined: false
allocation_domain:
slot_uri: schema:audienceType
description: |
Types of institutions this agency allocates identifiers for.
Multiple values allowed for agencies serving multiple domains.
Examples:
- KB: [LIBRARY_PUBLIC]
- OCLC: [LIBRARY_ACADEMIC, LIBRARY_RESEARCH]
- Nationaal Archief: [ARCHIVE]
- British Library: [LIBRARY_PUBLIC, LIBRARY_ACADEMIC, ARCHIVE] (all types)
range: AllocationDomainEnum
multivalued: true
required: true
allocates_for:
slot_uri: schema:serviceOutput
description: |
Standards for which this agency allocates identifiers.
Most agencies allocate for a single standard, but some handle multiple.
Examples:
- KB: [ISIL]
- DNB: [ISIL, ISNI]
- OCLC: [ISIL, VIAF]
range: Standard
multivalued: true
required: true
inlined: false
allocation_prefix:
slot_uri: schema:identifier
description: |
Prefix used by this agency when allocating identifiers.
For ISIL, this is typically the country code.
Examples:
- Netherlands ISIL: "NL-"
- Germany ISIL: "DE-"
- UK ISIL: "UK-" or "GB-" (both used historically)
range: string
parent_registration_authority:
slot_uri: schema:parentOrganization
description: |
The registration authority to which this agency reports allocations.
AllocationAgencies report their allocations to the global RegistrationAuthority.
Examples:
- KB (NL ISIL) → Danish Agency for Culture and Palaces
- DNB (DE ISNI) → ISNI International Agency
range: RegistrationAuthority
inlined: false
allocation_start_date:
slot_uri: schema:startDate
description: |
Date when this agency started allocating identifiers.
Format: ISO 8601 date
range: date
allocation_end_date:
slot_uri: schema:endDate
description: |
Date when this agency stopped allocating (if no longer active).
Null if still active.
range: date
is_active:
slot_uri: schema:status
description: Whether this agency is currently allocating identifiers
range: boolean
required: true
website:
slot_uri: schema:url
description: |
Official website of the allocation agency.
Preferably the page about identifier allocation services.
range: uri
contact_email:
slot_uri: schema:email
description: |
Contact email for identifier allocation requests.
Examples: "isil@kb.nl", "isni@dnb.de"
range: string
allocation_policy_url:
slot_uri: schema:usageInfo
description: |
URL to the allocation policy documentation.
Describes eligibility, process, requirements for obtaining identifiers.
range: uri
description:
slot_uri: schema:description
description: Description of the agency's allocation services and scope
range: string
slots:
- specificity_annotation
- template_specificity
slot_usage:
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
enums:
AllocationDomainEnum:
description: |
Types of heritage institutions that an AllocationAgency can serve.
Based on GLAMORCUBESFIXPHDNT taxonomy but focused on allocation domains.
permissible_values:
LIBRARY_PUBLIC:
description: |
Public libraries (openbare bibliotheken).
Examples: Municipal libraries, regional libraries
LIBRARY_ACADEMIC:
description: |
Academic and university libraries.
Examples: University libraries, polytechnic libraries
LIBRARY_RESEARCH:
description: |
Research and special libraries.
Examples: Corporate libraries, government agency libraries
LIBRARY_NATIONAL:
description: |
National libraries.
Examples: Koninklijke Bibliotheek, Library of Congress
ARCHIVE:
description: |
Archives of all types.
Examples: National archives, regional archives, municipal archives
MUSEUM:
description: |
Museums of all types.
Examples: Art museums, history museums, science museums
GALLERY:
description: |
Art galleries and exhibition spaces.
Examples: Commercial galleries, kunsthallen
HERITAGE_SOCIETY:
description: |
Heritage and historical societies.
Examples: Heemkundige kringen, genealogical societies
RESEARCH_ORGANIZATION:
description: |
Research organizations and documentation centers.
Examples: Research institutes, knowledge centers
EDUCATION_PROVIDER:
description: |
Educational institutions with heritage collections.
Examples: Universities, academies
RELIGIOUS_INSTITUTION:
description: |
Religious institutions with collections.
Examples: Church archives, monastery libraries
GOVERNMENT_AGENCY:
description: |
Government agencies and official institutions.
Examples: Ministries, provincial heritage services
ALL:
description: |
Agency allocates for all institution types.
Used when there's a single national agency for all domains.
Reference in a new issue View git blame Copy permalink