Список зависимых записей

Назначение

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

Для того чтобы данные, отобранные с помощью этой компоненты, сохранялись/считывались в/из базы данных, её необходимо расположить внутри (вложить) компоненты Форма.

Компонента Список зависимых записей находится в разделе Компоненты - Поля - Список зависимых записей.

В структуру компоненты Список зависимых записей, представленной набором простых компонентов и связанных между собой заранее определенными алгоритмами, входят следующие элементы

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

нажатие Кнопки “Изменить”, расположенной рядом с основной Таблицей зависимых записей на странице(в составе компоненты находится под элементом Связанная таблица); по нажатию на кнопку происходит открытие всплывающего диалогового окна
поиск необходимых значений в Таблице доступных записей (на странице в диалоговом окне находится слева)
выбор значения с помощью Кнопок “Добавить” или *“Добавить все” *из списка доступных записей; по нажатию на кнопку происходит перенос (добавление) записи из Таблицы доступных значений (на странице в диалоговом окне находится слева) в Связанную таблицу выбранных значений (на странице в диалоговом окне находится справа)
удаление выбранного значения с помощью Кнопок “Удалить” или “Удалить все” из списка уже выбранных значений; по нажатию на кнопку происходит перенос (удаление) записи из Связанной таблицы выбранных значений(на странице в диалоговом окне находится справа) и возвращение записи в Таблицу доступных значений(на странице в диалоговом окне находится слева)
перенос значений из Связанной таблицы выбранных записей в результирующую Связанную таблицу с главной сущностью (компонентой Формана текущей странице) по нажатию на Кнопку “Ок” и закрытие диалогового окна
сохранение всей карточки главной сущности компоненты Форма, при котором осуществляется взаимопривязка (линкование) каждой записи из элемента “Связанная таблица” к главной сущности экранного интерфейса

Структура

Основные вложенные элементы компоненты Список зависимых записей

Наименование элемента	Описание
Список зависимых записей	контейнер вертикального выравнивания, в который вложены все дочерние компоненты
Связанная таблица	используется для отображения строк в зависимой таблице, которые уже связаны сглавной сущностью компоненты Форма
Кнопка Изменить	используется для открытия (вызова) диалогового окна со списком доступных значений для выбора
Диалог	используется для отображения всплывающего диалогового окна со списком доступных значений для выбора
Таблица	используется для отображения списка доступных значений (записей) для выбора (во всплывающем диалоговом окне находится слева)
Кнопка Добавить	используется для переноса (добавления) одной выбранной записи из Таблицы
Кнопка Добавить все	используется для переноса (добавления) всех записей из Таблицы всех доступных значений(на странице в диалоговом окне находится слева)вСвязанную таблицувыбранных значений(на странице в диалоговом окне находится справа)
Кнопка Удалить	используется для исключения (удаления) строки из Связанной таблицы уже выбранных значений (на странице в диалоговом окне находится справа) и обратного переноса в Таблицу всех доступных значений(на странице в диалоговом окне находится слева)
Кнопка Удалить все	используется для исключения (удаления) всех строк из Связанной таблицы уже выбранных значений (на странице в диалоговом окне находится справа) и обратного переноса в Таблицу всех доступных значений(на странице в диалоговом окне находится слева)
Связанная таблица	используется для отображения списка уже выбранных пользователем записей (во всплывающем диалоговом окне находится справа) из массива доступных значений (записей) для выбора. Необязательна для настройки (только при необходимости более детального вывода информации), так как по умолчанию дублирует конфигурацию
Кнопка Ок	используется для переноса значений из Связанной таблицы выбранных записей в результирующую Связанную таблицу с главной сущностью(компонентойФормана текущей странице)и закрытия диалогового окна
Кнопка Отмена	используется для отмены выбора значений из списка доступных и закрытия диалогового окна

Свойства

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

Основные параметры Список зависимых записей

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Вертикальный контейнер

Основные параметры Связанной таблицы

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

