Описание веб-сервисов для взаимодействия с системой

Настроечные параметры приборов

Исключительные команды

2.4.1 Определение адреса прибора.

Запрос (c CRC):

f0 0f 0f f0 00 00 00 00 00 a5 44

Ответ:

<f0 0f 0f f0><Адрес прибора 4-е байта ><CRC>

2.4.2 Определение модели прибора

Запрос:

<Адрес прибора><03 02 46 00 01><CRC>

Ответ:

<Адрес прибора><03 02><Информация о модели><CRC>

Код параметра	Назначение	Возможные значения
0001h	Признак авто перехода на зимнее/летнее время	0-нет переходить 1-переходить
0002h	Номер часового пояса(не текущее смещение, для лето/зима), формат Byte(младший)	0..23
0003h	Длительность импульса	(0..2000] мС (4 байта Double)
0004h	Длительность паузы	(0..2000] мС (4 байта Double)
0005h	Версия прошивки	0..65535
0006h	Диагностика прибора	1-Байт ошибок, 2 – 0x00
000Ah-0011h	Статусы КВ модулей (только для радио пульсара)	DATETIME + (ucharV%)+0x00
0012h	Время работы без питания (только для радио пульсара)	Ulong int(4 байта) секунд
0013h	Вкл\выкл реж Р (только для радио пульсара)
0020h	Чтение нештатных сит. С контроллера перепада давления	8 байт. Информационные 0..4 Каждый байт отвечает за трубопроводы 1..5 Назначение бит 0 – “1” Датчик 1 не подключен 1 – “1” Датчик 2 не подключен 2 – “1” Датчик 1 подкл, но нет давления 3 – “1” Датчик 2 подкл, но нет давления. 4 – “1” Перепад давлений меньше минимума 5 – “1” Перепад давлений больше максимума

CRC считается полиномом 0x8005, начальное значение 0xffff, входящие биты и биты результата разворачиваются.
3. ЕХД Водоканал. Руководство внешнего взаимодействия с системой.

В данном документе описывается принципы внешнего взаимодействия с системой КСДУ посредством Веб-Сервисов.

Во избежание создания множества Веб-Сервисов для каждого типа сущности был разработан один универсальный Сервис, который позволяет выполнять следующие операции:

· Получения списка сущностей по ряду параметров;

· Обновление сущности;

· Удаление сущности;

· Создание сущности

Общие правила

1. Время всегда передается с указанием часового пояса, например: 2010-12-13T09:00:00.000+03:00 или 2010-12-13T09:00:00.000Z или 2010-12-13T12:00:00.000 +0300. Преобразование происходит посредством самого WS, если указан xsi:type="xs:dateTime" и тогда валидны все форматы, которые описаны в спецификации w3.org;

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

3. При создании/обновлении сущностей у значения поля attributeValue должно быть строго прописан тип, взависимости от передаваемых значений, например:

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

<soapenv:Envelope xmlns:soapenv= "http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsd= "http://www.w3.org/2001/XMLSchema" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" >

<soapenv:Body>

<essenceCreator xmlns= "http://webservices.asge.ru/" >

<arg0 xmlns= "" >

<attributes>

<attributeCode>places</attributeCode>

<attributeLinkValue xsi:type= "xsd:decimal" >108121</attributeLinkValue>

<attributeTypeCode>linkNto1</attributeTypeCode>

</attributes>

<attributes>

<attributeCode>valueTime</attributeCode>

<attributeTypeCode> timestamp </attributeTypeCode>

<attributeValue xsi:type= "xsd:dateTime" >2011-09-05T12:03:19.415Z</attributeValue>

</attributes>

<attributes>

<attributeCode>value</attributeCode>

<attributeTypeCode>floated</attributeTypeCode>

<attributeValue xsi:type= "xsd:decimal" >0</attributeValue>

</attributes>

<essenceClassCode>ExdValMpressure</essenceClassCode>

</arg0>

<arg1 xmlns= "" >vdkexdDB</arg1>

</essenceCreator>

</soapenv:Body>

</soapenv:Envelope>

Дата добавления: 2015-07-02