Class MeasurePoint

Namespace

Lers.Core

Assembly

Lers.System.dll

Предоставляет методы для работы с точкой учёта.

public abstract class MeasurePoint : EditableRecord, INotifyPropertyChanged, IIncidentContainer, IMeasurePoint, IUniqueObject

Inheritance

object

ServerObject

ServerUniqueObject

EditableRecord

MeasurePoint

Implements

INotifyPropertyChanged

IIncidentContainer

IMeasurePoint

IUniqueObject

Derived

CommunalMeasurePoint

RegularMeasurePoint

Inherited Members

EditableRecord.PropertyChanged

EditableRecord.SaveAsync(SaveOptions)

EditableRecord.DeleteAsync(bool)

EditableRecord.DeleteAsync()

ServerUniqueObject.InvalidRecordId

ServerUniqueObject.NewRecordId

ServerUniqueObject.Id

ServerUniqueObject.IsInvalidRecord

ServerUniqueObject.IsNewRecord

ServerUniqueObject.AssignIdentifier(int)

ServerUniqueObject.Equals(object)

ServerUniqueObject.GetHashCode()

ServerObject.Server

object.Equals(object, object)

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Extension Methods

DetailedStateExtensions.GetDetailedState(MeasurePoint)

MeasurePointExtensions.GetNode(MeasurePoint, NodeInfoFlags)

UniqueObjectExtensions.GetId<T>(T)

EnumerableExtensions.Yield<T>(T)

CastExtensions.CastTo<T>(object)

Fields

MaxCommentLength

Максимальная длина комментария для объекта учета.

public const int MaxCommentLength = 1000

Field Value

int

MaxMeterSerialNumberLength

Максимальная длина серийного номера счетчика.

public const int MaxMeterSerialNumberLength = 20

Field Value

int

MaxTitleLength

Максимальная длина наименования точки учета.

public const int MaxTitleLength = 150

Field Value

int

Properties

Address

Возвращает адрес точки учета.

public virtual string Address { get; }

Property Value

string

AdmissionDate

Дата, до которой точка учёта допущена в эксплуатацию.

public DateTime? AdmissionDate { get; set; }

Property Value

DateTime?

Attributes

Возвращает атрибуты заданные для точки учета.

public MeasurePointAttributeCollection Attributes { get; }

Property Value

MeasurePointAttributeCollection

Remarks

Чтобы получить значение, нужно передать флаг Attributes в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

AutoPoll

Настройка автоматического опроса.

public AutoPollList AutoPoll { get; }

Property Value

AutoPollList

AvailableInfo

Возвращает значение, определяющее какая дополнительная информация о точке учета была получена.

public MeasurePointInfoFlags AvailableInfo { get; }

Property Value

MeasurePointInfoFlags

CalculateOptions

Возвращает параметры расчета данных.

public MeasurePointCalculateOptions CalculateOptions { get; }

Property Value

MeasurePointCalculateOptions

Comment

Возвращает или задает произвольный комментарий.

public string Comment { get; set; }

Property Value

string

ConsumptionLimit

Возвращает коллекцию записей с договорными нагрузками.

public ContractConsumptionCollection ConsumptionLimit { get; }

Property Value

ContractConsumptionCollection

Remarks

Чтобы получить значение, нужно передать флаг ContractConsumption в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

Contract

Возвращает параметры договора.

public MeasurePointContract Contract { get; }

Property Value

MeasurePointContract

ContractConsumption

Возвращает коллекцию записей с договорными нагрузками.

public ContractConsumptionCollection ContractConsumption { get; }

Property Value

ContractConsumptionCollection

Remarks

Чтобы получить значение, нужно передать флаг ContractConsumption в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

CopySettings

Возвращает идентификаторы точек учета, из которых копируются Тхв и Тнв.

public DataCopySettings CopySettings { get; }

Property Value

DataCopySettings

Counter

Возвращает или задает счетчик на точке учета.

public Equipment Counter { get; set; }

Property Value

Equipment

Remarks

Чтобы получить значение, нужно передать флаг Equipment в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

CurrentRatio

Возвращает или задает коэффициент трансформации по току (для точек учета с системой "Электроснабжение").

public float CurrentRatio { get; set; }

Property Value

float

Customer

Потребитель.

public Customer Customer { get; set; }

Property Value

Customer

Data

Содержит методы для работы с данными о потреблении и значениями интеграторов.

