TaskService

Implements ITaskService (extending ValidatingServiceBase*) as the central service for claim activities ("tasks"): querying, creating, updating, completing, deleting, reassigning in bulk, and printing tasks tied to injury claims. It coordinates a large set of collaborators — IUnitOfWork for the Task/TaskGroup/TaskCategory/TaskPriority repositories, IUserProfileService for the current/target user and claim-note preferences, IDocumentService for PDF generation, IValidationService for ClaimTask validation, IClaimInformationService and IRTWService for claim security/RTW masking rules, IPolicyInformationService for policy name lookups, IImagingClient for OnBase document integration, ILogService for exception logging, IWorkCalendarService for due-date adjustment, and claim/worker query providers plus a Guidewire claim API client for building Claim domain objects.

Purpose

• Retrieves individual tasks, task groups, and filtered task lists, masking worker names on confidential/secured/conflict claims according to the current user's security access and RTW load code.
• Creates new tasks (stateful CreateTask and stateless CreateTaskStateless overloads), assigning default category/priority/source, work-day-adjusted due dates, and validating the result before persisting.
• Updates existing tasks, detecting stale concurrent edits via UpdateNumber, flags whether a UI refresh is required, and optionally completes the task as part of the update.
• Completes or deletes tasks individually or in bulk (comma-delimited ID lists), writing a claim note when a completed/deleted task is flagged for the notepad.
• Reassigns tasks in bulk to a new user, date, priority, group, and/or text, subject to per-field "only if provided" semantics.
• Produces PDF reports of filtered task lists and note printable output, and exposes claim/user/date validity checks used by ClaimTaskValidator.

Context

• Namespace: SAIF.Services.Claims.Tasks
• Assembly/package: SAIF.Services (packaged inside the SAIF.SAIFCode.Core NuGet package)

Public members

