---
source_files:
  - Common/DTS.Common.Import/DatabaseLocks/LockImportGroups.cs
  - Common/DTS.Common.Import/DatabaseLocks/LockImportTestSetups.cs
  - Common/DTS.Common.Import/DatabaseLocks/LockImportSensors.cs
generated_at: "2026-04-17T15:39:02.672881+00:00"
model: "zai-org/GLM-5-FP8"
schema_version: 1
sha256: "2421f56d39216d6a"
---

# Documentation: DTS.Common.Import.DatabaseLocks

## 1. Purpose

This module provides database locking mechanisms for import operations, ensuring that concurrent imports do not conflict by acquiring locks on Groups, TestSetups, and Sensors before import proceeds. It implements the `ILockImport` interface across three classes—`LockImportGroups`, `LockImportTestSetups`, and `LockImportSensors`—each managing locks for a specific entity type. The module handles lock acquisition, detection of contended locks (locks held by other users), automatic reclamation of expired "stranded" locks, and privileged lock stealing by administrators. All three classes reference FB 36740 in their namespace comments, suggesting they were created to address a specific feature request or bug fix.

---

## 2. Public Interface

### Interface: `ILockImport` (from `DTS.Common.Import.Interfaces`)

All three classes implement this interface with the following members:

#### `bool Contended { get; }`
Returns `true` if any items could not be locked because another user holds the lock.

#### `void FreeLock(ref ImportObject importObject)`
Releases all locks currently held by this instance. Iterates through the internal locked items list and calls `LockManager.FreeLock` for each. The `importObject` parameter is passed by reference but **is not used** in the implementation.

#### `void SetLock(ref ImportObject importObject, ref StringBuilder message)`
Attempts to acquire locks on all relevant items from the `importObject`. Populates the `message` StringBuilder with details of any contended items. Clears internal lock tracking lists at the start of execution.

#### `bool StealLock(bool proceed)`
Attempts to forcibly acquire contended locks. Returns `true` if no contention exists or if locks were successfully stolen; `false` if the user lacks admin privileges or `proceed` is `false`.

---

### Class: `LockImportGroups`

**Constructor:**
```csharp
public LockImportGroups(User currentUser, double strandedLockTimeoutMinutes)
```

**Behavior:**
- Locks items from `importObject.StaticGroups()`
- Uses `LockManager.ItemCategories.Group` for lock operations
- Tracks locks in `_lockedGroups` (successful) and `_contendedGroups` (failed due to contention)
- Uses `StringResources.ImportTestSetup_GroupsLocked` for contention messages

---

### Class: `LockImportTestSetups`

**Constructor:**
```csharp
public LockImportTestSetups(User currentUser, double strandedLockTimeoutMinutes)
```

**Behavior:**
- Locks items from `importObject.TestSetups()`
- Uses `LockManager.ItemCategories.TestSetup` for initial lock attempts
- Tracks locks in `_lockedTests` (