public MeasurePointData Data { get; }

Property Value

MeasurePointData

DataParameters

Возвращает или задает список отображаемых в таблице и графиках параметров данных.

public DataParameter[] DataParameters { get; set; }

Property Value

DataParameter[]

Device

Возвращает или задает устройство, используемое для считывания данных по этой точке учета.

public Equipment Device { get; set; }

Property Value

Equipment

Remarks

Чтобы получить значение, нужно передать флаг Equipment в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

DeviceBinding

Возвращает настройку привязки точки учета к устройству.

public MeasurePointDeviceBinding DeviceBinding { get; }

Property Value

MeasurePointDeviceBinding

Remarks

Чтобы получить значение, нужно передать флаг Equipment в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

DeviceId

Возвращает идентификатор устройства

public int? DeviceId { get; }

Property Value

int?

DevicePressureType

Возвращает или задает тип давления в устройстве.

public PressureType DevicePressureType { get; set; }

Property Value

PressureType

DiagDataTypes

Типы данных, по которым производится диагностика нештатных ситуаций по точке учёта.

public DeviceDataType? DiagDataTypes { get; set; }

Property Value

DeviceDataType?

Expressions

Коллекция выражений расчётной точки учёта.

public ExpressionCollection Expressions { get; }

Property Value

ExpressionCollection

FullTitle

Возвращает полное наименование точки учета, включающее наименование Объекта учета или Помещения.

public virtual string FullTitle { get; }

Property Value

string

IsDoublePipeHotWaterSystem

Возвращает или задает значение, определяющее, что эта точка учета имеет инженерную систему двухтрубного ГВС.

public bool IsDoublePipeHotWaterSystem { get; }

Property Value

bool

Remarks

Задать значение можно только для систем ГВС.

Exceptions

InvalidOperationException

Инженерная система точки учета не является ГВС.

IsModified

Получает значение, определяющее, есть ли изменения, которые можно сохранить.

public override bool IsModified { get; }

Property Value

bool

IsReversibleFlow

Возвращает или задает значение, определяющее, возможно ли течение потока в обратном направлении.

public bool IsReversibleFlow { get; set; }

Property Value

bool

Remarks

Это свойство может иметь значение true только для систем ХВС и Теплоснабжения.

IsTwoChannels

Возвращает значение, указывающее, что в этой точке учета доступно две магистрали (подающая и обратная).

public bool IsTwoChannels { get; set; }

Property Value

bool

IsVirtual

Возвращает значение, указывающее, что данная точка учета является расчетной.

public bool IsVirtual { get; set; }

Property Value

bool

NodeId

Возвращает идентификатор объекта учета, которому принадлежит эта точка учета.

public int NodeId { get; protected set; }

Property Value

int

Number

Возвращает или задает уникальный номер точки учета, используемый для связи с внешними системами.

public int Number { get; set; }

Property Value

int

ParentTitle

Наименование родительского объекта.

public string ParentTitle { get; }

Property Value

string

ReportingDay

Возвращает или задает расчетные сутки.

public byte ReportingDay { get; set; }

Property Value

byte

ReportingHour

Возвращает или задает расчетный час.

public byte ReportingHour { get; set; }

Property Value

byte

ReportingHourMode

Возвращает или задает вариант группировки часовых записей по расчетному часу.

public ReportingHourMode ReportingHourMode { get; set; }

Property Value

ReportingHourMode

Reports

Возвращает коллекцию отчетов этой точке учета.

public MeasurePointReportCollection Reports { get; }

Property Value

MeasurePointReportCollection

Remarks

Чтобы получить значение, нужно передать флаг Reports в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

ResourceKind

Возвращает вид ресурса, учитываемого на этой точке учета.

public ResourceKind ResourceKind { get; }

Property Value

ResourceKind

Sensors

Возвращает информацию о датчиках, настроенных в точке учёта.

public MeasurePointSensorsInformation Sensors { get; }

Property Value

MeasurePointSensorsInformation

Remarks

Чтобы получить значение, нужно передать флаг Equipment в метод получения списка точек учёта или в RefreshAsync(MeasurePointInfoFlags).

ServicingStatus

Режим обслуживания точки учёта.

public ServicingStatus ServicingStatus { get; set; }

Property Value

ServicingStatus

ShowBadValues

Возвращает или задает значение, определяющее следует ли отображать недостоверные значения для этой точки учета на графиках, в таблицах и отчетах.

