glam/frontend/public/schemas/20251121/linkml/modules/classes/ContributingAgency.yaml
2026-01-19 00:09:28 +01:00

283 lines
7.8 KiB
YAML

id: https://nde.nl/ontology/hc/class/ContributingAgency
name: contributing_agency
title: Contributing Agency Class
prefixes:
linkml: https://w3id.org/linkml/
schema: http://schema.org/
org: http://www.w3.org/ns/org#
dcat: http://www.w3.org/ns/dcat#
prov: http://www.w3.org/ns/prov#
hc: https://nde.nl/ontology/hc/
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ./Country
- ./StandardsOrganization
- ./AllocationAgency
- ./Standard
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/description
- ../slots/has_or_had_url # was: website - migrated per Rule 53 (2025-01-15)
- ./URL
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/contributor_code
- ../slots/name_local
- ../slots/has_or_had_abbreviation
- ../slots/has_authority_file_name
- ../slots/has_authority_file_abbreviation
- ../slots/has_authority_file_url
- ../slots/record_format
- ../slots/entity_types_covered
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/is_active
- ../slots/governance_representative
- ../slots/is_or_was_also_allocation_agency
- ../slots/member_of
- ../slots/governance_role
- ../enums/AuthorityRecordFormatEnum
- ../enums/AuthorityEntityTypeEnum
- ../enums/ConsortiumGovernanceRoleEnum
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/contributor_code
- ../slots/description
- ../slots/entity_types_covered
- ../slots/governance_representative
- ../slots/governance_role
- ../slots/has_authority_file_abbreviation
- ../slots/has_authority_file_name
- ../slots/has_authority_file_url
- ../slots/has_or_had_abbreviation
- ../slots/has_or_had_url
- ../slots/is_active
- ../slots/is_or_was_also_allocation_agency
- ../slots/member_of
- ../slots/name_local
- ../slots/record_format
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/contributor_code
- ../slots/description
- ../slots/entity_types_covered
- ../slots/governance_representative
- ../slots/governance_role
- ../slots/has_authority_file_abbreviation
- ../slots/has_authority_file_name
- ../slots/has_authority_file_url
- ../slots/has_or_had_abbreviation
- ../slots/has_or_had_url
- ../slots/is_active
- ../slots/is_or_was_also_allocation_agency
- ../slots/member_of
- ../slots/name_local
- ../slots/record_format
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
classes:
ContributingAgency:
class_uri: org:FormalOrganization
description: 'An organization that contributes authority data to a consortium-type identifier service.
**Primary Use Case: VIAF**
VIAF (Virtual International Authority File) is an aggregation service that clusters
matching authority records from 37 contributing agencies across 29 countries.
Each contributor provides:
1. **Authority records**: MARC21 or UNIMARC authority data
2. **Local identifiers**: Their national authority file IDs
3. **Regular updates**: Periodic batch uploads or OAI-PMH feeds
VIAF then:
- Clusters matching records using algorithms
- Assigns VIAF IDs to each cluster
- Links back to all source records
**CORRECT MODEL: OCLC is the Organization, VIAF is the Service**
The relationship chain:
1. **OCLC** (StandardsOrganization, type: LIBRARY_COOPERATIVE): The operating organization
2. **VIAF** (Standard, type: CONSORTIUM_SERVICE): The service operated by OCLC
3. **VIAF Council** (StandardsOrganization, type: GOVERNANCE_COUNCIL): Advisory body
4. **ContributingAgency**: Members of OCLC that contribute to VIAF
**Key Properties:**
- `member_of` -> OCLC (the organization, NOT "VIAF Consortium")
- `contributes_to` -> VIAF (the service)
- `governance_role` -> FOUNDING_MEMBER | VOTING_MEMBER (role in VIAF Council)
**Dual Role of National Libraries**
Many national libraries serve as BOTH:
- **ContributingAgency**: Provide authority records (e.g., NTA to VIAF)
- **AllocationAgency**: Allocate national identifiers (e.g., ISIL codes)
These are conceptually different roles, though often performed by the same organization.
**VIAF Contributors (as of 2024)**
| Abbreviation | Organization | Country |
|--------------|--------------|---------|
| LC | Library of Congress | US |
| DNB | Deutsche Nationalbibliothek | DE |
| BnF | Bibliotheque nationale de France | FR |
| NTA | National Library of the Netherlands | NL |
| BNE | Biblioteca Nacional de Espana | ES |
| ICCU | Istituto Centrale per il Catalogo Unico | IT |
| NDL | National Diet Library | JP |
| NLA | National Library of Australia | AU |
| NLI | National Library of Israel | IL |
| SWNL | Swiss National Library | CH |
| ... | (37 total contributors) | |
**Ontology Alignment**
- org:FormalOrganization - W3C Organization Ontology
- org:memberOf - Relationship to OCLC (the organization)
- prov:Agent - PROV-O (as data contributor)
- dcat:Catalog - DCAT (authority file as catalog)
'
exact_mappings:
- org:FormalOrganization
close_mappings:
- prov:Agent
- dcat:Catalog
- org:memberOf
see_also:
- linkml:https://nde.nl/ontology/hc/class/StandardsOrganization
- linkml:https://nde.nl/ontology/hc/class/Standard
attributes:
id:
identifier: true
slot_uri: schema:identifier
description: 'Unique identifier for this contributing agency.
Recommended format: lowercase has_or_had_abbreviation matching VIAF contributor code.
Examples: "lc", "dnb", "bnf", "nta", "bne", "iccu", "ndl"
'
range: uriorcurie
required: true
name:
slot_uri: schema:name
description: 'Full English name of the contributing agency.
Examples:
- "Library of Congress"
- "German National Library"
- "National Library of France"
- "National Library of the Netherlands"
'
range: string
required: true
country:
slot_uri: schema:location
description: 'Country of the contributing agency (ISO 3166-1 alpha-2).
Examples: "US", "DE", "FR", "NL", "ES", "IT", "JP"
'
range: Country
required: true
inlined: false
slots:
- contributor_code
- name_local
- has_or_had_abbreviation
- has_authority_file_name
- has_authority_file_abbreviation
- has_authority_file_url
- record_format
- entity_types_covered
- contributes_to
- contribution_start_date
- is_active
- governance_representative
- has_or_had_url # was: website - migrated per Rule 53 (2025-01-15)
- description
- is_or_was_also_allocation_agency
- member_of
- governance_role
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
slot_usage:
contributes_to:
range: Standard
is_or_was_also_allocation_agency:
range: AllocationAgency
member_of:
range: StandardsOrganization
has_or_had_url:
range: URL
inlined: true
multivalued: false
description: |
Official website of the contributing agency.
MIGRATED from website slot per slot_fixes.yaml (Rule 53, 2025-01-15).