Skip to content

SAIF.Business.Tasks overview

Documentation context: Front-End Application Component Documented via: LegalMaintenance (LegalMaintenance/LegalMaintenance.vbproj)

SAIF.Business.Tasks is the shared, source-system-agnostic task business layer in the SAIF BOF architecture. It defines the abstract task business object and collection that concrete task types (in SAIF.Business.Tasks.Claim) extend, the dynamic search/filter subsystem used to list tasks, and a set of read-only task code-table lookups.

Purpose

  • Provide a single, reusable persistence and validation contract for "task" records — reminders/follow-ups attached to claims, policies, or other business entities — so every consuming source system (claims, provider, imaging, etc.) shares the same create/update/delete/retrieve behavior and rule set.
  • Provide a dynamic, criteria-driven search capability (clsTaskCollection.Criteria) so callers can filter tasks by category, priority, date range, assigned user, claim, policy, action code, and free-text search without writing SQL themselves.
  • Provide read-only code-table lookups (action, category, priority, source codes) that translate between database code strings and framework enums (TaskSourceSystem, TaskPriority).
  • Consumed by SAIF.Business.Tasks.Claim (concrete claim task types) and the application layer (SAIF.Application.Claim, SAIF.Application.Claim.Legal) to manage claim-related tasks within the LegalMaintenance web application.

Responsibilities

  • Define the abstract task business object (clsTask) and abstract task collection (clsTaskCollection) with shared persistence plumbing, properties, and rule wiring.
  • Assemble dynamic, criteria-driven SELECT statements against TASK and enforce read-only access to task code tables.
  • Route TASK create/update/delete through the Oracle stored-procedure package pk82036_task.
  • Implement the common task business rules invoked by the BOF rules engine (see Business rules).

Key components

  • clsTask: abstract single-task business object — persistence lifecycle, properties, snapshot/restore state.
  • clsTaskCollection: abstract task collection — dynamic retrieval (GetTasks), batch save, and purge (PurgeTasks).
  • clsTaskCollection.Criteria: dynamic SQL-assembly component for the task search/filter subsystem.
  • clsTaskActionCode / clsTaskCategoryCode / clsTaskPriorityCode / clsTaskSourceCode (and their collections): read-only code-table lookups.
  • clsTaskContext: value holder for the six task "context" columns used to associate a task with an arbitrary business entity.
  • clsTaskBusinessRules: shared rule functions invoked by the BOF rules engine.

Sources

  • SAIF.Business.Tasks/clsTask.vb
  • SAIF.Business.Tasks/clsTaskCollection.vb
  • SAIF.Business.Tasks/clsTaskBusinessRules.vb
  • SAIF.Business.Tasks/SAIF.Business.Tasks.vbproj