Movensys.AlarmHelper.Winforms 1.0.0

Movensys.AlarmHelper.Winforms

Movensys.AlarmHelper.Winforms is a WinForms UI extension library built on top of
Movensys.AlarmHelper.Core, providing ready-to-use alarm management UIs for desktop applications.

This package is designed for industrial HMI / machine control software where alarms must be:

• clearly visualized
• searchable & filterable
• persisted to files
• localized with troubleshooting guidance

Features

🔔 Alarm History UI

• WinForms DataGridView-based alarm history viewer
• Supports live alarms and loaded history files
• Reverse chronological ordering (latest first)
• Level-based row coloring (Warning / Error / Critical)
• Millisecond-precision timestamps

🌍 Multi-Language Troubleshooting Editor

• Built-in Troubleshooting Editor Form
• Language-tab UI (ko / en / ja / zh)
• Line-based editing with intentional empty lines preserved
• Per-alarm troubleshooting stored in JSON
• Language enable/disable support

💾 File I/O Support

• Load / Save alarm history (.json)
• Load / Save troubleshooting maps
• DTO-based serialization (safe with enum, private set, multi-framework)
• Compatible with Newtonsoft.Json

🧩 Seamless Core Integration

• Fully compatible with:
  • CodeAlarm<TCode, TLevel>
  • WordAlarm<TCode, TLevel>
  • BaseAlarm<TCode, TLevel>
• No reflection or magic strings
• Strongly-typed enums end-to-end

Requirements

• Windows
• .NET Framework 4.7.2+ or
• .NET 6 / .NET 8 (-windows)
• Dependencies:
  • Movensys.AlarmHelper.Core
  • Newtonsoft.Json

Quick Start (WinForms)

1. Create Alarm Core

using Movensys.AlarmHelper.Core.AlarmTypes;

var alarm = new CodeAlarm<AlarmCode, AlarmLevel>();

2. Show Alarm History Form

var historyForm = new AlarmHistoryForm<AlarmCode, AlarmLevel>(alarm);
historyForm.Show(this);

3. Edit Troubleshooting Information

var editor = new TroubleShootingEditor(troubleShootingDictionary);
if (editor.ShowDialog(this) == DialogResult.OK)
{
    var result = editor.Result;
    // Apply to alarm configuration
}

JSON Structure

Troubleshooting Map Example

{
  "_troubleShootingLangEnable": {
    "ko": true,
    "en": true,
    "ja": false,
    "zh": false
  },
  "_troubleShootingParams": {
    "Port_E_Stop": {
      "ko": [
        "비상정지 발생",
        "",
        "1. 비상정지 버튼을 해제하세요."
      ],
      "en": [
        "Emergency stop triggered.",
        "",
        "1. Release the E-Stop button."
      ]
    }
  }
}

Design Philosophy

• UI-first: Everything is optimized for WinForms UX
• No business logic duplication: Core owns alarm logic
• DTO-based persistence: Safe across frameworks
• Explicit over implicit: No hidden behaviors

When to Use This Package

✔ You are building a WinForms-based machine UI
✔ You already use (or plan to use) Movensys.AlarmHelper.Core
✔ You want a production-ready alarm UI without re-implementing grids, editors, file I/O

❌ Not intended for WPF / Web / Blazor

Release History

dec 30, 2025 - 1.0.0 ver<br> Initial release

• Alarm History WinForms UI
• Troubleshooting Editor
• JSON file integration

Related Packages

• Movensys.AlarmHelper.Core – Alarm engine & data model
• Movensys.AlarmHelper.Winforms – WinForms UI layer (this package)