glam/schemas/20251121/linkml/modules/classes/AccessPolicy.yaml
kempersc fcd1c21c63 Add aliases and enhance slot definitions across various modules
- Added new aliases for existing slots to improve clarity and usability, including:
  - has_deadline: has_embargo_end_date
  - has_extent: has_extent_text
  - has_fonds: has_fond
  - has_laboratory: conservation_lab
  - has_language: has_iso_code639_1, has_iso_code639_3
  - has_legal_basis: legal_basis
  - has_light_exposure: max_light_lux
  - has_measurement_unit: has_unit
  - has_note: has_custodian_observation
  - has_occupation: occupation
  - has_operating_hours: has_operating_hours
  - has_position: position
  - has_quantity: has_artwork_count, link_count
  - has_roadmap: review_date
  - has_skill: skill
  - has_speaker: speaker_label
  - has_specification: specification_url
  - has_statement: rights_statement_url, rights_statement
  - has_type: custodian_only
  - has_user_category: serves_visitors_only
  - hold_record_set: record_count
  - identified_by: has_index_number
  - in_period: has_period
  - in_place: has_place
  - in_series: has_series
  - measure: has_measurement
  - measured_on: measurement_date
  - organized_by: has_organizer
  - originate_from: has_origin
  - part_of: suborganization_of
  - published_on: has_publication_date
  - receive_investment: has_investment
  - related_to: connection_heritage_type
  - require: preservation_requirement
  - safeguarded_by: current_keeper, record_holder_note
  - state: states_or_stated
  - take_comission: takes_or_took_comission
  - take_place_at: takes_or_took_place_at
  - transmit_through: transmits_or_transmitted_through
  - warrant: warrants_or_warranted

- Introduced a new slot definition for evaluated_through to capture evaluation methodologies and review statuses.
2026-02-14 14:41:49 +01:00

273 lines
13 KiB
YAML

