1. Permanent Urls
1.1. Metadata Resources
To support long-term FAIR (Findable, Accessible, Interoperable, and Reusable) access to Health-RI Metadata Schema resources, we provide persistent URLs using the W3ID system. These permanent identifiers improve the findability and accessibility of the related artifacts. The following W3ID redirects are available for Health-RI metadata:1.2. Health-RI Metadata
-
Git repository: w3id.org/health-ri/metadata/git
1.3. Versioning & Releases
-
Latest release: w3id.org/health-ri/metadata/releases/latest
-
All releases: w3id.org/health-ri/metadata/releases
-
Specific release:
-
Use the following pattern to reference a specific versioned release:
https://w3id.org/health-ri/metadata/releases/{version}
. -
For example: w3id.org/health-ri/metadata/releases/v1.0.1
1.4. Project Homepage
-
Main page: w3id.org/health-ri/metadata
2. Previous Published
2.1. Previous versions
The previous published version (version 1.0.2) of the Health-RI core metadata schema is available here.
3. Audience Documentation
3.1. Purpose and audience
This branch contains the 2nd version of the Health-RI core and generic health metadata schema for the National Health Data Catalogue, detailing the classes and entities involved and offering usage notes for developers. It addresses the schema’s design and application but excludes discussion on the National Health Data Catalogue and its onboarding process (these are described here). Please also visit Confluence for general information about the metadata schema and metadata mapping. Please note that we are currently still working on the implementation of the new schema into the frontend of the National Health Data Catalogue.
This documentation aims at a technical audience tasked with implementing the metadata schema and stakeholders interested in a detailed understanding of the core metadata schema. With any further questions or comments please contact Health-RI via the Health-RI ServiceDesk or via servicedesk@health-ri.nl.
4. Introduction
4.1. Scope and Current State of the Schema
Building on the 1st version of the metadata schema, version 2 aims to incorporate both DCAT-AP NL and the (yet-to-be-finalized) HealthDCAT-AP, along with Health-RI-specific requirements for the National Health Data Catalogue. It introduces several health-related properties (marked in blue in the UML diagram below), with suggested or required controlled vocabularies where applicable.Important Note: HealthDCAT-AP has not yet been officially finalized and remains subject to change. Once its official release is published, Health-RI will reevaluate compatibility with HealthDCAT-AP. This version is based on the draft dated 16-12-2024. In that draft, the cardinalities of HealthDCAT-AP vary depending on different access rights (public, restricted, non-public). For now, compliance is ensured with the open version, using its UML diagram for reference.
Additionally, several ELSI-related metadata fields, as gathered by the Health-RI ELSI team, have been included in this version 2. These fields are not mandatory but will be evaluated upon implementation in the catalogue.
To indicate the nature of the data (e.g., whole genome sequencing or questionnaire data), we propose using healthdcatap:healthTheme
. For synthetic data, use dct:type
with the required controlled vocabulary in the dcat:Dataset
class.
Several classes from DCAT-AP NL and draft HealthDCAT-AP have been included but not further specified for Health-RI yet. This includes the DataService class, meaning that these classes can be used but are not yet tailored to specific dataholder needs for the National Health Data Catalogue.
4.2. Used Prefixes
Prefix | Namespace IRI |
---|---|
adms | http://www.w3.org/ns/adms# |
dcat | http://www.w3.org/ns/dcat# |
dcatap | http://data.europa.eu/r5r/ |
dct | http://purl.org/dc/terms/ |
dpv | https://w3id.org/dpv# |
dqv | https://www.w3.org/TR/vocab-dqv/ |
eli | http://data.europa.eu/eli/ontology# |
foaf | http://xmlns.com/foaf/0.1/ |
owl | http://www.w3.org/2002/07/owl# |
rdf | http://www.w3.org/1999/02/22-rdf-syntax-ns# |
rdfs | http://www.w3.org/2000/01/rdf-schema# |
skos | http://www.w3.org/2004/02/skos/core# |
spdx | http://spdx.org/rdf/terms# |
time | http://www.w3.org/2006/time# |
vcard | http://www.w3.org/2006/vcard/ns# |
xsd | http://www.w3.org/2001/XMLSchema# |
healthdcatap | To Be Determined |
4.3. Overview and Diagram
An overview of the metadata schema core is presented in the UML diagram below. This UML diagram showcases primary classes (entities), excluding detailed definitions such asrdfs:label
and rdfs:comment
. Each block represents a class and lists its attributes (properties). Where properties reference another class, their range is displayed in pink font.
If a class is linked to another class with a closed arrow, it inherits all properties from the other class (e.g., dcat:Dataset
inherits from dcat:Resource
). Other arrows represent relationships, including their types (e.g., dcat:Dataset
connects to a dcat:DatasetSeries
via dcat:inSeries
), along with cardinalities (e.g., dcat:Dataset
connects to zero or more dcat:DatasetSeries
). Mandatory relationships are marked with dark labels, while recommended relationships use a lighter color.
The UML diagram separates main classes from supporting classes. While relationships between main classes are indicated by arrows, supporting class relationships are not visually connected via arrows to maintain clarity in the diagram. Instead, they can be deduced from the pink-colored property ranges listed per class.
Properties derived from draft HealthDCAT-AP (mostly within the dcat:Dataset
class) are marked blue.
A tabular overview of all classes and properties—including their range, cardinality, controlled vocabulary (if applicable), and usage notes—is provided below. A reference sheet containing this information can be found here. This sheet also documents property histories (compared to v1 of the Health-RI core metadata schema) and specifies the origins of new constraints (whether they stem from DCAT-AP v3, DCAT-AP NL, or HealthDCAT-AP).
4.4. UML of the Core Schema (Version 2)

