Skip to main content

Dedalus FHIR

Category: EHR & Practice Mgmt
Node id: dedalus-fhir

Standards: HIPAA, GDPR, SOC2

Integrates with Dedalus Healthcare (European EHR) via FHIR API with Keycloak-based OpenID Connect authentication

What it does​

  • Keycloak OpenID Connect authentication with realm support
  • FHIR R4 search, read, create, update, and batch operations
  • Transaction Bundle support for bulk operations
  • European healthcare system integration

Use cases​

  • Integrate European hospital data from Dedalus into analytics pipelines
  • Perform batch FHIR operations against Dedalus Healthcare systems
  • Create and update clinical resources in Dedalus-powered hospitals
  • Support EHDS data exchange with Dedalus as source or target

Runtime​

  • Performance tier: variable

Input ports​

NameTypeRequiredDescription
search_paramsjsonNoSearch parameters as key-value pairs
resource_idtextNoResource ID for read/update operations
resourcejsonNoFHIR resource object for create/update operations
bundlefhir-bundleNoFHIR Bundle for batch operations

Output ports​

NameTypeRequiredDescription
resultjsonNoMain result data from the Dedalus FHIR operation
metadatajsonNoResponse metadata including resource type, counts, and operation details
successbooleanNoWhether the operation succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Dedalus Base URLdedalus_base_urlstringYesBase URL of the Dedalus Healthcare instance
OperationoperationenumYessearchsearch, read, create, update, batchFHIR operation to perform
Resource Typeresource_typestringNoPatientFHIR resource type to operate on

Auth​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Client IDclient_idsecretYesKeycloak OAuth2 client ID
Client Secretclient_secretsecretYesKeycloak OAuth2 client secret
RealmrealmstringNodedalusKeycloak realm for authentication

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Search Parameterssearch_paramsjsonNoDefault search parameters as key-value pairs
Resource IDresource_idstringNoResource ID for read operations (can also come from input)

Errors​

CodeDescription
DEDALUS_AUTH_FAILEDFailed to obtain token from Keycloak
DEDALUS_SEARCH_FAILEDDedalus FHIR search returned an error
DEDALUS_CREATE_FAILEDDedalus rejected the resource creation
DEDALUS_BATCH_FAILEDDedalus rejected the batch Bundle
RESOURCE_ID_REQUIREDresource_id is required for read/update operations

Runtime notes​

  • Authenticates via Keycloak OpenID Connect — a fresh token is obtained on every execution
  • Search params from inputs override/merge with config search_params
  • Output 'result' always contains a nested object (bundle, resource) — shape varies by operation
  • FHIR base URL is constructed as dedalus_base_url + '/fhir'

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

Something unclear? Send documentation feedback by email.