Пополняемый список зависимых записей

Назначение

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

Если web-страница открывается в режиме просмотра/изменения, то компонента отображает и позволяет внести изменения в список ранее уже связанных записей зависимой таблицы с главной сущностью компоненты Форма.

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

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

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

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

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

Структура

Основные вложенные элементы компоненты “Пополняемый список зависимых записей”(табл.1)

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

Свойства

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

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

Базовые функции элемента “Пополняемый список зависимых записей”

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

Основные параметры элемента Редактируемая таблица

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

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

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

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

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

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

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

позволяет настроить колонки (набор , порядок следования, сортировка) в Таблице

Отображает новые записи, добавляемые пользователем с использованием компоненты Пополняемый список зависимых записей

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

Настройка колонок Таблицы

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

Автоматически переводит кнопки “Редактировать”, “Удалить” в кликабельное состояние после выбора строки в Редактируемой таблице.

Если ни одна строка в Редактируемой таблице не выбрана, то кнопки не могут быть нажаты пользователем.

Базовые функции элемента “Редактируемая таблица”

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

Основные параметры элемента Кнопка “Создать”

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойство компоненты: “Пополняемый список зависимых записей”. Изменить новую зависимую запись в списке

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

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

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

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

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

Свойство компоненты: “Пополняемый список зависимых записей”. Удалить новую зависимую запись в списке

Предписывает системе произвести операцию удаления выбранной записи из элемента Редактируемая (зависимая) таблица

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

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

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

Базовые функции элемента “Диалог”

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

Основные параметры элемента “Форма”

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

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

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

Наименование свойства	Назначение свойства	Принимаемые значения
Скрипт	Используется в предустановленной конфигурации по умолчанию, изменений со стороны пользователя не требует
Show server validation error	Позволяет выводить текст с северной ошибкой при загрузке формы.	Активно - выводит текст серверной ошибки Не активно - не выводить текст серверной Значение не определено - по умолчанию
Message validation template	Позволяет задать текст шаблона валидации

Базовые функции элемента “Форма”

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

Основные параметры элемента “Кнопка Сохранения”

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

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись на кнопке	позволяет задать надпись на кнопке	Значение “Ок” по умолчанию, может быть изменено
Текст подтверждения при нажатии	позволяет задать текст, который будет отображен пользователю внутри диалогового окна вместе с кнопками для подтверждения действия - Да/Нет
Компонента Форма	Указывает системе, данные из какого элемента Пополняемый список зависимых записей #Форма следует сохранить в таблицу зависимых записей

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

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

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

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

Предписывает системе закрыть элемент Пополняемый список зависимых записей #Диалог в случае нажатия на кнопку Отмена

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

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

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

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

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

Вследствие технических особенностей реализации скриптов (

-скрипты выполняются удаленно на сервере приложений,

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

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

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

Как задействовать компоненту “Пополняемый список зависимых записей”

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

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