Наименование свойства	Назначение свойства	Принимаемые значения
Показывать номер строки	позволяет задать автоматическую нумерацию строк	значение не определено - по умолчанию Активно - отображать нумерацию строк Не активно - не отображать нумерацию строк
Подсказка	позволяет создать подсказку, расположенную внутри элемента
Надпись	позволяет задать наименование поля, которое будет отображаться на странице
Multiselectable	позволяет задать возможность единовременного выбора одной или нескольких записей в Таблице; выбранные строки окрашиваются в отличный от других строк цвет	возможность выбора сразу нескольких или одной строки возможность выбора одной строки - значение по умолчанию
Checkbox Column	позволяет поставить отметку в виде флажка на тех записях, которые выбраны пользователем в рамках работы с компонентой	значение не определено - по умолчанию Активно - отображать колонку флагов Не активно - не отображать колонку флагов
Pinned Bottom Row Label	позволяет задать значение для названия итоговой строки таблицы (строки с агрегирующими значениями по колонкам таблицы)	пример возможного значения: Итого
Row click selection type	позволяет задать поведение выбора строк при клике на строку Таблицы	SINGLE_SELECT_CLICK – при клике на строку предыдущие выбранные строки сбрасываются, если не была зажата клавиша Ctrl или Shift- данный метод выбран по умолчанию MULTI_SELECT_CLICK -при каждом клике на строку, предыдущие выбранные строки не сбрасываются, т.е если кликнули на одну строку, а затем на другую, то первая строка останется выбранной. Клик по уже выбранной строке снимает с неё выделение. Использования данного метода допустимо, в случае, если в таблице доступен выбор нескольких строк (при значениисвойстваMultiselectable) SUPPRESS_SELECT_CLICK – исключает возможность выбора (выделения) строки по клику. В данном случае, выбор строки представляется возможным только при использовании чекбоксов.
Save Column State	позволяет задать возможность сохранения пользовательских настроек в части состава и ширины колонок в таблице	значение не определено - по умолчанию Активно - изменения пользователя в части отображаемых колонок в таблице (состав и ширина) будут сохраняться в локальном хранилище, т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения отобразятся Не активно - не сохранять изменения пользователя в части отображаемых колонокв таблице (состав и ширина), т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения не отобразятся и таблица будет иметь исходный вид по умолчанию
No Rows Overlay Message	позволяет указать текст для отображения пользователю в таблице в случае, если результат запроса не вернул ни одной строки, например, Данные отсутствуют(доступно для настройки при Loading Overlay Type - TEXT_OVERLAY)	пример возможного значения:Данные отсутствуют
Loading Overlay Type	позволяет выбрать вид прелоадера при подгрузке данных в таблицу	Доступны следующие виды настройки: TEXT_OVERLAY - отображает текст в центре таблицы при подгрузке данных, задаваемый в свойствах:No Rows Overlay Message и Loading Overlay Message PROGRESS_BAR - отображает прогресс-бар при подгрузке данных в таблицу
Allow Context Menu With	позволяет управлять отображением контекстного меню (список доступных для исполнения действий) при нажатии правой кнопкой мыши на ячейку внутри таблицы	значение не определено - по умолчанию Активно - при нажатии правой кнопкой мыши на ячейку внутри таблицы отображается контекстное меню доступных действий, например, копирование значения ячейки Не активно - исключает отображение контекстного меню при нажатии правой кнопкой мыши на ячейку внутри таблицы
Loading overlay message	позволяет указать текст для отображения пользователю в процессе подгрузки данных в таблицу, например,Загрузка данных, пожалуйста, подождите.(доступно для настройки приLoading Overlay Type - TEXT_OVERLAY)

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

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

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

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

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

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

Свойство компоненты: Список зависимых записей. Взаимосвязи таблиц

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

Колонка, ссылающаяся на таблицу “доступных” - указывается колонка объекта базы данных, включенного в Граф сущностей текущей настраиваемой Связанной таблицы, которая ссылается на главную таблицу в Графе сущностей Таблицы “доступных” записей для выбора (на странице в диалоговом окне находится слева)
Колонка, ссылающаяся на “основную” таблицу - указывается колонка объекта базы данных, включенного в Граф сущностей текущей настраиваемой Связанной таблицы, которая ссылается на главную таблицу в Графе сущностей основной компоненты Форма на странице
Колонка “основной” таблицы - указывается колонка (первичный ключ) главной таблицы в Графе сущностей основной компоненты Форма на странице, на которую ссылается текущая настраиваемая Связанная таблица

