NDE Catalogusbeschrijving
Profile for describing data catalogs according to NDE requirements.
Describe one data catalog according to NDE requirements.
A data catalog is a curated collection of dataset descriptions. The NDE Dataset Register discovers datasets by crawling catalog IRIs: it follows the catalog document to find all listed datasets, then validates and indexes each one. Fill in the Catalog IRI and link all datasets before publishing. For large catalogs (over 1,000 datasets), use the pagination fields to split the dataset list across multiple pages using the Hydra Core Vocabulary.
Based on
- NDE Requirements for datasets: Netwerk Digitaal Erfgoed requirements for dataset and data catalog descriptions.
| Schema | https://sidedoc.app/schemas/0.2.0/nde-data-catalog-description.json |
| Profile id | nde:v00002 |
| Version | 0.2.0 |
| Help file | help/docs.nde-data-catalog-description.json |
| Exports | dcat-ap-3.0.1 |
| Fields | 10 |
| Help | 10 of 10 fields have a short text, 10 an extended text, 0 a tooltip and 0 details (English). |
The schema's own version is 0.2.0: this bundle carries the profile unchanged from that version.
Types link to the type library. For what each fact means, see x-sidedoc keys and sheet columns.
Fields
| Field | Id | Type | Values | Required |
|---|---|---|---|---|
| Catalog metadata | nde:s01100 | string | 0..1 | |
| Catalog IRI | nde:f02400 | Url | 1..1 | yes |
| Catalog name | nde:f02500 | Literal | 1..1 | yes |
| Catalog description | nde:f02600 | Literal | 0..1 | |
| Catalog publisher | nde:f02700 | Agent | 0..1 | |
| Catalog dataset | nde:f02800 | Url | 1..* | yes |
| Catalog navigation | nde:s01200 | string | 0..1 | |
| First page | nde:f02900 | Url | 0..1 | |
| Next page | nde:f03000 | Url | 0..1 | |
| Last page | nde:f03100 | Url | 0..1 |
Field reference
Catalog metadata
| Id | nde:s01100 |
| Path | catalogMetadata |
| Type | string |
| Multilingual | no |
| Sub-fields | Catalog IRI, Catalog name, Catalog description, Catalog publisher, Catalog dataset |
Tooltip (level 1)
Not written yet.
Short help (level 2)
Core identity and ownership metadata for the catalog.
Extended help (level 3)
Include the catalog IRI, multilingual name and description, publisher, and the list of dataset IRIs that belong to this catalog. The catalog IRI is the entry point the NDE register crawls — fill it in first.
Details (level 4)
Not written yet.
Catalog IRI
| Id | nde:f02400 |
| Path | catalogMetadata.id |
| Type | Url |
| Values | 1..1 (required, one value) |
| Multilingual | no |
| UI hint | url |
| Validation | href: Starts with http:// or https:// ^https?:\/\/.+$As written in the sheet: {"href":"/^https?:\\/\\/.+$/"} |
| Part of | Catalog metadata |
Tooltip (level 1)
Not written yet.
Short help (level 2)
Permanent HTTP(S) identifier for this catalog — the entry point for NDE register crawling.
Extended help (level 3)
The catalog IRI must be a stable, resolvable HTTP or HTTPS URL. The NDE Dataset Register uses this IRI to periodically crawl the catalog, validate its contents, and update the dataset index. In DCAT-AP 3.0, this is the catalog URI used as the @id of the dcat:Catalog resource. From v2.0, the IRI must be an HTTP IRI (not a blank node or literal). The catalog IRI should point to a machine-readable RDF document containing the catalog description and its dataset list.
Details (level 4)
Not written yet.
Catalog name
| Id | nde:f02500 |
| Path | catalogMetadata.name |
| Type | Literal |
| Values | 1..1 (required, one value) |
| Multilingual | yes |
| Part of | Catalog metadata |
Tooltip (level 1)
Not written yet.
Short help (level 2)
Official name of this data catalog. Provide at least one language variant.
Extended help (level 3)
The catalog name identifies this collection in the NDE register, search results, and portal UIs. From v2.0 onwards, language-tagged strings become mandatory. The field is repeatable for multilingual names. In DCAT-AP 3.0, this is dct:title with cardinality 1..* (one or more, for multilingual support).
Details (level 4)
Not written yet.
Catalog description
| Id | nde:f02600 |
| Path | catalogMetadata.description |
| Type | Literal |
| Values | 0..1 (optional, one value) |
| Multilingual | yes |
| Part of | Catalog metadata |
Tooltip (level 1)
Not written yet.
Short help (level 2)
What this catalog contains — its scope, thematic focus, and institutional context. Currently recommended; required from NDE v2.0.
Extended help (level 3)
The catalog description helps users understand whether this collection is relevant before drilling into individual dataset records. Explain the scope, thematic focus, and institutional context. Aim for at least three sentences. Follow the same guidance as for dataset descriptions. Language-tagged strings will be mandatory from v2.0.
Details (level 4)
Not written yet.
Catalog publisher
| Id | nde:f02700 |
| Path | catalogMetadata.publisher |
| Type | Agent |
| Values | 0..1 (optional, one value) |
| Multilingual | no |
| Part of | Catalog metadata |
Tooltip (level 1)
Not written yet.
Short help (level 2)
Organisation or person responsible for publishing and maintaining this catalog.
Extended help (level 3)
The catalog publisher is accountable for the catalog's contents and ensures it stays up to date. Must be described with at minimum an HTTP IRI (@id) and a name. In DCAT-AP 3.0, dct:publisher is mandatory for catalogs (cardinality 1) and is defined as 'entity (organisation) responsible for making the Catalogue available'. Use the same schema:Organization structure as for dataset publishers.
Details (level 4)
Not written yet.
Catalog dataset
| Id | nde:f02800 |
| Path | catalogMetadata.dataset |
| Type | Url |
| Values | 1..* (required, repeatable) |
| Multilingual | no |
| UI hint | url |
| Validation | href: Starts with http:// or https:// ^https?:\/\/.+$As written in the sheet: {"href":"/^https?:\\/\\/.+$/"} |
| Part of | Catalog metadata |
Tooltip (level 1)
Not written yet.
Short help (level 2)
IRI of a dataset that is part of this catalog. Add one entry per dataset.
Extended help (level 3)
Each value is the IRI of a dataset description document that belongs to this catalog. The NDE register crawler follows these IRIs to discover, validate, and index each dataset. In DCAT-AP 3.0, this is dcat:dataset linking a dcat:Catalog to its member dcat:Dataset resources. For large catalogs, split the dataset list across paginated pages (see Catalog navigation) with a maximum of 1,000 datasets per page.
Details (level 4)
Not written yet.
Catalog navigation
| Id | nde:s01200 |
| Path | catalogNavigation |
| Type | string |
| Multilingual | no |
| Sub-fields | First page, Next page, Last page |
Tooltip (level 1)
Not written yet.
Short help (level 2)
Pagination links for large catalogs using the Hydra Core Vocabulary.
Extended help (level 3)
Use these fields when the catalog contains more than 1,000 datasets and must be split across multiple pages. The NDE specification requires using the Hydra Core Vocabulary for linked-data pagination. Each page must be a complete, self-contained RDF document. The NDE register crawler follows hydra:next links to index all datasets across a multi-page catalog.
Details (level 4)
Not written yet.
First page
| Id | nde:f02900 |
| Path | catalogNavigation.first |
| Type | Url |
| Values | 0..1 (optional, one value) |
| Multilingual | no |
| UI hint | url |
| Validation | href: Starts with http:// or https:// ^https?:\/\/.+$As written in the sheet: {"href":"/^https?:\\/\\/.+$/"} |
| Part of | Catalog navigation |
Tooltip (level 1)
Not written yet.
Short help (level 2)
URI of the first page in a paginated catalog (hydra:first).
Extended help (level 3)
hydra:first points to the first page of the catalog's dataset list. Include this on all pages of a paginated catalog so consumers can always navigate to the start. The pagination structure uses the Hydra Core Vocabulary, which is an NDE-specific extension — it is not part of the DCAT-AP specification.
Details (level 4)
Not written yet.
Next page
| Id | nde:f03000 |
| Path | catalogNavigation.next |
| Type | Url |
| Values | 0..1 (optional, one value) |
| Multilingual | no |
| UI hint | url |
| Validation | href: Starts with http:// or https:// ^https?:\/\/.+$As written in the sheet: {"href":"/^https?:\\/\\/.+$/"} |
| Part of | Catalog navigation |
Tooltip (level 1)
Not written yet.
Short help (level 2)
URI of the next page in a paginated catalog sequence (hydra:next).
Extended help (level 3)
hydra:next links each catalog page to the following one, enabling sequential traversal by the NDE register crawler. Each page must contain a complete RDF document for its portion of the dataset list. Omit this property on the last page of the catalog.
Details (level 4)
Not written yet.
Last page
| Id | nde:f03100 |
| Path | catalogNavigation.last |
| Type | Url |
| Values | 0..1 (optional, one value) |
| Multilingual | no |
| UI hint | url |
| Validation | href: Starts with http:// or https:// ^https?:\/\/.+$As written in the sheet: {"href":"/^https?:\\/\\/.+$/"} |
| Part of | Catalog navigation |
Tooltip (level 1)
Not written yet.
Short help (level 2)
URI of the last page in a paginated catalog sequence (hydra:last).
Extended help (level 3)
hydra:last allows consumers to jump directly to the end of a paginated dataset list without traversing every intermediate page. Recommended alongside hydra:first and hydra:next to form a complete Hydra Core Vocabulary pagination structure. Optional but recommended as a navigation aid for clients harvesting large catalogs.
Details (level 4)
Not written yet.