DP44/enriched-qwen3-coder-next/DataPRO/Modules/Groups/GroupImport/View.md

---
source_files:
  - DataPRO/Modules/Groups/GroupImport/View/GroupImportImportView.xaml.cs
  - DataPRO/Modules/Groups/GroupImport/View/GroupImportOptionsView.xaml.cs
  - DataPRO/Modules/Groups/GroupImport/View/GroupImportPreviewView.xaml.cs
generated_at: "2026-04-16T04:46:11.528450+00:00"
model: "Qwen/Qwen3-Coder-Next-FP8"
schema_version: 1
sha256: "4920dece220dd9a5"
---

# View

### **Purpose**  
This module provides the WPF UI views for the group import workflow within the DataPRO system, specifically handling user interaction for selecting source files, configuring import options, previewing imported groups and channels, and validating the import state before proceeding. It serves as the presentation layer for the group import functionality, coordinating with a shared `GroupImportViewModel` to manage state and business logic, while enforcing UI-specific validation rules and user privilege checks (e.g., admin-only tag editing).

---

### **Public Interface**  

#### **`GroupImportImportView`**  
- **Type**: `partial class` implementing `IGroupImportImportView`  
- **Constructor**: `GroupImportImportView()`  
  - Initializes the WPF component via `InitializeComponent()`.  
  - *No additional logic or public members exposed beyond initialization.*  

#### **`GroupImportOptionsView`**  
- **Type**: `partial class` implementing `IGroupImportOptionsView`  
- **Constructor**: `GroupImportOptionsView()`  
  - Initializes the WPF component via `InitializeComponent()`.  
- **`Validate(out List<string> errors, out List<string> warnings)`**  
  - **Signature**: `public bool Validate(out List<string> errors, out List<string> warnings)`  
  - **Behavior**: Validates that at least one source file is selected.  
    - Returns `true` if `vm.SourceFiles.Length >= 1`.  
    - Returns `false` and populates `errors` with `StringResources.Preview_NoFilesSelected` if no files are selected.  
  - *Note*: Does not validate file contents or other options—only file presence.  

#### **`GroupImportPreviewView`**  
- **Type**: `partial class` implementing `IGroupImportPreviewView`  
- **Constructor**: `GroupImportPreviewView()`  
  - Initializes the WPF component via `InitializeComponent()`.  
- **Event Handlers** (WPF event wiring, not public API but critical for behavior):  
  - `GroupName_Changed(object sender, TextChangedEventArgs e)`  
    - Updates the `GroupName` property of the bound `GroupGRPImportGroup` instance.  
    - Calls `GroupNameInvalidate()` on all channels in the group.  
    - Triggers `vm.CheckGroupName()` on the `GroupImportViewModel`.  
  - `GroupTags_Changed(object sender, TextChangedEventArgs e)`  
    - Updates the `GroupTags` property of the bound `GroupGRPImportGroup` instance.  
  - `IncludedChecked(object sender, RoutedEventArgs e)`  
    - Calls `vm.InvalidateChannels()` on the `GroupImportViewModel`.  
  - `IncludedUnchecked(object sender, RoutedEventArgs e)`  
    - Calls `vm.InvalidateChannels()` on the `GroupImportViewModel`.  
- **`Validate(bool userIsAdmin, out List<string> errors, out List<string> warnings)`**  
  - **Signature**: `public bool Validate(bool userIsAdmin, out List<string> errors, out List<string> warnings)`  
  - **Behavior**: Performs comprehensive validation of groups and channels for import.  
    - Checks admin-only tag compatibility: if `!userIsAdmin` and `GroupTags` contains tags not in `ImportingUserTags`, adds a formatted error and returns `false`.  
    - Checks `GroupNameHasError`: adds `StringResources.Preview_InvalidName` error and returns `false`.  
    - Checks `GroupErrors`: adds all `ExtraInfo` strings as errors and returns `false`.  
    - Checks if group exists (`vm.CheckGroupExists`) and `!Overwrite`: adds `StringResources.Preview_InvalidName` error and returns `false`.  
    - Iterates channels:  
      - On `ch.Error != null`:  
        - Adds warnings or errors based on `ErrorCode` (e.g., `InvalidISOCodeInput`, `InvalidFullScaleInput`, `SensorNotFound`).  
        - Some errors (`FileEmpty`, `InvalidISOCodeInput`) set `bAnyValidChannels = true` but do *not* fail validation.  
      - On `ch.Error == null`: sets `bValid = true` and `bAnyValidChannels = true`.  
    - If no valid channels exist (`!bAnyValidChannels`), adds `StringResources.Preview_NoGroupsToImport` to errors and returns `false`.  
    - Returns `true` only if no fatal errors occurred and at least one valid channel exists.  