Member	Signature	Purpose
ValidGroups	public IEnumerable<string> ValidGroups { get; }	The set of task-group identifiers (parsed from the ClaimActivities.ValidGroups environment setting) that are treated as valid assignees alongside individual mail IDs.
ClaimTaskCategoryCode	public const string ClaimTaskCategoryCode = "CLMM"	The default task-category code applied to claim tasks created without an explicit category.
TaskService(...)	public TaskService(IUnitOfWork unitOfWork, IUserProfileService userProfileService, IDocumentService documentService, IValidationService validationService, IClaimInformationService claimInformationService, IRTWService rtwService, IEnvironmentService environmentService, IPolicyInformationService policyInformationService, IImagingClient imagingClient, ILogService logService, IWorkCalendarService workCalendarService, IClaimQueryProvider claimQueryProvider, IWorkerQueryProvider workerQueryProvider, ICCClaimApiService claimApiService)	Validates required collaborators are non-null, stores them, loads the current user's ClaimTasksNotes/ClaimNoteDefaults note preferences, builds a ClaimUserSecurityAccess for the current user, and parses ValidGroups from environment configuration.
GetTaskById	public ClaimTask GetTaskById(long id)	Returns the task with the given ID mapped to a ClaimTask contract, or a mapped null result if no task with that ID exists.
GetTaskGroups	public IEnumerable<TaskGroup> GetTaskGroups()	Returns all configured task groups mapped to TaskGroup contracts.
GetTasks	public IEnumerable<ClaimTask> GetTasks(TaskFilter filter)	Returns claim/imaging-sourced, non-"INFO" tasks matching the filter (deleted-state, claim number, assigned user/group, and any additional filters), with worker name, policy, conflict/secure flags, and RTW masking applied; returns an empty list when no valid group configuration, claim, or user filter is present.
GetAdditionalInfoTask	public ClaimTask GetAdditionalInfoTask(string claimNumber)	Returns the most recent non-deleted "INFO"-priority/"INFO"-user task for the claim, or synthesizes an unsaved placeholder task (with TaskDate set to DateTime.MaxValue.Date) if none exists.
GetOnBaseEncodedString	public string GetOnBaseEncodedString(string claimNumber)	Calls the imaging API client to obtain an OnBase encoded query string for the claim's custom query, logging and returning null if the call throws.
CanUserEdit	public bool CanUserEdit(string userId)	Returns true when userId is non-blank and the resolved system user is authorized for CTTaskUpdate or RTWExternalUpdate.
IsValidClaim	public bool IsValidClaim(string claimNum)	Returns true if an injury claim with the given claim number exists.
IsValidWorkDate	public bool IsValidWorkDate(DateTime workDate)	Returns true when the date is between today and two years from today, inclusive.
GetClaimWorkerName	public string GetClaimWorkerName(string claimNum)	Deprecated: always throws NotImplementedException ("This method is not implemented and is deprecated as part of the CSI project"); the working implementation has been commented out.
CreateTaskStateless(TaskEditContext, ...)	public long CreateTaskStateless(TaskEditContext taskEdit, IMessageContainer messages, bool isBatchCommit = false)	Builds a new Task entity from the edit context (resolving claim, policy, category defaults, priority, group, and due-date adjustment), validates it, and — unless isBatchCommit is true (in which case the caller controls the transaction) — begins and commits its own transaction; returns the new task's ID, or 0 if validation fails.
CreateTaskStateless(TaskEdit, ...)	public long CreateTaskStateless(TaskEdit task, IMessageContainer messages, bool isBatchCommit = false)	Maps a TaskEdit to a TaskEditContext and delegates to the TaskEditContext overload.
CreateTask	public ClaimTask CreateTask(TaskEdit task, IMessageContainer messages)	Begins a transaction, builds and validates a new ClaimTask/Task pair (resolving claim, policy, category, priority, group, and adjusted due date), commits and returns the persisted, editable ClaimTask on success, or an empty ClaimTask if validation fails.
UpdateTask	public bool UpdateTask(long id, ref TaskEdit task, IMessageContainer messages)	Begins a transaction and applies the edit to the existing task, failing with an error if the task ID is invalid or if UpdateNumber indicates a concurrent edit; sets task.IsRefreshRequired when the date, user, or completion status changed; completes/deletes the task when IsComplete is set; validates and commits, returning whether the update succeeded.
DeleteTask	public bool DeleteTask(long id, IMessageContainer messages)	Begins a transaction, marks the task deleted (or reports an "Invalid Task ID" error if not found), writes a claim note if the task was flagged for the notepad, commits, and always returns true.
CompleteTasks	public void CompleteTasks(string ids)	In one transaction, marks each comma-delimited task ID as deleted/completed (recording a claim note for each).
DeleteTasks	public void DeleteTasks(string ids)	In one transaction, marks each comma-delimited task ID as deleted (not completed), recording a claim note only for notepad-flagged tasks.
ReassignTasks	public void ReassignTasks(string ids, string newTaskUser, DateTime newTaskDate, Boolean? newPriority, string newGroup, string newText)	In one transaction, updates each comma-delimited task ID's user, work-day-adjusted date, priority, group, and/or text — applying each field only when a corresponding non-empty/non-null value is supplied, and only rewriting text when the task is image-backed and not worker-name-masked.
PrintTasks	public byte[] PrintTasks(TaskFilter filter)	Builds an XML report payload for the filtered task list and returns the rendered PDF bytes from IDocumentService.GeneratePdf using the "Clm_TaskAndNotes_Tasks" template.
HasMedia	public bool HasMedia(long claimId)	Returns whether the claim has associated imaging media, per the imaging client's HasMedia check for DocTypeGroup.CLAIM.

Behavioral notes

• Extends ValidatingServiceBase*, whose members are not documented here because it could not be confirmed as a type from a documented dependency library.
• All create/update/delete/reassign/complete operations that own their own transaction call _unitOfWork.Begin() then Commit(); CreateTaskStateless skips the transaction boundary entirely when isBatchCommit is true, deferring to the caller.
• Worker names are masked to "Confidential" for conflict/secure claims unless the current user has the matching HasConflict/HasSecure claim security access or a claim-level security override; RTW-loaded external users are also checked via IRTWService.CanAccessRTWClaim.
• CreateTaskNote/AddLimitToHistory-style note creation throws an ApplicationException if the current user's claim-note category/type preferences are not set, requiring preferences be configured before tasks can be completed.
• UpdateTask treats a mismatched UpdateNumber as an optimistic-concurrency conflict and rolls back with a "someone else has updated this data" error.
• GetClaimWorkerName(string) is dead/deprecated code — it always throws NotImplementedException; callers relying on the private overloads (by claim or by flattened task data) are unaffected.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

• Services/SAIF.Services/Claims/Tasks/TaskService.cs