Справочники

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

code0

Код в шестнадцатеричном виде

codeDescription

code — ошибочный OPC UA status

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