Древовидная таблица

Назначение

Древовидная таблица - это компонента, которая используется для отображения иерархических данных из таблицы базы данных в виде дерева (каждую запись, можно назвать узлом или ветвью, которая может иметь один или несколько подразделов, то есть дочерних записей). При работе с элементом на странице можно развернуть каждую запись таблицы для просмотра подпунктов (если такие существуют), а также свернуть, чтобы их скрыть. Источником подгрузки данных в компоненту является иерархическая таблица базы данных (определенная в качестве Главной сущности в Редакторе структуры сущностей элемента), представляющая собой набор элементов данных (записей), связанных между собой иерархическими связями. Иерархические связи - это связи, в которых один из элементов данных является родителем другого элемента, то есть в таблице присутствует внешний ключ (например, parent_id), ссылающийся на первичный ключ этой же таблицы базы данных.

Компонента Древовидная таблица находится в разделе Компоненты - Таблицы - Древовидная таблица (рис.1)

Примером использования компоненты Древовидная таблица можно привести задачу, когда на странице необходимо отобразить справочник ОКТМО (Общероссийский классификатор территорий муниципальных образований), где каждый муниципальный район будет отображаться вместе со входящими в него сельскими и городскими поселениями, в виде дерева. В данном случае, Алексеевский муниципальный район будет считаться родителем для входящих в него сельских поселений, например, Лебяжинское, Майнское и др., которые считаются по отношению к нему дочерними записями. При этом на пользовательской странице родительская запись в таблице будет отображаться вместе с подсчитанным числом относящихся к нему дочерних записей, выведенным в скобках после значения, отображаемого в первом столбце таблицы, например, 92606000 (20), где 92606000 - это код муниципального района, а (20) - количество поселений входящих в данный муниципальный район.

рис.1 Компонента Древовидная таблица

рис.2 Пример использования компоненты Древовидная таблица на странице

Свойства

Компонента имеет набор общих свойств.

Наименование свойства	Назначение свойства	Принимаемые значения
Показывать номер строки	позволяет задать автоматическую нумерацию строк	значение не определено - по умолчанию Активно - отображать нумерацию строк Не активно - не отображать нумерацию строк
Зависит от	позволяет указать объект (родителя), по идентификатору которого будут отображаться сведения в текущей Таблице; задаётся в случае необходимости связать Таблицу с другой компонентой, например, Выпадающий список или Таблицей
Root id equal parent id	В случае, если корневой элемент таблицы имеет id равный родительскому id, свойство позволяет переопределить построение иерархии	Значение не определено/Не активно - по умолчанию. Активно - корневой элемент ссылается сам на себя при построении таблицы
Row click selection type	позволяет задать поведение выбора строк при клике на строку Таблицы	SINGLE_SELECT_CLICK – при клике на строку предыдущие выбранные строки сбрасываются, если не была зажата клавиша Ctrl или Shift- данный метод выбран по умолчанию MULTI_SELECT_CLICK– при каждом клике на строку не сбрасываются предыдущие выбранные строки. Например, если вы кликнули на одну строку, а затем на другую, то первая строка останется выбранной. В этом случае клик по уже выбранной строке снимает выделение (deselect). Эта настройка полезна для touch-устройств, у которых нет клавиш Ctrl или Shift. SUPPRESS_SELECT_CLICK– сроки не будут выбираться при клике. Например, если вы хотите выбирать строки только при нажатии на чекбокс.

Свойство компоненты: Таблица. Задействовать режим выбора нескольких строк

Наименование свойства	Назначение свойства	Принимаемые значения
Допустимо выбрать несколько строк	позволяет задать возможность единовременного выбора одной или нескольких записей в Таблице; выбранные строки окрашиваются в отличный от других строк цвет	возможность выбора сразу нескольких или одной строки возможность выбора одной строки - значение по умолчанию
Колонка “Флагов”	позволяет поставить отметку в виде флажка на тех записях, которые выбраны пользователем в рамках работы с компонентой Таблица	значение не определено - значение по умолчанию Активно - отображать колонку флагов Не активно - не отображать колонку флагов

Свойство компоненты: Древовидная таблица. Подгрузка данных

Позволяет задать Граф сущностей для подгрузки данных в Таблицу и Колонку, указывающую на родительский элемент для построения древовидной структуры. Является обязательным к заполнению и настройке.

Сущность - это объект с которым работают в графе. В качестве объекта могут быть: таблицы и представления (вью) из базы данных. Понятие сущности не равно понятию таблицы, поскольку одна таблица может быть добавлена в граф несколько раз.

Колонка, указывающая на родительский элемент - это колонка иерархической таблицы базы данных, включенной в качестве Главной сущности
в структуру сущности элемента Древовидная таблица, которая является внешним ключом (например,parent_id), ссылающимся на первичный ключ
этой же таблицы базы данных.

с описанием настройки Графа сущностей для Таблицы можно ознакомиться в разделе: Настройка Графа сущностей

Свойство компоненты: Таблица. Настроить колонки таблицы

позволяет настроить отображаемые колонки в Таблице с сортировкой данных по конкретному порядку

с описанием настройки Колонок Таблицы можно ознакомиться в разделе: Настройка колонок Таблицы

Функции

В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.

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

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

Определить права текущего пользователя

Определить роли текущего пользователя

Очистить форматирование колонок таблицы

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

Методические рекомендации по применению

Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:

Как задействовать компоненту Древовидная таблица на пользовательской странице?

Часто задаваемые вопросы

Вопрос	Ответ
Как задать ширину Таблицы?	Для того, чтобы настроить ширину или высоту таблицы необходимо в Основных настройках - Расширенные настройки - Стилизадать необходимые значения для настраиваемых параметров, например, Ширина 500px.
Как задать ширину колонок в процентах?	Для задания ширины колонок в процентах необходимо выставить нужный процент в поле width и поставить галочку “Автоматически выравнивать по ширине” (autoStretchColumns)
Можно ли поменять порядок отображаемых колонок в Таблице?	Для того, чтобы изменить порядок колонок в Таблице необходимо в свойстве Настроить колонки таблицы - Колонкинажать правой кнопкой мыши на «Элемент»ивыбрать предложенные варианты: Переместить наверх - Переместить вниз - Удалить элемент
Как настроить возможность многострочного выбора записей в Таблице?	Для того, чтобы настроить многострочный выбор (одновременный выбор нескольких) записей в Таблице необходимо в разделеТаблица. Задействовать режим выбора нескольких строкустановить свойство Допустимо выбрать несколько строк в значение(истина).
Можно ли поменять порядок отображаемых колонок в Таблице?	Для того, чтобы изменить порядок колонок в Таблице необходимо в свойстве Настроить колонки таблицы - Колонкинажать правой кнопкой мыши на «Элемент»ивыбрать предложенные варианты: Переместить наверх - Переместить вниз - Удалить элемент
Можно ли добавлять в Граф сущностейдополнительные таблицы, ссылающиеся на главную иерархическую таблицу, и отображать значения их колонок в Древовидной таблице?	Да, можно. Добавление к Главной сущности компоненты (иерархической таблице) связанных с ней таблиц базы данных, никак не изменяет логики работы и отображения данных в Древовидной таблице.