Class MeasurePointData

Namespace

Lers.Core

Assembly

Lers.System.dll

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

public sealed class MeasurePointData : IMeasurePointData

Inheritance

object

MeasurePointData

Implements

IMeasurePointData

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

EnumerableExtensions.Yield<T>(T)

CastExtensions.CastTo<T>(object)

Methods

DeleteConsumption(DateTimeInterval, DeviceDataType)

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

public void DeleteConsumption(DateTimeInterval interval, DeviceDataType dataType)

Parameters

interval DateTimeInterval

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

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

DeleteConsumption(IEnumerable<DateTimeInterval>, DeviceDataType)

Удаляет данные о потреблении по точке учета в указанных интервалах.

public void DeleteConsumption(IEnumerable<DateTimeInterval> intervals, DeviceDataType dataType)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов, в которых будут удалены все записи с потреблением.

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

DeleteConsumption(IEnumerable<DateTime>, DeviceDataType)

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

public void DeleteConsumption(IEnumerable<DateTime> dateTimes, DeviceDataType dataType)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, за которые необходимо удалить записи с потреблением.

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

DeleteConsumptionAsync(DateTimeInterval, DeviceDataType)

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

public Task DeleteConsumptionAsync(DateTimeInterval interval, DeviceDataType dataType)

Parameters

interval DateTimeInterval

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

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

Returns

Task

Задание, представляющее асинхронную операцию.

DeleteConsumptionAsync(IEnumerable<DateTimeInterval>, DeviceDataType)

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

public Task DeleteConsumptionAsync(IEnumerable<DateTimeInterval> intervals, DeviceDataType dataType)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов, в которых будут удалены все записи с потреблением.

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

Returns

Task

Задание, представляющее асинхронную операцию.

DeleteConsumptionAsync(IEnumerable<DateTime>, DeviceDataType)

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

public Task DeleteConsumptionAsync(IEnumerable<DateTime> dateTimes, DeviceDataType dataType)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, за которые необходимо удалить записи с потреблением.

dataType DeviceDataType

Тип данных (Current, Hour, Day или Month).

Returns

Task

Задание, представляющее асинхронную операцию.

DeleteElectricPower(DateTimeInterval)

Удаляет записи профиля мощности по точке учета в указанном интервале.

public void DeleteElectricPower(DateTimeInterval interval)

Parameters

interval DateTimeInterval

Интервал, в котором необходимо удалить записи.

DeleteElectricPower(IEnumerable<DateTimeInterval>)

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

public void DeleteElectricPower(IEnumerable<DateTimeInterval> intervals)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов, в которых необходимо удалить записи.

DeleteElectricPower(IEnumerable<DateTime>)

Удаляет записи профиля мощности по точке учета за указанные значения даты и времени.

public void DeleteElectricPower(IEnumerable<DateTime> dateTimes)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, на которые необходимо удалить записи.

DeleteElectricPowerAsync(DateTimeInterval)

Асинхронно удаляет записи профиля мощности по точке учета в указанном интервале.

public Task DeleteElectricPowerAsync(DateTimeInterval interval)

Parameters

interval DateTimeInterval

Интервал времени, в котором необходимо удалить записи.

Returns

Task

Задание, представляющее собой асинхронную операцию.

DeleteElectricPowerAsync(IEnumerable<DateTimeInterval>)

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

public Task DeleteElectricPowerAsync(IEnumerable<DateTimeInterval> intervals)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов времени, за которые необходимо удалить записи.

Returns

Task

Задание, представляющее собой асинхронную операцию.

DeleteElectricPowerAsync(IEnumerable<DateTime>)

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

public Task DeleteElectricPowerAsync(IEnumerable<DateTime> dateTimes)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, на которые необходимо удалить записи.

Returns

Task

Задание, представляющее собой асинхронную операцию.

DeleteTotals(DateTimeInterval)

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

public void DeleteTotals(DateTimeInterval interval)

Parameters

interval DateTimeInterval

Интервал, в котором необходимо удалить записи с интеграторами.

