---
source_files:
  - Common/DTS.CommonCore/Interface/Groups/IGroupImportImportView.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupHardwareDbRecord.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupImportOptionsView.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupImportPreviewView.cs
  - Common/DTS.CommonCore/Interface/Groups/ITestSetupGroupRecord.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupChannel.cs
  - Common/DTS.CommonCore/Interface/Groups/ITestObject.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupDbRecord.cs
  - Common/DTS.CommonCore/Interface/Groups/IGroupImportViewModel.cs
generated_at: "2026-04-17T15:31:49.103401+00:00"
model: "zai-org/GLM-5-FP8"
schema_version: 1
sha256: "56d6c6478dc26053"
---

# Documentation: DTS.Common.Interface.Groups

## 1. Purpose

This module defines the core interfaces for the Groups subsystem within the DTS application. It provides abstractions for group import workflows (file selection, preview, validation, and commit), database record mappings for groups and hardware associations, test object definitions, and channel representations. The module serves as a contract layer between the group import UI components, business logic, and the application's data layer, enabling loose coupling between the import module and the host application.

---

## 2. Public Interface

### IGroupImportImportView
```csharp
public interface IGroupImportImportView : IBaseView
```
An empty marker interface for views responsible for presenting progress feedback during group creation and commit operations.

---

### IGroupHardwareDbRecord
```csharp
public interface IGroupHardwareDbRecord
```
Describes a GroupHardware database record.

| Property | Type | Description |
|----------|------|-------------|
| `Id` | `int` | Primary key of the GroupHardware record (annotated with `[Key]`, `[Column("Id")]`) |
| `GroupId` | `int` | Foreign key reference to a group |
| `DASId` | `int` | Data Acquisition System identifier |
| `SerialNumber` | `string` | Serial number of the hardware |

---

### IGroupImportOptionsView
```csharp
public interface IGroupImportOptionsView : IBaseView
```
Controls file selection and validation for the import workflow.

| Method | Signature | Description |
|--------|-----------|-------------|
| `Validate` | `bool Validate(out List<string> errors, out List<string> warnings)` | Returns `true` if files have been selected; populates `errors` and `warnings` collections with validation results |

---

### IGroupImportPreviewView
```csharp
public interface IGroupImportPreviewView : IBaseView