id: https://nde.nl/ontology/hc/class/AccessPolicy
name: access_policy_class
title: AccessPolicy Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
premis: http://www.loc.gov/premis/rdf/v3/
dcterms: http://purl.org/dc/terms/
rico: https://www.ica.org/standards/RiC/ontology#
schema: http://schema.org/
skos: http://www.w3.org/2004/02/skos/core#
wd: http://www.wikidata.org/entity/
default_prefix: hc
imports:
- linkml:types
- ../slots/require
- ../slots/has_protocol
- ../slots/has_description
- ../slots/embargo
- ../slots/restricted_by
- ../slots/has_level
- ../slots/has_score
- ../slots/impose
- ../slots/has_legal_basis
- ../slots/identified_by
- ../slots/has_label
- ../slots/pose_condition
- ../slots/has_roadmap
- ../slots/has_statement
- ../slots/has_url
- ../slots/temporal_extent
classes:
AccessPolicy:
class_uri: premis:RightsStatus
description: "Access policy defining conditions under which heritage collections can be accessed.\n\n**PURPOSE**:\n\nAccessPolicy captures the access conditions governing a Collection:\n- WHO can access (public, researchers, staff only)\n- HOW access is granted (open, by appointment, with credentials)\n- WHEN access is available (opening hours, embargo periods)\n- WHAT restrictions apply (fragile materials, privacy, cultural sensitivity)\n\n1. **PREMIS**:\n - `premis:RightsStatus` - \"Information about the rights status of an object.\"\n - Links to Collection via premis:rightsStatus\n\n2. **Dublin Core**:\n - `dcterms:accessRights` - \"Information about who may access the resource\n or an indication of its security status.\"\n\n3. **RiC-O**:\n - `rico:hasOrHadAllMembersWithAccessConditions` - Links RecordSet to access\n conditions applying to all members\n\n4. **RightsStatements.org**:\n - Standardized rights statements for cultural heritage\n - E.g., \"In Copyright\"\
, \"No Copyright\", \"Unknown Copyright\"\n\n**ACCESS LEVEL TAXONOMY**:\n\n```\nAccessPolicy (root)\n \u2502\n \u251C\u2500\u2500 OpenAccess\n \u2502 \u251C\u2500\u2500 PUBLIC_OPEN - No restrictions, walk-in access\n \u2502 \u251C\u2500\u2500 PUBLIC_REGISTRATION - Free registration required\n \u2502 \u2514\u2500\u2500 PUBLIC_ONLINE - Digital access freely available\n \u2502\n \u251C\u2500\u2500 RestrictedAccess\n \u2502 \u251C\u2500\u2500 RESEARCHERS_ONLY - Academic researchers with credentials\n \u2502 \u251C\u2500\u2500 BY_APPOINTMENT - Advance booking required\n \u2502 \u251C\u2500\u2500 STAFF_ONLY - Internal access only\n \u2502 \u2514\u2500\u2500 PERMISSION_REQUIRED - Written permission needed\n \u2502\n \u251C\u2500\u2500 ClosedAccess\n \u2502 \u251C\u2500\u2500 TEMPORARILY_CLOSED - Renovation, conservation\n \u2502 \u251C\u2500\u2500 EMBARGOED - Time-limited closure\n \u2502 \u251C\u2500\u2500 PERMANENTLY_CLOSED - Not accessible\n\
\ \u2502 \u2514\u2500\u2500 REPATRIATED - Returned to community of origin\n \u2502\n \u2514\u2500\u2500 ConditionalAccess\n \u251C\u2500\u2500 CULTURALLY_SENSITIVE - Indigenous/sacred materials\n \u251C\u2500\u2500 PRIVACY_RESTRICTED - Personal data protection\n \u251C\u2500\u2500 FRAGILE_HANDLING - Special handling required\n \u2514\u2500\u2500 LEGAL_RESTRICTION - Copyright, legal constraints\n```\n\n**USE CASES**:\n\n1. **Archive Open Access**:\n ```yaml\n AccessPolicy:\n policy_id: \"hc:access-policy/nationaal-archief-open\"\n access_level: \"PUBLIC_OPEN\"\n access_description: \"Open to all visitors during reading room hours\"\n conditions: \"Valid ID required for registration\"\n ```\n\n2. **Restricted Research Materials**:\n ```yaml\n AccessPolicy:\n policy_id: \"hc:access-policy/university-special-collections\"\n access_level: \"RESEARCHERS_ONLY\"\n access_description: \"Academic researchers with institutional\
\ affiliation\"\n conditions: \"Letter of introduction required from supervising institution\"\n requires_appointment: true\n ```\n\n3. **Embargoed Collection**:\n ```yaml\n AccessPolicy:\n policy_id: \"hc:access-policy/donor-embargo-2050\"\n access_level: \"EMBARGOED\"\n access_description: \"Closed until 2050 per donor agreement\"\n embargo_end_date: \"2050-01-01\"\n embargo_reason: \"Donor privacy restrictions\"\n ```\n\n4. **Culturally Sensitive**:\n ```yaml\n AccessPolicy:\n policy_id: \"hc:access-policy/indigenous-protocols\"\n access_level: \"CULTURALLY_SENSITIVE\"\n access_description: \"Access governed by Traditional Knowledge protocols\"\n conditions: \"Consultation with originating community required\"\n cultural_protocol_url: \"https://localcontexts.org/tk-labels/\"\n ```\n\n**RELATIONSHIP TO DIM ARCHIVE**:\n\nDimArchive (Dark archive / Preservation-only storage) uses AccessPolicy to express:\n- Materials stored\
\ for preservation, not current access\n- Access restricted until triggering conditions (time, event)\n- \"Gray literature\" or un-catalogued backlogs awaiting processing\n"
exact_mappings:
- premis:RightsStatus
close_mappings:
- dcterms:accessRights
- rico:Rule
- schema:ActionAccessSpecification
related_mappings:
- rico:hasOrHadAllMembersWithAccessConditions
slots:
- has_description
- has_level
- require
- pose_condition
- require
- require
- has_protocol
- has_deadline
- restricted_by
- impose
- legal_basis
- identified_by
- has_label
- require
- review_date
- rights_statement
- rights_statement_url
- has_score
- temporal_extent
slot_usage:
identified_by:
# range: string # uriorcurie
required: true
identifier: true
examples:
- value: https://nde.nl/ontology/hc/access-policy/open-access
has_label:
# range: string
required: true
examples:
- value: Open Access
- value: Researchers Only
- value: Embargoed until 2050
has_level:
range: AccessLevel
required: true
inlined: true
examples:
- value:
has_label: PUBLIC_OPEN
- value:
has_label: RESEARCHERS_ONLY
- value:
has_label: EMBARGOED
has_description:
# range: string
inlined: false # Fixed invalid inline for primitive type
examples:
- value:
description_text: Open to all visitors during reading room hours (Mon-Fri 9-17)
- value:
description_text: Access restricted to academic researchers with institutional has_affiliation
pose_condition:
range: Condition
multivalued: true
inlined: true
inlined_as_list: true
examples:
- value:
- has_type: AccessCondition
has_description:
description_text: Valid government-issued ID required
- has_type: AccessCondition
has_description:
description_text: Registration form must be completed
rights_statement:
# range: string
examples:
- value: In Copyright
- value: No Copyright - United States
rights_statement_url:
range: uri
examples:
- value: http://rightsstatements.org/vocab/InC/1.0/
- value: http://rightsstatements.org/vocab/NoC-US/1.0/
require:
range: boolean
examples:
- value: true
- value: false
require:
range: boolean
examples:
- value: true
require:
# range: string
examples:
- value: INSTITUTIONAL
- value: true
impose:
# range: string # Fee
inlined: false # Fixed invalid inline for primitive type
multivalued: true
examples:
- value:
has_quantity:
has_measurement_unit:
has_description: Daily reading room fee
- value:
has_quantity:
has_description: Free for researchers
- value:
has_quantity:
has_measurement_unit:
has_description: General public fee
has_deadline:
range: date
examples:
- value: '2050-01-01'
restricted_by:
# range: string
examples:
- value: Donor privacy restrictions per deed of gift
- value: Contains personal data protected under GDPR
has_protocol:
range: uri
examples:
- value: https://localcontexts.org/tk-labels/
legal_basis:
# range: string
examples:
- value: General Data Protection Regulation (GDPR)
- value: Freedom of Information Act exemption 6
review_date:
range: date
examples:
- value: '2025-12-31'
temporal_extent:
range: TimeSpan
inlined: true
required: true
examples:
- value:
begin_of_the_begin: '2024-01-01'
end_of_the_end: '2050-12-31'
require:
range: Appointment
multivalued: true
inlined: true
examples:
- value:
- appointment_id: hc:appointment/special-collections-48h
has_label: Special Collections Appointment
has_description: Book at least 48 hours in advance for manuscript access
comments:
- AccessPolicy defines access conditions for Collection instances
- Used by Collection.access_policy_ref to link policies to holdings
- Supports RightsStatements.org and Local Contexts protocols
- Temporal validity enables policy versioning and embargo expiration
- DimArchive (dark archive) uses AccessPolicy to express preservation-only access
see_also:
- http://www.loc.gov/premis/rdf/v3/RightsStatus
- https://rightsstatements.org/
- https://localcontexts.org/
- https://www.ica.org/standards/RiC/ontology#Rule
examples:
- value:
policy_id: https://nde.nl/ontology/hc/access-policy/nationaal-archief-open
policy_name: Nationaal Archief Public Access
has_level:
has_label: PUBLIC_OPEN
has_description:
description_text: Open to all visitors during reading room hours
pose_condition:
- has_type: AccessCondition
has_description:
description_text: Valid government-issued ID required
- has_type: AccessCondition
has_description:
description_text: Registration form must be completed
- has_type: HandlingCondition
has_description:
description_text: Original materials handled with gloves
registration_required: true
requires_appointment: false
has_contact_point:
- value:
policy_id: https://nde.nl/ontology/hc/access-policy/donor-embargo-2050
policy_name: Embargoed until 2050
has_level:
has_label: EMBARGOED
has_description:
description_text: Collection closed until 2050 per donor agreement
has_embargo_end_date: '2050-01-01'
restricted_by: Donor privacy restrictions per deed of gift
legal_basis: Deed of Gift clause 4.2
review_date: '2049-06-01'
- value:
policy_id: https://nde.nl/ontology/hc/access-policy/dim-archive-preservation
policy_name: DIM Archive - Preservation Only
has_level:
has_label: TEMPORARILY_CLOSED
has_description:
description_text: Materials in preservation storage, not currently accessible
pose_condition:
- has_type: ProcessingCondition
has_description:
description_text: Awaiting processing and cataloging
- has_type: AccessCondition
has_description:
description_text: Access may be arranged for urgent research needs
requires_appointment: true
credentials_required: PROFESSIONAL
has_contact_point:
- value:
policy_id: https://nde.nl/ontology/hc/access-policy/special-collections-rich
policy_name: Special Collections - Rich Appointment Policy
has_level:
has_label: RESEARCHERS_ONLY
has_description:
description_text: Academic researchers with institutional affiliation
require:
- appointment_id: hc:appointment/special-collections-booking
has_label: Special Collections Appointment
has_description: 'Appointments for manuscript and rare book collections must be made
at least 48 hours in advance. Please specify which materials you
wish to consult.
'
registration_required: true
credentials_required: INSTITUTIONAL
has_contact_point:
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"