Zum Hauptinhalt springen

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.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..