---

### **Invariants**  
- **File Selection**: `GroupImportOptionsView.Validate()` requires `SourceFiles.Length >= 1` for success; otherwise, it fails with a specific error.  
- **Admin Tag Enforcement**: Non-admin users cannot set `GroupTags` that include tags not present in `ImportingUserTags`; this causes immediate validation failure with a detailed error message.  
- **Group Name Validity**: A group with `GroupNameHasError == true`, existing group name without `Overwrite == true`, or non-empty `GroupErrors` causes immediate validation failure in `GroupImportPreviewView.Validate()`.  
- **Channel-Level Errors**:  
  - `FileEmpty` and `InvalidISOCodeInput` errors do *not* prevent import (but may indicate partial failure).  
  - `InvalidFullScaleInput`, `InvalidInvertInput`, `InvalidSensorInput`, and `SensorNotFound` produce warnings but do *not* block import.  
- **No-Import Guard**: If no channels are valid (`bAnyValidChannels == false`), validation fails with `StringResources.Preview_NoGroupsToImport`.  

---

### **Dependencies**  
- **External Dependencies**:  
  - `DTS.Common.Interface.Groups`: Defines interfaces `IGroupImportImportView`, `IGroupImportOptionsView`, `IGroupImportPreviewView`.  
  - `DTS.Common.Classes.Groups`: Provides concrete types `GroupGRPImportGroup`, `GroupGRPImportError`.  
  - `DTS.Common.Strings`: Provides `StringResources` for localized error/warning messages.  
  - `GroupImport.Resources`: Contains `StringResources` (likely auto-generated `.resx`-based resources).  
- **Internal Dependencies**:  
  - `GroupImportViewModel`: Used as `DataContext` in all three views; its methods (`CheckGroupName`, `InvalidateChannels`, `CheckGroupExists`) are called directly.  
  - WPF framework (`System.Windows.Controls`, `System.Windows.RoutedEventArgs`, etc.).  

---

### **Gotchas**  
- **Typo in XML comment**: `GroupImportPreviewView.xaml.cs` has `/// <summary> Interaction logic for GroupImportOptionsView.xaml </summary>` instead of `GroupImportPreviewView.xaml`.  
- **Ambiguous `bValid` logic**: In `GroupImportPreviewView.Validate()`, `bValid` is initialized to `true`, then set to `false` *before* checking channels, and only set to `true` if a channel has no error. This may be confusing—`bValid` is ultimately determined by whether *at least one* channel is valid *and* no fatal errors occurred.  
- **Tag validation is strict**: Non-admin users are blocked if *any* tag in `GroupTags` is not in `ImportingUserTags`. The error message lists both sets explicitly.  
- **Duplicate error suppression**: Errors/warnings are deduplicated via `!errors.Contains(...)` checks, but this is linear-time and may be inefficient for large error sets.  
- **No explicit handling for null `vm`**: All views cast `DataContext` to `GroupImportViewModel` without null checks; a null `DataContext` will cause a `NullReferenceException`.  
- **`GroupNameInvalidate()` and `InvalidateChannels()` are called on UI thread changes**: These likely trigger re-validation or UI refreshes; callers must ensure thread-safety if invoked off-thread (though WPF data binding typically handles this).  
- **`Split()` extension method**: Used on `ImportingUserTags` and `GroupTags` (e.g., `g.ImportingUserTags.Split()`), implying a custom extension method (not standard `string.Split()`); behavior depends on its implementation (e.g., whitespace delimiters? empty entries?).