api/ru.sydis.api/BaseApi/dpQueryListConnect

dpQueryListConnect

@ApiStatus.Experimental
fun dpQueryListConnect(query: String, sortOrder: ProtoDpQueryIdsSortOrder = ProtoDpQueryIdsSortOrder.BY_DP_NAME, callback: (List<ProtoValue>) -> Unit, answer: Boolean = true, onlyChanged: Boolean = false): ConnectSubsId

Включает подписку на изменение точек данных, попадающих под запрос. Результаты передаются в callback в виде списка, отсортированного в указанном порядке сортировки.

Внимание! Это частичная реализация метода dpQueryConnect, имеющая свои ограничения. Подробнее см. в документации.

Return

Идентификатор созданной подписки

Parameters

query

SQL-запрос

sortOrder

Порядок сортировки результата. По умолчанию - по имени точки данных

callback

Функция, которая будет вызвана при изменении точек данных

answer

Переключатель поведения при первой подписке. True - callback будет вызван при подписке

onlyChanged

Переключатель, указывающий на то, что по подписке будут возвращаться только измененные точки данных

Throws

Если запрос пустой

Если BaseApi не инициализирован

Если запрос содержит синтаксические ошибки