Установка значений и вызов функциональных блоков

<< 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, сессии или другого раннего этапа