ConceptScheme

CDIFCodelist::Classes::ConceptScheme

Definition

Documentation

Original

Reference

skos:ConceptScheme

Definition

A set of concepts, optionally including statements about semantic relationships between those concepts.

CDIF

Definition

A controlled-vocabulary codelist implemented as a skos:ConceptScheme constrained for CDIF use. The scheme must have a resolvable @id and identify its top concepts via skos:hasTopConcept; each concept (CdifCodelistConcept) must have a resolvable @id, skos:inScheme, skos:prefLabel, and skos:notation. Hierarchical concepts must declare both skos:narrower (for JSON tree traversal) and skos:broader (for upward navigation) where hierarchy exists. CDIF metadata properties (schema:identifier, schema:dateModified, schema:license or schema:conditionsOfAccess) take precedence over the equivalent dcterms properties from the base skos:ConceptScheme.

Scope

A SKOS Concept Scheme - an aggregation of one or more SKOS Concepts forming a controlled vocabulary or codelist. The metadata record describing this scheme (schema:subjectOf > CatalogRecord) MUST declare conformance to https://w3id.org/cdif/codelist/1.1.

Diagram

Inheritance

No generalization relationships.

Attributes

Name	Type	Multiplicity	Description
identifier	XsdAnyUri	[1]	Documentation CDIF Definition Primary identifier for the codelist. May be a string URI or a structured PropertyValue. Scope @id - resolvable URI for the concept scheme. Required.
prefLabel	string	[1]	Documentation Original Reference skos:prefLabel Definition A resource has no more than one value of skos:prefLabel per language tag, and no more than one value of skos:prefLabel without language tag. CDIF Definition Preferred lexical label for the concept scheme. Required. A single string, a single language-tagged value, or an array of language-tagged values. Uniqueness rule. Each language should appear at most once in the set of prefLabel values. Two prefLabel values with duplicate `@language` tags are non-conformant. Consumers may reject or arbitrarily pick one. Multilinguality. For codelists intended for multilingual use, supply an array of language-tagged values — one per supported locale. When a bare string is supplied (no `@language` tag), consumers treat it as untagged and MAY infer the language from the enclosing document's `@context` or from `schema:inLanguage` on the codelist itself. Relationship to skos:altLabel. Alternate labels (acronyms, spelling variants, obsolete names) go on `skos:altLabel`, NOT on `prefLabel`. A concept scheme has exactly one preferred label per language. Scope skos:prefLabel - the preferred lexical label for the concept scheme. Required.
definition	string	[0..1]	Documentation Original Reference skos:definition Definition A statement or formal explanation of the meaning of a concept. CDIF Definition Formal explanation of the meaning or purpose of this concept scheme. Scope skos:definition - formal explanation of the meaning or purpose of this concept scheme.
note	string	[0..1]	Documentation Original Reference skos:note Definition A general note, for any purpose. CDIF Definition General note about the concept scheme. Scope skos:note - general note about the concept scheme.
dateModified	XsdDate	[1]	Documentation Original Reference schema:dateModified Definition The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed. Scope Domain: CreativeWork (https://schema.org/CreativeWork), DataFeedItem (https://schema.org/DataFeedItem). Range: Date (https://schema.org/Date), DateTime (https://schema.org/DateTime). CDIF Definition ISO 8601 date when the codelist was last modified. Scope schema:dateModified - ISO 8601 date when the codelist was last modified. Required.
url	XsdAnyUri	[0..1]	Documentation Original Reference schema:url Definition URL of the item. Scope Domain: Thing (https://schema.org/Thing). Range: URL (https://schema.org/URL). CDIF Definition Web location of a page describing the codelist. Scope schema:url - web location of a page describing the codelist.
license	string	[0..*]	Documentation Original Reference schema:license Definition A license document that applies to this content, typically indicated by URL. Scope Domain: CreativeWork (https://schema.org/CreativeWork). Range: CreativeWork (https://schema.org/CreativeWork), URL (https://schema.org/URL). CDIF Definition License for the codelist. Scope schema:license - license for the codelist. Either schema:license OR schema:conditionsOfAccess is required (anyOf).
conditionsOfAccess	string	[0..*]	Documentation Original Reference schema:conditionsOfAccess Definition Conditions that affect the availability of, or method(s) of access to, an item. Typically used for real world items such as an [[ArchiveComponent]] held by an [[ArchiveOrganization]]. This property is not suitable for use as a general Web access control mechanism. It is expressed only in natural language.\n\nFor example "Available by appointment from the Reading Room" or "Accessible only from logged-in accounts ". Scope Domain: CreativeWork (https://schema.org/CreativeWork). Range: Text (https://schema.org/Text). CDIF Definition Text statement of access conditions for the codelist. Scope schema:conditionsOfAccess - text statement of access conditions. Either schema:license OR schema:conditionsOfAccess is required (anyOf).

Associations

Role	Target	Multiplicity	Kind
subjectOf	→ CatalogRecord	[1]	composition
identifier	→ Identifier	[0..1]	composition
hasTopConcept	→ Concept	[1..*]	composition
inScheme	← Concept	[1..*]	association