Свойство компоненты: Список зависимых записей. Заполнить значением по умолчанию

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

с описанием функции Заполнить значением по умолчанию можно ознакомиться в разделе: Заполнить значением по умолчанию - Список зависимых записей.

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

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет создать надпись на кнопке	Изменить - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Внести изменения в список?

Свойство компоненты: Диалог. Вызвать

Наименование свойства	Назначение свойства	Принимаемые значения
Вызвать диалог	позволяет задать диалог, который будет открываться при нажатии на кнопку	по умолчанию задан Диалог вложенный в компоненту Список зависимых записей

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

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

Из списка зависимых записей: указывается основная результирующая Связанная таблица с главной сущностью(компонентой Формана текущей странице)
В таблицу выбранных записей: указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных
Таблица со всеми доступными записями: указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи

Основные параметры Диалога

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Диалог

Наименование свойства	Назначение свойства	Принимаемые значения
Заголовок	позволяет задать заголовок диалога на странице	пример возможного значения: Выбор записей - значение по умолчанию
Допускается скрытие через системную Х	позволяет задать возможность закрытия диалога по нажатию на системный	возможно закрыть диалог через- значение по умолчанию, невозможно закрыть диалог (системный скрыт)

Основные параметры Таблицы

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

Наименование свойства	Назначение свойства	Принимаемые значения
Зависит от	позволяет указать объект (родителя), по идентификатору которого будут отображаться сведения в текущей Таблице; задаётся в случае необходимости связать Таблицу с другой компонентой, например, Выпадающий список
Multiselectable	позволяет задать возможность единовременного выбора одной или нескольких записей в Таблице; выбранные строки окрашиваются в отличный от других строк цвет	возможность выбора сразу нескольких или одной строки возможность выбора одной строки - значение по умолчанию
Checkbox Column	позволяет поставить отметку в виде флажка на тех записях, которые выбраны пользователем в рамках работы с компонентой	значение не определено - по умолчанию Активно - отображать колонку флагов Не активно - не отображать колонку флагов
Показывать номер строки	позволяет задать автоматическую нумерацию строк	значение не определено - по умолчанию Активно - отображать нумерацию строк Не активно - не отображать нумерацию строк
Pinned Bottom Row Label	позволяет задать значение для названия итоговой строки таблицы (строки с агрегирующими значениями по колонкам таблицы)	пример возможного значения: Итого
Row click selection type	позволяет задать поведение выбора строк при клике на строку Таблицы	SINGLE_SELECT_CLICK – при клике на строку предыдущие выбранные строки сбрасываются, если не была зажата клавиша Ctrl или Shift- данный метод выбран по умолчанию MULTI_SELECT_CLICK -при каждом клике на строку, предыдущие выбранные строки не сбрасываются, т.е если кликнули на одну строку, а затем на другую, то первая строка останется выбранной. Клик по уже выбранной строке снимает с неё выделение. Использования данного метода допустимо, в случае, если в таблице доступен выбор нескольких строк (при значениисвойстваMultiselectable) SUPPRESS_SELECT_CLICK – исключает возможность выбора (выделения) строки по клику. В данном случае, выбор строки представляется возможным только при использовании чекбоксов.
Save column state	позволяет задать возможность сохранения пользовательских настроек в части состава и ширины колонок в таблице	значение не определено - по умолчанию Активно - изменения пользователя в части отображаемых колонок в таблице (состав и ширина) будут сохраняться в локальном хранилище, т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения отобразятся Не активно - не сохранять изменения пользователя в части отображаемых колонокв таблице (состав и ширина), т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения не отобразятся и таблица будет иметь исходный вид по умолчанию
Loading Overlay Type	позволяет выбрать вид прелоадера при подгрузке данных в таблицу	Доступны следующие виды настройки: TEXT_OVERLAY - отображает текст в центре таблицы при подгрузке данных, задаваемый в свойствах:No Rows Overlay Message и Loading Overlay Message PROGRESS_BAR - отображает прогресс-бар при подгрузке данных в таблицу
No Rows Overlay Message	позволяет указать текст для отображения пользователю в таблице в случае, если результат запроса не вернул ни одной строки, например, Данные отсутствуют(доступно для настройки при Loading Overlay Type - TEXT_OVERLAY)
Loading overlay message	позволяет указать текст для отображения пользователю в процессе подгрузки данных в таблицу, например,Загрузка данных, пожалуйста, подождите.(доступно для настройки приLoading Overlay Type - TEXT_OVERLAY)	*пример возможного значения:Загрузка данных, пожалуйста, подождите.
Allow Context Menu With	позволяет управлять отображением контекстного меню (список доступных для исполнения действий) при нажатии правой кнопкой мыши на ячейку внутри таблицы	значение не определено - по умолчанию Активно - при нажатии правой кнопкой мыши на ячейку внутри таблицы отображается контекстное меню доступных действий, например, копирование значения ячейки Не активно - исключает отображение контекстного меню при нажатии правой кнопкой мыши на ячейку внутри таблицы

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

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

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

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

