<< Click to Display Table of Contents >> Разработка > Элементы разработки > Настройка панели фильтрации Добавление ссылки на сущность |
Предположим, что у сущностей в списке есть свойство Журнал регистрации. Возможные значения свойства выбираются из соответствующего справочника. Необходимо настроить фильтрацию записей в списке по журналу регистрации. Для этого используйте контрол «Ссылка на сущность».
Чтобы добавить контрол со ссылкой на сущность:
1.В дереве типа сущности последовательно раскройте узлы «Списки», «Collection» и «FilterPanel».
2.В контекстном меню группы выберите пункт Добавить ссылку на сущность.
3.Задайте свойства контрол со ссылкой на сущность:
*Имя контрола. Должно быть уникальным в рамках группы, состоять из букв латинского алфавита и цифр.
Отображаемое имя. Название контрола, которое будет отображаться на панели фильтрации. Для локализации отображаемого имени нажмите на кнопку Локализовать.
Примечание. Чтобы в качестве отображаемого имени контрола использовалось название группы, оставьте поле Отображаемое имя незаполненным.
*Тип сущности. Сущности указанного типа будут использоваться в качестве возможных значений контрола.
*Способ выбора значения. Возможные значения:
•Выпадающий список. Значения будут отображаться в виде выпадающего списка. Рекомендуется устанавливать, если сущностей нужного типа немного (до 20), их количество не будет меняться и у типа сущности мало свойств;
•Форма список. Значения свойства-ссылки будут отображаться в отдельном окне. Рекомендуется устанавливать, если сущностей нужного типа много, их количество будет расти и у типа сущности много свойств.
*Количество строк, которое будет использоваться для отображения контрола Возможные значения: Одна строка (значение по умолчанию), Две строки.
Контрол «флажок» для управления доступностью. При настройке панели фильтрации возможны варианты, когда нужно, чтобы контрол со ссылкой на сущность был:
•доступен всегда. В этом случае оставьте поле незаполненным;
•доступен только если установлен флажок из некоторого набора флажков. В этом случае укажите в поле имя флажка, который нужно будет установить на панели фильтрации. В выпадающем списке для выбора доступны флажки из всех наборов, которые добавлены на панель фильтрации. Например, аналогично настраивается контрол «Период дат», который становится доступным, когда установлен один из флажков для фильтрации записей по наиболее частым периодам.
Отображать в панели фильтрации. Контрол будет отображаться на панели фильтрации. Если необходимо скрыть контрол на панели фильтрации списка в перекрытии модуля, снимите флажок.
4.Если необходимо фильтровать возможные значения контрола «Ссылка на сущность», задайте обработчик события Фильтрация сущностей. Для этого установите флажок рядом с событием и перейдите по ссылке Перейти к коду.
Например, в событии можно задать обработку, чтобы при выборе журнала регистрации отображались только те журналы, в которых регистрируются документы определенного типа.
5.Задайте условия фильтрации записей в списке.
В результате на панели фильтрации появится контрол, в котором можно будет выбрать определенный тип сущности, например:
При необходимости измените расположение контрола на панели фильтрации. Для этого перетащите контрол выше или ниже в дереве сущности. Места для вставки подсвечиваются желтым цветом. Перемещать контрол можно только в пределах группы, где он был создан.
© Компания Directum, 2024 |