warning-dcl.md — Warning and Error Dialog

File: warning.dcl
Version: v3.60
Category: Dialog Definitions
Size: 5.6 KB (170 lines)

Note

System Warnings and Errors

Display validation warnings, error messages, and critical alerts to user with severity levels and corrective action guidance.

Functional Purpose

Warning/Error Dialog - Presents validation issues, configuration problems, and critical alerts to user with appropriate severity indication and resolution guidance.

Key Functions:

  1. Display warnings (non-critical issues)

  2. Display errors (must fix before continuing)

  3. Severity indication (info, warning, error, critical)

  4. Resolution guidance (how to fix)

  5. Multiple messages (list of issues)

  6. Action buttons (OK, Cancel, Fix, Ignore)

Typical Workflow

1. User configures panel
2. User clicks OK or Generate Drawing
3. System validates configuration
4. Issues found:
   • ERROR: No panel dimensions specified
   • WARNING: Lifting capacity may be inadequate
   • INFO: Rebar spacing wider than recommended
5. warning-dcl displays with 3 messages
6. User sees:
   ? ERROR: Must specify dimensions (can't continue)
   ??  WARNING: Check lift capacity (can continue)
   ??  INFO: Consider tighter rebar spacing (suggestion)
7. User must fix ERROR before proceeding
8. User can ignore WARNING/INFO (at their risk)

Control Semantics

Message Display:

  • wrn_icon - Severity icon:

    • ? Error (red X - critical)

    • ?? Warning (yellow triangle - caution)

    • ?? Info (blue i - suggestion)

    • ? Success (green check - confirmation)

Message Text:

  • wrn_title - Issue summary (brief)

  • wrn_detail - Full explanation (detailed)

  • wrn_location - Where issue occurred (panel, dialog, field)

Resolution:

  • wrn_fix - Suggested fix (how to resolve)

  • wrn_ref - Reference (code section, manual page)

Actions:

  • wrn_ok - Acknowledge and close

  • wrn_fix_btn - Auto-fix if possible

  • wrn_ignore - Continue despite warning (warnings only)

  • wrn_cancel - Stop operation

Severity Levels

ERROR (Critical)

Must fix before continuing:

? ERROR: No panel dimensions specified

Details:
Panel width, height, and thickness are required
before drawing can be generated.

Resolution:
1. Return to panel configuration
2. Enter dimensions in mp_dlg
3. Retry drawing generation

Cannot proceed until fixed!

WARNING (Caution)

Should review, can continue:

??  WARNING: Lifting capacity may be inadequate

Details:
Panel weight: 8,500 lbs
Lift inserts: (2) 2,500 lb capacity = 5,000 lbs total
Safety factor: 5,000 / 8,500 = 0.59 (< 2.0 required!)

Resolution:
1. Add more lift inserts (recommend 4 total)
2. Use higher capacity inserts (5,000 lb)
3. Have structural engineer verify

Can continue but NOT RECOMMENDED!

INFO (Suggestion)

Best practice suggestion:

??  INFO: Rebar spacing wider than typical

Details:
Current: #5 @ 18" o.c.
Typical: #5 @ 12" o.c.
Meets minimum code requirements but wider than standard practice.

Suggestion:
Consider reducing spacing to 12" for better crack control
and more uniform load distribution.

No action required (informational only)

Common Warnings

Configuration Warnings

??  Arch top with embed array
   "Arch top panels cannot use embed arrays"
   ? Change to individual embed placement

??  Metal top plate not flush
   "Metal top plates must be flush to concrete top"
   ? Verify elevations, adjust if needed

??  Insufficient bearing width
   "Bearing width < 4" (code minimum)"
   ? Increase bearing to 4" minimum

Engineering Warnings

??  Inadequate rebar development
   "Bar development length < required"
   ? Extend bars OR use smaller bar size

??  High bearing stress
   "Bearing stress 250 PSI > allowable 200 PSI"
   ? Increase bearing area OR reduce loads

??  Large opening near edge
   "Opening within 12" of panel edge"
   ? Relocate opening OR add edge reinforcement

Drawing Warnings

??  Missing dimensions
   "Some features not dimensioned"
   ? Add dimensions before finalizing

??  Scale too small
   "Text will be 0.05" high at plot scale (unreadable)"
   ? Increase scale OR increase text size

??  Title block incomplete
   "Project name, date, or drawn-by missing"
   ? Complete all title block fields

Multi-Message Display

Multiple Issues:

????????????????????????????????????????????
? Validation Results: 5 issues found      ?
????????????????????????????????????????????
? ? ERROR (1)                             ?
?   • No panel dimensions                  ?
?                                          ?
? ??  WARNINGS (3)                         ?
?   • Lift capacity inadequate             ?
?   • Bearing width < minimum              ?
?   • Rebar spacing wide                   ?
?                                          ?
? ??  INFO (1)                             ?
?   • Consider Class A finish exterior     ?
????????????????????????????????????????????

[Fix Errors] [Review Warnings] [Cancel]

Auto-Fix Capability

When Available:

??  WARNING: Panel number not sequential
   Last panel: P-105
   Current: P-110
   Expected: P-106

[Auto-Fix: Renumber to P-106]
[Keep P-110]
[Cancel]

Auto-fix changes P-110 ? P-106
Maintains sequential numbering

Integration

Called By:

  • Validation routines

  • Configuration dialogs (on OK)

  • Drawing generation (pre-flight check)

  • Data import (error handling)

Triggers:

  • Required field missing

  • Value out of range

  • Configuration conflict

  • Engineering violation

  • Code non-compliance

Best Practices

For Users:

  • ? Always fix ERRORS (required)

  • ? Review WARNINGS carefully (important)

  • ? Consider INFO suggestions (best practice)

  • ? Don’t ignore all warnings (risky!)

For Developers:

  • ? Clear, specific messages (not vague)

  • ? Suggest resolution (help user fix)

  • ? Appropriate severity (don’t over-warn)

  • ? Link to documentation (reference)

Documentation Metadata

Enhancement Status: ? COMPREHENSIVE - ENHANCED [41/42]

End of Document