Imaging lookup and alert support¶
This operation combines the image lookup logic in ImageInfo with the security, alerting, and error-logging helpers in ImageServices. The library resolves image identifiers from several key types, derives access flags, and delegates alert workflows to Oracle packages.
| Field | Value |
|---|---|
| Operation ID | OP-SB-09 |
| Trigger | Caller invokes image lookup, access, alert, tracking, or PDF-error helpers. |
| Inputs | Image sequence, IFN/IFNDS, tower ID, claim ID or claim number, image file code, mail ID, report metadata, PDF conversion error details |
| Outputs | ImageInfo, booleans, alert-recipient text, or insert success |
| Primary components | ImageServices.GetImageInfo, ImageServices.AlertLegalonClaim, ImageServices.HasAccessToClaim, ImageServices.TrackInReport, ImageServices.WhoWasAlerted, ImageServices.LogPDFConversionError, ImageInfo.New |
| Entry point | Business\SAIF.Business\ImageServices.vb |
Steps¶
- Image lookup starts from whichever identifier the caller has—image sequence, IFN, IFNDS, or tower ID—and uses the image lookup SQL family to resolve the matching
IMAGEorIMGSYSrow (SQL-037, IMAGE, IMGSYS). ImageInfohydrates sequence numbers, IFN forms, tower data, storage path fields, and file-extension metadata so later callers can request file location or format details from the same object (SQL-037, IMAGE, IMGSYS).- Claim-image alert checks call
pk80001_legalnet.alertlegalcase, which returnsTrueonly when at least one legal case on the claim is flagged for image alerts (SQL-038, PROC-RULE-004). - Claim-media and image-resource access helpers combine resource-code checks with claim-security flags to decide whether the requesting user may see the image for the claim.
TrackInReportforwards the image/report tuple topk73101_image.track_in_report, which marks the image as included in downstream report output (SQL-038).WhoWasAlertedcallspk73101_image.who_was_alertedand returns the comma-separated user summary produced by the procedure (SQL-038, PROC-RULE-001, PROC-RULE-002, PROC-RULE-003).- PDF conversion failures are written to
PDF_CONVERSION_ERROR, including the image identifiers, conversion context, and failure message supplied by the caller (SQL-003, PDF_CONVERSION_ERROR).
Process flow¶
The following diagram visualizes this operation's control flow.
flowchart TD
Start([Imaging request]) --> Kind{Lookup, access, alert, or log?}
Kind -->|Lookup| Lookup[Resolve IMAGE or IMGSYS row]
Kind -->|Access| Access[Evaluate claim and resource access]
Kind -->|Alert| Alert[Call legalnet or image alert package]
Kind -->|Log| Log[Insert PDF conversion error]
Lookup --> Return1([Return image metadata])
Access --> Return2([Return boolean])
Alert --> Return3([Return alert state or message])
Log --> Return4([Return insert result])
Failure and edge-case behavior¶
- Image lookups return empty metadata when the supplied key cannot be matched in
IMAGEorIMGSYS. - Claim-image alerts only succeed when the underlying legal-case procedure finds at least one flagged case (PROC-RULE-004).
- Alert-recipient summaries can return an explicit not-found message instead of an empty list when the alert package finds no related task rows (PROC-RULE-002).
Related documentation¶
Sources¶
Business\SAIF.Business\ImageInfo.vbBusiness\SAIF.Business\ImageServices.vb