/Methods/CreateMonitoredDataItems

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > JSON для HTTP-запросов > Описание JSON-запросов > Получение и отправка данных >

/Methods/CreateMonitoredDataItems

CreateMonitoredDataItems - запрос на добавление параметров в подписку. Выборка идентифицируется клиентом по ClientHandle.

Данные запроса

{"sessionId":<ID сессии>,

"subscriptionId":<ID подписки>,

"items":[ - массив добавляемых параметров:

         {"clientHandle":<ID> - ID параметра, заданный клиентом

        "taskId":<номер задачи> - номер задачи, которому принадлежит параметр

      "itemId":<ID параметра>

      "path":"" - путь внутри составного параметра ItemID (можно не задавать). Если ItemID=0, то в path передается полный путь к параметру

      "type":"тип параметра" - может быть именем сложного типа

      "typeHash":<хеш>, - хеш типа параметра (необязательно)

      "timestampsToReturn": "Neither" (по умолчанию) - не возвращать метки времени значений

                             "Source" - вместе со значением возвращает дополнительно sourceTime

      "queueSize":<максимальное кол-во значений> - максимальное количество значений накапливаемых по одному параметру (по умолчанию - 1, т. е. посылается последнее значение).

                                                     Если указано 0, то пересылаются все изменения

}]}

Данные ответа

{"subscriptionId":<ID подписки>,

"items":[ - массив добавленных параметров

       {"clientHandle":<ID> - ID параметра, заданный клиентом. По нему в дальнейшем будут передаваться данные по запросу, адресуемому этой записью

       "statusCode":<код ошибки> - код ошибки добавления данного параметра

       "monitoredItemId":<ID параметра> - ID параметра, уникальный в рамках подписки

}]}

Пример

Запрос

{"sessionId":"1234", "subscriptionId":1,

"items":[

       {"clientHandle":1,

       "taskId":0,

       "itemId":28012,

       "type":"STRING",

       "typeHash":4

       }]

}

Ответ

{"code":0, "subscriptionId":1,

"items":[{"clientHandle":1,

       "statusCode":0,

       "monitoredItemId":1

        }]

}