Aller au contenu principal

Data Enricher

Category: Transform
Node id: data-enricher

Enriches data with additional information from external services, supplementary data merging, or static field augmentation

What it does​

  • Three enrichment modes: external service, supplementary merge, static augmentation
  • Three merge strategies: supplement, override, deep_merge
  • HTTP-based external enrichment service integration
  • Static field injection for metadata augmentation

Use cases​

  • Enrich patient records with data from an external demographics service
  • Merge supplementary lab data into clinical observations
  • Add audit metadata fields to pipeline-processed records

Runtime​

  • Performance tier: variable

Input ports​

NameTypeRequiredDescription
datajsonYesPrimary data to enrich
supplementary_datajsonNoSupplementary data for merge operation

Output ports​

NameTypeRequiredDescription
enriched_datajsonNoEnriched result data
enrichedbooleanNoWhether enrichment was applied
http_statusnumberNoHTTP status from enrichment service
merge_strategytextNoMerge strategy used (merge operation)
notetextNoInformational note

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
OperationoperationenumYesenrichenrich, merge, augmentEnrichment operation to perform
Enrichment Endpointenrichment_endpointstringNoURL of the enrichment service (for enrich operation)
Merge Strategymerge_strategyenumNosupplementsupplement, override, deep_mergeStrategy for merging supplementary data

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
API Keyapi_keysecretNoAPI key for the enrichment service
Static Fieldsstatic_fieldsjsonNoStatic key-value pairs to add during augmentation

Errors​

CodeDescription
ENRICHMENT_FAILEDExternal enrichment service call failed
MISSING_SUPPLEMENTARYSupplementary data input is required for merge operation
UNSUPPORTED_OPERATIONThe specified enrichment operation is not recognized

Runtime notes​

  • Output keys are top-level (enriched_data, enriched, http_status) — not wrapped in a 'result' object
  • If enrichment_endpoint is empty, data passes through unchanged with enriched=false
  • Merge 'supplement' only adds missing keys; 'override' overwrites; 'deep_merge' recurses into nested maps
  • Augment mode injects _enriched_at timestamp and any configured static_fields into the data

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

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.