426 lines
18 KiB
YAML
426 lines
18 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/temporal_extent
|
|
- ./TimeSpan
|
|
- ../slots/embargo_end_date
|
|
- ../slots/policy_id
|
|
- ../slots/policy_name
|
|
- ../slots/has_or_had_description
|
|
- ./Description
|
|
- ../slots/has_or_had_level
|
|
- ./AccessLevel
|
|
- ../slots/requires_appointment
|
|
- ../slots/poses_or_posed_condition
|
|
- ./Condition
|
|
- ../slots/credentials_required
|
|
- ../slots/cultural_protocol_url
|
|
- ../slots/embargo_reason
|
|
- ../slots/imposes_or_imposed
|
|
- ./Fee
|
|
- ../slots/fee_required
|
|
- ../slots/legal_basis
|
|
- ../slots/registration_required
|
|
- ../slots/review_date
|
|
- ../slots/rights_statement
|
|
- ../slots/rights_statement_url
|
|
- ../slots/specificity_annotation
|
|
- ../slots/has_or_had_score
|
|
- ./SpecificityAnnotation
|
|
- ./TemplateSpecificityScore
|
|
- ./TemplateSpecificityType
|
|
- ./TemplateSpecificityTypes
|
|
- ../slots/condition_of_access
|
|
- ../slots/requires_or_required
|
|
- ./Appointment
|
|
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
|
|
- dcterms:accessRights
|
|
close_mappings:
|
|
- rico:Rule
|
|
- schema:ActionAccessSpecification
|
|
related_mappings:
|
|
- rico:hasOrHadAllMembersWithAccessConditions
|
|
slots:
|
|
- has_or_had_description
|
|
- has_or_had_level
|
|
- requires_appointment
|
|
- poses_or_posed_condition
|
|
- condition_of_access
|
|
- requires_or_required
|
|
- credentials_required
|
|
- cultural_protocol_url
|
|
- embargo_end_date
|
|
- embargo_reason
|
|
- imposes_or_imposed
|
|
- fee_required
|
|
- legal_basis
|
|
- policy_id
|
|
- policy_name
|
|
- registration_required
|
|
- review_date
|
|
- rights_statement
|
|
- rights_statement_url
|
|
- specificity_annotation
|
|
- has_or_had_score
|
|
- temporal_extent
|
|
slot_usage:
|
|
policy_id:
|
|
range: uriorcurie
|
|
required: true
|
|
identifier: true
|
|
examples:
|
|
- value: https://nde.nl/ontology/hc/access-policy/open-access
|
|
description: Standard open access policy
|
|
policy_name:
|
|
range: string
|
|
required: true
|
|
examples:
|
|
- value: Open Access
|
|
description: Public open access
|
|
- value: Researchers Only
|
|
description: Restricted to researchers
|
|
- value: Embargoed until 2050
|
|
description: Time-limited closure
|
|
has_or_had_level:
|
|
description: 'Access level of the policy.
|
|
|
|
MIGRATED from has_or_had_access_level per Rule 53.
|
|
|
|
Uses AccessLevel class.
|
|
|
|
'
|
|
range: AccessLevel
|
|
required: true
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
has_or_had_label: PUBLIC_OPEN
|
|
- value:
|
|
has_or_had_label: RESEARCHERS_ONLY
|
|
- value:
|
|
has_or_had_label: EMBARGOED
|
|
has_or_had_description:
|
|
description: 'Description of the access policy.
|
|
|
|
MIGRATED from has_or_had_access_description per Rule 53.
|
|
|
|
Uses Description class.
|
|
|
|
'
|
|
range: Description
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
description_text: Open to all visitors during reading room hours (Mon-Fri 9-17)
|
|
description: Archive public access
|
|
- value:
|
|
description_text: Access restricted to academic researchers with institutional has_or_had_affiliation
|
|
description: University special collections
|
|
poses_or_posed_condition:
|
|
range: Condition
|
|
multivalued: true
|
|
inlined: true
|
|
inlined_as_list: true
|
|
description: 'Access conditions or requirements using structured Condition class.
|
|
|
|
MIGRATED from condition string slot per slot_fixes.yaml (Rule 53, 2026-01-22).
|
|
|
|
'
|
|
examples:
|
|
- value:
|
|
- has_or_had_type: AccessCondition
|
|
has_or_had_description:
|
|
description_text: Valid government-issued ID required
|
|
- has_or_had_type: AccessCondition
|
|
has_or_had_description:
|
|
description_text: Registration form must be completed
|
|
description: Archive access conditions using Condition class
|
|
rights_statement:
|
|
range: string
|
|
examples:
|
|
- value: In Copyright
|
|
description: Copyright protected
|
|
- value: No Copyright - United States
|
|
description: Public domain (US)
|
|
rights_statement_url:
|
|
range: uri
|
|
examples:
|
|
- value: http://rightsstatements.org/vocab/InC/1.0/
|
|
description: In Copyright
|
|
- value: http://rightsstatements.org/vocab/NoC-US/1.0/
|
|
description: No Copyright - United States
|
|
requires_appointment:
|
|
range: boolean
|
|
description: 'Whether an appointment is required for access.
|
|
|
|
Uses schema:reservationRequired which is semantically correct for access policies.
|
|
|
|
'
|
|
examples:
|
|
- value: true
|
|
description: Appointment required
|
|
- value: false
|
|
description: Walk-in access
|
|
registration_required:
|
|
range: boolean
|
|
examples:
|
|
- value: true
|
|
description: Must register as reader
|
|
credentials_required:
|
|
range: string
|
|
examples:
|
|
- value: INSTITUTIONAL
|
|
description: Must be affiliated with research institution
|
|
fee_required:
|
|
range: boolean
|
|
examples:
|
|
- value: false
|
|
description: Free access
|
|
- value: true
|
|
description: Fee required
|
|
imposes_or_imposed:
|
|
description: 'Fees imposed by the access policy.
|
|
|
|
MIGRATED from fee_amount per Rule 53.
|
|
|
|
Uses Fee class with structured Quantity.
|
|
|
|
'
|
|
range: Fee
|
|
inlined: true
|
|
multivalued: true
|
|
examples:
|
|
- value:
|
|
has_or_had_quantity:
|
|
quantity_value: 5.0
|
|
has_or_had_unit:
|
|
unit_value: EUR
|
|
has_or_had_description: Daily reading room fee
|
|
description: "\u20AC5.00 per day"
|
|
- value:
|
|
has_or_had_quantity:
|
|
quantity_value: 0
|
|
has_or_had_description: Free for researchers
|
|
description: Free for researchers
|
|
- value:
|
|
has_or_had_quantity:
|
|
quantity_value: 10.0
|
|
has_or_had_unit:
|
|
unit_value: EUR
|
|
has_or_had_description: General public fee
|
|
description: "\u20AC10 for general public"
|
|
embargo_end_date:
|
|
range: date
|
|
examples:
|
|
- value: '2050-01-01'
|
|
description: Embargo lifts January 1, 2050
|
|
embargo_reason:
|
|
range: string
|
|
examples:
|
|
- value: Donor privacy restrictions per deed of gift
|
|
description: Donor-imposed embargo
|
|
- value: Contains personal data protected under GDPR
|
|
description: Privacy law embargo
|
|
cultural_protocol_url:
|
|
range: uri
|
|
examples:
|
|
- value: https://localcontexts.org/tk-labels/
|
|
description: Traditional Knowledge labels
|
|
legal_basis:
|
|
range: string
|
|
examples:
|
|
- value: General Data Protection Regulation (GDPR)
|
|
description: EU privacy law
|
|
- value: Freedom of Information Act exemption 6
|
|
description: US FOIA exemption
|
|
review_date:
|
|
range: date
|
|
examples:
|
|
- value: '2025-12-31'
|
|
description: Annual review date
|
|
temporal_extent:
|
|
description: 'Validity period for this access policy using CIDOC-CRM TimeSpan.
|
|
|
|
MIGRATED from valid_from + valid_to per slot_fixes.yaml (Rule 53).
|
|
|
|
Uses begin_of_the_begin for policy start date and end_of_the_end for expiry.
|
|
|
|
'
|
|
range: TimeSpan
|
|
inlined: true
|
|
required: false
|
|
examples:
|
|
- value:
|
|
begin_of_the_begin: '2024-01-01'
|
|
end_of_the_end: '2050-12-31'
|
|
description: Policy valid from 2024 until end of 2050
|
|
condition_of_access:
|
|
description: 'Textual conditions or requirements for access (RiC-O style).
|
|
|
|
Use for human-readable access requirements. For structured appointment
|
|
|
|
data, use requires_or_required with Appointment instances.
|
|
|
|
'
|
|
range: string
|
|
multivalued: true
|
|
examples:
|
|
- value:
|
|
- Appointment required 48 hours in advance
|
|
- Valid researcher credentials required
|
|
- Materials must be handled with cotton gloves
|
|
description: Multiple access conditions
|
|
requires_or_required:
|
|
description: 'Links to structured Appointment entities for rich appointment modeling.
|
|
|
|
ADDED 2026-01-17 per slot_fixes.yaml revision for appointment_required.
|
|
|
|
|
|
Use this for detailed appointment requirements (lead time, booking method,
|
|
|
|
contact info). For simple boolean, use requires_appointment instead.
|
|
|
|
'
|
|
range: Appointment
|
|
multivalued: true
|
|
inlined: true
|
|
examples:
|
|
- value:
|
|
- appointment_id: hc:appointment/special-collections-48h
|
|
has_or_had_label: Special Collections Appointment
|
|
has_or_had_description: Book at least 48 hours in advance for manuscript access
|
|
lead_time_hours: 48
|
|
booking_method:
|
|
- email
|
|
- online_form
|
|
booking_contact: bijzondere.collecties@archive.nl
|
|
appointment_required: true
|
|
description: Structured appointment requirement with rich metadata
|
|
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_or_had_level:
|
|
has_or_had_label: PUBLIC_OPEN
|
|
has_or_had_description:
|
|
description_text: Open to all visitors during reading room hours
|
|
poses_or_posed_condition:
|
|
- has_or_had_type: AccessCondition
|
|
has_or_had_description:
|
|
description_text: Valid government-issued ID required
|
|
- has_or_had_type: AccessCondition
|
|
has_or_had_description:
|
|
description_text: Registration form must be completed
|
|
- has_or_had_type: HandlingCondition
|
|
has_or_had_description:
|
|
description_text: Original materials handled with gloves
|
|
registration_required: true
|
|
requires_appointment: false
|
|
fee_required: false
|
|
has_or_had_contact_point:
|
|
email: studiezaal@nationaalarchief.nl
|
|
description: Standard archive public access policy
|
|
- value:
|
|
policy_id: https://nde.nl/ontology/hc/access-policy/donor-embargo-2050
|
|
policy_name: Embargoed until 2050
|
|
has_or_had_level:
|
|
has_or_had_label: EMBARGOED
|
|
has_or_had_description:
|
|
description_text: Collection closed until 2050 per donor agreement
|
|
embargo_end_date: '2050-01-01'
|
|
embargo_reason: Donor privacy restrictions per deed of gift
|
|
legal_basis: Deed of Gift clause 4.2
|
|
review_date: '2049-06-01'
|
|
description: Time-limited embargo policy
|
|
- value:
|
|
policy_id: https://nde.nl/ontology/hc/access-policy/dim-archive-preservation
|
|
policy_name: DIM Archive - Preservation Only
|
|
has_or_had_level:
|
|
has_or_had_label: TEMPORARILY_CLOSED
|
|
has_or_had_description:
|
|
description_text: Materials in preservation storage, not currently accessible
|
|
poses_or_posed_condition:
|
|
- has_or_had_type: ProcessingCondition
|
|
has_or_had_description:
|
|
description_text: Awaiting processing and cataloging
|
|
- has_or_had_type: AccessCondition
|
|
has_or_had_description:
|
|
description_text: Access may be arranged for urgent research needs
|
|
requires_appointment: true
|
|
credentials_required: PROFESSIONAL
|
|
has_or_had_contact_point:
|
|
email: preservation@archive.org
|
|
description: Dark archive / DIM access policy
|
|
- value:
|
|
policy_id: https://nde.nl/ontology/hc/access-policy/special-collections-rich
|
|
policy_name: Special Collections - Rich Appointment Policy
|
|
has_or_had_level:
|
|
has_or_had_label: RESEARCHERS_ONLY
|
|
has_or_had_description:
|
|
description_text: Academic researchers with institutional affiliation
|
|
condition_of_access:
|
|
- Valid institutional ID required
|
|
- Letter of introduction from supervisor
|
|
- Maximum 5 items per visit
|
|
requires_or_required:
|
|
- appointment_id: hc:appointment/special-collections-booking
|
|
has_or_had_label: Special Collections Appointment
|
|
has_or_had_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.
|
|
|
|
'
|
|
lead_time_hours: 48
|
|
booking_method:
|
|
- email
|
|
- online_form
|
|
booking_contact: bijzondere.collecties@archive.nl
|
|
confirmation_required: true
|
|
cancellation_notice_hours: 24
|
|
appointment_required: true
|
|
registration_required: true
|
|
credentials_required: INSTITUTIONAL
|
|
fee_required: false
|
|
has_or_had_contact_point:
|
|
email: special.collections@archive.nl
|
|
description: Rich appointment modeling with structured Appointment entity
|
|
annotations:
|
|
specificity_score: 0.1
|
|
specificity_rationale: Generic utility class/slot created during migration
|
|
custodian_types:
|
|
- '*'
|
|
custodian_types_rationale: Universal utility concept
|