HL7 real-time feed · ClarityFlow pipeline
StrideCare · Flow-HL7-Processing
Overall Processing job for HL7 pipeline
trigger
How it's scheduled
New appointments land continuously on the HL7 real-time feed. Front-of-house work is time-boxed — the estimate and letter have to reach the patient before the visit — so the pipeline polls every 10 minutes to check eligibility and price the good-faith estimate within minutes of an appointment being booked, rather than waiting for an overnight batch. It stands down while Daily - Processing - StrideCare runs (the heavier nightly pass).
| Scheduled task | Cadence | Server | State | Coordination |
|---|---|---|---|---|
\MDC\HL7 - Processing - StrideCare | every 10 min (from 00:03) | prod-db-1 | enabled | yields to Daily - Processing - StrideCare |
shape
Against the canonical Flow spine
Every Flow pipeline is a variation on one shape. Lit stages are the ones this pipeline runs; the labels match the capability lens.
computed concepts · from the SQL
What it computes
Business concepts mined from this pipeline's SQL text — the meaning behind the typed steps. Each links to the concept lens (who else computes it).
task tree
What the pipeline runs
Tasks in order, each with what it does — typed stepsfrom the MDClarity task docs (click to open the reference), sub-jobsyou can expand inline (▶) to reveal their own tasks, and SQL steps summarized by Gemini (✨). Every step shows the tables it writes/reads and which earlier step it feeds from(sqlglot lineage).
Flow-HL7-Processing
- LoadHL7FilesLoadHL7FilesParses and imports patient demographics, visits, and charges from HL7 message files located in a specified directory.message folder path={HL7Directory}message processed folder path={HL7Archive}add timestamp to file name
- HL7ProcessLog + HL7Deltasql
flow_hl7_processing__hl7processlog_hl7delta.sql✨ Initializes the HL7 process log and identifies the latest scheduling and patient messages from the archive for delta processing.writesHL7ADTBatchHL7DeltaHL7ProcessLogHL7ProcessLogArchiveKeysHL7SIUBatch· readsHL7ADTBatchHL7ArchiveHL7ProcessLogHL7SIUBatchTransformPatientTransformVisit ▶Flow-HL7-Transformsub-job · 9↗HL7 Transformation Layer
- TruncateVisitDeltasql
flow_hl7_transform__truncatevisitdelta.sql✨ Clears the visit delta table to prepare for a fresh set of changed records in the current pipeline run.writesVisitDelta - ImportHL7ADTCombinedsql
flow_hl7_transform__importhl7adtcombined.sql✨ Consolidates patient demographics and insurance information from HL7 ADT messages into a unified staging table for further processing.writesImportHL7ADTCombined - TransformPatientsql
flow_hl7_transform__transformpatient.sql✨ Synchronizes the patient transformation table by merging the latest demographic updates from both ADT and visit-based HL7 messages.writesTransformPatient· readsHL7ArchiveHL7DeltaHL7VisitImportHL7ADTCombined↳ feeds from ImportHL7ADTCombined - ImportTransformPatientInsurancesql
flow_hl7_transform__importtransformpatientinsurance.sql✨ Extracts and maps the most recent primary, secondary, and tertiary insurance details from consolidated HL7 messages for each patient.writesImportTransformPatientInsurance· readsImportHL7ADTCombinedInsuranceMap↳ feeds from ImportHL7ADTCombined - TransformPatientInsurance+VisitDeltasql
flow_hl7_transform__transformpatientinsurance_visitdelta.sql✨ Synchronizes patient insurance records and flags upcoming visits for reprocessing when insurance information changes.writesTransformPatientInsuranceVisitDelta· readsInsuranceChangesTransformVisitimporttransformpatientinsurance↳ feeds from ImportTransformPatientInsurance, MergeTransformVisit+VisitDelta - ImportTransformVisitsql
flow_hl7_transform__importtransformvisit.sql✨ Builds the visit transformation table by mapping appointment details, facilities, and resolving provider identifiers from HL7 scheduling messages.writesImportTransformVisit· readsHL7DeltaHL7VisitSourceProvider_33143 - MergeTransformVisit+VisitDeltasql
flow_hl7_transform__mergetransformvisit_visitdelta.sql✨ Updates the transformed visit table with staged appointment data and records new or modified visits in the delta tracking table.writesTransformVisitVisitDelta· readsImportTransformVisitVisitDelta↳ feeds from ImportTransformVisit, TransformPatientInsurance+VisitDelta, TruncateVisitDelta - ImportTransformVisitInsurancesql
flow_hl7_transform__importtransformvisitinsurance.sql✨ Builds the visit insurance import table by mapping patient insurance records to specific visits based on coordination of benefits.writesImportTransformVisitInsurance· readsTransformPatientInsuranceTransformVisitVisitDelta↳ feeds from MergeTransformVisit+VisitDelta, TransformPatientInsurance+VisitDelta, TruncateVisitDelta - MergeTransformVisitInsurancesql
flow_hl7_transform__mergetransformvisitinsurance.sql✨ Refreshes the visit insurance table by replacing existing records with updated insurance details from the staging table.writesTransformVisitInsurance· readsImportTransformVisitInsurance↳ feeds from ImportTransformVisitInsurance
- LoadPatientsLoadPatientsUpsert patient records into the patient dimension.· reads
PatientTransformPatientcustom patient query ▶Load-Entitiessub-job · 2↗Load Facility, Provider
- Load FacilityLoadEntitieswrites
Facility· readsSourceDepartmentfacilitysourcefacilitymappingentity type=Facilitycustom query - Load Providersql
load_entities__load_provider.sql✨ Updates the provider registry with names, NPI numbers, and taxonomy codes from source system data.writesProvider· readsSourceProvider
▶Flow-HL7-Transform-LoadDimensionMemberssub-job · 9↗
- Synchronize insurance-specific dimension members from the insurance table to update contract and eligibility filtering options across the application.writes
DimensionMemberload insuranceload quote insuranceload eligibility insuranceDISABLED - Load Time Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_time_dimensions.sql✨ Builds and updates time-based dimension members for days, months, and years based on the range of scheduled appointment dates.writesDimensionMember· readsTransformVisit - Load VisitStatus Dimensionsql
flow_hl7_transform_loaddimensionmembers__load_visitstatus_dimension.sql✨ Loads visit status dimension members from appointment data to ensure all scheduling statuses are available for reporting and filtering.writesDimensionMember· readsTransformVisit - Load Provider Dimensionsql
flow_hl7_transform_loaddimensionmembers__load_provider_dimension.sql✨ Updates provider and provider type dimensions to maintain a hierarchical relationship between individual clinicians and their professional categories.writesDimensionMember· readsProvider - Load Facility Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_facility_dimensions.sqldisabled✨ Loads facility dimension members and their parent groups to organize service locations for consistent reporting across the organization.writesDimensionMember· readsFacility - Load VisitType Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_visittype_dimensions.sql✨ Loads visit type dimension members by consolidating appointment codes and descriptions from multiple source systems for standardized visit categorization.writesDimensionMember· readsSourceAppointmentTypeSourceAppointmentType_33143TransformVisit - Load VisitTypeCategory Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_visittypecategory_dimensions.sql✨ Builds the visit type category dimension by extracting unique parent classifications from existing visit type records.writesDimensionMember· readsDimensionMember↳ feeds from Load Provider Dimension, Load SourceInsurance Dimensions, Load Time Dimensions, Load VisitStatus Dimension, Load VisitType Dimensions - Load SourceInsurance Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_sourceinsurance_dimensions.sql✨ Loads source insurance and insurance parent dimensions to map specific insurance packages to their broader reporting categories.writesDimensionMember· readsAccountInsuranceDimensionMemberInsuranceMapSourcePayer↳ feeds from Load Provider Dimension, Load Time Dimensions, Load VisitStatus Dimension, Load VisitType Dimensions, Load VisitTypeCategory Dimensions - Load State Dimensionssql
flow_hl7_transform_loaddimensionmembers__load_state_dimensions.sqldisabled✨ Updates state dimensions using facility location data to allow for geographic segmentation of healthcare services and revenue.writesDimensionMember· readsFacility
▶Flow-HL7-Processing-LoadVisitssub-job · 20↗
- Load TempBatchVisitsql
flow_hl7_processing_loadvisits__load_tempbatchvisit.sqldisabled✨ Builds a temporary batch table to identify upcoming visits requiring initial or follow-up insurance eligibility and benefit verification.writesTempBatchVisitVisitEligServiceTypesVisitServiceTypes· readsDimensionMemberTempBatchVisitTransformVisitTransformVisitInsuranceTransformVisitInsuranceCoverageStatusVisitEligServiceTypesVisitServiceTypes - Augment Visit Deltasql
flow_hl7_processing_loadvisits__augment_visit_delta.sqldisabled✨ Updates the visit delta table by adding records flagged as requiring new insurance eligibility lookups from the batch process.writesVisitDelta· readsTempBatchVisitVisitDelta - ReprocessChangedConfigurationsReprocessChangedConfigurationsIdentify and queue visits or accounts affected by configuration changes to ensure historical data reflects updated pricing or insurance rules.reprocess visits
- Augment VisitDelta - ReprocessChangedConfigssql
flow_hl7_processing_loadvisits__augment_visitdelta_reprocesschangedconfigs.sql✨ Builds a lookup for visits requiring reprocessing and adds them to the change tracking table following configuration updates.writesVisitDeltaVisitKeyLookup· readsTransformVisitVisitDeltaVisitKeyLookup - LoadVisitBatchLoadVisitBatchLoad scheduled visits and associated charges into the processing pipeline using custom SQL queries for pricing estimation and quote generation.writes
QuoteBatchVisitBatch· readsFacilityInsuranceMapPatientTransformVisitTransformVisitInsuranceVisitVisitDelta↳ feeds from Augment VisitDelta - ReprocessChangedConfigs, Sync Visits and Quotescustom visit queryauto charge querycustom service type querycustom coverage queryadd zero charge ▶Flow-HL7-Processing-LoadCustomPropertiessub-job · 2↗Load custom properties from Load-Visits
- UpdateVisitCustomPropertyFromQueryUpdateVisitCustomPropertyFromQuerydisabled· reads
InsuranceSearch_ResultTransformVisitInsuranceCoverageStatusVisitBatchcustom visit update custom property queryDISABLED - LoadCustomNotesCustomPropertyLoadCustomNotesCustomPropertydisabled· reads
BundleNotesMappingHL7DeltaHL7VisitVisitBatchentity=Visitcustom property key=CustomNotescustom querybatch modeDISABLED
- AutoApplyBundlesToVisitBatchAutoApplyBundlesToVisitBatchApplies matching charge bundles to batch visits based on facility and insurance to ensure consistent pricing across service types.
- CheckBenefitsflowVerifies insurance eligibility and retrieves detailed benefits information for visits by making real-time API calls to insurance providers.auto query
- Verifies insurance eligibility and retrieves detailed benefits information for visits by making real-time API calls to insurance providers.· reads
EligibilityStatusMapEligibilityTxnTempBatchVisitVisitBatchcustom queryDISABLED - AutoApplyBenefitsAutoApplyBenefitsPopulates insurance benefits like copays and deductibles on batch visits using data from eligibility verification transactions.
- CalculateVisitsflowCompute the good-faith estimate (CalculateVisits).· reads
DimensionMemberVisitBatch↳ feeds from LoadVisitBatchcustom querycalculate chargesbatch mode - LogVisitChangeEventsBatchLogVisitChangeEventsBatchCompare batch visits against production records to detect and log specific property changes for auditing and compliance tracking.
- Load TransformVisitInsuranceCoverageStatussql
flow_hl7_processing_loadvisits__load_transformvisitinsurancecoveragestatus.sql✨ Loads insurance coverage status by calculating the latest eligibility transaction results for visits in the current batch.writesTempEligibilityStatsTransformVisitInsuranceCoverageStatus· readsTempEligibilityStatsTransformVisitInsuranceVisitBatch↳ feeds from LoadVisitBatch ▶Flow-HL7-Processing-CustomPropertyCoverageStatussub-job · 3↗
- Load Primary Coverage StatusUpdateCustomPropertyFromQuery· reads
CustomPropertyMapEligibilityTxnVisitBatchVisitCoverageBatchentity=Visitcustom property key=PrimaryCoverageStatuscustom querybatch mode - Load Secondary Coverage StatusUpdateCustomPropertyFromQuery· reads
CustomPropertyMapEligibilityTxnVisitBatchVisitCoverageBatchentity=Visitcustom property key=SecondaryCoverageStatuscustom querybatch mode - Load Tertiary Coverage StatusUpdateCustomPropertyFromQuerydisabled· reads
TransformVisitInsuranceCoverageStatusVisitBatchentity=Visitcustom property key=TertiaryCoverageStatuscustom querybatch modeDISABLED
- Sync Visits and QuotesSyncBatchSynchronizes processed data from batch staging tables to production tables, updating visits, quotes, and custom property mappings.writes
CustomPropertyMapQuoteVisitVisitChangeEvent· readsCustomPropertyMapBatchQuoteBatchVisitBatchVisitChangeEventBatch↳ feeds from LoadVisitBatchsync quotesync visitsync custom property mapsync visit change event - ExportBatchVisitEligibilityflowdisabledPush the batch to the app / export results.· reads
EligibilityTxnVisitBatchcustom querytable name=BatchEligibility_Resultsarchive table name=BatchEligibility_ResultsArchiveDISABLED - SearchForInsuranceflowdisabledFind coverage for visits missing insurance.· reads
EligibilityTxnBatchcustom querytable name=InsuranceSearch_Resultbatch modeDISABLED
- UpdateHL7ProcessLogsql
flow_hl7_processing__updatehl7processlog.sql✨ Updates the HL7 process log to mark the most recent active processing task as completed.· readsHL7ProcessLog↳ feeds from HL7ProcessLog + HL7Delta - WorkqueueAssignmentWorkqueueAssignmentAssigns accounts or visits to workqueue stacks by evaluating matching criteria and updating item lists based on search terms.
- Regenerates optimized aggregate tables for all dashboard reports and updates their definitions to reflect the latest source data.DISABLED
markers
Why it classified as flow
Front-of-house actions found anywhere in the tree (including nested sub-jobs).