GwMatterRequest

GwMatterRequest is a plain data-transfer object that carries the fields needed to create or update a Guidewire legal "matter" record from a hearing schedule (case number, status, secretary/attorney user IDs, matter date/type, and — for closed/settled/dismissed statuses — a computed matterClosedEffDate). It is built by clsScheduleManager.SendDataToGw/clsAssignmentManager.SendDataToGw and passed to the GwMatterApi API client, first as a Create/RetrieveWithBody call and, on failure, retried as an Update call (Business rules). It has no base class and no persistence behavior of its own.

Purpose

• Carry the case number, status, secretary/attorney user IDs, matter date, and matter type needed to create or update a Guidewire matter record.
• Compute and carry matterClosedEffDate when the schedule's status is closed, settled, or dismissed, so Guidewire reflects the matter's closure date.
• Decouple the Guidewire REST payload shape from the internal clsLegalSchedule business object.

Context

• Namespace: SAIF.Application.Claim.Legal
• Assembly/package: SAIF.Application.Claim.Legal.dll (embedded library, constructed by clsScheduleManager/clsAssignmentManager and consumed by the GwMatterApi API client)

Public members

Member	Signature	Purpose
New()	Public Sub New()*	Default constructor for property-initializer-style construction before serialization to the Guidewire API request body.
CaseNumber	Public Property CaseNumber As Decimal*	Identifies the legal case the matter record corresponds to in Guidewire.
Status	Public Property Status As String*	Carries the schedule/case status used by Guidewire to determine the matter's current state.
SecretaryUserId	Public Property SecretaryUserId As String*	Identifies the assigned secretary's Guidewire/SAIF user ID for the matter record.
AttorneyUserId	Public Property AttorneyUserId As String*	Identifies the assigned attorney's Guidewire/SAIF user ID; matter sync is only attempted when this is populated (Business rules).
MatterDate	Public Property MatterDate As Date*	Carries the hearing/matter date synchronized to Guidewire.
MatterType	Public Property MatterType As String*	Carries the schedule type (e.g., HEAR, MED) used by Guidewire to classify the matter.
MatterClosedEffDate	Public Property MatterClosedEffDate As Date?*	Carries the computed closure-effective date when the schedule's status is closed, settled, or dismissed; left unset otherwise.

Behavioral notes

• MatterClosedEffDate is only populated for closed/settled/dismissed statuses, mirroring the conditional logic in clsScheduleManager.SendDataToGw/clsAssignmentManager.SendDataToGw*.
• The matter sync using this DTO is skipped entirely when AttorneyUserId is blank, per this library's attorney-assignment gate (Business rules).

Constraints and usage notes

• As a plain DTO, GwMatterRequest performs no validation of its own; correctness of the values depends entirely on the caller (clsScheduleManager/clsAssignmentManager)**.

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

• SAIF.Application.Claim.Legal\LegalNet\GwMatterRequest.vb