glam/schemas/20251121/linkml/modules/classes/ContributingAgency.yaml
kempersc 1f8776bef4 Update schemas and slots with new mappings and descriptions
- Updated manifest.json with new generated timestamp.
- Added close mappings to APIRequest and Administration classes.
- Renamed slots in AccessPolicy to has_or_had_embargo_end_date and has_or_had_embargo_reason.
- Changed class_uri for Accumulation to rico:AccumulationRelation and updated description.
- Added exact mappings to Altitude, AppellationType, and ArchitecturalStyle classes.
- Removed deprecated slots from CollectionManagementSystem and updated has_or_had_type.
- Added new slots for has_or_had_embargo_end_date and has_or_had_embargo_reason.
- Updated slot definitions for has_or_had_assessment, has_or_had_sequence_index, and others with new URIs and mappings.
- Removed unused slots end_seconds and end_time.
- Added new slot definitions for has_or_had_exhibition_type, has_or_had_extent_text, and is_or_was_documented_by.
2026-01-29 13:33:23 +01:00

329 lines
8.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
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../slots/has_or_had_description
- ../slots/has_or_had_url
- ./URL
- ../slots/specificity_annotation
- ../slots/has_or_had_score
- ../slots/contributor_code
- ../slots/name_local
- ../slots/has_or_had_abbreviation
- ../slots/has_authority_file_name
- ../slots/contributes_or_contributed
- ./AuthorityData
- ../slots/has_authority_file_url
- ../slots/provides_or_provided
- ./AuthorityFile
- ./Entity
- ./EntityType
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/is_active
- ../slots/is_or_was_represented_by
- ./Agent
- ../slots/is_or_was_also_allocation_agency
- ../slots/member_of
- ../slots/has_or_had_role
- ./GovernanceRole
- ../enums/AuthorityRecordFormatEnum
- ../enums/AuthorityEntityTypeEnum
- ../enums/ConsortiumGovernanceRoleEnum
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/contributor_code
- ../slots/has_or_had_description
- ../slots/entity_types_covered
- ../slots/governance_representative
- ../slots/governance_role
- ../slots/contributes_or_contributed
- ../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
- ../slots/provides_or_provided
- ../slots/contributes_to
- ../slots/contribution_start_date
- ../slots/contributor_code
- ../slots/has_or_had_description
- ../slots/is_or_was_represented_by
- ../slots/has_or_had_role
- ../slots/contributes_or_contributed
- ../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
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:
- has_or_had_label
- contributes_or_contributed
- has_authority_file_url
- record_format
- provides_or_provided
- contributes_to
- contribution_start_date
- is_active
- is_or_was_represented_by
- has_or_had_url
- has_or_had_description
- is_or_was_also_allocation_agency
- member_of
- has_or_had_role
- specificity_annotation
- has_or_had_score
slot_usage:
provides_or_provided:
range: AuthorityFile
multivalued: true
inlined: true
description: 'Authority files provided by this agency.
MIGRATED from entity_types_covered per slot_fixes.yaml (Rule 53, 2026-01-26).
The AuthorityFile indicates which Entity types it contains.
'
examples:
- value:
has_or_had_label: Library of Congress Name Authority File
contains_or_contained:
- has_or_had_type: PERSON
- has_or_had_type: CORPORATE_BODY
description: LCNAF covering persons and corporate bodies
contributes_to:
range: Standard
is_or_was_also_allocation_agency:
range: AllocationAgency
member_of:
range: StandardsOrganization
is_or_was_represented_by:
range: Agent
description: Representative in the governance council.
has_or_had_role:
range: GovernanceRole
description: Role in the consortium (e.g. Founding Member).
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).
'
contributes_or_contributed:
description: 'Contributes authority data/abbreviation to the consortium.
MIGRATED from has_authority_file_abbreviation per Rule 53.
Uses AuthorityData class.
'
range: AuthorityData
inlined: true
examples:
- value:
has_or_had_label: LCNAF
has_or_had_type: abbreviation
description: Contributes the LCNAF abbreviation
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
custodian_types_rationale: Universal utility concept