glam/schemas/20251121/linkml/modules/classes/Access.yaml
kempersc 7b4e113a5a Refactor Access schema and related components
- Updated Access.yaml to replace properties with new slots: has_or_had_type, has_or_had_user_category, condition_of_access, and has_or_had_description.
- Introduced AccessTypeEnum for standardized access types.
- Migrated eligible_users to has_or_had_user_category slot.
- Adjusted examples in Access.yaml to reflect new slot structure.
- Modified AuxiliaryPlace, CustodianPlace, GeoSpatialPlace, ServiceArea schemas to use has_or_had_format for geometry representation.
- Added new slots and enums for better categorization and access control.
2026-01-28 15:11:20 +01:00

173 lines
5.8 KiB
YAML

# Access class
# Structured access information for heritage collections and services
#
# Created per slot_fixes.yaml revision for collection_access migration
# Generation date: 2026-01-19
# Rule compliance: 53 (slot_fixes.yaml), 39 (RiC-O naming)
id: https://nde.nl/ontology/hc/class/Access
name: Access
title: Access Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
crm: http://www.cidoc-crm.org/cidoc-crm/
default_prefix: hc
imports:
- linkml:types
- ../metadata
- ./TimeSpan
- ../slots/has_or_had_frequency
- ./Frequency
- ../slots/condition_of_access
- ../slots/has_or_had_type
- ../slots/has_or_had_description
- ../slots/has_or_had_user_category
- ../enums/AccessTypeEnum
classes:
Access:
class_uri: dcterms:RightsStatement
description: |
Structured access information for heritage collections, services, or facilities.
**Purpose**:
Replaces simple string descriptions of access conditions with structured
data capturing access types, eligible users, conditions, and restrictions.
**Key Properties**:
- `has_or_had_type`: Type of access (PUBLIC, BY_APPOINTMENT, RESTRICTED, etc.)
- `has_or_had_user_category`: Who can access (public, students, faculty, researchers)
- `condition_of_access`: Conditions or requirements for access
- `has_or_had_description`: Free-text description
- `temporal_extent`: When this access policy applies
**Access Types**:
- PUBLIC: Open to general public
- BY_APPOINTMENT: Requires advance appointment
- ACADEMIC: Restricted to academic community
- RESEARCHER: Restricted to credentialed researchers
- MEMBER: Requires membership
- RESTRICTED: Limited access with specific conditions
- CLOSED: Not currently accessible
- DIGITAL_ONLY: Available only in digital form
**Ontological Alignment**:
- **Primary**: `dcterms:RightsStatement` - Dublin Core rights statement
- **Close**: `schema:publicAccess` - Schema.org access indicator
- **Related**: `crm:E30_Right` - CIDOC-CRM rights
exact_mappings:
- dcterms:RightsStatement
close_mappings:
- schema:publicAccess
related_mappings:
- crm:E30_Right
slots:
- has_or_had_type
- has_or_had_user_category
- condition_of_access
- has_or_had_description
- temporal_extent
- is_digital_access
- has_or_had_frequency
slot_usage:
has_or_had_type:
range: AccessTypeEnum
required: true
description: Type of access offered
has_or_had_user_category:
required: false
description: |
Categories of users eligible for this access.
Examples: "enrolled students", "faculty", "visiting scholars",
"credentialed researchers", "general public"
examples:
- value: "enrolled students"
- value: "faculty and staff"
- value: "visiting researchers with credentials"
temporal_extent:
required: false
range: TimeSpan
inlined: true
description: |
Time period during which this access policy applies.
Useful for temporary restrictions or seasonal access.
is_digital_access:
required: false
range: boolean
description: Whether this is digital access
has_or_had_frequency:
required: false
range: Frequency
description: Frequency of access (e.g., daily, weekly, by appointment)
inlined: true
examples:
- value:
has_or_had_label: "Daily"
description: Access available daily
annotations:
specificity_score: 0.50
specificity_rationale: "Moderately specific - applies to collection and service access contexts"
custodian_types: '["*"]'
custodian_types_rationale: "All institution types offer some form of access"
comments:
- "Created per slot_fixes.yaml revision for collection_access migration"
- "Replaces string-based collection_access with structured access data"
- "RULE 53: Part of collection_access → offers_or_offered_access + Access migration"
examples:
- value:
has_or_had_type: PUBLIC
has_or_had_description: "Open to general public during gallery hours"
has_or_had_user_category:
- "general public"
condition_of_access:
- "during posted gallery hours"
description: "Public access during gallery hours"
- value:
has_or_had_type: BY_APPOINTMENT
has_or_had_user_category:
- "credentialed researchers"
- "graduate students with faculty sponsor"
condition_of_access:
- "48-hour advance booking required"
- "handling training required for original materials"
- "fragile materials limited to supervised viewing only"
description: "Research access by appointment with conditions"
- value:
has_or_had_type: ACADEMIC
has_or_had_description: "Open to enrolled students and faculty; public by appointment"
has_or_had_user_category:
- "enrolled students"
- "faculty"
- "research staff"
condition_of_access:
- "valid university ID"
is_digital_access: false
description: "Academic community access with public by appointment"
- value:
has_or_had_type: DIGITAL_ONLY
has_or_had_description: "Collection accessible only through online database"
has_or_had_user_category:
- "anyone with internet access"
is_digital_access: true
description: "Digital-only access"