Видимые колонки данной Таблицы должны быть равны колонкам, отображаемым в основной Связанной таблице (колонки могут быть скрыты, но должны быть включены в таблицу)

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

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

устанавливает доступность Кнопки “Добавить” после выбора строки в Таблице со списком доступных записей (на странице в диалоговом окне находится слева) для переноса записи в Связанную таблицу выбранных пользователем записей (на странице в диалоговом окне находится справа)

-по умолчанию задана Кнопка “Добавить”, вложенная в компоненту Список зависимых записей

Свойство компоненты: Продублировать конфигурацию текущей таблицы (с доступными строками) в таблицу уже выбранных строк

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

-по умолчанию задана Связанная таблица, вложенная в компоненту Список зависимых записей

Свойство компоненты: Исключить из текущей таблицы (доступных строк) уже выбранные строки

при выборе записи в Таблице с доступными для выбора записей (на странице в диалоговом окне находится слева) и переносе её (с помощью Кнопки “Добавить” или Кнопки “Добавить все” ) в Связанную таблицу уже выбранных пользователем записей (на странице в диалоговом окне находится справа) исключает данную запись (и) из текущей Таблицы (доступных строк)

-по умолчанию задана Связанная таблица, вложенная в компоненту Список зависимых записей

Свойство компоненты: Таблица. Настроить динамическую подгрузку данных при просмотре страницы

Наименование свойства	Назначение свойства	Принимаемые значения
Количество записей в блоке	количество отображаемых записей в Таблице по умолчанию при каждой новой подгрузке	20 - значение по умолчанию

Основные параметры Кнопки “Добавить”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет задать надпись на кнопке	пример возможного значения: > - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно хотите выбрать данное значение?

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

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

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

Из таблицы “доступных”: указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи, откуда будет перенесена выбранная запись
В таблицу “выбранных”: указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных, куда будет перенесена выбранная запись

Основные параметры Кнопки “Добавить все”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе-Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет задать надпись на кнопке	*пример возможного значения: >> - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно хотите выбрать данное значение?

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

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

Из таблицы “доступных”: указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи, откуда будут перенесены все записи одновременно
В таблицу “выбранных”: указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных, куда будут перенесены записи

Основные параметры **Кнопки “Удалить”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет задать надпись на кнопке	пример возможного значения: < - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно хотите исключить данное значение?

Свойство компоненты: Список зависимых записей. Вернуть строку в таблицу “доступных” из таблицы “выбранных”

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

В таблицу “доступных”: указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи, куда будет перенесена (возвращена) выбранная запись
Из таблицы “выбранных”: указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных, откуда будет перенесена (возвращена) выбранная запись

