Skip to main content

MGCLatticeDMFExecutionCompletedBusinessEvent

Business event raised when an entity of a Data Management Framework data project execution finishes its target step - the TargetStatus on a DMFDefinitionGroupExecution row reaches a terminal state (Finished, Error, or Canceled). It lets an integration chain react to a completed DMF import/export instead of polling the execution history, with a derived Succeeded/PartiallyFailed/ Failed outcome and the record counts. Two send sites: the row's update() (MGCLatticeDMFDefinitionGroupExecution_Table_Extension) for the writers that go through it, and DMFEntityDbExporter::generateEntityDBDataV2 (MGCLatticeDMFEntityDbExporter_Class_Extension) for bring-your-own-database exports, which record their result with doUpdate() and would otherwise never reach update(). While a BYOD export of an entity runs, MGCLatticeDmfByodExportContext hands that entity's row to the export wrapper, so each completion is sent exactly once. The event fires per entity. The execution id and definition group travel on every emission, and the payload carries the total entity count, so a consumer can group the per-entity completions of one data project. There is no single project-level emission.

  • Event id: MGCLatticeDMFExecutionCompletedBusinessEvent
  • Contract class: MGCLatticeDMFExecutionCompletedBusinessEventContract

Payload fields​

NameTypeDescription
eventSequenceint64Gets or sets the ordering sequence of this emission.
correlationIdstrGets or sets the identifier grouping emissions that belong to one logical run or flow.
schemaVersionintGets or sets the payload schema version of the emitting contract.
legalEntityDataAreaIdGets or sets the legal entity the entity was imported into or exported from, in lower case.
executionIdDMFExecutionIdGets or sets the DMF execution identifier.
definitionGroupDMFDefinitionGroupNameGets or sets the data project (definition group) name.
entityDMFEntityNameGets or sets the data entity name.
sourceDMFSourceNameGets or sets the source (source-data format) name.
outcomestrGets or sets the derived business outcome (Succeeded / PartiallyFailed / Failed / Canceled).
targetStatusintGets or sets the target status as an integer.
targetStatusNamestrGets or sets the human-readable target status.
stagingStatusintGets or sets the staging status as an integer.
stagingStatusNamestrGets or sets the human-readable staging status.
recordCountintGets or sets the number of records processed for the entity.
targetNewCountintGets or sets the number of records created in the target.
targetUpdatedCountintGets or sets the number of records updated in the target.
targetDeletedCountintGets or sets the number of records deleted in the target.
stagingErrorCountintGets or sets the number of staging errors.
targetErrorCountintGets or sets the number of target errors.
totalEntitiesInExecutionintGets or sets the number of entities in the execution, so a consumer knows the run's size.