Saltar al contenido principal

Dataspace Publish

Category: Integration
Node id: dataspace-publish

Standards: IDSA-DSP, GAIA-X, GDPR

Register this pipeline's output as an IDS/GAIA-X dataspace asset so external consumers can discover and pull it via the Dataspace Protocol (DSP)

What it does​

  • IDS Dataspace Protocol (DSP) asset registration
  • Idempotent — skips creation if the asset already exists
  • Auto-derives asset ID from pipeline ID when not configured
  • Supports GAIA-X and IDSA data sovereignty contracts

Use cases​

  • Expose a clinical pipeline's FHIR output to partner organisations via the dataspace
  • Register a real-time wearables pipeline as a dataspace product for research consumers
  • Publish anonymized patient cohort data to a health data space

Runtime​

  • Performance tier: medium

Input ports​

NameTypeRequiredDescription
dataanyNoPipeline data to publish (passed through to output unchanged)

Output ports​

NameTypeRequiredDescription
asset_idtextNoDataspace asset ID assigned to this pipeline
catalog_urltextNoURL of the asset in the dataspace catalog
pipeline_idtextNoHydra pipeline ID linked to the asset
registeredbooleanNoTrue if the asset was newly created, false if it already existed
successbooleanNoWhether registration succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Dataspace Service URLdataspace_urlstringYesBase URL of the TietAI dataspace connector (e.g. https://dataspace.tiet.ai)
Asset Nameasset_namestringYesHuman-readable name for this data asset in the dataspace catalog
Asset DescriptiondescriptionstringNoDescription of the data asset for catalog consumers

Auth​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Dataspace API Keyapi_keysecretNoManagement API key for the dataspace service

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Asset IDasset_idstringNoCustom asset ID (leave blank to auto-generate from pipeline ID as 'hydra-<pipeline_id>')
Pipeline IDpipeline_idstringNoHydra pipeline ID whose outputs are exposed (auto-detected from execution context if blank)
Content Typecontent_typestringNoapplication/jsonMIME type of the pipeline output (default: application/json)

Errors​

CodeDescription
MISSING_DATASPACE_URLdataspace_url config field is empty
MISSING_ASSET_NAMEasset_name config field is empty
MISSING_PIPELINE_IDpipeline_id not in config and not available from execution context
ASSET_CREATE_FAILEDDataspace management API returned an error when creating the asset

Runtime notes​

  • The node registers the pipeline as a dataspace asset; consumers pull the latest completed execution via DSP
  • Running the node multiple times is safe — if the asset already exists it returns the existing asset_id without error
  • pipeline_id is auto-detected from execution context; set it explicitly if running outside a normal pipeline execution
  • The dataspace service must be reachable from the Hydra platform network at the configured dataspace_url

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..