DP44/docs/ai/Common/DTS.Common.Serialization/TestSetup/Graph.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.Serialization/TestSetup/Graph/Graph.cs Common/DTS.Common.Serialization/TestSetup/Graph/Channel.cs	2026-04-17T16:26:22.110592+00:00	zai-org/GLM-5-FP8	1	1596815b04ddd43d

Graph

Purpose

This module defines the data structure for a TestSetup.Graph and its nested Channel objects. It serves as a serialization-compatible model for test configurations, wrapping properties in a custom Property construct (likely for change tracking or validation) and exposing metadata about test channels, hardware associations, and versioning. It acts as a bridge between raw test module definitions and serialized storage formats.

Public Interface

Class: TestSetup.Graph

• Graph() - Constructor. Initializes Name to null, Version to "1.0.0.0", and generates a new Identifier.
• void UnSet() - No-op implementation in current source.
• List<Channel> Channels - Gets or sets the list of channels associated with this graph.
• string Name - Gets or sets the name of the graph.
• string HardwareChannelName - Gets or sets the hardware channel name.
• string DisplayName - Read-only. Returns _Name.Value + "_" + _HardwareChannelName.Value.
• string Version - Gets or sets the version string.
• bool IsSingleChannelGraph - (XmlIgnore) Returns true if Channels is not null and contains exactly one channel.
• Channel FirstChannel - (XmlIgnore) Returns the first channel in the Channels list.
• Test.Module.Channel FirstTestChannel - (XmlIgnore) Returns the TestChannel property of the first channel in the list.
• Guid Identifier - (XmlIgnore) Gets a unique identifier for this graph instance; set privately by constructor.

Class: TestSetup.Graph.Channel

• Channel(Test.Module.Channel channel) - Constructor. Initializes the channel from a Test.Module.Channel object.
• Channel(string channelId) - Constructor. Initializes with a specific string ID; sets ParentTestModule and TestChannel to null.
• Channel(long groupChannelId) - Constructor. Initializes with a long ID converted to string; sets ParentTestModule and TestChannel to null.
• string ChannelId - Gets or sets the unique ID for the logical channel.
• string ChannelGroupName - Gets or sets the group name.
• string Name - Read-only. Returns TestChannel.ChannelDescriptionString or "Not Set".
• string SensorName - (XmlIgnore) Returns TestChannel.ChannelDescriptionString or "Not Set".
• string AxisUnit - (XmlIgnore) Returns engineering units if TestChannel is an AnalogInputChannel, otherwise "EU".
• string SerialNumber - (XmlIgnore) Returns ParentTestModule.SerialNumber or "Not Set".
• Test.Module ParentTestModule - (XmlIgnore) Field holding a reference to the parent test module.
• Test.Module.Channel TestChannel - (XmlIgnore) Field holding a reference to the underlying test channel.

Invariants

• Graph.Identifier is immutable after construction (private setter).
• Graph.Version defaults to "1.0.0.0" upon instantiation.
• Channel has a private parameterless constructor, enforcing that instances must be created via one of the public constructors providing data.
• Channel.Name, SensorName, AxisUnit, and SerialNumber all return "Not Set" (or "EU" for units) if TestChannel is null.

Dependencies

• Depends on: System, System.Collections.Generic, DTS.Common.Utilities, DTS.Common.Utilities.DotNetProgrammingConstructs, Test.Module (referenced in Channel constructors and properties).
• Dependents: Unknown from source alone, but likely serialization logic or test setup management components.

Gotchas

• Indexing Risks: The properties FirstChannel and FirstTestChannel access Channels[0] directly without bounds checking. If Channels is null or empty, this will throw an exception.
• DisplayName Format: DisplayName concatenates values with an underscore. If _Name.Value is null (the default), the result will start with an underscore (e.g., _HardwareName).
• Internal Property Wrappers: Public properties are backed by Property objects. The behavior of these wrappers (e.g., validation logic) is defined in DTS.Common.Utilities.DotNetProgrammingConstructs and is not visible here.