The Bulk Processing Controller manages the life cycle of bulk processing tasks, and determines whether they are New, Pending, In Progress, Completed, or Terminated.
The following diagram shows the life cycle of bulk processing tasks.
When a task is initially created, it is in the New state. The Bulk Processing Controller looks for tasks in the New state and processes the first available one and marks it as Pending. The Bulk Processing Controller then finds out how many entities are subject to the given task and then records the result as XML in the second TaskCommentBObj object for the associated bulk processing task. The TaskCommentBObj XML includes the following elements:
- Total – The total number of service calls.
- Failed – The total number of failed service calls.
- Completed – The total number of successful service calls.
- LastProcessedEntityID – The primary key of the last processed entity.
- TerminationReason (optional) – The business or technical reason that a terminated task has been terminated.
If the total count is zero, the Bulk Processing Controller marks the task as Terminated and the Bulk Processing Controller exits. Otherwise, the task is marked as In Progress and then the Bulk Processing Controller begins invoking the bulk processing services. During this period, the Bulk Processing Controller updates the progress status (Failed, Completed, LastProcessedEntityId) on the second instance of TaskCommentBObj.
If all of the attempted service calls are completed successfully, then the Bulk Processing Controller marks the task as Completed and the Bulk Processing Controller exits.
