diff --git a/_external/dcat-us b/_external/dcat-us index b38667363..d970980e2 160000 --- a/_external/dcat-us +++ b/_external/dcat-us @@ -1 +1 @@ -Subproject commit b3866736324aa8db9b2a1e82aa17de820804cb1f +Subproject commit d970980e2c45c5dde3c153009ecc76e28a65c7f8 diff --git a/pages/_data_standards/dcat-us-3/dataset.md b/pages/_data_standards/dcat-us-3/dataset.md index 215896910..1f5261c49 100644 --- a/pages/_data_standards/dcat-us-3/dataset.md +++ b/pages/_data_standards/dcat-us-3/dataset.md @@ -103,66 +103,70 @@ A collection of data published or curated by one provider } ``` -| Property | Type | Requirement Level | Title/Description | -| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [contactPoint](#contactPoint) | More than one type | Mandatory | A contact point for questions about the Dataset (single contact or list). Include an email address that is continuously monitored | -| [description](#description) | string | Mandatory | Plain-language summary of the dataset | -| [identifier](#identifier) | null or [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) | Mandatory | The unique identifier for the Dataset, e.g. the URI or other unique identifier in the context of the Catalog | -| [title](#title) | string | Mandatory | Human-readable title of the dataset | -| [describedBy](#describedBy) | null or [Distribution](/standards/catalog/dcat-us-3/distribution/#root) | Recommended | A distribution describing the Data Dictionary for this dataset | -| [distribution](#distribution) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Recommended | List of available distributions for the dataset. This can be omitted when no distribution is available yet. | -| [keyword](#keyword) | null or array of string | Recommended | List of keywords or tags describing the dataset | -| [landingPage](#landingPage) | null or [Document](/standards/catalog/dcat-us-3/quality-governance/#document) | Recommended | A web page from the original data provider that gives access to the Dataset, its Distributions, and related information | -| [modified](#modified) | null or object | Recommended | Most recent date when the dataset's actual data changed, not just metadata | -| [publisher](#publisher) | null or [Organization](/standards/catalog/dcat-us-3/agents/#organization) | Recommended | Organization responsible for publishing and making the dataset available | -| [rights](#rights) | null or array of string | Recommended | Rights statements not already covered by license or accessRights, such as copyright or policy restrictions | -| [spatial](#spatial) | More than one type | Recommended | A geographic region or regions that are covered by the Dataset | -| [temporal](#temporal) | null or array of [PeriodOfTime](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#period-of-time) classes | Recommended | Time periods covered by the dataset | -| [theme](#theme) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Recommended | List of themes or categories for the dataset | -| [@id](#@id) | string | Optional | | -| [@type](#@type) | string | Optional | | -| [accessRights](#accessRights) | null or string | Optional | Information about whether the dataset is publicly accessible, restricted, or not public | -| [accrualPeriodicity](#accrualPeriodicity) | More than one type | Optional | The frequency at which the Dataset is updated | -| [category](#category) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of high-level categories for the dataset | -| [conformsTo](#conformsTo) | null or array of [Standard](/standards/catalog/dcat-us-3/quality-governance/#standard) classes | Optional | List of standards, schemas, or profiles the dataset follows | -| [contributor](#contributor) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents contributing to the Dataset | -| [created](#created) | null or object | Optional | The date on which the Dataset was first created | -| [creator](#creator) | null or [Agent](/standards/catalog/dcat-us-3/agents/#agent) | Optional | Person or organization responsible for creating the dataset | -| [first](#first) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | the first item of the sequence the dataset belongs to | -| [hasCurrentVersion](#hasCurrentVersion) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | reference to the current (latest) version of a dataset | -| [hasPart](#hasPart) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related datasets that are part of the described dataset | -| [hasQualityMeasurement](#hasQualityMeasurement) | null or array of [QualityMeasurement](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#quality-measurement) classes | Optional | List of quality measurements for the dataset (for example, completeness, accuracy, or timeliness) beyond spatial or temporal resolution | -| [hasVersion](#hasVersion) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related Datasets that are a version, edition, or adaptation of the described Dataset | -| [image](#image) | null or string | Optional | Thumbnail image illustrating the dataset, especially useful for visual data such as maps, photos, or video | -| [inSeries](#inSeries) | null or array of [DatasetSeries](/standards/catalog/dcat-us-3/dataset-series/#root) classes | Optional | Dataset series this dataset belongs to | -| [isReferencedBy](#isReferencedBy) | null or array of string | Optional | List of links to related resources, such as publications, that reference, cite, or otherwise point to the Dataset | -| [issued](#issued) | null or object | Optional | Date when the dataset was first published. If the exact publication date is unknown, use the date it was first referenced in the catalog. | -| [language](#language) | More than one type | Optional | ISO 639-1 language code values used in the dataset text or metadata, such as en or es, full list can be seen at https://id.loc.gov/vocabulary/iso639-1.html | -| [liabilityStatement](#liabilityStatement) | null or string | Optional | A liability statement about the dataset that may clarify limitations of responsibility, qualifications on the accuracy, reliability, and completeness of the data, or absence of endorsement by the data publisher or provider, among other considerations | -| [metadataDistribution](#metadataDistribution) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Optional | Distribution of the original metadata document this dataset was derived from | -| [otherIdentifier](#otherIdentifier) | null or array of [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) classes | Optional | Additional identifiers for the dataset besides the main identifier, such as a DOI or other persistent ID | -| [page](#page) | null or array of [Document](/standards/catalog/dcat-us-3/quality-governance/#document) classes | Optional | List of pages or documents about this dataset | -| [previousVersion](#previousVersion) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | reference to the previous dataset version | -| [provenance](#provenance) | null or array of string | Optional | List of statements about the lineage of a Dataset, including any changes in its ownership or custody since its creation that may be significant for its authenticity, integrity, or interpretation | -| [purpose](#purpose) | null or string | Optional | The purpose of the dataset | -| [qualifiedAttribution](#qualifiedAttribution) | null or array of [Attribution](/standards/catalog/dcat-us-3/quality-governance/#attribution) classes | Optional | List of agents with specific responsibilities for the dataset | -| [qualifiedRelation](#qualifiedRelation) | null or array of [Relationship](/standards/catalog/dcat-us-3/identifiers-and-relationships/#relationship) classes | Optional | Detailed relationship between the dataset and another resource, including the role of that relationship | -| [relation](#relation) | null or array of string | Optional | List of links to related resources when the relationship is not otherwise specified | -| [replaces](#replaces) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of Datasets replaced by this Dataset | -| [rightsHolder](#rightsHolder) | null or array of [Organization](/standards/catalog/dcat-us-3/agents/#organization) classes | Optional | List of agents (organizations) holding rights on the Dataset | -| [sample](#sample) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Optional | List of sample distributions for the dataset | -| [scopeNote](#scopeNote) | null or string | Optional | usage note for the dataset | -| [source](#source) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related Datasets from which the described Dataset is derived | -| [spatialResolutionInMeters](#spatialResolutionInMeters) | null or string | Optional | Smallest spatial distance between data points, in meters, represented as a single value | -| [status](#status) | null or [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) | Optional | Lifecycle status of the dataset, such as completed, deprecated, under development, or withdrawn | -| [subject](#subject) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of primary subjects for the dataset, usually narrower than broad theme categories | -| [supportedSchema](#supportedSchema) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | supported schema for this dataset | -| [temporalResolution](#temporalResolution) | null or string | Optional | Smallest time interval between data points, using xsd:duration format (for example, P1D) | -| [version](#version) | null or string | Optional | The version indicator (name or identifier) of a resource | -| [versionNotes](#versionNotes) | null or string | Optional | Notes describing how this version differs from earlier versions of the dataset | -| [wasAttributedTo](#wasAttributedTo) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents attributed to this dataset | -| [wasGeneratedBy](#wasGeneratedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that generated, or provide the business context for the creation of the dataset | -| [wasUsedBy](#wasUsedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that used the Dataset | +| Property | Type | Requirement Level | Title/Description | +| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [contactPoint](#contactPoint) | More than one type | Mandatory | A contact point for questions about the Dataset (single contact or list). Include an email address that is continuously monitored | +| [description](#description) | string | Mandatory | Plain-language summary of the dataset | +| [identifier](#identifier) | null or [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) | Mandatory | The unique identifier for the Dataset, e.g. the URI or other unique identifier in the context of the Catalog | +| [title](#title) | string | Mandatory | Human-readable title of the dataset | +| [accessRestriction](#accessRestriction) | null or array of [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction) classes | Recommended | List of access restrictions related to the dataset | +| [cuiRestriction](#cuiRestriction) | null or [CUIRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#cui-restriction) | Recommended | Controlled Unclassified Information restriction related to the dataset | +| [describedBy](#describedBy) | null or [Distribution](/standards/catalog/dcat-us-3/distribution/#root) | Recommended | A distribution describing the Data Dictionary for this dataset | +| [distribution](#distribution) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Recommended | List of available distributions for the dataset. This can be omitted when no distribution is available yet. | +| [keyword](#keyword) | null or array of string | Recommended | List of keywords or tags describing the dataset | +| [landingPage](#landingPage) | null or [Document](/standards/catalog/dcat-us-3/quality-governance/#document) | Recommended | A web page from the original data provider that gives access to the Dataset, its Distributions, and related information | +| [license](#license) | null or string | Recommended | License that governs how the dataset can be used or reused | +| [modified](#modified) | null or object | Recommended | Most recent date when the dataset's actual data changed, not just metadata | +| [publisher](#publisher) | null or [Organization](/standards/catalog/dcat-us-3/agents/#organization) | Recommended | Organization responsible for publishing and making the dataset available | +| [rights](#rights) | null or array of string | Recommended | Rights statements not already covered by license or accessRights, such as copyright or policy restrictions | +| [spatial](#spatial) | More than one type | Recommended | A geographic region or regions that are covered by the Dataset | +| [temporal](#temporal) | null or array of [PeriodOfTime](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#period-of-time) classes | Recommended | Time periods covered by the dataset | +| [theme](#theme) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Recommended | List of themes or categories for the dataset | +| [useRestriction](#useRestriction) | null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes | Recommended | List of use restrictions related to the dataset | +| [@id](#@id) | string | Optional | | +| [@type](#@type) | string | Optional | | +| [accessRights](#accessRights) | null or string | Optional | Information about whether the dataset is publicly accessible, restricted, or not public | +| [accrualPeriodicity](#accrualPeriodicity) | More than one type | Optional | The frequency at which the Dataset is updated | +| [category](#category) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of high-level categories for the dataset | +| [conformsTo](#conformsTo) | null or array of [Standard](/standards/catalog/dcat-us-3/quality-governance/#standard) classes | Optional | List of standards, schemas, or profiles the dataset follows | +| [contributor](#contributor) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents contributing to the Dataset | +| [created](#created) | null or object | Optional | The date on which the Dataset was first created | +| [creator](#creator) | null or [Agent](/standards/catalog/dcat-us-3/agents/#agent) | Optional | Person or organization responsible for creating the dataset | +| [first](#first) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | the first item of the sequence the dataset belongs to | +| [hasCurrentVersion](#hasCurrentVersion) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | reference to the current (latest) version of a dataset | +| [hasPart](#hasPart) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related datasets that are part of the described dataset | +| [hasQualityMeasurement](#hasQualityMeasurement) | null or array of [QualityMeasurement](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#quality-measurement) classes | Optional | List of quality measurements for the dataset (for example, completeness, accuracy, or timeliness) beyond spatial or temporal resolution | +| [hasVersion](#hasVersion) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related Datasets that are a version, edition, or adaptation of the described Dataset | +| [image](#image) | null or string | Optional | Thumbnail image illustrating the dataset, especially useful for visual data such as maps, photos, or video | +| [inSeries](#inSeries) | null or array of [DatasetSeries](/standards/catalog/dcat-us-3/dataset-series/#root) classes | Optional | Dataset series this dataset belongs to | +| [isReferencedBy](#isReferencedBy) | null or array of string | Optional | List of links to related resources, such as publications, that reference, cite, or otherwise point to the Dataset | +| [issued](#issued) | null or object | Optional | Date when the dataset was first published. If the exact publication date is unknown, use the date it was first referenced in the catalog. | +| [language](#language) | More than one type | Optional | ISO 639-1 language code values used in the dataset text or metadata, such as en or es, full list can be seen at https://id.loc.gov/vocabulary/iso639-1.html | +| [liabilityStatement](#liabilityStatement) | null or string | Optional | A liability statement about the dataset that may clarify limitations of responsibility, qualifications on the accuracy, reliability, and completeness of the data, or absence of endorsement by the data publisher or provider, among other considerations | +| [metadataDistribution](#metadataDistribution) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Optional | Distribution of the original metadata document this dataset was derived from | +| [otherIdentifier](#otherIdentifier) | null or array of [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) classes | Optional | Additional identifiers for the dataset besides the main identifier, such as a DOI or other persistent ID | +| [page](#page) | null or array of [Document](/standards/catalog/dcat-us-3/quality-governance/#document) classes | Optional | List of pages or documents about this dataset | +| [previousVersion](#previousVersion) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | reference to the previous dataset version | +| [provenance](#provenance) | null or array of string | Optional | List of statements about the lineage of a Dataset, including any changes in its ownership or custody since its creation that may be significant for its authenticity, integrity, or interpretation | +| [purpose](#purpose) | null or string | Optional | The purpose of the dataset | +| [qualifiedAttribution](#qualifiedAttribution) | null or array of [Attribution](/standards/catalog/dcat-us-3/quality-governance/#attribution) classes | Optional | List of agents with specific responsibilities for the dataset | +| [qualifiedRelation](#qualifiedRelation) | null or array of [Relationship](/standards/catalog/dcat-us-3/identifiers-and-relationships/#relationship) classes | Optional | Detailed relationship between the dataset and another resource, including the role of that relationship | +| [relation](#relation) | null or array of string | Optional | List of links to related resources when the relationship is not otherwise specified | +| [replaces](#replaces) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of Datasets replaced by this Dataset | +| [rightsHolder](#rightsHolder) | null or array of [Organization](/standards/catalog/dcat-us-3/agents/#organization) classes | Optional | List of agents (organizations) holding rights on the Dataset | +| [sample](#sample) | null or array of [Distribution](/standards/catalog/dcat-us-3/distribution/#root) classes | Optional | List of sample distributions for the dataset | +| [scopeNote](#scopeNote) | null or string | Optional | usage note for the dataset | +| [source](#source) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Optional | List of related Datasets from which the described Dataset is derived | +| [spatialResolutionInMeters](#spatialResolutionInMeters) | null or string | Optional | Smallest spatial distance between data points, in meters, represented as a single value | +| [status](#status) | null or [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) | Optional | Lifecycle status of the dataset, such as completed, deprecated, under development, or withdrawn | +| [subject](#subject) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of primary subjects for the dataset, usually narrower than broad theme categories | +| [supportedSchema](#supportedSchema) | null or [Dataset](/standards/catalog/dcat-us-3/dataset/#root) | Optional | supported schema for this dataset | +| [temporalResolution](#temporalResolution) | null or string | Optional | Smallest time interval between data points, using xsd:duration format (for example, P1D) | +| [version](#version) | null or string | Optional | The version indicator (name or identifier) of a resource | +| [versionNotes](#versionNotes) | null or string | Optional | Notes describing how this version differs from earlier versions of the dataset | +| [wasAttributedTo](#wasAttributedTo) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents attributed to this dataset | +| [wasGeneratedBy](#wasGeneratedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that generated, or provide the business context for the creation of the dataset | +| [wasUsedBy](#wasUsedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that used the Dataset | ## `Dataset > contactPoint` [#](#contactPoint) @@ -240,6 +244,25 @@ Human-readable title of the dataset "National Climate Observations 2024" ``` +## `Dataset > accessRestriction` [#](#accessRestriction) + +**Requirement:** Recommended + +List of access restrictions related to the dataset + +- **Type**: null or array of [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction) classes + +**Each item of this array must be:** +- [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction): Rules or indicators that describe who can access a resource + +## `Dataset > cuiRestriction` [#](#cuiRestriction) + +**Requirement:** Recommended + +Controlled Unclassified Information restriction related to the dataset + +- **Type**: null or [CUIRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#cui-restriction) + ## `Dataset > describedBy` [#](#describedBy) **Title:** data dictionary @@ -314,6 +337,20 @@ A web page from the original data provider that gives access to the Dataset, its - **Type**: null or [Document](/standards/catalog/dcat-us-3/quality-governance/#document) +## `Dataset > license` [#](#license) + +**Requirement:** Recommended + +License that governs how the dataset can be used or reused + +- **Type**: null or string + +**Example:** + +```json +"https://creativecommons.org/publicdomain/zero/1.0/" +``` + ## `Dataset > modified` [#](#modified) **Title:** last modified @@ -442,6 +479,17 @@ List of themes or categories for the dataset **Each item of this array must be:** - [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept): A controlled term or label, optionally drawn from a concept scheme +## `Dataset > useRestriction` [#](#useRestriction) + +**Requirement:** Recommended + +List of use restrictions related to the dataset + +- **Type**: null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes + +**Each item of this array must be:** +- [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction): Rules or legal limits on how a resource may be used + ## `Dataset > @id` [#](#@id) **Requirement:** Optional diff --git a/pages/_data_standards/dcat-us-3/distribution.md b/pages/_data_standards/dcat-us-3/distribution.md index f0cd991ae..2e940d1a4 100644 --- a/pages/_data_standards/dcat-us-3/distribution.md +++ b/pages/_data_standards/dcat-us-3/distribution.md @@ -32,7 +32,7 @@ A specific representation of a dataset, such as a file, feed, or API response "No rights reserved. This data is in the public domain." ], "describedBy": { - "@type": "Standard", + "@type": "Distribution", "title": "CSV Data Dictionary", "accessURL": "https://example.gov/data/climate/dictionary" }, @@ -54,7 +54,7 @@ A specific representation of a dataset, such as a file, feed, or API response | [modified](#modified) | null or object | Recommended | The most recent date on which the Distribution was changed or modified | | [rights](#rights) | null or array of string | Recommended | Rights statements not already covered by license or accessRights, such as copyright or policy restrictions | | [title](#title) | null or string | Recommended | Human-readable title of the distribution | -| [useRestriction](#useRestriction) | null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes | Recommended | Use restriction related to the distribution | +| [useRestriction](#useRestriction) | null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes | Recommended | List of use restrictions related to the distribution | | [@id](#@id) | string | Optional | | | [@type](#@type) | string | Optional | | | [accessRights](#accessRights) | null or string | Optional | Information about whether the distribution is publicly accessible, restricted, or not public | @@ -254,7 +254,7 @@ Human-readable title of the distribution **Requirement:** Recommended -Use restriction related to the distribution +List of use restrictions related to the distribution - **Type**: null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes diff --git a/pages/_data_standards/dcat-us-3/quality-governance.md b/pages/_data_standards/dcat-us-3/quality-governance.md index 5d5038691..a50ec1b91 100644 --- a/pages/_data_standards/dcat-us-3/quality-governance.md +++ b/pages/_data_standards/dcat-us-3/quality-governance.md @@ -930,38 +930,41 @@ A service that provides access to data or data processing functions } ``` -| Property | Type | Requirement Level | Title/Description | -| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| [contactPoint](#data-service--contactPoint) | array of [Kind](/standards/catalog/dcat-us-3/agents/#kind) classes | Mandatory | Contact information for questions about the Data Service. Include an email address that is continuously monitored | -| [endpointURL](#data-service--endpointURL) | array of string | Mandatory | A list of root locations or primary endpoints of the service (a Web-resolvable IRI) | -| [publisher](#data-service--publisher) | object | Mandatory | Person or organization responsible for publishing and making the data service available | -| [title](#data-service--title) | string | Mandatory | Human-readable title of the data service | -| [endpointDescription](#data-service--endpointDescription) | null or array of string | Recommended | List of endpoint descriptions with operations and parameters (for example, OpenAPI or similar service documentation) | -| [license](#data-service--license) | null or string | Recommended | License that governs how the data service can be used or reused | -| [servesDataset](#data-service--servesDataset) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Recommended | List of datasets this service provides access to | -| [@id](#data-service--@id) | string | Optional | | -| [@type](#data-service--@type) | string | Optional | | -| [accessRights](#data-service--accessRights) | null or string | Optional | Information about whether the data service is publicly accessible, restricted, or not public | -| [category](#data-service--category) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of high-level categories for the data service | -| [conformsTo](#data-service--conformsTo) | null or array of [Standard](/standards/catalog/dcat-us-3/quality-governance/#standard) classes | Optional | List of general standards or specifications that the Data Service endpoints implement | -| [created](#data-service--created) | null or object | Optional | The date on which the Data Service was first created | -| [creator](#data-service--creator) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents primarily responsible for producing the Data Service | -| [description](#data-service--description) | null or string | Optional | Plain-language summary of the data service | -| [hasQualityMeasurement](#data-service--hasQualityMeasurement) | null or array of [QualityMeasurement](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#quality-measurement) classes | Optional | Quality measurements for the data service (for example, availability, response time, or reliability) | -| [identifier](#data-service--identifier) | null or [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) | Optional | The unique identifier for the Data Service, e.g. the URI or other unique identifier in the context of the Catalog | -| [keyword](#data-service--keyword) | null or array of string | Optional | List of keywords or tags describing the data service | -| [language](#data-service--language) | More than one type | Optional | ISO 639-1 language code values supported by the data service, such as en or es, full list can be seen at https://id.loc.gov/vocabulary/iso639-1.html | -| [modified](#data-service--modified) | null or object | Optional | The most recent date on which the Data Service was changed or modified | -| [otherIdentifier](#data-service--otherIdentifier) | null or array of [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) classes | Optional | A list of identifiers for the Data Service besides the main identifier, e.g. the URI or other unique identifiers in the context of the Catalog | -| [qualifiedAttribution](#data-service--qualifiedAttribution) | null or array of [Attribution](/standards/catalog/dcat-us-3/quality-governance/#attribution) classes | Optional | List of agents with specific responsibilities for the data service | -| [rights](#data-service--rights) | null or array of string | Optional | Rights statements not already covered by license or accessRights, such as copyright or policy restrictions | -| [rightsHolder](#data-service--rightsHolder) | null or array of [Organization](/standards/catalog/dcat-us-3/agents/#organization) classes | Optional | A list of Agents (organizations) holding rights on the Data Service | -| [spatial](#data-service--spatial) | null or array of [Location](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#location) classes | Optional | A geographic region that is covered by the Data Service | -| [spatialResolutionInMeters](#data-service--spatialResolutionInMeters) | null or string | Optional | The minimum spatial separation resolvable in a Data Service, measured in meters | -| [temporal](#data-service--temporal) | null or array of [PeriodOfTime](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#period-of-time) classes | Optional | Time periods covered by the data service | -| [temporalResolution](#data-service--temporalResolution) | null or string | Optional | The minimum time period resolvable by the Data Service | -| [theme](#data-service--theme) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of themes or categories for the data service | -| [wasUsedBy](#data-service--wasUsedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that used or tested the data service | +| Property | Type | Requirement Level | Title/Description | +| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| [contactPoint](#data-service--contactPoint) | array of [Kind](/standards/catalog/dcat-us-3/agents/#kind) classes | Mandatory | Contact information for questions about the Data Service. Include an email address that is continuously monitored | +| [endpointURL](#data-service--endpointURL) | array of string | Mandatory | A list of root locations or primary endpoints of the service (a Web-resolvable IRI) | +| [publisher](#data-service--publisher) | object | Mandatory | Person or organization responsible for publishing and making the data service available | +| [title](#data-service--title) | string | Mandatory | Human-readable title of the data service | +| [endpointDescription](#data-service--endpointDescription) | null or array of string | Recommended | List of endpoint descriptions with operations and parameters (for example, OpenAPI or similar service documentation) | +| [license](#data-service--license) | null or string | Recommended | License that governs how the data service can be used or reused | +| [servesDataset](#data-service--servesDataset) | null or array of [Dataset](/standards/catalog/dcat-us-3/dataset/#root) classes | Recommended | List of datasets this service provides access to | +| [@id](#data-service--@id) | string | Optional | | +| [@type](#data-service--@type) | string | Optional | | +| [accessRestriction](#data-service--accessRestriction) | null or array of [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction) classes | Optional | List of access restrictions related to the data service | +| [accessRights](#data-service--accessRights) | null or string | Optional | Information about whether the data service is publicly accessible, restricted, or not public | +| [category](#data-service--category) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of high-level categories for the data service | +| [conformsTo](#data-service--conformsTo) | null or array of [Standard](/standards/catalog/dcat-us-3/quality-governance/#standard) classes | Optional | List of general standards or specifications that the Data Service endpoints implement | +| [created](#data-service--created) | null or object | Optional | The date on which the Data Service was first created | +| [creator](#data-service--creator) | null or array of [Agent](/standards/catalog/dcat-us-3/agents/#agent) classes | Optional | List of agents primarily responsible for producing the Data Service | +| [cuiRestriction](#data-service--cuiRestriction) | null or [CUIRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#cui-restriction) | Optional | Controlled Unclassified Information restriction related to the data service | +| [description](#data-service--description) | null or string | Optional | Plain-language summary of the data service | +| [hasQualityMeasurement](#data-service--hasQualityMeasurement) | null or array of [QualityMeasurement](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#quality-measurement) classes | Optional | Quality measurements for the data service (for example, availability, response time, or reliability) | +| [identifier](#data-service--identifier) | null or [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) | Optional | The unique identifier for the Data Service, e.g. the URI or other unique identifier in the context of the Catalog | +| [keyword](#data-service--keyword) | null or array of string | Optional | List of keywords or tags describing the data service | +| [language](#data-service--language) | More than one type | Optional | ISO 639-1 language code values supported by the data service, such as en or es, full list can be seen at https://id.loc.gov/vocabulary/iso639-1.html | +| [modified](#data-service--modified) | null or object | Optional | The most recent date on which the Data Service was changed or modified | +| [otherIdentifier](#data-service--otherIdentifier) | null or array of [Identifier](/standards/catalog/dcat-us-3/identifiers-and-relationships/#identifier) classes | Optional | A list of identifiers for the Data Service besides the main identifier, e.g. the URI or other unique identifiers in the context of the Catalog | +| [qualifiedAttribution](#data-service--qualifiedAttribution) | null or array of [Attribution](/standards/catalog/dcat-us-3/quality-governance/#attribution) classes | Optional | List of agents with specific responsibilities for the data service | +| [rights](#data-service--rights) | null or array of string | Optional | Rights statements not already covered by license or accessRights, such as copyright or policy restrictions | +| [rightsHolder](#data-service--rightsHolder) | null or array of [Organization](/standards/catalog/dcat-us-3/agents/#organization) classes | Optional | A list of Agents (organizations) holding rights on the Data Service | +| [spatial](#data-service--spatial) | null or array of [Location](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#location) classes | Optional | A geographic region that is covered by the Data Service | +| [spatialResolutionInMeters](#data-service--spatialResolutionInMeters) | null or string | Optional | The minimum spatial separation resolvable in a Data Service, measured in meters | +| [temporal](#data-service--temporal) | null or array of [PeriodOfTime](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#period-of-time) classes | Optional | Time periods covered by the data service | +| [temporalResolution](#data-service--temporalResolution) | null or string | Optional | The minimum time period resolvable by the Data Service | +| [theme](#data-service--theme) | null or array of [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept) classes | Optional | List of themes or categories for the data service | +| [useRestriction](#data-service--useRestriction) | null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes | Optional | List of use restrictions related to the data service | +| [wasUsedBy](#data-service--wasUsedBy) | null or array of [Activity](/standards/catalog/dcat-us-3/temporal-spatial-metrics/#activity) classes | Optional | List of activities that used or tested the data service | ## `DataService > contactPoint` [#](#data-service--contactPoint) @@ -1109,6 +1112,17 @@ List of datasets this service provides access to - **Type**: `string` - **Default**: `"DataService"` +## `DataService > accessRestriction` [#](#data-service--accessRestriction) + +**Requirement:** Optional + +List of access restrictions related to the data service + +- **Type**: null or array of [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction) classes + +**Each item of this array must be:** +- [AccessRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#access-restriction): Rules or indicators that describe who can access a resource + ## `DataService > accessRights` [#](#data-service--accessRights) **Requirement:** Optional @@ -1184,6 +1198,14 @@ List of agents primarily responsible for producing the Data Service **Each item of this array must be:** - [Agent](/standards/catalog/dcat-us-3/agents/#agent): A person, organization, software agent, or other entity involved with a resource +## `DataService > cuiRestriction` [#](#data-service--cuiRestriction) + +**Requirement:** Optional + +Controlled Unclassified Information restriction related to the data service + +- **Type**: null or [CUIRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#cui-restriction) + ## `DataService > description` [#](#data-service--description) **Requirement:** Optional @@ -1462,6 +1484,17 @@ List of themes or categories for the data service **Each item of this array must be:** - [Concept](/standards/catalog/dcat-us-3/identifiers-and-relationships/#concept): A controlled term or label, optionally drawn from a concept scheme +## `DataService > useRestriction` [#](#data-service--useRestriction) + +**Requirement:** Optional + +List of use restrictions related to the data service + +- **Type**: null or array of [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction) classes + +**Each item of this array must be:** +- [UseRestriction](/standards/catalog/dcat-us-3/constraints-and-restrictions/#use-restriction): Rules or legal limits on how a resource may be used + ## `DataService > wasUsedBy` [#](#data-service--wasUsedBy) **Requirement:** Optional