Основные параметры **Кнопки “Удалить все”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет задать надпись на кнопке	пример возможного значения: << - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно хотите исключить все значения?

Свойство компоненты: Список зависимых записей. Вернуть все строки в таблицу “доступных” из таблицы “выбранных”

В таблицу “доступных”: указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи, куда будут перенесены (возвращены) все записи
Из таблицы “выбранных”: указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных, откуда будут перенесены (возвращены) все записи

Основные параметры Связанной таблицы (таблица выбранных пользователем записей)

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

Наименование свойства	Назначение свойства	Принимаемые значения
Показывать номер строки	позволяет задать автоматическую нумерацию строк	значение не определено - по умолчанию Активно - отображать нумерацию строк Не активно - не отображать нумерацию строк
Подсказка	позволяет создать подсказку, расположенную внутри элемента
Надпись	позволяет задать наименование поля, которое будет отображаться на странице
Multiselectable	позволяет задать возможность единовременного выбора одной или нескольких записей в Таблице; выбранные строки окрашиваются в отличный от других строк цвет	возможность выбора сразу нескольких или одной строки возможность выбора одной строки - значение по умолчанию
Checkbox Column	позволяет поставить отметку в виде флажка на тех записях, которые выбраны пользователем в рамках работы с компонентой Таблица	значение не определено - по умолчанию Активно - отображать колонку флагов Не активно - не отображать колонку флагов
Pinned Bottom Row Label	позволяет задать значение для названия итоговой строки таблицы (строки с агрегирующими значениями по колонкам таблицы)	пример возможного значения: Итого
Row click selection type	позволяет задать поведение выбора строк при клике на строку Таблицы	SINGLE_SELECT_CLICK – при клике на строку предыдущие выбранные строки сбрасываются, если не была зажата клавиша Ctrl или Shift- данный метод выбран по умолчанию MULTI_SELECT_CLICK -при каждом клике на строку, предыдущие выбранные строки не сбрасываются, т.е если кликнули на одну строку, а затем на другую, то первая строка останется выбранной. Клик по уже выбранной строке снимает с неё выделение. Использования данного метода допустимо, в случае, если в таблице доступен выбор нескольких строк (при значениисвойстваMultiselectable) SUPPRESS_SELECT_CLICK – исключает возможность выбора (выделения) строки по клику. В данном случае, выбор строки представляется возможным только при использовании чекбоксов.
Save Column State	позволяет задать возможность сохранения пользовательских настроек в части состава и ширины колонок в таблице	значение не определено - по умолчанию Активно - изменения пользователя в части отображаемых колонок в таблице (состав и ширина) будут сохраняться в локальном хранилище, т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения отобразятся Не активно - не сохранять изменения пользователя в части отображаемых колонокв таблице (состав и ширина), т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения не отобразятся и таблица будет иметь исходный вид по умолчанию
Loading Overlay Type	позволяет выбрать вид прелоадера при подгрузке данных в таблицу	Доступны следующие виды настройки: TEXT_OVERLAY - отображает текст в центре таблицы при подгрузке данных, задаваемый в свойствах:No Rows Overlay Message и Loading Overlay Message PROGRESS_BAR - отображает прогресс-бар при подгрузке данных в таблицу
No Rows Overlay Message	позволяет указать текст для отображения пользователю в таблице в случае, если результат запроса не вернул ни одной строки, например, Данные отсутствуют(доступно для настройки при Loading Overlay Type - TEXT_OVERLAY)
Loading overlay message	позволяет указать текст для отображения пользователю в процессе подгрузки данных в таблицу, например,Загрузка данных, пожалуйста, подождите.(доступно для настройки приLoading Overlay Type - TEXT_OVERLAY)
Allow Context Menu With	позволяет управлять отображением контекстного меню (список доступных для исполнения действий) при нажатии правой кнопкой мыши на ячейку внутри таблицы	значение не определено - по умолчанию Активно - при нажатии правой кнопкой мыши на ячейку внутри таблицы отображается контекстное меню доступных действий, например, копирование значения ячейки Не активно - исключает отображение контекстного меню при нажатии правой кнопкой мыши на ячейку внутри таблицы

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

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

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

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

