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

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

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

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

Решение задачи:

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

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

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

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

• в Основных параметрах Поля множественного выбора необходимо заполнить значениями следующие свойства (рис.2):
  • Надпись - Утверждающие
  • Видимость -(Истина)
  • Недоступно для управления -(Истина)
  • Разделитель - ;
• в функции Поле с множественным выбором. Подгрузка данных вГраф сущностейнастраиваемого элемента необходимо включитьтаблицу базы данных (справочник Сотрудников)-employee.(рис.3)
• в функции Поле с множественным выбором. Подгрузка данных в свойстве “Отображаемая колонка” необходимо указать колонку базы данных ФИО сотрудника -employee.name_short_email (рис.3)

рис.2 Настройка основных параметров компоненты Поле с множественным выбором
рис.3 Настройка Графа сущностей компоненты Поле с множественным выбором

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

• в Граф сущностейнастраиваемого элемента необходимо включить в качестве Главной сущности таблицу базы данныхСправочник пользователей -employee ина которую ссылается представление базы данных view_admin_employee(рис.4)
• в свойстве компоненты Таблица. Настроить колонки таблицы необходимо указать колонкуФИО (name)таблицы базы данных view_admin_employee(рис.5)

рис.4 Редактор структуры сущностей Таблицы доступных строк
рис.5 Настройка колонок Таблицы доступных строк

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

рис.6 Связанная таблица уже выбранных пользователем строк
рис.7 Настройка функции Продублировать конфигурацию текущей таблицы в таблицу выбранных строк

• настройки Кнопок действий"Добавить", “Добавить все”, “Удалить”, “Удалить все”, используемые для добавления исключения записей в/изТаблицыдоступных строк иСвязанной таблицыуже выбранных пользователем строк, находящихсявнутрикомпонентыДиалог- оставить неизменными, т.е.по умолчанию заданными.
• настройки Кнопок подтверждения и отмены действия"Ок"/“Отмена”,находящихся внутри компонентыДиалог,остаютсяпо умолчанию заданными.

Результат выполнения задачи:

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

рис.9 Окно Параметры отчета
рис.10 Диалоговое окно со списком сотрудников для выбора

рис.11 Добавление записей из Таблицы доступных в Таблицу выбранных строк
рис.12 Отображение результата выбора значений