glam/schemas/20251121/linkml/modules/classes/AccessPolicy.yaml
kempersc d37a120ef2 Refactor schema definitions across multiple classes to improve clarity and consistency
- Removed unnecessary aliases and adjusted slot definitions in Timestamp, Topic, TopicType, TransferEvent, TransferPolicy, and others.
- Enhanced descriptions and added alternative language descriptions for TradeUnionArchiveRecordSetType and UnescoIchElement.
- Updated slot usage for various archive-related classes to use `equals_string` instead of `equals_expression`.
- Streamlined VideoChapter class by refining descriptions and restructuring slot usage for better navigation and organization.
- General cleanup of comments and annotations to ensure clarity and maintainability.
2026-02-16 11:17:33 +01:00

284 lines
11 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
alt_descriptions:
nl: Beleid dat voorwaarden vastlegt waaronder collecties of onderdelen daarvan toegankelijk zijn.
de: Richtlinie die Bedingungen fuer den Zugang zu Sammlungen oder deren Teilen festlegt.
fr: Politique definissant les conditions d acces aux collections ou a leurs elements.
es: Politica que define las condiciones de acceso a colecciones o a sus partes.
ar: سياسة تحدد شروط الوصول إلى المجموعات أو عناصرها.
id: Kebijakan yang menetapkan ketentuan akses ke koleksi atau bagiannya.
zh: 规定对馆藏或其组成部分的访问条件的政策。
structured_aliases:
- {literal_form: toegangsbeleid, in_language: nl}
- {literal_form: Zugangsrichtlinie, in_language: de}
- {literal_form: politique d acces, in_language: fr}
- {literal_form: politica de acceso, in_language: es}
- {literal_form: سياسة وصول, in_language: ar}
- {literal_form: kebijakan akses, in_language: id}
- {literal_form: 访问政策, in_language: zh}
description: >-
Conditions under which a collection (or its members) may be accessed,
including restrictions, requirements, and temporal validity.
exact_mappings:
- premis:RightsStatus
close_mappings:
- dcterms:accessRights
- rico:Rule
- schema:ActionAccessSpecification
related_mappings:
- rico:hasOrHadAllMembersWithAccessConditions
slots:
- has_description
- has_level
- require
- pose_condition
- has_protocol
- has_deadline
- restricted_by
- impose
- legal_basis
- identified_by
- has_label
- 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: string
multivalued: true
examples:
- value: registration_required
- value: appointment_required
- value: institutional_affiliation_required
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'
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
- Extended notes and legacy examples are stored in annotations
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:
identified_by: https://nde.nl/ontology/hc/access-policy/nationaal-archief-open
has_label: 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
temporal_extent:
begin_of_the_begin: '2024-01-01'
- value:
identified_by: https://nde.nl/ontology/hc/access-policy/donor-embargo-2050
has_label: Embargoed until 2050
has_level:
has_label: EMBARGOED
has_description:
description_text: Collection closed until 2050 per donor agreement
has_deadline: '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'
temporal_extent:
begin_of_the_begin: '2024-01-01'
end_of_the_end: '2050-12-31'
notes:
- |
Preserved from prior description (commit 37852a46):
"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\"\
annotations:
specificity_score: 0.1
specificity_rationale: Generic utility class/slot created during migration
custodian_types: "['*']"
modeling_notes: |
Purpose
AccessPolicy captures access conditions governing a collection or a set of records:
- who can access (public, researchers, staff)
- how access is granted (open, appointment, credentials)
- when access applies (opening hours, embargo periods)
- what restrictions apply (fragile handling, privacy, cultural sensitivity)
Alignment notes
- PREMIS: premis:RightsStatus ("Information about the rights status of an object")
- DCTerms: dcterms:accessRights (who may access / security status)
- RiC-O: rico:hasOrHadAllMembersWithAccessConditions (conditions applying to all members)
- RightsStatements.org: standardized rights statements (e.g., "In Copyright")
Access level taxonomy (illustrative)
- Open access: PUBLIC_OPEN, PUBLIC_REGISTRATION, PUBLIC_ONLINE
- Restricted access: RESEARCHERS_ONLY, BY_APPOINTMENT, STAFF_ONLY, PERMISSION_REQUIRED
- Closed access: TEMPORARILY_CLOSED, EMBARGOED, PERMANENTLY_CLOSED, REPATRIATED
- Conditional access: CULTURALLY_SENSITIVE, PRIVACY_RESTRICTED, FRAGILE_HANDLING, LEGAL_RESTRICTION
DimArchive (dark archive)
A preservation-only storage context can use AccessPolicy to express:
- materials are stored for preservation, not current access
- access is restricted until triggering conditions (time or event)
- backlogs awaiting processing
legacy_examples: |
Preserved from earlier migration examples; may include fields not currently modeled
as slots on this class.
- 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}
registration_required: true
- 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}
credentials_required: PROFESSIONAL