2d09776856
- Removed compliance_status slot and replaced it with has_or_had_status. - Updated has_or_had_status to use ComplianceStatus for structured representation. - Adjusted examples to reflect new structure for compliance status. - Updated documentation to indicate migration and provide details on the ComplianceStatus class.
149 lines
4.4 KiB
YAML
149 lines
4.4 KiB
YAML
# Agent class
|
|
# Represents a person or organization that performs actions
|
|
#
|
|
# Created per slot_fixes.yaml migration for: collector
|
|
# Creation date: 2026-01-22
|
|
#
|
|
# Rule 53 (No Bespoke Slots): collector → is_or_was_acquired_by + Agent
|
|
|
|
id: https://nde.nl/ontology/hc/class/Agent
|
|
name: Agent
|
|
title: Agent
|
|
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
prov: http://www.w3.org/ns/prov#
|
|
foaf: http://xmlns.com/foaf/0.1/
|
|
schema: http://schema.org/
|
|
dcterms: http://purl.org/dc/terms/
|
|
|
|
default_prefix: hc
|
|
|
|
imports:
|
|
- linkml:types
|
|
- ../slots/has_or_had_name
|
|
- ../slots/has_or_had_type
|
|
- ../slots/has_or_had_identifier
|
|
|
|
classes:
|
|
Agent:
|
|
class_uri: prov:Agent
|
|
description: |
|
|
An agent (person, organization, or software) that performs actions.
|
|
|
|
**RULE 53 MIGRATION**:
|
|
Replaces simple string slots with a structured agent model:
|
|
- `is_or_was_acquired_by` → Agent (this class)
|
|
- Supports typed agents (person, organization, software)
|
|
|
|
**USAGE**:
|
|
```yaml
|
|
is_or_was_acquired_by:
|
|
- agent_name: "Dr. Jane Smith"
|
|
agent_type: person
|
|
has_or_had_identifier:
|
|
- identifier_scheme: ORCID
|
|
identifier_value: "0000-0001-2345-6789"
|
|
```
|
|
|
|
**Ontological Alignment**:
|
|
- **Primary** (`class_uri`): `prov:Agent` - PROV-O agent
|
|
- **Close**: `foaf:Agent` - FOAF agent
|
|
- **Close**: `schema:Person` / `schema:Organization` - Schema.org agents
|
|
- **Close**: `dcterms:Agent` - Dublin Core agent
|
|
|
|
**Use Cases**:
|
|
- Specimen collectors (field biologists)
|
|
- Artwork donors/sellers
|
|
- Archive depositors
|
|
- Record creators
|
|
|
|
exact_mappings:
|
|
- prov:Agent
|
|
|
|
close_mappings:
|
|
- foaf:Agent
|
|
- dcterms:Agent
|
|
|
|
related_mappings:
|
|
- schema:Person
|
|
- schema:Organization
|
|
|
|
slots:
|
|
- has_or_had_name
|
|
- has_or_had_type
|
|
- has_or_had_identifier
|
|
|
|
attributes:
|
|
agent_name:
|
|
range: string
|
|
description: Name of the agent (person or organization name)
|
|
required: true
|
|
|
|
agent_type:
|
|
range: string
|
|
description: |
|
|
Type of agent: person, organization, software, group
|
|
required: false
|
|
examples:
|
|
- value: person
|
|
- value: organization
|
|
- value: software
|
|
- value: group
|
|
|
|
agent_role:
|
|
range: string
|
|
description: |
|
|
Role of the agent in the action (collector, donor, creator, etc.)
|
|
required: false
|
|
|
|
slot_usage:
|
|
has_or_had_name:
|
|
description: |
|
|
Structured name for the agent.
|
|
range: uriorcurie
|
|
required: false
|
|
has_or_had_type:
|
|
description: |
|
|
Classification of the agent type.
|
|
range: uriorcurie
|
|
required: false
|
|
has_or_had_identifier:
|
|
description: |
|
|
Identifiers for the agent (ORCID, ISNI, etc.).
|
|
range: uriorcurie
|
|
multivalued: true
|
|
required: false
|
|
|
|
annotations:
|
|
specificity_score: "0.25"
|
|
specificity_rationale: "Broadly applicable - agents appear across all heritage contexts."
|
|
template_specificity: '{"archive_search": 0.30, "museum_search": 0.30, "library_search": 0.30, "collection_discovery": 0.40, "person_research": 0.60, "location_browse": 0.15, "identifier_lookup": 0.35, "organizational_change": 0.25, "digital_platform": 0.20, "general_heritage": 0.25}'
|
|
|
|
examples:
|
|
- value:
|
|
agent_name: "Dr. Jane Smith"
|
|
agent_type: person
|
|
agent_role: collector
|
|
description: Field biologist who collected specimens
|
|
|
|
- value:
|
|
agent_name: "Rijksmuseum Foundation"
|
|
agent_type: organization
|
|
agent_role: donor
|
|
description: Organization that donated artwork
|
|
|
|
- value:
|
|
agent_name: "National Archives of the Netherlands"
|
|
agent_type: organization
|
|
agent_role: transferring_agency
|
|
has_or_had_identifier:
|
|
- identifier_scheme: ISIL
|
|
identifier_value: "NL-HaNA"
|
|
description: Archive transferring records
|
|
|
|
comments:
|
|
- "Created per slot_fixes.yaml migration (2026-01-22)"
|
|
- "RULE 53: Replaces collector string slot with structured model"
|
|
- "Generic agent class for persons, organizations, and software"
|