DeleteTotals(IEnumerable<DateTimeInterval>)

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

public void DeleteTotals(IEnumerable<DateTimeInterval> intervals)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов, в которых необходимо удалить записи с интеграторами.

DeleteTotals(IEnumerable<DateTime>)

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

public void DeleteTotals(IEnumerable<DateTime> dateTimes)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, на которые необходимо удалить записи с интеграторами.

DeleteTotalsAsync(DateTimeInterval)

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

public Task DeleteTotalsAsync(DateTimeInterval interval)

Parameters

interval DateTimeInterval

Интервал времени, в котором необходимо удалить записи с интеграторами.

Returns

Task

Задание, представляющее асинхронную операцию.

DeleteTotalsAsync(IEnumerable<DateTimeInterval>)

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

public Task DeleteTotalsAsync(IEnumerable<DateTimeInterval> intervals)

Parameters

intervals IEnumerable<DateTimeInterval>

Список интервалов времени, за которые необходимо удалить записи с интеграторами.

Returns

Task

Задание, представляющее асинхронную операцию.

DeleteTotalsAsync(IEnumerable<DateTime>)

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

public Task DeleteTotalsAsync(IEnumerable<DateTime> dateTimes)

Parameters

dateTimes IEnumerable<DateTime>

Список значений даты и времени, на которые необходимо удалить записи с интеграторами.

Returns

Task

Задание, представляющее асинхронную операцию.

ExportElectricPowerToXml80020(DateTime, DateTime, ElectricDataKind, ElectricPowerAveraging)

Экспортирует данные профиля мощности в файл формата XML макета 80020.

public byte[] ExportElectricPowerToXml80020(DateTime startDate, DateTime endDate, ElectricDataKind electricDataKind, ElectricPowerAveraging averagingInterval)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

electricDataKind ElectricDataKind

Вид значений по электроэнергии (исходные/реальные).

averagingInterval ElectricPowerAveraging

Интервал осреднения.

Returns

byte[]

Бинарное содержимое файла с данными в формате XML макета 80020.

ExportElectricPowerToXml80020Async(DateTime, DateTime, ElectricDataKind, ElectricPowerAveraging)

Экспортирует данные профиля мощности в файл формата XML макета 80020.

public Task<byte[]> ExportElectricPowerToXml80020Async(DateTime startDate, DateTime endDate, ElectricDataKind electricDataKind, ElectricPowerAveraging averagingInterval)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

electricDataKind ElectricDataKind

Вид значений по электроэнергии (исходные/реальные).

averagingInterval ElectricPowerAveraging

Интервал осреднения.

Returns

Task<byte[]>

Бинарное содержимое файла с данными в формате XML макета 80020.

GetConsumption(DateTime, DateTime, MeasurePointGetConsumptionOptions)

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

public MeasurePointConsumption GetConsumption(DateTime startDate, DateTime endDate, MeasurePointGetConsumptionOptions opts)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

opts MeasurePointGetConsumptionOptions

Returns

MeasurePointConsumption

Записи с потреблением.

GetConsumption(DateTime, DateTime, DeviceDataType)

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

public MeasurePointConsumptionRecordCollection GetConsumption(DateTime startDate, DateTime endDate, DeviceDataType dataType)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

dataType DeviceDataType

Тип данных.

Returns

MeasurePointConsumptionRecordCollection

Записи с потреблением.

GetConsumptionAsync(DateTime, DateTime, MeasurePointGetConsumptionOptions)

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

public Task<MeasurePointConsumption> GetConsumptionAsync(DateTime startDate, DateTime endDate, MeasurePointGetConsumptionOptions options)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

options MeasurePointGetConsumptionOptions

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

Returns

Task<MeasurePointConsumption>

GetConsumptionAsync(DateTime, DateTime, DeviceDataType)

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

public Task<MeasurePointConsumptionRecordCollection> GetConsumptionAsync(DateTime startDate, DateTime endDate, DeviceDataType dataType)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

dataType DeviceDataType

Тип данных.

Returns

Task<MeasurePointConsumptionRecordCollection>

