Other Parties¶

Other Parties is a LegalMaintenance maintenance screen that uses clsLegalPersonManager from SAIF.Application.Claim.Legal to bind editable SAIF.Business.Claim.Legal other-firm records. The user selects a firm-type filter in ddlFirmType, retrieves the matching rows into a single Infragistics grid, and manages inserts, saves, deletes, and layout preferences through the shared SAIF toolbar.

Entry conditions¶

User opens frmOtherFirms.aspx; on first load the page creates clsLegalPersonManager, loads ddlFirmType, and binds dgFirm.

Fields¶

Field	Control type	Purpose	Validation
`ddlFirmType`	`DropDownList`	Filters the grid by firm type before retrieval and rebinding.	Populated from `Manager.FirmTypeList`; `BindData` applies the selected value to `Manager.FirmFilter`.
`dgFirm.FirmName`	`WebDataGrid` text column	Stores the employer or insurer name.	Validated by `Manager.OtherFirmCol.IsValid` on save; no field-specific client mask is defined in this page.
`dgFirm.OtherFirmTypeCode`	`WebDataGrid` drop-down column	Stores the firm-type classification.	Choices are loaded from `Manager.FirmTypeList`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.Addr1`	`WebDataGrid` text column	Stores the first address line.	Validated by `Manager.OtherFirmCol.IsValid` on save; no field-specific client mask is defined in this page.
`dgFirm.Addr2`	`WebDataGrid` text column	Stores the second address line.	Validated by `Manager.OtherFirmCol.IsValid` on save; no field-specific client mask is defined in this page.
`dgFirm.City`	`WebDataGrid` masked text column	Stores the city.	Masked by `wdg_CityEditor` with `CCCCCCCCCCCCCCCCCCCCCCCCCCCCC`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.State`	`WebDataGrid` masked text column	Stores the state abbreviation.	Masked by `Wdg_StateEditor` with `>LL`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.Zip`	`WebDataGrid` masked text column	Stores the ZIP code.	Masked by `wdg_ZipEditor` with `#####`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.Zip4`	`WebDataGrid` masked text column	Stores the ZIP+4 suffix.	Masked by `wdg_Zip4Editor` with `####`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.Phone`	`WebDataGrid` masked text column	Stores the main phone number.	Masked by `dgFirm_MaskEditorProvider_Phone` with `###.###.####`; validated by `Manager.OtherFirmCol.IsValid` on save.
`dgFirm.Fax`	`WebDataGrid` masked text column	Stores the fax number.	Masked by `dgFirm_MaskEditorProvider_Phone` with `###.###.####`; validated by `Manager.OtherFirmCol.IsValid` on save.

Operations¶

Operation	Trigger	Description
Load filtered grid	`Page_Load`	On first load, initializes the manager, loads the firm-type filter, binds `dgFirm`, applies preferences, and enables or disables toolbar actions based on `Manager.IsInViewOnly`.
Retrieve filtered firms	`btnRetrieve` `Click`	Causes a postback that rebinds `dgFirm` using the current `ddlFirmType` value through `Manager.FirmFilter`.
Insert firm row	`SAIFMenuTop.InsertButton` `ToolbarClick`	Inserts a new other-firm row, rebinds `dgFirm`, and starts inline editing in `FirmName`.
Save changes	`SAIFMenuTop.SaveButton` `ToolbarClick`	Validates the collection, writes through the controller, forces a refresh filter after successful save, and shows success or validation messages.
Delete selected firm	`SAIFMenuTop.DeleteButton` `ToolbarClick`	Deletes the selected other-firm row when the collection is valid, then rebinds the grid.
Save display preferences	`SAIFMenuTop.PrefsSet` `ToolbarClick`	Saves grid sizing and column preferences using `hfGridHeight` and `hfGridWidth`.
Clear display preferences	`SAIFMenuTop.PrefsClear` `ToolbarClick`	Clears saved preferences for `dgFirm`.

Business rules¶

Rule ID	Rule	Enforcement	Source
BR-APP-001	View-only users can open the screen but cannot use Delete, Insert, or Save.	`Page_Load` checks `Manager.IsInViewOnly` and disables the toolbar buttons.	`LegalMaintenance\frmOtherFirms.aspx.vb:38-49`
Screen-specific	The selected firm type is applied as `Manager.FirmFilter` whenever the grid is rebound, and a successful save forces a refreshed data load.	`BindData` and `Save`.	`LegalMaintenance\frmOtherFirms.aspx.vb:67-79, 98-107`
Screen-specific	Invalid saves mark broken-rule cells with CSS class `wgcerror` and move edit focus to the first invalid property.	`SetErrorColor`.	`LegalMaintenance\frmOtherFirms.aspx.vb:118-136`
Screen-specific	Delete executes only when the collection is valid; otherwise the screen shows current error messages and rebinds the grid.	`Delete`.	`LegalMaintenance\frmOtherFirms.aspx.vb:142-152`

Infragistics components¶

Control ID	Control type	SAIF wrapper	Infragistics base	Purpose
`dgFirm`	`ig:WebDataGrid`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.WebDataGrid`	Edits other-firm records.
`dgFirm_MaskEditorProvider_Phone`	`ig:MaskEditorProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the phone and fax input mask.
`dgFirm_DropDownProvider1`	`ig:DropDownProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.DropDownProvider`	Supplies firm-type choices for `dgFirm.OtherFirmTypeCode`.
`Wdg_StateEditor`	`ig:MaskEditorProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the two-letter state mask.
`wdg_ZipEditor`	`ig:MaskEditorProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the five-digit ZIP mask.
`wdg_Zip4Editor`	`ig:MaskEditorProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the four-digit ZIP+4 mask.
`wdg_CityEditor`	`ig:MaskEditorProvider`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.Web.UI.GridControls.MaskEditorProvider`	Applies the city text mask.
`WebResizingExtender1`	`igui:WebResizingExtender`	Direct Infragistics control (no SAIF wrapper)	`Infragistics.WebUI.WebResizingExtender`	Persists client resizing for `dgFirm`.

Target	Trigger	Parameters
`frmAttorneyProfile.aspx`	inherited `Page_Load` timeout redirect	`msg=Your session has timed out`

Sources¶

LegalMaintenance\frmOtherFirms.aspx
LegalMaintenance\frmOtherFirms.aspx.vb
LegalMaintenance\Classes\clsLegalMaintenanceAncestor.vb