Skip to main content

Interface: IDataspaceProtocolDataset

Dataset interface compliant with Eclipse Data Space Protocol.

This interface extends IDataset and enforces DS Protocol-specific requirements by overriding properties with more specific types and constraints.

Requirements per DS Protocol:

  • @id MUST be present for dataset identification (REQUIRED)
  • odrl:hasPolicy MUST be present as an array of ODRL Offers (REQUIRED)
  • Array MUST contain at least one IOdrlOffer
  • Each Offer MUST have @type: "Offer"
  • Each Offer MUST have @id
  • dcat:distribution MUST be present (REQUIRED)

Type System Design:

  • W3C DCAT spec defines odrl:hasPolicy as optional singular IOdrlPolicy
  • DS Protocol requires it as a REQUIRED array of IOdrlOffer
  • Interface extension allows TypeScript to override inherited property types
  • Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly
  • DS Protocol-specific constraints are defined here

Future Compatibility:

  • Currently only one Offer per dataset is supported
  • Array structure allows future support for multiple offers

See​

Extends​

Properties​

@context​

@context: DataspaceProtocolContextType

LD Context. Required per Eclipse Data Space Protocol.

@type​

@type: "Dataset"

The type identifier for the dataset. REQUIRED per Eclipse Data Space Protocol.

Inherited from​

IDataspaceProtocolDataset.@type

@id​

@id: string

Unique identifier for the dataset. REQUIRED per Eclipse Data Space Protocol.

Inherited from​

IDataspaceProtocolDatasetBase.@id

hasPolicy​

hasPolicy: IDataspaceProtocolOfferBase[]

Array of ODRL policies (Offers) as required by DS Protocol.

REQUIRED per Eclipse Data Space Protocol spec. Must contain at least one IOdrlOffer. Currently only single offer is supported, but array structure allows for future multi-offer support.

Inherited from​

IDataspaceProtocolDatasetBase.hasPolicy

distribution​

distribution: IDataspaceProtocolDistributionBase[]

Distribution of the dataset. REQUIRED per Eclipse Data Space Protocol.

Inherited from​

IDataspaceProtocolDatasetBase.distribution

dcterms:accrualPeriodicity?​

optional dcterms:accrualPeriodicity?: string

The frequency at which the dataset is published.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_frequency

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:accrualPeriodicity

dcat:inSeries?​

optional dcat:inSeries?: string

A dataset series of which the dataset is part.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_in_series

Inherited from​

IDataspaceProtocolDatasetBase.dcat:inSeries

dcterms:spatial?​

optional dcterms:spatial?: string | string[] | IJsonLdNodeObject

The geographical area covered by the dataset.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_spatial

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:spatial

dcat:spatialResolutionInMeters?​

optional dcat:spatialResolutionInMeters?: number

Minimum spatial separation resolvable in a dataset, measured in meters.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_spatial_resolution

Inherited from​

IDataspaceProtocolDatasetBase.dcat:spatialResolutionInMeters

dcterms:temporal?​

optional dcterms:temporal?: IDublinCorePeriodOfTime

The temporal period that the dataset covers.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_temporal

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:temporal

dcat:temporalResolution?​

optional dcat:temporalResolution?: string

Minimum time period resolvable in the dataset.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_temporal_resolution

Inherited from​

IDataspaceProtocolDatasetBase.dcat:temporalResolution

prov:wasGeneratedBy?​

optional prov:wasGeneratedBy?: string | IJsonLdNodeObject

An activity that generated, or provides the business context for, the creation of the dataset.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:dataset_was_generated_by

Inherited from​

IDataspaceProtocolDatasetBase.prov:wasGeneratedBy

dcterms:title?​

optional dcterms:title?: ObjectOrArray<string>

A name given to the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_title

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:title

dcterms:description?​

optional dcterms:description?: ObjectOrArray<string>

A free-text account of the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_description

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:description

dcterms:identifier?​

optional dcterms:identifier?: ObjectOrArray<string>

A unique identifier of the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_identifier

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:identifier

dcterms:issued?​

optional dcterms:issued?: string

Date of formal issuance (publication) of the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_release_date

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:issued

dcterms:modified?​

optional dcterms:modified?: string

Most recent date on which the resource was changed, updated or modified.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_update_date

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:modified

dcterms:language?​

optional dcterms:language?: ObjectOrArray<string>

A language of the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_language

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:language

dcterms:publisher?​

optional dcterms:publisher?: string | IFoafAgentWithAliases

An entity responsible for making the resource available.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_publisher

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:publisher

dcterms:creator?​

optional dcterms:creator?: string | IFoafAgentWithAliases

An entity responsible for producing the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_creator

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:creator

dcterms:accessRights?​

optional dcterms:accessRights?: string | IJsonLdNodeObject

Information about who can access the resource or an indication of its security status.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_access_rights

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:accessRights

dcterms:license?​

optional dcterms:license?: string | IJsonLdNodeObject

A legal document under which the resource is made available.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_license

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:license

dcterms:rights?​

optional dcterms:rights?: string | IJsonLdNodeObject

Information about rights held in and over the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_rights

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:rights

dcterms:conformsTo?​

optional dcterms:conformsTo?: ObjectOrArray<string>

An established standard to which the resource conforms.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_conforms_to

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:conformsTo

dcterms:type?​

optional dcterms:type?: string

The nature or genre of the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_type

Inherited from​

IDataspaceProtocolDatasetBase.dcterms:type

dcat:contactPoint?​

optional dcat:contactPoint?: string | IJsonLdNodeObject

Relevant contact information for the catalogued resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_contact_point

Inherited from​

IDataspaceProtocolDatasetBase.dcat:contactPoint

dcat:keyword?​

optional dcat:keyword?: ObjectOrArray<string>

A keyword or tag describing the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_keyword

Inherited from​

IDataspaceProtocolDatasetBase.dcat:keyword

dcat:theme?​

optional dcat:theme?: ObjectOrArray<string>

A main category of the resource. A resource can have multiple themes.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_theme

Inherited from​

IDataspaceProtocolDatasetBase.dcat:theme

dcat:landingPage?​

optional dcat:landingPage?: ObjectOrArray<string>

A Web page that can be navigated to gain access to the resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_landing_page

Inherited from​

IDataspaceProtocolDatasetBase.dcat:landingPage

dcat:qualifiedRelation?​

optional dcat:qualifiedRelation?: string | IDcatRelationship

Link to a description of a relationship with another resource.

See​

https://www.w3.org/TR/vocab-dcat-3/#Property:resource_qualified_relation

Inherited from​

IDataspaceProtocolDatasetBase.dcat:qualifiedRelation