Задание, которое после завершения вернёт коллекцию записей с потреблением.

GetConsumptionDataInfoAsync()

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

public Task<MeasurePointConsumptionDataInfo> GetConsumptionDataInfoAsync()

Returns

Task<MeasurePointConsumptionDataInfo>

GetDataStatusAsync(DeviceDataType, DateTime, DateTime)

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

public Task<MeasurePointDataStatus> GetDataStatusAsync(DeviceDataType dataTypes, DateTime startDate, DateTime endDate)

Parameters

dataTypes DeviceDataType

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

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

Returns

Task<MeasurePointDataStatus>

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

GetDeviceErrors(DeviceDataType, DateTime, DateTime)

Получает архив ошибок устройства по точке учета.

public MeasurePointDeviceErrors GetDeviceErrors(DeviceDataType dataTypes, DateTime startDate, DateTime endDate)

Parameters

dataTypes DeviceDataType

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

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

Returns

MeasurePointDeviceErrors

Экземпляр MeasurePointDeviceErrors.

GetDeviceErrorsAsync(DeviceDataType, DateTime, DateTime)

Возвращает архив ошибок устройства по точке учета.

public Task<MeasurePointDeviceErrors> GetDeviceErrorsAsync(DeviceDataType dataTypes, DateTime startDate, DateTime endDate)

Parameters

dataTypes DeviceDataType

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

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

Returns

Task<MeasurePointDeviceErrors>

Задание, содержащее архив ошибок по точке учёта.

GetElectricPower(DateTime, DateTime, ElectricDataKind, ElectricPowerAveraging)

Получает профиль мощности по точке учёта.

public MeasurePointElectricPowerRecordCollection GetElectricPower(DateTime startDate, DateTime endDate, ElectricDataKind dataKind = ElectricDataKind.Real, ElectricPowerAveraging averagingInterval = ElectricPowerAveraging.Default)

Parameters

startDate DateTime

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

endDate DateTime

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

dataKind ElectricDataKind

Вид данных: исходные со счетчика или реальные, с учетом коэффициентов трансформации.

averagingInterval ElectricPowerAveraging

Интервал осреднения.

Returns

MeasurePointElectricPowerRecordCollection

Задание, которое после окончания вернёт коллекцию записей с профилем мощности.

GetElectricPowerAsync(DateTime, DateTime, ElectricDataKind, ElectricPowerAveraging)

Асинхронно получает профиль мощности по точке учёта.

public Task<MeasurePointElectricPowerRecordCollection> GetElectricPowerAsync(DateTime startDate, DateTime endDate, ElectricDataKind dataKind = ElectricDataKind.Real, ElectricPowerAveraging averagingInterval = ElectricPowerAveraging.Default)

Parameters

startDate DateTime

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

endDate DateTime

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

dataKind ElectricDataKind

Вид данных: исходные со счетчика или реальные, с учетом коэффициентов трансформации.

averagingInterval ElectricPowerAveraging

Интервал осреднения.

Returns

Task<MeasurePointElectricPowerRecordCollection>

Задание, которое после окончания вернёт коллекцию записей с профилем мощности.

GetLastConsumptionAsync()

Асинхронно получает последние данные потребления по точке учёта.

public Task<MeasurePointLastConsumptionRecord> GetLastConsumptionAsync()

Returns

Task<MeasurePointLastConsumptionRecord>

GetLastTotalsAsync()

Получает последние показания по точке учета.

public Task<MeasurePointLastTotalsRecord> GetLastTotalsAsync()

Returns

Task<MeasurePointLastTotalsRecord>

Возвращает экземпляр MeasurePointTotalsRecord или null, если показания отсутствуют.

GetTotals(DateTime, DateTime)

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

public MeasurePointTotalsRecordCollection GetTotals(DateTime startDate, DateTime endDate)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

Returns

MeasurePointTotalsRecordCollection

Задание, которое после окончания вернёт коллекцию записей с интеграторами.

GetTotals(DateTime, DateTime, MeasurePointGetTotalsOptions)

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