public bool ShowBadValues { get; set; }

Property Value

bool

ShowCalculatedData

Возвращает или задает значение, определяющее следует ли отображать рассчитанные данные для этой точки учета на графиках, в таблицах и отчетах.

public bool ShowCalculatedData { get; set; }

Property Value

bool

State

Возвращает состояние точки учета.

public MeasurePointState State { get; }

Property Value

MeasurePointState

SystemType

Возвращает или задает тип инженерной системы учета.

public SystemType SystemType { get; set; }

Property Value

SystemType

Title

Возвращает или задает наименование.

public string Title { get; set; }

Property Value

string

Type

Возвращает тип этой точки учета.

public abstract MeasurePointType Type { get; }

Property Value

MeasurePointType

UnitsOfMeasurements

Список отображаемых в таблице и графиках единиц измерения.

public MeasurePointUnitOfMeasurementCollection UnitsOfMeasurements { get; set; }

Property Value

MeasurePointUnitOfMeasurementCollection

VoltageRatio

Возвращает или задает коэффициент трансформации по напряжению (для точек учета с системой "Электроснабжение").

public float VoltageRatio { get; set; }

Property Value

float

Methods

CreateSaveParams(EditMeasurePointRequestParameters)

Создает параметры для запроса на сохранение записи.

protected virtual EditMeasurePointRequestParameters CreateSaveParams(EditMeasurePointRequestParameters externalParams)

Parameters

externalParams EditMeasurePointRequestParameters

Returns

EditMeasurePointRequestParameters

GetActiveIncidents()

Асинхронно возвращает список открытых нештатных ситуаций по точке учёта.

public Task<Incident[]> GetActiveIncidents()

Returns

Task<Incident[]>

Задание, которое после окончания вернёт список открытых нештатных ситуаций по точке учёта.

GetContractAnalysisData(DeviceDataType, DateTime, DateTime, bool)

Получает данные сравнения потребления с договорной нагрузкой с возможность указать тип интервала (суточный или месячный).

public ContractAnalysisDataRecord[] GetContractAnalysisData(DeviceDataType deviceDataType, DateTime startDate, DateTime endDate, bool includeSummer)

Parameters

deviceDataType DeviceDataType

Тип интервала.

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

includeSummer bool

Указывает, что нужно включить месяцы с летним режимом.

Returns

ContractAnalysisDataRecord[]

Массив экземпляров класса ContractAnalysisDataRecord.

GetContractAnalysisData(DateTime, DateTime, bool)

Получает месячные данные сравнения потребления с договорной нагрузкой.

public ContractAnalysisDataRecord[] GetContractAnalysisData(DateTime startDate, DateTime endDate, bool includeSummer)

Parameters

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

includeSummer bool

Указывает, что нужно включить месяцы с летним режимом.

Returns

ContractAnalysisDataRecord[]

Массив экземпляров класса ContractAnalysisDataRecord.

GetContractAnalysisDataAsync(DeviceDataType, DateTime, DateTime, bool)

Начинает асинхронную операцию получения данных сравнения потребления с договорной нагрузкой.

public Task<ContractAnalysisDataRecord[]> GetContractAnalysisDataAsync(DeviceDataType deviceDataType, DateTime startDate, DateTime endDate, bool includeSummer)

Parameters

deviceDataType DeviceDataType

Тип интервала.

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

includeSummer bool

Указывает, что нужно включить месяцы с летним режимом.

Returns

Task<ContractAnalysisDataRecord[]>

Задание, содержащее записи с анализом сравнения потребления с договорной нагрузкой.

GetDataParameters()

Возвращает список доступных для этой точки учета параметров.

public DataParameter[] GetDataParameters()

Returns

DataParameter[]

Массив параметров.

GetDataParametersByResourceKind(ResourceKind)

Возвращает список доступных для указанного ресурса параметров.

public static DataParameter[] GetDataParametersByResourceKind(ResourceKind resourceKind)

Parameters

resourceKind ResourceKind

Тип ресурса.

Returns

DataParameter[]

Массив параметров.

GetDataParametersBySystemType(SystemType)

Возвращает список доступных для указанной системы параметров.

public static DataParameter[] GetDataParametersBySystemType(SystemType systemType)

Parameters

systemType SystemType

Тип системы.

Returns

DataParameter[]

Массив параметров.

