DP44/enriched-qwen3-coder-next/DataPRO/Modules/Hardware/HardwareList/Converters.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/Modules/Hardware/HardwareList/Converters/FirstUseDateConverter.cs DataPRO/Modules/Hardware/HardwareList/Converters/StandInFieldConverter.cs	2026-04-16T04:37:34.782938+00:00	Qwen/Qwen3-Coder-Next-FP8	1	aee017cd34357419

Converters

Documentation: HardwareList.Converters Module

---

1. Purpose

This module provides WPF value converters for formatting and conditional display of hardware-related properties in UI-bound data grids or forms. Specifically, FirstUseDateConverter and StandInFieldConverter translate raw model data into user-friendly string representations (e.g., "N/A", "---", or actual DateTime values), handling edge cases such as missing, invalid, or inapplicable data based on hardware state (e.g., StandIn flag). These converters enable consistent, declarative UI formatting without cluttering view models with presentation logic.

---

2. Public Interface

FirstUseDateConverter

Namespace: HardwareList.Converters
Implements: IValueConverter

• Convert(object value, Type targetType, object parameter, CultureInfo culture)

  • Behavior:
    • If value is not a HardareList.Model.HardwareModel, returns Strings.Table_NA.
    • If model.IsFirstUseValid is false, returns Strings.NotApplicable.
    • If model.FirstUseDate is non-null, returns model.FirstUseDate (as DateTime?).
    • Otherwise, returns Strings.Table_NA.
  • Return type: object (typically string or DateTime?).

• ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)

  • Behavior:
    • If value is a DateTime, returns it.
    • Otherwise, returns Strings.Table_NA.
  • Note: This is a minimal reverse converter; it does not validate or parse strings.
  • Return type: object.

---

StandInFieldConverter

Namespace: HardwareList.Converters
Implements: IValueConverter

• Convert(object value, Type targetType, object parameter, CultureInfo culture)

  • Behavior:
    • If value is not a HardareList.Model.HardwareModel, returns Strings.Table_NA.
    • If model.Hardware does not implement IISOHardware, returns string.Empty.
    • If isoHW.StandIn is true, returns Strings.Table_NA.
    • If parameter is a string matching "CalDueDate", "CalDate", or "Firmware", returns the corresponding property (model.CalDueDate, model.CalDate, or model.Firmware).
    • Otherwise, returns Strings.Table_NA.
  • Return type: object (typically string, DateTime?, or object depending on the requested field).

• ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)

  • Behavior:
    • If value is a DateTime, returns it.
    • Otherwise, returns Strings.Table_NA.
  • Return type: object.

---

3. Invariants

• Type Safety: Both converters expect the input value to be a HardareList.Model.HardwareModel. Failure to meet this results in fallback to Strings.Table_NA.
• Null Handling:
  • FirstUseDateConverter treats null FirstUseDate as "---" (Strings.Table_NA), distinct from IsFirstUseValid == false which yields "N/A" (Strings.NotApplicable).
  • StandInFieldConverter short-circuits to Strings.Table_NA if isoHW.StandIn is true, regardless of the requested field.
• Parameter Dependency (StandInFieldConverter only):
  • The converter’s output depends critically on the parameter being a string matching one of the three known keys ("CalDueDate", "CalDate", "Firmware"). Any other parameter yields Strings.Table_NA.
• No Validation on ConvertBack: Both converters perform no validation or parsing in ConvertBack; they only pass through DateTime values or return Strings.Table_NA.

---

4. Dependencies

• Internal Dependencies (from source):

  • HardareList.Model.HardwareModel (note: likely typo in namespace HardareList vs. HardwareList).
  • DTS.Common.Strings (provides Strings.Table_NA, Strings.NotApplicable).
  • DTS.Common.Interface.DASFactory.Diagnostics.IISOHardware (used in StandInFieldConverter).
  • System.Windows.Data.IValueConverter (WPF base interface).

• External Dependencies:

  • WPF framework (for IValueConverter usage in XAML).
  • DTS.Common assembly (contains Strings and IISOHardware).

• Depended Upon By:

  • UI layers (XAML bindings) referencing these converters in DataGrid columns or TextBlock bindings for hardware properties.
  • No direct code dependencies inferred—converters are consumed via XAML markup extension or resource references.

---

5. Gotchas

• Typo in Namespace: The model type is referenced as HardareList.Model.HardwareModel (missing 'w' in "Hardware"), which may cause runtime binding failures if the actual namespace is HardwareList.
• Ambiguous parameter Usage: StandInFieldConverter relies on string literals for field selection ("CalDueDate", etc.). Typos or case mismatches in XAML parameter values will silently fall back to Strings.Table_NA.
• Inconsistent ConvertBack Behavior: Both converters return Strings.Table_NA for non-DateTime inputs in ConvertBack, which may be misleading if the UI expects a null or DateTime? result (e.g., for nullable fields like CalDueDate).
• No Handling for Invalid IISOHardware Cast: In StandInFieldConverter, if model.Hardware is non-null but not IISOHardware, the converter returns string.Empty—a subtle distinction from Strings.Table_NA ("---"), which could cause visual inconsistency.
• Missing Documentation for Strings Values: While Strings.Table_NA and Strings.NotApplicable are used, their exact string values (e.g., "---" vs "N/A") are not visible in this source and must be verified in DTS.Common.Strings.

None identified beyond the above.