Hearing Locations¶

This screen maintains hearing-location reference data for the LegalMaintenance application. It initializes clsHearingLocationManager from SAIF.Application.Claim.Legal, binds hearing-location rows and location-code lookups, and edits hearing-location business objects supplied by SAIF.Business.Claim.Legal.

Entry conditions¶

Request to frmHearingLocation.aspx in the LegalMaintenance application.

Fields¶

Field	Control type	Purpose	Validation
`dgLocation.HearingLocationCode`	Infragistics WebDataGrid bound field	Stores the hearing location code for the row.	Drop-down provider loaded from `Manager.LocationCode`.
`dgLocation.LocationName`	Infragistics WebDataGrid bound field	Stores the hearing location name.	No explicit page-level validation found in source.
`dgLocation.Addr1`	Infragistics WebDataGrid bound field	Stores address line 1.	No explicit page-level validation found in source.
`dgLocation.Addr2`	Infragistics WebDataGrid bound field	Stores address line 2.	No explicit page-level validation found in source.
`dgLocation.Addr3`	Infragistics WebDataGrid bound field	Stores address line 3.	No explicit page-level validation found in source.
`dgLocation.City`	Infragistics WebDataGrid bound field	Stores the city name.	`wdg_CityEditor` mask editor is assigned to the `City` column.
`dgLocation.State`	Infragistics WebDataGrid bound field	Stores the state abbreviation.	`Wdg_StateEditor` applies mask `>LL`.
`dgLocation.Zip`	Infragistics WebDataGrid bound field	Stores the ZIP code.	`wdg_ZipEditor` applies mask `#####`.
`dgLocation.Zip4`	Infragistics WebDataGrid bound field	Stores the ZIP+4 suffix.	`wdg_Zip4Editor` applies mask `####`.
`dgLocation.RequiresFullDayFlag`	Infragistics WebDataGrid checkbox field	Marks whether the location requires a full-day setting.	Boolean checkbox input.
`dgLocation.RotationFlag`	Infragistics WebDataGrid checkbox field	Marks whether the location participates in rotation scheduling.	Boolean checkbox input.
`dgLocation.EffectiveDate`	Infragistics WebDataGrid bound field	Stores the row effective date.	Display format `MM/dd/yyyy`; no explicit page-level validation found in source.
`dgLocation.ExpirationDate`	Infragistics WebDataGrid bound field	Stores the row expiration date.	Display format `MM/dd/yyyy`; no explicit page-level validation found in source.
`dgLocation.RotationAverageCaseCount`	Infragistics WebDataGrid bound field	Displays the average rotation case count for the location.	Decimal data field; no explicit page-level validation found in source.
`hfSelectedRowIndex`	Hidden input	Stores the selected grid row index for client-side row selection state.	Set by `dgLocation_RowSelectionChanged`.
`hfGridHeight`	Hidden field	Stores the resized grid height for preference saving.	Saved only when numeric in `SavePrefs`.
`hfGridWidth`	Hidden field	Stores the resized grid width for preference saving.	Saved only when numeric in `SavePrefs`.

Operations¶

Operation	Trigger	Description
Select row	`dgLocation` RowSelectionChanged	Stores the selected row index in `hfSelectedRowIndex`.
Insert hearing location	`SAIFMenuTop.InsertButton` click	Calls `Manager.InsertNewLocation()`, rebinds the grid, and begins edit mode on `HearingLocationCode`.
Save hearing locations	`SAIFMenuTop.SaveButton` click	Saves dirty, valid hearing-location rows through `Controller.Write`; otherwise shows validation or no-save messages.
Delete hearing location	`SAIFMenuTop.DeleteButton` click	Deletes the selected hearing location row by grid data key, then rebinds the grid.
Save grid preferences	`SAIFMenuTop.PrefsSetButton` click	Persists grid column and size preferences using `hfGridHeight` and `hfGridWidth`.
Clear grid preferences	`SAIFMenuTop.PrefsClearButton` click	Clears saved grid preferences and shows a confirmation message.

Business rules¶

Rule ID	Rule	Enforcement	Source
BR-APP-001	Users in view-only mode cannot insert, save, or delete hearing-location rows from this screen.	`Page_Load` disables `DeleteButton`, `InsertButton`, and `SaveButton` when `Manager.IsInViewOnly`.	`LegalMaintenance\frmHearingLocation.aspx.vb:47-53`
—	The page only writes hearing-location changes when `Manager.HearingLocationCol` is dirty and valid; otherwise it shows either the no-save message or collection error messages.	`Save`	`LegalMaintenance\frmHearingLocation.aspx.vb:101-116`
—	Deletion is attempted only when the hearing-location collection is valid, and the selected row's data key is passed to `Manager.DeleteLocation`.	`Delete`	`LegalMaintenance\frmHearingLocation.aspx.vb:126-133`

Infragistics components¶

Control ID	Control type	SAIF wrapper	Infragistics base	Purpose
`dgLocation`	WebDataGrid	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.WebDataGrid`	Displays and edits hearing-location rows.
`dgFirm_MaskEditorProvider_Phone`	MaskEditorProvider	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Declares a phone-style mask editor provider in the page.
`Wdg_StateEditor`	MaskEditorProvider	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the two-letter state mask.
`wdg_ZipEditor`	MaskEditorProvider	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the five-digit ZIP mask.
`wdg_Zip4Editor`	MaskEditorProvider	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the ZIP+4 mask.
`wdg_CityEditor`	MaskEditorProvider	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the city editor mask.
`WebResizingExtender1`	WebResizingExtender	Direct Infragistics control (no SAIF wrapper)	`Infragistics.WebUI.WebResizingExtender`	Captures client-side grid resizing for preference persistence.

Target	Trigger	Parameters
`frmAttorneyProfile.aspx`	Postback when `Session.IsNewSession` is `True`	`msg=Your session has timed out` via `REDIRECTFORTIMEOUT` in `clsLegalMaintenanceAncestor`.

Sources¶

LegalMaintenance\frmHearingLocation.aspx
LegalMaintenance\frmHearingLocation.aspx.vb