4.5. Usage Notes on Schema / Mapping
-
Main classes include: Catalog, Dataset, Data Service, Dataset Series, Distribution.
-
Supporting classes include: Agent, Kind, Attribution, Checksum, Identifier, Period of time, Relationship, Quality certificate.
-
Certain properties (e.g.,
dct:publisher
,dct:creator
,dct:contactPoint
) refer to supporting classes (e.g.,foaf:Agent
,vcard:Kind
). These properties instantiate new instances each time they are used. -
Not all metadata schema classes may be necessary for describing your dataset. For example, DataService or DatasetSeries might not apply to every dataset in the National Health Data Catalogue.
-
DCAT’s flexibility enables data holders to structure their metadata according to their needs.
-
Mapping examples from various data sources have been collected for reference.
-
Further information on the metadata schema and guidance on metadata mapping is available.
5. Classes
5.1. Mandatory Terms
Class name | HealthDCAT-AP Definition | Usage Note | URI |
---|---|---|---|
Catalog | A catalogue or repository that hosts the Datasets or Data Services being described. | A catalog that is listed in the National Health Data catalog and contains one or several datasets and/or data services. Used to describe a bundle of datasets (and other resources) under a single title, for example, a collection. | dcat:Catalog |
Dataset | A conceptual entity that represents the information published. | When focusing on health data, a dataset typically contains structured information gathered from a study or research project related to health topics. This might include clinical trial results, public health statistics, patient records, survey data, etc. How the data in a dataset can be accessed is defined in the Distribution, which usually points to the actual data files available for access or download. Datasets are often included in a catalog, which organizes and provides metadata about multiple datasets, making them easier to find and use. The term 'agent' refers to any entity responsible for creating, maintaining, or distributing the dataset. | dcat:Dataset |
Agent | Any entity carrying out actions with respect to the (Core) entities Catalogue, Datasets, Data Services and Distributions. | A person or organisation that is associated with the catalogue or dataset. This class is instantiated in these classes whenever the range is foaf:Agent .
| foaf:Agent |
Kind | A description following the vCard specification. | Used to describe contact information for Dataset and DatasetSeries. This class is instantiated in these classes whenever the range is vcard:Kind .
| vcard:Kind |
5.2. Recommended Terms
Class name | HealthDCAT-AP Definition | Usage Note | URI |
---|---|---|---|
Data Service | A collection of operations that provides access to one or more datasets or data processing functions. | A Data service offers the possibility to access and query the data of one (or several datasets) through operations. It offers more extensive possibilities to access the data than the Distribution through a variety of potential actions. | dcat:DataService |
Dataset Series | A collection of datasets that are published separately, but share some characteristics that group them. | A Dataset Series is a collection of similar datasets that are somehow interrelated but published separately. An example is consecutive datasets split by year and/or datasets separated by location. Instead of being made available in a single dataset, the individual (e.g. yearly) datasets are linked together with the Dataset Series class. | dcat:DatasetSeries |
Distribution | A physical embodiment of the Dataset in a particular format. | Used to describe the different ways that a single dataset can be made available. I.e., it can be downloaded or it can be accessed online in one or more distributions (e.g. one in a downloadable .csv file, another file with an access or query webpage). | dcat:Distribution |
Attribution | Attribution is the ascribing of an entity to an agent. | This class is instantiated by the property "qualified attribution" (prov:qualifiedAttribution ) in other classes. Use this class to describe any Agent (other than publisher or creator) that has some form of responsibility for the resource. Within the class, this Agent is described with an instance of foaf:Agent , and the role is chosen from a controlled vocabulary. This class can be used to indicate the funding agent that provided funding for the dataset.
| prov:Attribution |
Checksum | A value that allows the contents of a file to be authenticated. | This class is instantiated by properties in other classes that have the range spdx:Checksum .
| spdx:Checksum |
Identifier | An identifier in a particular context, consisting of the string that is the identifier; an optional identifier for the identifier scheme; an optional identifier for the version of the identifier scheme; an optional identifier for the agency that manages the identifier scheme. | This class is instantiated by the property "other identifier" (adms:identifier ) in other classes. Use this class to provide any additional identifier to the resource or dataset that is not the primary identifier provided in dct:identifier .
| adms:Identifier |
Period of Time | An interval of time that is named or defined by its start and end dates. | This class is instantiated by properties in other classes that have the range dct:PeriodOfTime .
| dct:PeriodOfTime |
Relationship | An association class for attaching additional information to a relationship between DCAT Resources. | This class is instantiated by the property "qualified relation" (dcat:qualifiedRelation ) in other classes. Use this class to describe a relationship with another resource or dataset. Within the class, that resource is indicated, as well as the role this resource has in relation to the described one. The role is indicated based on a controlled vocabulary.
| dcat:Relationship |
Quality Certificate | An annotation that associates a resource (especially, a dataset or a distribution) to another resource (for example, a document) that certifies the resource’s quality according to a set of quality assessment rules. | This class is instantiated by the property "quality annotation" (dqv:hasQualityAnnotation ) in other classes. Use this class to provide a link between the resource or dataset and an associated quality annotation.
| dqv:QualityCertificate |
6. Properties
The main classes and supportive classes together form the Health-RI data catalogue Application Profile. The properties and their associated constraints that apply in the context of this profile, and the range of properties are listed below.6.1. Agent
Any entity carrying out actions with respect to the (Core) entities Catalogue, Datasets, Data Services and Distributions.
Usage note
: A person or organisation that is associated with the catalogue or dataset. This class is instantiated in these classes whenever the range is foaf:Agent
.
6.1.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
An email address via which contact can be made. This property SHOULD be used to provide the email address of the Agent, specified using fully qualified mailto: URI scheme linkto:macro: (RFC6068). The email SHOULD be used to establish a communication channel to the agent. | foaf:mbox
| NA | rdfs:Resource
| It is possible to provide the email address of the appropriate institution or department if no personal email address can be provided. The email address has to be provided starting with mailto: prefix. For example: mailto:info@example.com / mailto:jane.doe@example.com | 1 | |
identifier | A unique identifier of the agent. | dct:identifier
| ORCID: (https://orcid.org/) ROR: (https://ror.org/) ISNI: (https://isni.org/page/search-database/) TOOI: (https://standaarden.overheid.nl/tooi/waardelijsten/) Wikidata: (https://www.wikidata.org/) | rdfs:Literal
| Specify the entity (person or organisation) by providing an identifier. We recommend using an ORCID identifier for a person or ROR identifier for an organisation. Dutch governmental organisations are listed in TOOI. If these are not available, you can use ISNI, or Wikidata or any other identifier you may have. If you have multiple identifiers, you should provide them all. | 1..* |
name | A name for some thing. | foaf:name
| NA | rdfs:Literal
| This property refers to the given name of the entity. Example: Jane Doe (for a person) and Radboudumc (for an organisation). This property can be repeated for different versions of the name (e.g. the name in different languages). | 1..* |
URL | A homepage for some thing. | foaf:homepage
| NA | rdfs:Resource
| Provide the URL of the page containing contact information, such as a contact form or details for reaching out. If a specific contact page is unavailable, the main website of the Agent is sufficient. | 1 |
6.1.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
country | Country of the agent. | dct:spatial
| EU Vocabularies Country Authority List | dct:Location
| Use the appropriate term from the EU authority table. Example for the Netherlands: http://publications.europa.eu/resource/authority/country/NLD
| 0..* |
publisher note | A property used to provide additional context about a publisher. | healthdcatap:publisherNote
| NA | rdfs:Literal
| This property can be repeated for parallel language versions of the publisher’s notes. Example: "Sciensano is a research institute and the national public health institute of Belgium. It is a so-called federal scientific institution that operates under the authority of the federal minister of Public Health and the federal minister of Agriculture of Belgium."@en | 0..1 |
publisher type | A category (type) of organisation that makes the Dataset available | healthdcatap:publisherType
| NA | skos:Concept
| A controlled vocabulary is provided, denoting commonly recognised health publishers. Current status: Specifically for the health domain, a controlled vocabulary is being developed to include commonly recognised health publishers. This vocabulary is currently under development. Version 1.0 includes the following types: Academia-ScientificOrganisation, Company, IndustryConsortium, LocalAuthority, NationalAuthority, NonGovernmentalOrganisation, NonProfitOrganisation, PrivateIndividual, RegionalAuthority, StandardisationBody and SupraNationalAuthority. These should use the following URL format: http://purl.org/adms/publishertype/[type] .
| 0..1 |
type | A type of the agent that makes the Catalogue or Dataset available. | dct:type
| ADMS Agent Type | skos:Concept
| NA | 0..1 |
6.2. Attribution
Attribution is the ascribing of an entity to an agent.
Usage note
: This class is instantiated by the property "qualified attribution".
6.2.1. Mandatory Attributes
There are currently no mandatory properties for this class.
6.2.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
agent | The prov:agent property references an prov:Agent which influenced a resource. | prov:agent
| NA | foaf:Agent
| This property points to another instance of class foaf:Agent .
| 0..1 |
role | The function of an entity or agent with respect to another entity or resource. | dcat:hadRole
| Codelist CI_RoleCode | rdfs:Resource (IRI)
| Choose one of the roles as listed in the controlled vocabulary. Note that for HealthDCAT-AP, the list of roles might be extended in the future. Example: https://standards.iso.org/iso/19115/resources/Codelists/gml/CI_RoleCode.xml#processor
| 0..1 |
6.3. Catalog
A catalogue or repository that hosts the Datasets or Data Services being described.
Usage note
: A catalog that is listed in the National Health Data catalog and contains one or several datasets and/or data services. Used to describe a bundle of datasets (and other resources) under a single title, for example, a collection.
6.3.1. Mandatory Attributes
Property label | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
contact point | Relevant contact information for the cataloged resource. | dcat:contactPoint
| NA | vcard:Kind
| This property points to a contact point (department or person) that can answer questions about the catalogue. Details on how to describe these are provided under class vcard:Kind . Whenever possible, use general contact information (for example from a department) instead of contact information of an individual. | 1 | TBD |
dataset | A dataset that is listed in the catalog. | dcat:dataset
| NA | dcat:Dataset
| Each catalog contains one or more datasets. This property serves to link datasets to a catalogue. Therefore, a dataset is always contained inside a catalogue. | 1..* | TBD |
description | An account of the resource. | dct:description
| NA | rdfs:Literal
| Briefly describe the catalog and what it contains. You can repeat this in multiple languages. | 1..* | This catalogue describes the core metadata of AUMC Inflammatory Bowel Disease datasets. This catalogue describes breast cancer imaging, clinical and omics datasets. |
publisher | An entity responsible for making the resource available. | dct:publisher
| NA | foaf:Agent
| The organisation or individual that is the holder of the intellectual property rights of a dataset. For more details about the publisher, see the class [Agent]linkto:agent). | 1 | name: Radboud University Medical Center identifier: https://ror.org/05wg1m734 (see class foaf: Agent) |
title | A name given to the resource. | dct:title
| NA | rdfs:Literal
| Provide a unique title for your catalog, which can be repeated in multiple languages. | 1..* | Healthy Brain Study |
6.3.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
applicable legislation | The legislation that is applicable to this resource. | dcatap:applicableLegislation
| NA | eli:LegalResource
| NA | 0..* |
catalog | A catalog that is listed in the catalog. | dcat:catalog
| NA | dcat:Catalog
| For certain research projects, multiple catalogs may need to be organized in a nested manner. This property serves to connect the different catalogs with each other. | 0..* |
creator | An entity responsible for making the resource. | dct:creator
| NA | foaf:Agent
| Note that the Health-RI model diverges from DCAT-AP NL here, which reduces the maximum number of creators to 1. The Health-RI model allows the specification of multiple creators of a catalogue. | 0..* |
geographical coverage | Spatial characteristics of the resource. | dct:spatial
| EU Vocabularies Lists: Continents Countries Places OR Geonames OR CBS Classificaties en begrippen | dct:Location
| The EU Vocabularies Name Authority Lists must be used for continents, countries and places that are in those lists; if a particular location is not in one of the mentioned Named Authority Lists, Geonames URIs must be used. For districts or neighbourhoods in NL, the Dutch vocab can be used. | 0..* |
has part | A related resource that is included either physically or logically in the described resource. | dct:hasPart
| NA | dcat:Catalog
| Use this property to establish another catalogue in this catalogue. Note that deeply nested structures should be avoided, and can currently not be displayed in the National Health Data Catalogue. | 0..* |
home page | A homepage for some thing. | foaf:homepage
| NA | foaf:Document
| The home page of the catalogue, if available. | 0..1 |
language | A language of the resource. | dct:language
| EU Vocabularies Language Authority List | dct:LinguisticSystem
| The value of this property must be an IRI from the provided controlled vocabulary. For example: http://publications.europa.eu/resource/authority/language/NLD
| 0..* |
licence | A legal document giving official permission to do something with the resource. | dct:license
| Geonovum licence list | dct:LicenseDocument
| The licence under which the catalogue (with resource description) is made available. In the description of distributions and data services, the licences of that resources are taken up. | 0..1 |
modification date | Date on which the resource was changed. | dct:modified
| NA | xsd:dateTime
| NA | 0..1 |
release date | Date of formal issuance of the resource. | dct:issued
| NA | xsd:dateTime
| NA | 0..1 |
rights | Information about rights held in and over the resource. | dct:rights
| NA | dct:RightsStatement
| The rights statement should be a free-text statement placed at a web-accessible location such that the value of this property is the IRI pointing to that statement. | 0..1 |
service | A service that is listed in the catalog. | dcat:service
| NA | dcat:DataService
| Some datasets may have real-time Data Services (e.g., Beacon API counting individuals). IT teams should define the relationship between the catalog and the Data Service via this property. While crucial for interoperability, this property is not relevant for end-users to collect. | 0..* |
temporal coverage | Temporal characteristics of the resource. | dct:temporal
| NA | dct:PeriodOfTime
| Use this property, if applicable to the catalogue, to indicate a time period the catalogue spans. | 0..* |
themes | A main category of the resource. A resource can have multiple themes. | dcat:themeTaxonomy
| NA | skos:ConceptScheme
| This property refers to a knowledge organisation system used to classify the Catalogue’s Datasets. It must have at least the value NAL:data-theme as this is the mandatory controlled vocabulary for dcat:theme .
| 0..* |
6.4. Checksum
A value that allows the contents of a file to be authenticated.
Usage note
: This class is instantiated by properties in other classes that have the range spdx:Checksum
.
6.4.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
algorithm | Identifies the algorithm used to produce the subject Checksum. | spdx:algorithm
| Checksum Algorithm members | spdx:ChecksumAlgorithm
| Choose one member of the checksum algorithm members as indicated on the webpage linked in the Controlled Vocabulary column. | 1 |
checksum value | The checksumValue property provides a lower case hexidecimal encoded digest value produced using a specific algorithm. | spdx:checksumValue
| NA | xsd:hexBinary
| NA | 1 |
6.4.2. Recommended Attributes
There are currently no recommended properties for this class.
6.5. Data Service
A collection of operations that provides access to one or more datasets or data processing functions.
Usage note
: A Data service offers the possibility to access and query the data of one (or several datasets) through operations. It offers more extensive possibilities to access the data than the Distribution through a variety of potential actions. An example of a Data Service is a Beacon API to query genomics data.
6.5.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
access rights | Information about who accesses the resource or an indication of its security status. | dct:accessRights
| EU Vocabularies Access Rights Authority List | Rights Statement (IRI) | Information that indicates whether the Dataset is publicly accessible, has access restrictions, or is not public. This property is required to adopt one of the predefined values listed in the Access Rights Named Authority List provided by the Publications Office. This designation informs data users whether the dataset is considered open data or is classified as non-public. | 1 | For non-public data, use the value: http://publications.europa.eu/resource/authority/access-right/NON_PUBLIC
|
contact point | Relevant contact information for the cataloged resource. | dcat:contactPoint
| NA | vcard:Kind
| This property points to a contact point (department or person) that can answer questions about the data service. Details on how to describe these are provided under class vcard:Kind . Whenever possible, use general contact information (for example from a department) instead of contact information of an individual. | 1 | mailto: data-access-committee@xumc.nl with the name Data Access Committee of the x UMC (see vcard:Kind )
|
description | An account of the resource. | dct:description
| NA | rdfs:Literal
| Briefly describe the data service provided. You can repeat this description in multiple languages. | 1..* | A data service that provides API access to real-time electrocardiogram (ECG) monitoring data for clinical research applications. |
end point description | A description of the services available via the end-points, including their operations, parameters, etc. | dcat:endpointDescription
| NA | rdfs:Resource
| Provides technical documentation that explains how to access and interact with the data service’s endpoint. | 1 | TBD |
end point URL | The root location or primary endpoint of the service (a Web-resolvable IRI). | dcat:endpointURL
| NA | rdfs:Resource
| Provide the URL of the endpoint that users can interact with to access the data service. This should be a direct link to the service’s endpoint, such as an API URL, SPARQL endpoint, or similar. | 1 | NA |
identifier | An unambiguous reference to the resource within a given context. | dct:identifier
| NA | rdfs:Literal
| Provide a unique identifier for the data service. This could be a globally unique and persistent identifier, such as a DOI, URN, or UUID. If no persistent identifier is available, you may use the accessURL or endpointURL as the identifier, provided it is stable and unique to the service. | 1 | NA |
licence | A legal document giving official permission to do something with the resource. | dct:license
| Geonovum licence list | dct:LicenseDocument
| For public data, use a Creative Commons (CC) license (see Geonovum options). For most National Health Data Catalogue data services, where data is not public, use the 'not open' license from Geonovum and specify data reuse agreements in the dct:rights property.
| 1 | NA |
publisher | An entity responsible for making the resource available. | dct:publisher
| NA | foaf:Agent
| The organisation or individual responsible for making the data service available. In the context of data services, the publisher is typically the organisation that manages or provides access to the service. For details, see the class Agent. | 1 | name: Radboud University Medical Center identifier: https://ror.org/05wg1m734 (see class foaf: Agent) |
theme | A main category of the resource. A resource can have multiple themes. | dcat:theme
| EU Vocabularies Theme Authority List | skos:Concept
| This property should use the controlled vocabulary. In the Health Data Catalogue, most data services will use NAL:data-theme 'HEAL', but additional values from the same vocabulary are allowed.
| 1..* | https://publications.europa.eu/resource/authority/data-theme/HEAL
|
title | A name given to the resource. | dct:title
| NA | rdfs:Literal
| NA | 1..* | NA |
6.5.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
applicable legislation | The legislation that is applicable to this resource. | dcatap:applicableLegislation
| NA | eli:LegalResource
| TBA | 0..* |
application profile | An established standard to which the described resource conforms. | dct:conformsTo
| NA | dct:Standard
| The standards referred here SHOULD describe the Data Service and not the data it serves. The latter is provided by the dataset with which this Data Service is connected. For instance, the data service adheres to the OGC WFS API standard, while the associated dataset adheres to the INSPIRE Address data model. | 0..* |
creator | An entity responsible for making the resource. | dct:creator
| NA | foaf:Agent
| Note that the Health-RI model diverges from DCAT-AP NL here, which reduces the maximum number of creators to 1. The Health-RI model allows the specification of multiple creators of a data service. | 0..* |
format | The file format, physical medium, or dimensions of the resource. | dct:format
| EU Vocabularies File Type Authority List | dct:MediaType or Extent
| The term from the authority table should be used. | 0..* |
HVD Category | A data category defined in the High Value Dataset Implementing Regulation. | dcatap:hvdCategory
| NA | skos:Concept
| NA | 0..* |
keyword | A keyword or tag describing the resource. | dcat:keyword
| NA | rdfs:Literal
| NA | 0..* |
landing page | A Web page that can be navigated to in a Web browser to gain access to the catalog, a dataset, its distributions and/or additional information. | dcat:landingPage
| NA | foaf:Document
| It is intended to point to a landing page at the original data service provider, not to a page on a site of a third party, such as an aggregator. | 0..* |
language | A language of the resource. | dct:language
| EU Vocabularies Language Authority List | dct:LinguisticSystem
| Indicates the natural language used in the data service, indicated with a value from the EU controlled vocabulary. | 0..* |
modification date | Date on which the resource was changed. | dct:modified
| NA | xsd:dateTime
| This property indicates the date of the last changes to the dataset, not the metadata record. An absent value may mean the resource hasn’t changed since publication, the modification date is unknown, or the resource is continuously updated. | 0..1 |
other identifier | Links a resource to an adms:Identifier class.
| adms:identifier
| NA | adms:Identifier
| NA | 0..* |
rights | Information about rights held in and over the resource. | dct:rights
| NA | dct:RightsStatement
| NA | 0..* |
serves dataset | A collection of data that this data service can distribute. | dcat:servesDataset
| NA | dcat:Dataset
| This property connects the Data Service class to its corresponding dataset(s), ensuring every data service links to at least one dcat:Dataset . While essential for metadata implementation teams on each node, it’s less relevant for researchers to collect.
| 0..* |
6.6. Dataset
A conceptual entity that represents the information published.
Usage note
: When focusing on health data, a dataset typically contains structured information gathered from a study or research project related to health topics. This might include clinical trial results, public health statistics, patient records, survey data, etc.
How the data in a dataset can be accessed is defined in the Distribution, which usually points to the actual data files available for access or download. Datasets are often included in a catalog, which organizes and provides metadata about multiple datasets, making them easier to find and use. The term 'agent' refers to any entity responsible for creating, maintaining, or distributing the dataset.
6.6.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
access rights | Information about who accesses the resource or an indication of its security status. | dct:accessRights
| EU Vocabularies Access Rights Authority List | Rights Statement (IRI) | Information that indicates whether the Dataset is publicly accessible, has access restrictions, or is not public. It is foreseen that one of the three options has to be used: public , restricted , non-public . - Open Data (Public): The dataset is available under general open data rules, such as those covered by the High Value Datasets Implementing Regulation. - Protected Data (Restricted): The dataset contains protected data and is accessible only under specific conditions, as outlined in regulations like the Data Governance Act. - Sensitive Data (Non public): The dataset includes resources that may contain sensitive or personal information, falling under regulations such as the EHDS Regulation. Since most data contain personal information, these datasets will need to take the value 'non-public' for the access rights property. | 1 | http://publications.europa.eu/resource/authority/access-right/RESTRICTED
|
applicable legislation | The legislation that is applicable to this resource. | dcatap:applicableLegislation
| NA | eli:LegalResource
| The ELI of the EHDS was published in March 2025 and can now be included as the applicable legislation mandating that the dataset has to be made public. For health datasets, the value must include the ELI of the EHDS Regulation. As multiple legislations may apply to the resource, the maximum cardinality is not limited. While the applicable legislation indicates which legislation mandates the publication of the dataset, the legal basis property (also in Datasets) described the legal basis for initial collection and processing of (personal) data. | 1..* | NA |
contact point | Relevant contact information for the cataloged resource. | dcat:contactPoint
| NA | vcard:Kind
| This property points to a contact point (department or person) that can answer questions about the dataset. Details on how to describe these are provided under class vcard:Kind . Whenever possible, use general contact information (for example from a department) instead of contact information of an individual. | 1 | mailto: data-access-committee@xumc.nl with the name Data Access Committee of the x UMC (see vcard:Kind) |
creator | An entity responsible for making the resource. | dct:creator
| NA | foaf:Agent
| This property points to a person (known as Agent ) responsible for generating the dataset. In most cases, this should be the project’s Principal Investigator, provided they consent to being listed in the catalogue. If not, the associated department or institute may be specified instead.
| 1..* | Jip Fictief, Inez Maginary, Fabio Abricated for name of foaf:Agent
|
description | An account of the resource. | dct:description
| NA | rdfs:Literal
| Brief description of the dataset. You can repeat this property in multiple languages. | 1..* | Collection of physiological data of Healthy Brain Study participants. This collection includes measurements via biowearables for heart rate, oxygenation, systolic and diastolic measures and stress levels. |
identifier | An unambiguous reference to the resource within a given context. | dct:identifier
| NA | rdfs:Literal
| Please see the latest usage recommendations on this page. | 1 | https://doi.org/10.34894/ZLOYOJ
|
keyword | A keyword or tag describing the resource. | dcat:keyword
| NA | rdfs:Literal
| Add keywords to increase dataset discoverability. You can include keywords in different languages, submitting each keyword as a separate entry. | 1..* | Physiological measures, Heart Rate, Stress Measures |
publisher | An entity responsible for making the resource available. | dct:publisher
| NA | foaf:Agent
| This property identifies the organisation or individual responsible for making the dataset available. For datasets, this is typically the employer of the data creators. In simple cases, the dataset publisher may be the same as the catalog publisher. In more complex settings, such as when datasets come from multiple institutions within a consortium, the consortium should be listed as the publisher where possible. If no formal consortium can be specified, provide the information of the contributing organizations or individuals under dct:creator instead. For more details, refer to the Agent class.
| 1 | Radboud University Medical Center; identifier https://ror.org/05wg1m734 (see foaf: Agent)
|
theme | A main category of the resource. A resource can have multiple themes. | dcat:theme
| Dataset Theme Vocabulary | skos:Concept
| This property should use a controlled vocabulary. In the Health Data Catalogue, all datasets will use the theme HEAL, but additional values from the same vocabulary are allowed. | 1..* | http://publications.europa.eu/resource/authority/data-theme/HEAL
|
title | A name given to the resource. | dct:title
| NA | rdfs:Literal
| Provide a unique title for your Dataset, which can be repeated in multiple languages. | 1..* | Healthy Brain Study - Physiological Data |
6.6.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
analytics | An analytics distribution of the dataset. | healthdcatap:analytics
| NA | dcat:Distribution
| Publishers are encouraged to provide URLs pointing to document repositories where users can access or request associated resources such as technical reports of the dataset, quality measurements, usability indicators,... Note that HealthDCAT-AP mentions also API endpoints or analytics services, but these would not be Distributions but rather DatasetServices. | 0..* | NA |
code values | Health classifications and their codes associated with the dataset. | healthdcatap:hasCodeValues
| NA | skos:Concept
| Inside this property, you can provide the coding system of the dataset in the form of wikidata URI (example: https://www.wikidata.org/entity/P494 for ICD-10 ID) and the URI of the value that describes the dataset (example: https://icd.who.int/browse10/2019/en#/Y59.0 for viral vaccines)
| 0..* | https://www.wikidata.org/entity/P494 for ICD-10 ID and https://icd.who.int/browse10/2019/en#/Y59.0 for viral vaccines
|
coding system | Coding systems in use (ex: ICD-10-CM, DGRs, SNOMED-CT, ...). | healthdcatap:hasCodingSystem
| NA | dct:Standard (IRI)
| This property provides information on which coding systems are in use inside your dataset. For this, wikidata URIs must be used. | 0..* | https://www.wikidata.org/entity/P494 (ICD-10 ID)
|
conforms to | An established standard to which the described resource conforms. | dct:conformsTo
| NA | dct:Standard (IRI)
| If your data conforms to an established standard or specification, use this property to indicate which one. The wikidata URI of the specification must be used. | 0..* | https://www.wikidata.org/wiki/Q19597236 for FHIR
|
distribution | An available distribution of the dataset. | dcat:distribution
| NA | dcat:Distribution
| Metadata element used as a key link to the class Distribution. | 0..* | NA |
documentation | A page or document about this thing. | foaf:page
| NA | foaf:Document (IRI)
| The value of this property is the IRI directing to the webpage or document about the dataset. | 0..* | NA |
frequency | The frequency with which items are added to a collection. | dct:accrualPeriodicity
| EU Vocabularies Frequency Authority List | skos:Concept
| "The value of this property should be the IRI from the listed controlled vocabulary, indicating the frequency at which the dataset is updated. | 0..1 | http://publications.europa.eu/resource/authority/frequency/WEEKLY
|
geographical coverage | Spatial characteristics of the resource. | dct:spatial
|
EU Vocabularies Lists: Continents Countries Places OR Geonames OR CBS Classificaties en begrippen | dct:Location
| The EU Vocabularies Name Authority Lists must be used for continents, countries and places that are in those lists; if a particular location is not in one of the mentioned Named Authority Lists, Geonames URIs must be used. For districts or neighborhoods in NL, the Dutch vocab can be used. However, it might in many cases be desirable to keep the geographical coverage broader (e.g. indicating that NL is covered), to not expose detailed information of subject’s locations. | 0..* | http://publications.europa.eu/resource/authority/place/NLD_AMS
|
has version | This resource has a more specific, versioned resource. | dcat:hasVersion
| NA | dcat:Dataset
| Indicate the dataset which is the other version of the current dataset. | 0..* | NA |
health theme | A category of the Dataset or tag describing the Dataset. | healthdcatap:healthTheme
| NA | skos:Concept
| This property is a structured way to tag the dataset with different health themes. This could include, for example, the specific disease the dataset is about. More details can be provided, if desirable, in the keywords' property. Current status: the HealthDCAT-AP working group is currently exploring is other sources (ontologies, thesauri) can be used for this, next to Wikidata. | 0..* | https://www.wikidata.org/wiki/Q58624061
|
in series | A dataset series of which the dataset is part. | dcat:inSeries
| NA | dcat:DatasetSeries
| This property points to which Dataset Series the Dataset is part of. | 0..* | NA |
is referenced by | A related resource that references, cites, or otherwise points to the described resource. | dct:isReferencedBy
| NA | rdfs:Resource
| The value of this property is the IRI of the doi to the publication or other related resource. | 0..* | https://doi.org/10.1186/s13690-021-00709-x
|
language | A language of the resource. | dct:language
| EU Vocabularies Language Named Authority List | dct:LinguisticSystem
| The language of the Dataset. For this property, the values from the EU Vocabularies Languages Named Authority List must be used. If your Dataset contains multiple languages, this property can be repeated. | 0..* | http://publications.europa.eu/resource/authority/language/NLD
|
legal basis | Indicates use or applicability of a Legal Basis. | dpv:hasLegalBasis
| DPV Taxonomy | dpv:LegalBasis
| The legal basis can be provided as a value from the dpv taxonomy (see Controlled vocabulary column). While the applicable legislation indicates which legislation mandates the publication of the dataset, the legal basis property described the legal basis for initial collection and processing of (personal) data. Example value for this property could be: dpv:Consent. | 0..* | dpv:Consent
|
maximum typical age | Maximum typical age of the population within the dataset. | healthdcatap:maxTypicalAge
| NA | xsd:nonNegativeInteger
| The approximate maximum age of subjects in the dataset, if applicable. Approximate age is given to protect potentially sensitive information of subjects in the dataset. | 0..1 | NA |
minimum typical age | Minimum typical age of the population within the dataset. | healthdcatap:minTypicalAge
| NA | xsd:nonNegativeInteger
| The approximate minimum age of subjects in the dataset, if applicable. Approximate age is given to protect potentially sensitive information of subjects in the dataset. | 0..1 | NA |
modification date | Date on which the resource was changed. | dct:modified
| NA | xsd:dateTime
| This property indicates changes to the dataset, not the metadata record. An absent value may mean the resource hasn’t changed since publication, the modification date is unknown, or the resource is continuously updated. | 0..1 | 2024-06-04T13:36:10.246Z |
number of records | Size of the dataset in terms of the number of records. | healthdcatap:numberOfRecords
| NA | xsd:nonNegativeInteger
| Number of records inside a Dataset. | 0..1 | NA |
number of unique individuals | Number of records for unique individuals. | healthdcatap:numberOfUniqueIndividuals
| NA | xsd:nonNegativeInteger
| This property is not mandatory, since not all datasets might include data from individuals. | 0..1 | NA |
other identifier | Links a resource to an adms:Identifier class. | adms:identifier
| NA | adms:Identifier
| Examples for secondary identifiers are MAST/ADS , DataCite , DOI , EZID or W3ID (if not used for the original identifier). This property makes use of another, small class: adms:Identifier , where you provide the identifier and the name of the identifier schema (e.g., DOI).
| 0..* | NA |
personal data | Indicates association with Personal Data. | dpv:hasPersonalData
| DPV Taxonomy | dpv:PersonalData
| The different types of personal information that are collected in the dataset can be indicated with this property. Values can be picked from the dpv taxonomy (see controlled vocabulary column). For example: dpv-pd:Gender. | 0..* | NA |
population coverage | A definition of the population within the dataset. | healthdcatap:populationCoverage
| NA | rdfs:Literal
| This field is a free text description of the population covered in the dataset. | 0..* | Adults aged 18–65 diagnosed with type 2 diabetes in the Netherlands between 2015 and 2020 |
purpose | Indicates association with Purpose. | dpv:hasPurpose
| DPV Taxonomy Purposes | dpv:Purpose
| One (or many) category or sub-category of the purposes can be chosen from the taxonomy provided by dpv (see the controlled vocabulary column). Example value could be: dpv:ResearchAndDevelopment. | 0..* | dpv:ResearchAndDevelopment
|
qualified attribution | Attribution is the ascribing of an entity to an agent. | prov:qualifiedAttribution
| NA | prov:Attribution
| This property makes use of another small class (prov:Attribution ). There, you can choose one of the roles as listed in the controlled vocabulary and link that to a specific Agent (expressed with foaf:Agent ). Note that for HealthDCAT-AP, the list of roles might be extended in the future. Example: https://standards.iso.org/iso/19115/resources/Codelists/gml/CI_RoleCode.xml#processor Use this property if you would like to indicate the funder of the (research project that resulted in creation of the) dataset. The value for role then becomes: https://standards.iso.org/iso/19115/resources/Codelists/gml/CI_RoleCode.xml#funder "
| 0..* | See Usage Note |
qualified relation | Link to a description of a relationship with another resource. | dcat:qualifiedRelation
| NA | dcat:Relationship
| This property makes use of another small class (dcat:Relationship ), in which you can indicate the related resource (via its identifier) and the nature of the relation (based on a controlled vocabulary, which is described in the information of the class).
| 0..* | NA |
quality annotation | Refers to a quality annotation. | dqv:hasQualityAnnotation
| NA | dqv:QualityCertificate
| This property makes use of another small class (dqv:QualityCertificate ), in which you indicate the IRI of the quality certificate, linked to the described resource (via the identifier of the dataset). See that class for more information.
| 0..* | NA |
release date | Date of formal issuance of the resource. | dct:issued
| NA | xsd:dateTime
| This property should point to the first known date of issuance, such as the publication date in a data repository. | 0..1 | 2023-12-10T13:16:10.246Z |
retention period | A temporal period in which the dataset is available for secondary use. | healthdcatap:retentionPeriod
| NA | dct:PeriodOfTime
| This property makes use of the class dct:PeriodOfTime , in which a start and end date should be provided.
| 0..1 | NA |
sample | Links to a sample of an Asset (which is itself an Asset). | adms:sample
| NA | dcat:Distribution
| This property makes use of the dcat:Distribution class to describe a sample distribution of the dataset, which can be anonymized or synthetic data, or the data dictionary provided in CSVW format . This is currently further developed by the TEHDAS2 program. More information can be found here.
| 0..* | NA |
source | A related resource from which the described resource is derived. | dct:source
| NA | dcat:Dataset
| Indicate the dataset on which this described dataset is based. | 0..* | NA |
status | The status of the Asset in the context of a particular workflow process. | adms:status
| EU Vocabularies Dataset Status Named Authority List | skos:Concept
| This property makes use of a controlled vocabulary to indicate the status of the described dataset. | 0..1 | http://publications.europa.eu/resource/authority/dataset-status/COMPLETED
|
temporal coverage | Temporal characteristics of the resource. | dct:temporal
| NA | dct:PeriodOfTime
| The start and end date of the period that the dataset covers. This property makes use of a small class: Period of Time, in which a start and end date can be given. | 0..* | NA |
temporal resolution | Minimum time period resolvable in the dataset. | dcat:temporalResolution
| NA | xsd:duration
| If the dataset is a time-series, this should correspond to the spacing of items in the series. For other kinds of dataset, this property will usually indicate the smallest time difference between items in the dataset. The time period has to be provided in the xsd:duration format.
| 0..1 | NA |
type | The nature or genre of the resource. | dct:type
| EU Vocabularies Dataset Type Named Authority List | skos:Concept
| A recommended controlled vocabulary data-type is foreseen. Health datasets with personal information must use 'personal data'. This list supports dataset categorization for the EU Open Data Portal. Currently, 'PERSONAL_DATA' is not included in the EU vocabulary and cannot be filled out. | 0..* | http://publications.europa.eu/resource/authority/dataset-type/PERSONAL_DATA
|
version | The version indicator (name or identifier) of a resource. | dcat:version
| NA | rdfs:Literal
| Suggested practice: track major_version.minor_version. Register a new identifier for major changes (e.g., 1.0.0 for an unchanged dataset). | 0..1 | NA |
version notes | A description of changes between this version and the previous version of the Asset. | adms:versionNotes
| NA | rdfs:Literal
| Provide a short description of changes made to the dataset from the previous version. | 0..* | NA |
was generated by | Generation is the completion of production of a new entity by an activity. This entity did not exist before generation and becomes available for usage after this generation. | prov:wasGeneratedBy
| NA | prov:Activity
| NA | 0..* | NA |
6.7. Dataset Series
A collection of datasets that are published separately, but share some characteristics that group them.
Usage note
: A Dataset Series is a collection of similar datasets that are somehow interrelated but published separately. An example is consecutive datasets split by year and/or datasets separated by location. Instead of being made available in a single dataset, the individual (e.g. yearly) datasets are linked together with the Dataset Series class.
6.7.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
contact point | Relevant contact information for the cataloged resource. | dcat:contactPoint
| NA | vcard:Kind
| This property points to a contact point (department or person) that can answer questions about the dataset series. Details on how to describe these are provided under class vcard:Kind . Whenever possible, use general contact information (for example from a department) instead of contact information of an individual. | 1..* |
description | An account of the resource. | dct:description
| NA | rdfs:Literal
| Provide a brief description of the dataset series in the catalog. You can repeat this in multiple languages. | 1..* |
title | A name given to the resource. | dct:title
| NA | rdfs:Literal
| Provide a unique title for your Dataset Series. It can be provided in multiple languages. | 1..* |
6.7.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
applicable legislation | The legislation that is applicable to this resource. | dcatap:applicableLegislation
| NA | eli:LegalResource
| The legislation that mandates the creation or management of the Dataset Series. | 0..* |
frequency | The frequency with which items are added to a collection. | dct:accrualPeriodicity
| EU Vocabularies Frequency Authority List | skos:Concept
| The frequency of a dataset series is not equal to the frequency of the dataset in the collection. | 0..1 |
geographical coverage | Spatial characteristics of the resource. | dct:spatial
|
EU Vocabularies Lists: Continents Countries Places OR Geonames OR CBS Classificaties en begrippen | dct:Location
| The EU Vocabularies Name Authority Lists must be used for continents, countries, and places that are in those lists. If a particular location is not in one of the mentioned Named Authority Lists, Geonames URIs must be used. For districts or neighbourhoods in NL, the Dutch vocab can be used. However, it might in many cases be desirable to keep the geographical coverage broader (e.g., indicating that NL is covered) to avoid exposing detailed information about the subjects' locations. | 0..* |
modification date | Date on which the resource was changed. | dct:modified
| NA | xsd:dateTime
| This does not correspond to the most recently modified dataset in the collection of the dataset series. | 0..1 |
publisher | An entity responsible for making the resource available. | dct:publisher
| NA | foaf:Agent
| The publisher of the dataset series may not be the publisher of all datasets. E.g., a digital archive could take over the publishing of older datasets in the series. | 0..1 |
release date | Date of formal issuance of the resource. | dct:issued
| NA | xsd:dateTime
| This refers to the moment when the dataset series was established as a managed resource. This is not equal to the release date of the oldest dataset in the collection of the dataset series. | 0..1 |
temporal coverage | Temporal characteristics of the resource. | dct:temporal
| NA | dct:PeriodOfTime
| When temporal coverage is a dimension in the dataset series, then the temporal coverage of each dataset in the collection should be part of the temporal coverage. In that case, an open-ended value is recommended, e.g., after 2012. | 0..* |
6.8. Distribution
A physical embodiment of the Dataset in a particular format.
Usage note
: Used to describe the different ways that a single dataset can be made available in. I.e., it can be downloaded, or it can be accessed online in one or more distributions (e.g. one in a downloadable .csv
file, another file with an access or query webpage)
6.8.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
access URL | A URL of the resource that gives access to a distribution of the dataset. E.g., landing page, feed, SPARQL endpoint. | dcat:accessURL
| NA | IRI
| Add a link that points to where the dataset can be found. If it’s hosted in a Data Repository, include the link to its entry. For datasets not in a repository (like registries), but still available for secondary use, provide a link to an access request form or a webpage with instructions for accessing the data. | 1 | NA |
byte size | The size of a Distribution in bytes. | dcat:byteSize
| NA | xsd:nonNegativeInteger
| Describes the size of the distribution (the actual file) in bytes, and is therefore expressed as a non-negative integer. If the actual size is not know, it can be estimated. | 1 | NA |
format | The file format, physical medium, or dimensions of the resource. | dct:format
| EU Vocabularies File Type Authority List | dct:MediaType or Extent
| This property can be used to describe a media format in more detail than media type (using IANA media type) when needed. Instances of this property should use a URL, e.g., from the File Type vocabulary. For instance, for mzML files, the value of this property could be: http://edamontology.org/format_3244
| 1 | http://publications.europa.eu/resource/authority/file-type/TSV
|
license | A legal document giving official permission to do something with the resource. | dct:license
| Geonovum licence list | dct:LicenseDocument
| For public data, use a Creative Commons (CC) license (see Geonovum options). For most National Health Data Catalogue distributions, where data is not public, use the 'not open' license from Geonovum and specify data reuse agreements in the dct:rights property.
| 1 | NA |
rights | Information about rights held in and over the resource. | dct:rights
| NA | dct:RightsStatement
| A statement that concerns all rights not addressed in fields license or access rights . In case of not open data (as specified in the dct:licence property), further agreements regarding data reuse (e.g., Data Transfer Agreement, DTA) should be stated in this property. The rights statement should be a free-text statement placed at a web-accessible location such that the value of this property is the IRI pointing to that statement. Current status: This recommendation on how to state data transfer/reuse conditions will be piloted in 2025. | 1 | NA |
6.8.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality | Example |
---|---|---|---|---|---|---|---|
access service | A data service that gives access to the distribution of the dataset | dcat:accessService
| NA | dcat:DataService
| This property links the distribution class to the corresponding data service(s). | 0..1 | NA |
applicable legislation | The legislation that is applicable to this resource. | dcatap:applicableLegislation
| NA | eli:LegalResource
| The legislation that mandates the creation or management of the Distribution. | 0..* | NA |
checksum | The checksum property provides a mechanism that can be used to verify that the contents of a file or package have not changed. | spdx:checksum
| NA | spdx:Checksum
| The checksum is related to the downloadURL. This property makes use of the spdx:Checksum class, which itself has two properties to indicate checksum algorithm and checksum value (see Checksum class for further details).
| 0..1 | NA |
compression format | The compression format of the distribution in which the data is contained in a compressed form, e.g., to reduce the size of the downloadable file. | dcat:compressFormat
| IANA Media Types | dct:MediaType
| It MUST be expressed using a media type as defined in the official register of media types managed by IANA. | 0..1 | NA |
description | An account of the resource. | dct:description
| NA | rdfs:Literal
| Provide specific details about the distribution here, complementing the description of the related Dataset. This field can be repeated for different language versions of the description. | 0..* | NA |
documentation | A homepage for some thing. | foaf:page
| NA | foaf:Document (IRI)
| This page can contain additional information about the distribution. | 0..* | NA |
download URL | The URL of the downloadable file in a given format. E.g., CSV file or RDF file. The format is indicated by the distribution’s dct:format and/or dcat:mediaType. | dcat:downloadURL
| NA | IRI
| If the dataset is openly accessible and available in a repository, you can directly include a link to the downloadable file here. | 0..1 | NA |
language | A language of the resource. | dct:language
| EU Vocabularies Language Authority List | dct:LinguisticSystem (IRI)
| Indicates the natural language used in the Distribution, indicated with a value from the EU controlled vocabulary. Not all distributions might have a language, for example, imaging data. Note that here the Health-RI model diverges from DCAT-AP NL, which allows a maximum of 1 language per Distribution. The Health-RI model allows multiple languages in the same Distribution. | 0..* | NA |
linked schemas | An established standard to which the described resource conforms. | dct:conformsTo
| NA | dct:Standard (IRI)
| This property SHOULD be used to indicate the model, schema, ontology, view, or profile to which this representation of a dataset conforms, in a machine-readable form. This is generally a complementary concern to the media-type or format. Use a reference to the official publication of the respective schema. | 0..* | NA |
media type | The media type of the distribution as defined by IANA. [IANA-MEDIA-TYPES]. | dcat:mediaType
| IANA media types | IRI
| Use the specified vocabularies, prioritizing IANA media types whenever possible. If unavailable, consider other ontologies, such as ZonMw generic terms, to describe the format. If IANA media types do not sufficiently describe the format, use "format" to describe it in more detail. | 0..1 | https://www.iana.org/assignments/media-types/text/csv
|
modification date | Date on which the resource was changed. | dct:modified
| NA | xsd:dateTime
| NA | 0..1 | NA |
packaging format | The package format of the distribution in which one or more data files are grouped together, e.g., to enable a set of related files to be downloaded together. | dcat:packageFormat
| IANA media types | dct:MediaType
| It SHOULD be expressed using a media type as defined in the official register of media types managed by IANA. | 0..1 | NA |
release date | Date of formal issuance of the resource. | dct:issued
| NA | xsd:dateTime
| The date the dataset distribution was issued. | 0..1 | NA |
retention period | A temporal period in which the dataset is available for secondary use. | healthdcatap:retentionPeriod
| NA | dct:PeriodOfTime
| This property makes use of the class dct:PeriodOfTime , in which a start and end date should be provided.
| 0..1 | NA |
status | The status of the Asset in the context of a particular workflow process. | adms:status
| EU Vocabularies Distribution Status Authority List | skos:Concept
| It MUST take one of the values: Completed, Deprecated, Under Development, Withdrawn, from the provided controlled vocabulary. | 0..1 | NA |
temporal resolution | Minimum time period resolvable in the dataset. | dcat:temporalResolution
| NA | xsd:duration
| If applicable, this property indicates the minimum time period resolvable in the dataset distribution, expressed in xsd:duration format (see for more information here)
| 0..1 | NA |
title | A name given to the resource. | dct:title
| NA | rdfs:Literal
| A title given to the distribution. This property can be repeated to provide names in parallel languages. | 0..* | Data Access Request of Healthy Brain study |
6.9. Identifier
An identifier in a particular context, consisting of the string that is the identifier; an optional identifier for the identifier scheme; an optional identifier for the version of the identifier scheme; an optional identifier for the agency that manages the identifier scheme.
Usage note
: This class is instantiated by the property "other identifier".
6.9.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
notation | A string that is an identifier in the context of the identifier scheme referenced by its datatype. | skos:notation
| NA | rdfs:Literal
| The value of this property is the alternative identifier of the dataset, next to the one indicated in the dct:identifier property. | 1 |
6.9.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
schema agency | The name of the agency that issued the identifier. | adms:schemaAgency
| NA | rdfs:Literal
| NA | 0..1 |
6.10. Kind
A description following the vCard specification.
Usage note
: Used to describe contact information for Dataset and Dataset Series. This class is instantiated in these classes whenever the range is vcard:Kind
.
6.10.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
formatted name | The formatted text corresponding to the name of the object. | vcard:fn
| NA | xsd:string
| Provide the full name of the contact point, such as the name of a person or department responsible for communication. | 1 |
has email | To specify the electronic mail address for communication with the object. | vcard:hasEmail
| NA | rdfs:Resource
| When naming a contact point, this information needs to be further specified with additional information, i.e., an email address. This email address does not need to be a direct contact to the person responsible for the management of the data, it could be a generic information email. The email address has to be provided starting with mailto: prefix. For example: mailto:info@example.com / mailto:jane.doe@example.com
| 1 |
6.10.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
contact page | To specify a uniform resource locator associated with the object. | vcard:hasURL
| NA | rdfs:Resource
| A webpage that either allows to make contact (i.e. a webform) or the information contains how to get into contact. | 0..* |
6.11. Period of time
An interval of time that is named or defined by its start and end dates.
Usage note
: This class is instantiated by properties in other classes that have the range dct:PeriodOfTime
.
6.11.1. Mandatory Attributes
There are currently no mandatory properties for this class.
6.11.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
end date | The end of the period. | dcat:endDate
| NA | xsd:dateTime
| NA | 0..1 |
start date | The start of the period. | dcat:startDate
| NA | xsd:dateTime
| NA | 0..1 |
6.12. Quality certificate
An annotation that associates a resource (especially a dataset or a distribution) to another resource (for example, a document) that certifies the resource’s quality according to a set of quality assessment rules.
Usage note
: This class is instantiated by the property "quality annotation" (dqv:hasQualityAnnotation
) in other classes. Use this class to provide a link between the resource or dataset and an associated quality annotation.
6.12.1. Mandatory Attributes
There are currently no mandatory properties for this class.
6.12.2. Recommended Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
target | The relationship between an Annotation and its Target. | oa:hasTarget
| NA | rdfs:Resource (IRI)
| This property has to be filled with the same value as the dct:identifier of the dataset described, in order to link the quality certificate to that dataset. See also the example in HealthDCAT-AP.
| 0..1 |
body | The object of the relationship is a resource that is a body of the Annotation. | oa:hasBody
| NA | rdfs:Resource (IRI)
| IRI pointing to the location where the quality certificate can be found. | 0..1 |
6.13. Relationship
An association class for attaching additional information to a relationship between DCAT Resources.
Usage note
: This class is instantiated by the property "qualified relation" (dcat:qualifiedRelation
) in other classes. Use this class to describe a relationship with another resource or dataset. Within the class, that resource is indicated, as well as the role this resource has in relation to the described one. The role is indicated based on a controlled vocabulary.
6.13.1. Mandatory Attributes
Property name | Definition | URI | Controlled Vocabulary | rdfs:Range | Usage Note | Cardinality |
---|---|---|---|---|---|---|
had role | The function of an entity or agent with respect to another entity or resource. | dcat:hadRole
|
IANA Link Relations or ISO Codelist | skos:Concept (IRI)
| Specify, ideally with a value from the linked controlled vocabulary, the nature of the relationship between the linked resources. Example: http://www.iana.org/assignments/relation/related
| 1..* |
relation | A related resource. | dct:relation
| NA | rdfs:Resource (IRI)
| This property establishes the link between the described and the related resources. The value of this property is the IRI of the related resource. | 1..* |
6.13.2. Recommended Attributes
There are currently no recommended properties for this class.
7. Further Information
7.1. Model extension
This is a Health-RI core metadata schema, which means it is designed to be “minimal” and cover the basic metadata elements of catalogue resources. If you come from a specific working group or domain and see some of the important elements from your domain should be represented in the metadata, you could build an extension (or so-called petal) of this model for your domain’s specific needs. For more information on this, please check out the process description for domain-specific metadata.