public MeasurePointTotalsRecordCollection GetTotals(DateTime startDate, DateTime endDate, MeasurePointGetTotalsOptions options)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

options MeasurePointGetTotalsOptions

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

Returns

MeasurePointTotalsRecordCollection

Записи с интеграторами.

GetTotalsAsync(DateTime, DateTime)

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

public Task<MeasurePointTotalsRecordCollection> GetTotalsAsync(DateTime startDate, DateTime endDate)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

Returns

Task<MeasurePointTotalsRecordCollection>

Задание, которое после окончания вернёт коллекцию записей с интеграторами.

GetTotalsAsync(DateTime, DateTime, MeasurePointGetTotalsOptions)

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

public Task<MeasurePointTotalsRecordCollection> GetTotalsAsync(DateTime startDate, DateTime endDate, MeasurePointGetTotalsOptions options)

Parameters

startDate DateTime

Начальная дата периода.

endDate DateTime

Конечная дата периода.

options MeasurePointGetTotalsOptions

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

Returns

Task<MeasurePointTotalsRecordCollection>

Задание, которое после окончания вернёт коллекцию записей с интеграторами.

NewConsumptionRecord(DateTime)

Создает пустую запись о потреблении.

public MeasurePointConsumptionRecord NewConsumptionRecord(DateTime dateTime)

Parameters

dateTime DateTime

Дата и время.

Returns

MeasurePointConsumptionRecord

NewTotalsRecord(DateTime)

Создает пустую запись с интеграторами.

public MeasurePointTotalsRecord NewTotalsRecord(DateTime dateTime)

Parameters

dateTime DateTime

Дата и время.

Returns

MeasurePointTotalsRecord

RecalcDataAsync(DateTime, DateTime)

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

public Task RecalcDataAsync(DateTime startDate, DateTime endDate)

Parameters

startDate DateTime

Начало пересчитываемого периода.

endDate DateTime

Конец пересчитываемого периода.

Returns

Task

Задание, представляющее собой запущенную асинхронную операцию.

SaveCurrentArchive(ICollection<MeasurePointConsumptionRecord>, MeasurePointSetConsumptionOptions)

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

public Task SaveCurrentArchive(ICollection<MeasurePointConsumptionRecord> currentConsumptionList, MeasurePointSetConsumptionOptions options)

Parameters

currentConsumptionList ICollection<MeasurePointConsumptionRecord>

Список данных для сохранения.

options MeasurePointSetConsumptionOptions

Параметры сохранения.

Returns

Task

Задание, после завершения которого на сервере будут сохранены текущие архивные данные.

SetConsumption(MeasurePointConsumptionRecordCollection, MeasurePointSetConsumptionOptions)

Сохраняет потребление по точке учёта.

public void SetConsumption(MeasurePointConsumptionRecordCollection consumption, MeasurePointSetConsumptionOptions options)

Parameters

consumption MeasurePointConsumptionRecordCollection

options MeasurePointSetConsumptionOptions

SetConsumptionAsync(MeasurePointConsumptionRecordCollection, MeasurePointSetConsumptionOptions)

Асинхронно сохраняет потребление по точке учёта.

public Task SetConsumptionAsync(MeasurePointConsumptionRecordCollection consumption, MeasurePointSetConsumptionOptions options)

Parameters

consumption MeasurePointConsumptionRecordCollection

Коллекция записей с данными о потреблении.

options MeasurePointSetConsumptionOptions

Параметры сохранения.

Returns

Task

Задание, представляющее собой асинхронную операцию сохранения.

Remarks

Этот метод только сохраняет данные на сервере, расчёт недостающих значений и архивов не выполняется. Чтобы рассчитать недостающие данные и архивы, используйте метод SetDataAsync(MeasurePointConsumptionRecordCollection, MeasurePointTotalsRecordCollection, MeasurePointSetConsumptionOptions) или запустите перерасчёт вручную, вызвав метод RecalcDataAsync(DateTime, DateTime)

