Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Получение информации о структуре узлов источника данных

Чтобы просматривать дерево сигналов источника данных (например, Alpha.Server), а также осуществлять поиск узлов в этом источнике по заданному фильтру воспользуйтесь компонентом Браузер источника АР.

Компонент Браузер источника АР расположен в юните APБиблиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

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

Полученные данные можно отобразить в виде древовидной структуры на форме с использованием компонентов Источник данных дерева, Дерево и Колонка дерева из юнита Визуальные. Чтобы узнать подробности о возвращаемых значениях, обратитесь к разделу Какие данные возвращает компонент.

Подробнее о свойствах и методах компонента Браузер источника АР.

Какие данные возвращает компонент

Компонент Браузер источника АР возвращает данные в табличном формате. Используя указанные ниже идентификаторы, вы можете обращаться к этим данным в проекте. Для просмотра результатов браузинга подключите Браузер источника АР к одному из компонентов: Дерево или Таблица.

Идентификатор колонки Тип колонки Тип возвращаемого значения Описание
name 1 string Имя узла.
id 2 string Идентификатор элемента.
parent_id 3 string

Идентификатор родительского узла.

display_name 4 string Отображаемое имя.
cdt 5 uint1

Идентификатор типа значения, хранимого в узле источника.

  • 0 - empty;
  • 1 - Int1;
  • 3 - UInt1;
  • 5 - Bool;
  • 6 - UInt4;
  • 7 - Int4;
  • 8 - UInt2;
  • 9 - Int2;
  • 12 - UInt8;
  • 13 - Int8;
  • 14 - Float;
  • 15 - Double;
  • 17 - String;
  • 18 - Time.
historizing 5 bool

Флаг ведения истории.

description 5 string Описание узла.
has_children 6 bool Наличие у узла дочерних узлов.

Как построить дерево сигналов источника данных Alpha.Server (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) использования компонента Браузер источника АР в проекте Alpha.HMI (проект сделан на языке Alpha.Om).

В примере показано, как:

  • Настроить отображение дерева сигналов источника данных в виде древовидной структуры;
  • Настроить взаимодействие компонента Браузер источника АР с источником данных для получения информации о структуре узлов источника;
  • Получить информацию об узлах источника, имя которых соответствует заданному фильтру.

В результате будет подготовлена форма, при открытии которой информация о структуре источника будет получена с Alpha.Server и отображена в виде древовидной структуры с возможностью ввода фильтра для поиска узлов по имени.

Убедитесь, что у вас уже настроено подключение к источнику данных, с которым вы планируете взаимодействовать. Для получения подробной информации о настройке и подключении источника данных обратитесь к разделу Подключение к источнику.

Настроить отображение дерева сигналов источника данных в виде древовидной структуры

  1. Добавьте на экранную форму объект типа Дерево.

  2. В Структуре объектов щелкните правой кнопкой мыши по компоненту Дерево→ Создать. Откроется мастер создания элементов.

    1. В поле Тип элемента оставьте Экземпляр типа , Базовый тип элемента → Источник данных дерева (раздел Визуальные) → Создать.

    2. В Структуре объектов добавится компонент Источник данных дерева дочерним компоненту Дерево.

  3. Для объекта Источник данных дерева аналогичным образом добавьте Колонки дерева с идентификаторами:

    • name
    • id
    • parent_id
    • display_name
    • cdt

    Используйте значения Идентификатора колонки и Тип колонки в соответствии с таблицей возвращаемых значений в разделе Какие данные возвращает компонент, которая поможет правильно настроить свойства для каждой Колонки дерева. Имя колонки указывается в произвольном виде.

    Колонки дерева с идентификаторами name, id и parent_id обязательны для добавления на форму, все остальные добавляются при необходимости.

Настроить взаимодействие компонента Браузер источника АР с источником данных для получения информации о структуре узлов источника

  1. Для просмотра дерева сигналов добавьте на форму компонент Браузер источника АР дочерним Источнику данных дерева.

  2. В редакторе свойств у объекта Браузер источника АР укажите ссылку на добавленный ранее компонент Источник АР. Для этого нажмите правой кнопкой мыши по свойству Источник АР → Сослаться → ApSource_1.

  3. Для просмотра дерева сигналов сразу после открытия экранной формы в рантайме, воспользуйтесь обработчиком события Opened. Ниже указан пример кода на языке JavaScript:

    // Создание запроса
    var request = {
        "level": "children", // Уровень выполнения запроса (дочерние узлы)
        "rootTag": "",      // Путь к корневому узлу (оставьте пустым для корня)
        "columns": [
            {
                "id": "name",
                "type": "attribute",
                "parameters": {
                    "id": "name" // Короткое имя узла
                }
            },
            {
                "id": "id",
                "type": "attribute",
                "parameters": {
                    "id": "id" // Уникальный идентификатор узла
                }
            },
            {
                "id": "parent_id",
                "type": "attribute",
                "parameters": {
                    "id": "parentRuntimeId" // Идентификатор родительского узла
                }
            },
            {
                "id": "display_name",
                "type": "attribute",
                "parameters": {
                    "id": "displayName" // Отображаемое имя узла
                }
            },
            {
                "id": "cdt",
                "type": "attribute",
                "parameters": {
                    "id": "cdt" // Канонический тип данных
                }
            }
        ]
    };
    
    // Преобразование объекта запроса в строку JSON
    var requestJson = JSON.stringify(request);
    
    // Выполнение метода Browse с созданным запросом
    Tree_1.TreeDataSource_1.ApSourceBrowser_1.Browse(requestJson);
    

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

  1. Добавьте на форму текстовое поле, в котором можно будет вводить фильтр для поиска узлов.

  2. Разместите на форме кнопку, которая будет запускать процесс поиска узлов при нажатии на нее.

  3. В обработчике события нажатия кнопки ButtonPressed используйте функцию GetSourceNodes(), передав в нее значение фильтра из текстового поля в качестве аргумента. Пример кода:

    // Получение значения фильтра из текстового поля
    filter: string = LineEdit_1.Text;
    // Очистка дерева перед выполнением запроса
    Tree_1.RemoveChildren("");
    // Вызов функции GetSourceNodes() с передачей фильтра
    Tree_1.TreeDataSource_1.ApSourceBrowser_1.GetSourceNodes(filter);