Справочники

<< 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

Локализованное описание кода