устанавливает доступность Кнопки “Удалить” после выбора строки в Связанной таблице выбранных пользователем записей (на странице в диалоговом окне находится справа) для переноса (возврата) записи в Таблицу со списком доступных записей (на странице в диалоговом окне находится слева)

по умолчанию задана - Кнопка “Удалить”

Свойство компоненты:Список зависимых записей. Заполнить значением по умолчанию

Внимание! При использовании данной функции, нет необходимости настройки и заполнения Графа сущностей в текущей таблице

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

Основные параметры Кнопки “Ок”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет создать надпись на кнопке	пример возможного значения: Ок - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно выбрали все необходимые значения?

Свойство компоненты: Диалог. Скрыть

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

Свойство компоненты: Список зависимых записей. Перенести записи из таблицы “выбранных” записей

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

Из таблицы “выбранных”: указывается Связанная таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных, откуда будут перенесены значения
В список зависимых записей: указывается основная результирующая Связанная таблица с главной сущностью(компонентой Формана текущей странице), куда будут перенесены записи

Основные параметры Кнопки “Отмена”

прим.: с полным описанием компоненты и её настройки также можно ознакомиться в разделе - Кнопка

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет создать надпись на кнопке	пример возможного значения: Отмена - значение по умолчанию
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет	пример возможного значения: Вы действительно хотите отменить операцию?

Свойство компоненты: Диалог. Скрыть

позволяет задать диалог, который будет закрыт при нажатии на кнопку

- по умолчанию задан Список зависимых записей#Диалог, вложенный в компоненту Список зависимых записей

Базовые функции

заполнить значением по умолчанию

Назначение

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

Функция Заполнить значением по умолчанию должна быть задействована на обоих компонентах “Связанная таблица”, а настроена только на основной компоненте “Связанная таблица”, входящей в состав сложной компоненты Список зависимых записей.

Активация и настройка функции на первой компоненте “Связанная таблица”

Активация без настройки функции на второй компоненте “Связанная таблица”

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

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

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

Дополнительные функции

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

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

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

Рекурсивно копировать составные объекты сложных компонент

TODO

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

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

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

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

Как задействовать компоненту Список зависимых записей ?

Как ограничить количество строк в Связанной таблице (LinkField)

Чтобы ограничить количество строк в Связанной таблице установите необходимое значение в параметр “Макс. количество строк” (Если значение не установлено или 0, то ограничение не действует):

Если Вы хотите выбрать действие при попытке выйти за границы максимального количества, выберите это действие в блоке “Тогда” в компоненте “Обработка событий”:

Если Вы хотите динамически менять максимальное количество строк, используйте метод “Задать максимальное количество строк” в компоненте:

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

