dpNames

fun dpNames(pattern: String, type: String, ignoreCase: Boolean = true, defaultSystem: Int = 1): List<String>

Возвращает список полных имён точек данных или их элементов, соответствующих заданным шаблонам имени точки данных и типа.

Функция выполняет запрос к API для поиска точек данных, чьи имена и типы совпадают с указанными шаблонами. Результат включает полные имена в формате [<system>:]<data_point>.<element>:<config>.<detail>.<attr>, с учётом глубины, заданной в pattern.

Формат шаблона pattern:

(1) Полная глубина вложенности:

[<system>:]<data_point>.**[:<specific>]

— возвращает все элементы и подэлементы точки данных до максимальной глубины.

(2) Заданная глубина вложенности:

[<system>:]<data_point>[.<element>[:<specific>]]*

— возвращает элементы только на указанном уровне вложенности.

Где specific определяет детализацию конфигурации:

  • * — все конфигурации элемента;

  • <config>.* — все совпадения для указанной конфигурации;

  • <config>.<detail>.* — все атрибуты в группе с индексом detail (например, 0, 1, ...);

  • <config>.<detail>.<attr> — конкретный атрибут.

Во всех частях шаблона (data_point, element, config, detail, attr) допускается использование символа * как wildcard для совпадения с любым количеством символов.

Return

Список полных имён точек данных или их элементов, соответствующих шаблонам. Имена возвращаются в каноническом формате, включающем систему, элементы и спецификацию конфигурации.

Parameters

pattern

Шаблон имени точки данных (см. описание форматов выше).

type

Шаблон имени типа точки данных .

ignoreCase

Игнорировать ли регистр при сопоставлении шаблонов. По умолчанию true.

defaultSystem

Идентификатор системы, используемый, если он не указан явно в pattern. По умолчанию 1.

Throws

Если объект BaseApi не инициализирован.

если pattern пустой или имеет некорректный формат (например, слишком много : или недопустимая структура спецификации конфигурации).

если указанное в pattern имя системы не найдено, либо система с идентификатором defaultSystem отсутствует.