GetDefaultDataParameters(SystemType, bool)

Возвращает отображаемые параметры по умолчанию для указанной системы.

public static DataParameter[] GetDefaultDataParameters(SystemType systemType, bool isTwoChannels)

Parameters

systemType SystemType

Тип системы.

isTwoChannels bool

Признак двухтрубной системы ГВС.

Returns

DataParameter[]

Массив строк с названиями параметров.

GetIncidentLog(DateTime, DateTime)

Получает журнал нештатных ситуаций за указанный период.

public IncidentLogRecord[] GetIncidentLog(DateTime startDate, DateTime endDate)

Parameters

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

Returns

IncidentLogRecord[]

Массив записей типа IncidentLogRecord.

GetIncidentLogAsync(DateTime, DateTime)

Начинает асинхронную операцию получения журнала нештатных ситуаций за указанный период.

public Task<IncidentLogRecord[]> GetIncidentLogAsync(DateTime startDate, DateTime endDate)

Parameters

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

Returns

Task<IncidentLogRecord[]>

Задание, которое после окончания вернёт журнал нештатных ситуаций.

GetTemperatureChartData(DeviceDataType, DateTime, DateTime)

Получает данные температурного графика.

public TemperatureChartData GetTemperatureChartData(DeviceDataType dataType, DateTime startDate, DateTime endDate)

Parameters

dataType DeviceDataType

Тип данных, для которого запрашивается температурный график.

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

Returns

TemperatureChartData

Возвращает экземпляр TemperatureChartData.

GetTemperatureChartDataAsync(DeviceDataType, DateTime, DateTime)

Начинает асинхронную операцию получения данных температурного графика.

public Task<TemperatureChartData> GetTemperatureChartDataAsync(DeviceDataType dataType, DateTime startDate, DateTime endDate)

Parameters

dataType DeviceDataType

Тип данных, для которого запрашивается температурный график.

startDate DateTime

Начало периода.

endDate DateTime

Окончание периода.

Returns

Task<TemperatureChartData>

Задание, которое после завершения вернёт данные температурного графика.

InitializeUnitsOfMeasurement()

Инициализирует список единиц измерения отображаемых параметров.

public void InitializeUnitsOfMeasurement()

PollCurrentAsync(MeasurePointPollCurrentOptions)

Асинхронно начинает опрос текущих данных.

public Task<int> PollCurrentAsync(MeasurePointPollCurrentOptions options)

Parameters

options MeasurePointPollCurrentOptions

Опции опроса текущих данных.

Returns

Task<int>

Возвращает идентификатор запущенного сеанса опроса или выдаёт исключение PollDataException в случае ошибки.

ProcessSaveResponseData(BaseSaveResponseParameters)

Обрабатывает данные, полученные в ответе на запрос сохранения.

protected override void ProcessSaveResponseData(BaseSaveResponseParameters param)

Parameters

param BaseSaveResponseParameters

Данные, полученные в ответе на запрос сохранения.

Refresh(MeasurePointInfoFlags)

Обновляет информацию с указанием флагов.

public void Refresh(MeasurePointInfoFlags flags)

Parameters

flags MeasurePointInfoFlags

Флаги, определяющие, какую дополнительную информацию необходимо обновить.

RefreshAsync(MeasurePointInfoFlags)

Обновляет информацию с возможностью запросить дополнительную информацию.

public Task RefreshAsync(MeasurePointInfoFlags flags)

Parameters

flags MeasurePointInfoFlags

Флаги, определяющие, какую дополнительную информацию необходимо обновить.

Returns

Task

SetSensorsAsync(IEnumerable<Sensor>)

Асинхронно устанавливает датчики в точку учёта.

public Task SetSensorsAsync(IEnumerable<Sensor> sensorList)

Parameters

sensorList IEnumerable<Sensor>

Список датчиков, которые нужно установить.

Returns

Task

Задание, которое сообщит о завершении асинхронной операции.

Remarks

Заменяет существующие в точке учёта датчики на переданный список.

SystemTypeToResourceKind(SystemType)

Преобразует тип системы в вид ресурса, к которому она относится.

public static ResourceKind SystemTypeToResourceKind(SystemType systemType)

Parameters

systemType SystemType

Тип системы.

Returns

ResourceKind

Вид ресурса.

ToString()

Возвращает полное наименование точки учета.

public override string ToString()

Returns

string

Полное наименование точки учета