Вопрос	Ответ
Как сделать, чтобы данные, отобранные с помощью компоненты Список зависимых записей, сохранялись в базу данных?	Для того, чтобы данные, отобранные с помощью компоненты Список зависимых записей, сохранялись/считывались в/из базы данных, её необходимо вложить внутрь основной компоненты Формана странице.
Какие дочерние элементы Списка зависимых записей требуют обязательной и непосредственнойнастройки аналитиком?	Большинству описанных параметров дочерних элементов компоненты Список зависимых записей уже заранее заданы значения по умолчанию, и они не требуют каких-либо изменений от аналитика в типовых случаях. Но часть параметров следует задать в процессе использования компоненты для её корректной работы и внедрения в логику бизнес-процесса: параметры основной Таблицы Списка зависимых записей на странице -Связанная таблица: Список зависимых записей. Подгрузка данныхСписок зависимых записей. Взаимосвязи таблиц Таблица. Настроить колонки таблицы параметры Таблицы доступных строк для выбора -Таблица: Таблица. Подгрузка данных Таблица. Настроить колонки таблицы
В каких случаях используется Список зависимых записей, а в каких случаях Список с поиском для выбора одного значения?	В случае, когда необходимо связать идентификатор главной сущности компоненты Форма, например, Заявление на получение лицензии, одновременно с несколькими значениями (связь многие ко многим), например, виды деятельности лицензиата,из заранее сформированного списка доступных значений, то используется Список зависимых записей (сохранение отобранных значений, осуществляется в таблицу связи базы данных, в приведенном примере, между Заявлением и Видом деятельности лицензиата). В случае, когда архитектура базы данных предполагает сохранение одного идентификатора из списка доступных значений (связь один ко многим) используется Список с поиском для выбора одного значения
Можно ли использовать Набор фильтров для удобства поиска значений в Таблице доступных строк?	Да, можно. Для этого необходимо в элемент Диалог, входящий в состав компоненты Список зависимых записей, добавить элемент Набор фильтров со вложенными фильтрами, например, Текстовое поле (фильтр)или Фильтр по числовому полю, настроить их свойства и в качестве Таблицы, по значениям которой будет происходить фильтрация, в Наборе фильтров указать Таблицу доступных строк компоненты Список зависимых записей.
Почему при открытии диалога на странице неактивна кнопка “Добавить”?	Кнопка "Добавить"недоступна для управления по умолчанию и становится активна только при выборе записи (с помощью функцииАктивировать кнопку после выбора строки в таблице, настраиваемой в свойствах Таблицы) в Таблице доступных строк для выбора(на странице в диалоговом окне находится слева). По нажатию на кнопку выбранная пользователем строка будет перенесена в Таблицу выбранных строк(на странице в диалоговом окне находится справа). Аналогичная логика заложена в работу кнопки “Удалить”, которая становится активна только при выборе записи в Таблице выбранных строк(на странице в диалоговом окне находится справа),и по нажатию на кнопку выбранная запись будет перенесена в Таблицу доступных строк(на странице в диалоговом окне находится слева).
Можно ли выбрать одновременно несколько строк в Таблице доступных записей для добавления в Таблицу выбранных строк?	Да, можно. Для этого необходимо при настройке основных параметров Таблицы доступных строк, привести свойства Допустимо выбрать несколько строк и Колонка флагов в значение(истина) в параметре Таблица. Задействовать режим выбора нескольких строк, после чего в интерфейсе в Таблице доступных строк (на странице в диалоговом окне находится слева)отобразится колонка флагов (выбора записи), которая позволит одновременно выделить несколько строк (при этом выбранные строки окрасятся в отличный от других строк цвет), и по нажатию на кнопку “Добавить” выбранные записи будут перенесены в Таблицу выбранных строк(на странице в диалоговом окне находится слева). В случае, когда необходимо выбрать все предложенные записи в Таблице доступных строк и включить их в Таблицу выбранных строк используется кнопка “Добавить все”.
Можно ли изменить цветовое оформление Таблицы?	Да. Цветовым оформлением Таблицы можно управлять с помощью CSS-стилей, задаваемых в**Основных параметрах - Расширенные настройки - CSS классы.
Как изменить формат отображения данных в колонке Таблицы?	В случае, если необходимо изменить формат отображения значений в колонке Таблицы необходимо при настройке колонки применить Форматтер. Например, подгружаемое значение в колонку имеет тип данных Дата и Время (DateTime), но на странице пользовательского приложения необходимо отображать значение в колонке без Времени, только Дату. В таком случае, целесообразно использовать форматтер DateFormatter, который отобразит значение колонки в нужном виде. Но при этом предварительно необходимо применить к Таблице функцию Очистить форматирование колонок таблицы, указав наименование настраиваемой колонки.
Можно ли поменять порядок отображаемых колонок в Таблице?	Для того, чтобы изменить порядок колонок в Таблице необходимо в свойстве Настроить колонки таблицы - Колонки нажать правой кнопкой мыши на «Элемент» и выбрать предложенные варианты: Переместить наверх - Переместить вниз - Удалить элемент.
Можно ли задать автоматическую нумерацию строк (записей) в Таблице?	Да, можно. Для этого необходимо в настраиваемых параметрах Таблицы перейти к свойству Таблица. Основные параметры - Показывать номер строки и привести его в значение(истина).