|
<< Click to Display Table of Contents >> Navigation: API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Справочники |
Методы этого раздела читают и изменяют данные справочников (табличных наборов данных проекта), включая разрешение связей между зависимыми справочниками.
•Все методы вызываются POST-запросом с JSON-объектом в теле.
•Обработчики раздела не проверяют сессию и права: поле sessionId в теле не читается. Разграничение доступа выполняется на уровне веб-сервера, а не этими методами.
•serverTime в ответ не добавляется.
•Справочник адресуется числовым полем table — идентификатором справочника в VMInfo.
•Прикладной результат возвращается с HTTP-статусом 200, в том числе при ненулевом code.
•Успешный ответ содержит code: 0 и данные метода.
•Проверки структуры запроса (нет table/fields/data/recs или неверный тип) возвращают OpcUa_BadRequestHeaderInvalid без дополнительного текста. Ошибка выполнения запроса к БД возвращает соответствующий код и текст в errorText; оболочка core/mplcshare добавляет hex и codeDescription. Список кодов — в формате запросов и ответов.
Общие поля ответа:
Поле |
Когда присутствует |
Описание |
|---|---|---|
code |
всегда |
Числовой прикладной результат; 0 означает успех |
errorText |
ошибка выполнения запроса к БД |
Текст ошибки |
hex |
code ≠ 0 |
Код в шестнадцатеричном виде |
codeDescription |
code — ошибочный OPC UA status |
Локализованное описание кода |