|
<< Click to Display Table of Contents >> Navigation: API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Установка значений и вызов функциональных блоков |
Методы этого раздела изменяют значения параметров проекта и вызывают программы или функциональные блоки (POU) в Lua-задачах контроллера.
•Оба метода вызываются POST-запросом с JSON-объектом в теле.
•Нужна действующая сессия. В примерах sessionId передаётся в JSON; вместо него можно использовать HTTP-заголовок Session-Id.
•Прикладной результат возвращается с HTTP-статусом 200, в том числе при ненулевом code.
•Обычный успешный ответ содержит code: 0 и serverTime — время сервера в миллисекундах с начала Unix-эпохи.
•Если обработчик возвращает ошибочный OPC UA status, общая оболочка добавляет hex и codeDescription. Ошибки JSON или сессии, перехваченные раньше в mplc_fcgi, используют errorText и не содержат serverTime.
•Корневой code описывает весь метод. Результат отдельной записи находится в соответствующем recs[].statusCode, но конкретные исключения описаны ниже.
•В обоих запросах recs должен быть массивом. Текущий обработчик вызывает Size() без предварительной проверки типа, поэтому объект другого типа не является поддерживаемым запросом.
Общие поля ответа:
Поле |
Когда присутствует |
Описание |
|---|---|---|
code |
всегда |
Числовой прикладной результат; 0 означает успех |
serverTime |
обычный путь обработчика завершён без раннего отказа |
Время сервера, Unix time в миллисекундах |
hex |
обработчик или шлюз сформировал ошибку |
Код в шестнадцатеричном виде |
codeDescription |
обработчик вернул ошибочный OPC UA status |
Локализованное описание кода |
errorText |
запрос отклонён шлюзом до вызова метода |
Текст ошибки JSON, сессии или другого раннего этапа |