SetData(MeasurePointConsumptionRecordCollection, MeasurePointTotalsRecordCollection, MeasurePointSetConsumptionOptions)

Сохраняет данные по точке учёта.

public void SetData(MeasurePointConsumptionRecordCollection consumption, MeasurePointTotalsRecordCollection totals, MeasurePointSetConsumptionOptions options)

Parameters

consumption MeasurePointConsumptionRecordCollection

Сохраняемое потребление.

totals MeasurePointTotalsRecordCollection

Сохраняемые интеграторы.

options MeasurePointSetConsumptionOptions

Дополнительные параметры, используемые для сохранения данных.

Remarks

Сохранение данных с помощью этого метода запускает на сервере расчёт недостающих параметров и архивов. Метод рекомендуется использовать для импорта данных в систему.

SetDataAsync(MeasurePointConsumptionRecordCollection, MeasurePointTotalsRecordCollection, MeasurePointSetConsumptionOptions)

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

public Task SetDataAsync(MeasurePointConsumptionRecordCollection consumption, MeasurePointTotalsRecordCollection totals, MeasurePointSetConsumptionOptions options)

Parameters

consumption MeasurePointConsumptionRecordCollection

Сохраняемое потребление.

totals MeasurePointTotalsRecordCollection

Сохраняемые интеграторы.

options MeasurePointSetConsumptionOptions

Дополнительные параметры, используемые для сохранения данных.

Returns

Task

Remarks

Сохранение данных с помощью этого метода запускает на сервере расчёт недостающих параметров и архивов. Метод рекомендуется использовать для импорта данных в систему.

SetElectricPowerAsync(MeasurePointElectricPowerRecordCollection, MeasurePointSetConsumptionOptions)

Асинхронно сохраняет данные профиля мощности.

public Task SetElectricPowerAsync(MeasurePointElectricPowerRecordCollection electricPower, MeasurePointSetConsumptionOptions options)

Parameters

electricPower MeasurePointElectricPowerRecordCollection

options MeasurePointSetConsumptionOptions

Returns

Task

SetTotals(MeasurePointTotalsRecordCollection, MeasurePointSetTotalsOptions)

Сохраняет интеграторы по точке учёта.

public void SetTotals(MeasurePointTotalsRecordCollection totals, MeasurePointSetTotalsOptions options)

Parameters

totals MeasurePointTotalsRecordCollection

options MeasurePointSetTotalsOptions

SetTotalsAsync(MeasurePointTotalsRecordCollection, MeasurePointSetTotalsOptions)

Асинхронная операция сохранения значений интеграторов по точке учета.

public Task SetTotalsAsync(MeasurePointTotalsRecordCollection totals, MeasurePointSetTotalsOptions options)

Parameters

totals MeasurePointTotalsRecordCollection

Коллекция записей значений интеграторов.

options MeasurePointSetTotalsOptions

Параметры сохранения.

Returns

Task

Задание, представляющее собой асинхронную операцию сохранения.

Remarks

Этот метод только сохраняет данные на сервере, расчёт недостающих значений и архивов не выполняется. Чтобы рассчитать недостающие данные и архивы, используйте метод SetDataAsync(MeasurePointConsumptionRecordCollection, MeasurePointTotalsRecordCollection, MeasurePointSetConsumptionOptions) или запустите перерасчёт вручную, вызвав метод RecalcDataAsync(DateTime, DateTime).

SubscribeSaveCurrents(LersServer, int)

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

public static void SubscribeSaveCurrents(LersServer server, int pollSessionId = -1)

Parameters

server LersServer

pollSessionId int

UnsubscribeSaveCurrents(LersServer)

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

public static void UnsubscribeSaveCurrents(LersServer server)

Parameters

server LersServer

Events

CurrentsSaved

Событие вызывается при сохранении текущих данных по точке учёта. Чтобы его получить нужно подписаться на уведомления методом SubscribeSaveCurrents(LersServer, int)

public static event EventHandler<MeasurePointConsumptionEventArgs> CurrentsSaved

Event Type

EventHandler<MeasurePointConsumptionEventArgs>