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

Назначение

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

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

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

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

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

рис.3 Поле с множественным выборок и кнопка “Изменить”

рис.4 Диалоговое окно для выбора значений

Структура

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

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

Свойства

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

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

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

Наименование свойства	Назначение свойства	Принимаемые значения

Основные параметры Поле с множественным выбором

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения:Утверждающие (рис.1)
Разделитель	позволяет указать символ или пробел, который будет разделять между собой выбранные значения в поле	пример возможного значения: ;
Подсказка	позволяет создать подсказку, расположенную внутри элемента	пример возможного значения:Выбрать сотрудников

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

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

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

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

позволяет указать значение по умолчанию, которое будет подгружаться в поле с помощью двух типов подгрузки (источников подгрузки значения):

из колонки
из сервиса

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

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

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

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

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

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

Свойство компоненты: Список зависимых записей. Перенести записи в Поле множественного выбора (SetRowsFromFieldForMTMField)

Наименование свойства	Назначение свойства	Принимаемые значения
SetRowsFromFieldForMTMField	параметры заполнены по умолчанию ссылками на элементы, иерархически входящими в состав компоненты Список зависимых записей (поле)	From (Из списка зависимых записей): указывается результирующий элемент Поле с множественным выбором To (В таблицу выбранных записей): указывается таблица, расположенная (справа) во всплывающем диалоговом окне, в которой находятся уже выбранные пользователем записи из списка доступных Grid (Таблица со всеми доступными записями): указывается таблица, расположенная (слева) во всплывающем диалоговом окне, в которой находятся все доступные для выбора записи

рис.1 Отображение связи элементов

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

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

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

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

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

Наименование свойства	Назначение свойства	Принимаемые значения
Зависит от	позволяет указать объект (родителя), по идентификатору которого будут отображаться сведения в текущей Таблице; задаётся в случае необходимости связать Таблицу с другой компонентой, например, Выпадающий список
Всплывающая подсказка	позволяет указать текст всплывающей подсказки, которая появляется при наведении курсора на элемент
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	позволяет управлять отображением контекстного меню (список доступных для исполнения действий) при нажатии правой кнопкой мыши на ячейку внутри таблицы	значение не определено - по умолчанию Активно - при нажатии правой кнопкой мыши на ячейку внутри таблицы отображается контекстное меню доступных действий, например, копирование значения ячейки Не активно - исключает отображение контекстного меню при нажатии правой кнопкой мыши на ячейку внутри таблицы

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

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

Граф сущностей элемента настраивается в соответствии с п. Настройка Графа сущностей.

Колонка для режима “Зависит от” - позволяет указать колонку настраиваемой Таблицы, которая обеспечивает связь текущей компоненты с компонентой заданной в параметре “Зависит от”
Datasource Jndi Name - позволяет задать иной источник (базу данных) для выполнения запроса, заданного с помощью элементов базы данных в редакторе Графа сущностей элемента.

Значение данного свойства может быть задано следующим образом: java:/webbpm/AppRepDS, а сам адрес базы данных, логин и пароль для подключения должен быть указан в файле standalone.xml (аналогично тому, как указывается, например, подключение к базе данных безопасности).

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

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

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

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

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

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

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

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

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

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

Наименование свойства	Назначение свойства	Принимаемые значения
Количество запесей в блоке	количество отображаемых записей в Таблице по умолчанию при каждой новой подгрузке	пример возможного значения: 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

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

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

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

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

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

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

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