Пример макета

Формат файла – xml в кодировке UTF-8.

Описание структуры файла

1. Элемент <Import> является корневым. Потомком элемента <Import> является <Device>. В документе допускается наличие только одного корневого элемента <Import>.

2. Элемент <Device> является потомком корневого элемента <Import> и содержит данные о измерительном устройстве. Допускается наличие нескольких элементов <Device>. Потомком элемента <Device> является элемент <Channel>. Если элемент <Device> не содержит хотя бы один из атрибутов <Id>, <SerialNumber>, <Name> отсутствует, то дальнейший импорт будет невозможен.

3. Атрибут <Id> элемента <Device>является необязательным. Атрибут <Id> содержит численный идентификатор устройства из БД «Учет энергоресурсов». Если атрибут содержит несуществующий идентификатор устройства, то дальнейший импорт элемента <Device> производиться не будет. Если атрибут <Id> отсутствует, то будет произведен поиск устройства по атрибуту <SerialNumber> либо <Name>.

4. Атрибут <SerialNumber> элемента <Device> является необязательным. Атрибут <SerialNumber> содержит серийный номер устройства. Длина серийного номера до 50 символов. Если атрибут <SerialNumber> отсутствует, то поиск измерительного устройства будет произведен по атрибуту <Name>.

5. Атрибут <Name> элемента <Device> является необязательным. Атрибут <Name> содержит наименование устройства. Длина наименования до 100 символов.

6. Атрибут <CoefI> элемента <Device> является необязательным. Атрибут <CoefI> содержит коэффициент трансформации по току. При отсутствии атрибута во время создания счетчика будет использовано значение 1. Не оказывает влияние на существующее устройство.

7. Атрибут <CoefU> элемента <Device> является необязательным. Атрибут <CoefU> содержит коэффициент трансформации по напряжению. При отсутствии атрибута во время создания счетчика будет использовано значение 1. Не оказывает влияние на существующее устройство.

8. Атрибут <Install> элемента <Device> является необязательным. Атрибут <Install> содержит время установки счетчика, указанное в формате YYYY-MM-DDThh:mm:ss, где YYYY – год, MM – месяц, DD – день, hh – час, mm – минуты, ss – секунды. При отсутствии атрибута во время создания счетчика будет использовано минимальное значение измерений.Не оказывает влияние на существующее устройство.

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

9. Элемент <Channel> является потомком элемента <Device>. Допускается наличие нескольких элементов <Channel>. Содержимым элемента <Channel> является элемент <Row>.

10. Атрибут <Type> элемента <Channel> является обязательным и содержит информацию, необходимую для однозначного сопоставления типа импортируемых данных для устройства. Длина типа измерений до 100 символов. В качестве значения атрибута <Type> можно использовать как наименование, так и идентификатор типа канала.

11. Элемент <Row>является потомком элемента <Channel>. Допускается наличие наличие нескольких элементов <Row>. В зависимости от типа измерений (интегральные или мгновенные) элемент <Row> содержит различные атрибуты.

12. Атрибут <Value> элемента <Row> содержит значение измерительного канала устройства. Для мгновенных измерений атрибут <Value> является обязательным.Для интегральных измерений допустимо отсутствие атрибута <Value>, при наличии атрибута <Indication>. Разделителем дробной части (при её наличии) является точка.

13. Атрибут <Time> элемента <Row> является обязательным для мгновенных измерений, но недопустим для интегральных измерений. Атрибут <Time> содержит время измерения, указанное в формате YYYY-MM-DDThh:mm:ss, где YYYY – год, MM – месяц, DD – день, hh – час, mm – минуты, ss – секунды.

14. Атрибут <End> элемента <Row> является обязательным для интегральных измерений, при отсутствии одного из атрибутов <Start> или <Period>, но недопустим для мгновенных измерений. Атрибут <End> содержит время конца измерений, указанное в формате YYYY-MM-DDThh:mm:ss, где YYYY – год, MM – месяц, DD – день, hh – час, mm – минуты, ss – секунды.

15. Атрибут <Start> элемента <Row> является обязательным для интегральных измерений, при отсутствии одного из атрибутов <End> или <Period>, но недопустим для мгновенных измерений. Атрибут <Start> содержит время конца измерений, указанное в формате YYYY-MM-DDThh:mm:ss, где YYYY – год, MM – месяц, DD – день, hh – час, mm – минуты, ss – секунды.

16. Атрибут <Period> элемента <Row> является обязательным для интегральных измерений, при отсутствии одного из атрибутов <Start> или <End>, но недопустим для мгновенных измерений. Атрибут <Period> содержит длительность измерения в секундах. При наличии всех трех атрибутов <Period>, <Start> и <End> недопустимо их противоречие, в противном случае измерение будет отброшено.

17. Атрибут <Indication> элемента <Row> содержит показание на конец времени. Атрибут <Indication> является необязательным для интегральных измерений при наличии атрибута <Value>, но недопустим для мгновенных измерений.

<?xml version="1.0" encoding="utf-8"?>

</Channel>

</Channel>

</Channel>

</Channel>

</Channel>

</Channel>

</Channel>

</Channel>

</Device>

</Import>