DP44/enriched-qwen3-coder-next/DataPRO/Modules/SystemSettings/DBImportExport/ViewModel.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/Modules/SystemSettings/DBImportExport/ViewModel/DBViewModel.cs	2026-04-16T04:40:45.205601+00:00	Qwen/Qwen3-Coder-Next-FP8	1	197f884be4481037

ViewModel

Documentation: DBViewModel (DBImportExport Module)

---

1. Purpose

The DBViewModel class serves as the view model for database import and export functionality within the DataPRO application. It acts as a bridge between the UI (via IDBImportView and IDBExportView) and the underlying data layer, handling user interactions for selecting import/export files, validating data, and performing file I/O operations using XML strings. Due to architectural constraints (legacy DataPRO objects reside in a separate project), its functionality is currently limited to managing XML string data flow—not direct database manipulation.

---

2. Public Interface

Constructor

public DBViewModel(
    IDBImportView importView,
    IDBExportView exportView,
    IRegionManager regionManager,
    IEventAggregator eventAggregator,
    IUnityContainer unityContainer)

• Initializes the view model with views, region/event management, and dependency injection containers.
• Sets DataContext of both views to this.
• Subscribes to RaiseNotification and BusyIndicatorChangeNotification events.

Lifecycle Methods (No-op)

All lifecycle methods currently have empty implementations:

• void Cleanup()
• Task CleanupAsync()
• void Initialize()
• void Initialize(object parameter)
• void Initialize(object parameter, object model)
• Task InitializeAsync()
• Task InitializeAsync(object parameter)
• void Activated()

Event Handlers (Internal)

• private void OnBusyIndicatorNotification(bool eventArg)
  Sets IsBusy to eventArg.
• private void OnRaiseNotification(NotificationContentEventArgs eventArgsWithTitle)
  Converts NotificationContentEventArgs to Notification and raises NotificationRequest.

Public Methods

• public void Export()
  Writes ExportData (XML string) to ExportFileName using Encoding.Unicode.
  Validation checks:
  • Fails early if ExportFileName or ExportData is null/whitespace, publishing a ShowStatus event with failure message.
  • If ExportFileName already exists, deletes/moves it via FileUtils.DeleteFileOrMove.
  • Writes file using File.WriteAllText.

Interaction Requests (Public)

• public InteractionRequest<Notification> NotificationRequest { get; }
  Used to trigger notification popups (e.g., success/error messages).
• public InteractionRequest<Confirmation> ConfirmationRequest { get; }
  Reserved for confirmation dialogs (not used in current implementation).

Commands (Public)

• public DelegateCommand ImportBrowseCommand { get; }
  Opens an OpenFileDialog to select an import file. Sets ImportFileName and updates ImportStatusText.
• public DelegateCommand ExportBrowseCommand { get; }
  Opens a SaveFileDialog to set ExportFileName.

Properties (Public)

• IDBImportView ImportView { get; set; }
  Reference to the import view instance.
• IDBExportView ExportView { get; set; }
  Reference to the export view instance.
• bool IsDirty { get; private set; }
  Always false (never set).
• bool IsBusy { get; set; }
  Bound to busy indicator; updated via OnBusyIndicatorNotification.
• bool IsMenuIncluded { get; set; }
  Property exposed for UI binding (value never read/written beyond property setter).
• bool IsNavigationIncluded { get; set; }
  Same as above.
• string HeaderInfo { get; }
  Hardcoded to "MainRegion".
• string ImportData { get; set; }
  XML string for imported data (no import logic implemented—only storage).
• string ExportData { get; set; }
  XML string for exported data (no export logic implemented—only storage).
• string ExportFileName { get; set; }
  Full path to export file.
• string ImportFileName { get; set; }
  Full path to import file.
• string ImportStatusText { get; set; }
  Status message for import UI (e.g., warning about database overwrite).
• event PropertyChangedEventHandler PropertyChanged
  Implements INotifyPropertyChanged.
• void OnPropertyChanged(string propertyName)
  Raises PropertyChanged event.

Nested Type

• public enum PropertyNames
  Lists property names used in OnPropertyChanged:
  ExportFileName, ImportFileName, ImportStatusText.

---

3. Invariants

• Export() requires:
  • ExportFileName must be non-null/non-whitespace.
  • ExportData must be non-null/non-whitespace.
• Export() guarantees:
  • If file exists at ExportFileName, it is deleted/moved before writing.
  • File is written using Encoding.Unicode.
• ImportBrowseMethod():
  • Uses OpenFileDialog with CheckFileExists = true and CheckPathExists = true.
  • Sets ImportFileName only if dialog succeeds.
• ExportBrowseMethod():
  • Uses SaveFileDialog with OverwritePrompt = false.
  • Sets ExportFileName only if dialog succeeds.
• IsBusy is updated synchronously via event subscription (on publisher thread).
• ImportStatusText is updated only in ImportBrowseMethod() (no import operation is triggered by this view model).

---

4. Dependencies

Imports/Usings

• System.ComponentModel, System.ComponentModel.Composition, System.Threading.Tasks
• DTS.Common.Events (e.g., RaiseNotification, BusyIndicatorChangeNotification, ShowStatus, StatusInfo)
• Prism.Events, Prism.Regions, Prism.Commands
• Unity (for IUnityContainer)
• DTS.Common.Interface (e.g., IDBImportView, IDBExportView, IDBViewModel)
• DTS.Common.Utils (e.g., FileUtils)
• DTS.Common.Interactivity (e.g., InteractionRequest<T>)
• System.Text (for Encoding)
• System.Windows.Forms (for OpenFileDialog, SaveFileDialog)

Consumed Types

• IDBImportView, IDBExportView, IDBViewModel (from DBImportExport namespace)
• NotificationContentEventArgs, StatusInfo, StatusInfo.StatusState
• FileUtils.DeleteFileOrMove
• Resources.StringResources (for UI strings: ImportFileBrowse_Filter, ExportFileBrowse_Filter, ExportFileName_Empty, ExportFileData_Empty)

Depended Upon By

• Prism-based shell/shell regions (via IRegionManager).
• Event publishers (e.g., RaiseNotification, BusyIndicatorChangeNotification).
• Views (IDBImportView, IDBExportView) bound to this view model.

---

5. Gotchas

• No actual import/export logic:
  ImportData and ExportData are only storage properties. No code parses, validates, or processes the XML strings. Import/export is purely file I/O—no database interaction occurs in this class.
• Cleanup()/Initialize() are no-ops:
  Lifecycle methods exist for interface compliance but perform no work.
• IsDirty is never set:
  Always false; likely unused or incomplete.
• IsMenuIncluded/IsNavigationIncluded unused:
  Properties exist but have no observed consumers in this file.
• Hardcoded HeaderInfo:
  Always "MainRegion"—no dynamic behavior.
• LogDummyFunc does nothing:
  Passed to FileUtils.DeleteFileOrMove but never logs (silently ignores errors).
• No import operation triggered:
  ImportFileName is set via browse dialog, but no Import() method exists to process the file.
• Export() writes directly without user confirmation:
  Overwrites existing files silently (only uses FileUtils.DeleteFileOrMove).
• NotificationRequest conversion quirk:
  OnRaiseNotification constructs a new NotificationContentEventArgs with empty strings for Image and CommandParameter—may lose data if callers rely on them.
• Thread safety:
  IsBusy updates occur on PublisherThread (via ThreadOption.PublisherThread), but other properties lack thread-safety guarantees.

None identified from source alone for critical bugs or anti-patterns beyond the above architectural limitations.