Шаг 1. Создание шаблона фильтра
Для добавления фильтра в проект необходимо нажать кнопку , расположенную в правом меню кнопок в режиме редактирования проекта:
После нажатия на кнопку появляется окно просмотра связей на слое:
Для доступа к созданию нового фильтра следует нажать на кнопку "Новая связь".
После нажатия на кнопку откроется первый шаг настройки связи:
В окне можно выбрать шаблон фильтра из уже готовых, либо элемент слоя для фильтрации. Также доступна кнопка "Выбрать на слое", которая позволяет напрямую перейти на слой и выбрать элемент.
Для добавления принципиально нового фильтра на вкладке "Шаблоны фильтров" следует нажать на кнопку-ссылку "Добавить новый фильтр".
После нажатия на кнопку откроется окно для добавления нового шаблона фильтра:
Окно содержит следующие поля:
- Название - наименование фильтра. Обязательное поле.
- Ключ - произвольная комбинация латинских букв верхнего и нижнего регистра, цифр и нижнего подчеркивания "_". Одинаковые значения ключа позволяют передавать значения фильтра между слоями и проектами, как описано в разделе "Глобальный фильтр".
- Расположение - не показывать, сверху, снизу, слева или справа от ближайшего элемента.
- Тип фильтра - обязательное поле. О типах фильтров см. руководство пользователя Manager, раздел "Фильтры".
- Отображение - обязательное поле. Зависит от типа фильтра. О настройке отображения см. руководство пользователя Manager, раздел "Фильтры".
После выбора типа и отображения в окне настройки большинства фильтров появляются поля:
- Датасет - набор данных, на котором построен фильтр. Фильтр и виджет могут быть построены на разных датасетах, главное, чтобы оба содержали колонки, по которым будет осуществляться фильтрация. Для примера, виджет построен на датасете "Города РФ с кодами", а фильтр - "Города РФ" (см рисунок выше).
- Отображаемое значение - колонка, присутствующая в обоих датасетах, и содержащая человекочитаемые значения, которые будут отображаться пользователю в фильтре. Для примера, колонка "Город", выбранная на рисунке выше, содержит названия городов.
- "Ключ" - колонка, присутствующая в обоих датасетах, и не отображающаяся пользователю, но фактически осуществляющая фильтрацию. Для примера, колонка "Кодгорода", выбранная на рисунке выше, содержит числовые коды городов.
- Условие - обязательное поле. Зависит от типа фильтра. О настройке условия см. руководство пользователя Manager, раздел "Фильтры".
- Права доступа к фильтру - см. Работа с расширенным фильтром.
После настройки следует нажать на кнопку "Создать". Новый шаблон фильтра будет добавлен в список шаблонов, и отобразится вкладка "Шаблоны фильтров".
Шаг 2. Связывание фильтра и виджета
Для того чтобы связать фильтр и виджет, необходимо выбрать шаблон фильтра в списке шаблонов фильтров. Отобразится окно, в котором представлены все существующие фильтры и компоненты, которые можно связать с новым фильтром.
В окне нужно установить чек-бокс у элемента, с которым будет создана связь.
Далее есть два варианта связи:
- По колонке. Для связи нужно выбрать колонку датасета, содержащую значения, которые будут отображаться в фильтре И использоваться для фильтрации. Обратите внимание, что фильтр и виджет построены на разных датасетах, поэтому для связи нужно выбрать колонку, содержащую значения, аналогичные колонке фильтра - в нашем случае это "Населенный пункт".
- По ключу. Для связи необходимо перевести переключатель "По ключу" в положение "Включено", а в поле "Колонка" выбрать колонку, аналогичную заданной в качестве ключа. В нашем случае это колонка "Код". Обратите внимание, что значения колонки-ключа не будут отображаться в фильтре, хотя по ним будет фактически осуществляться фильтрация. Вместо них пользователю будут отображаться человекочитаемые значения из колонки "Город", заданной в качестве отображаемого значения.
Далее необходимо нажать на кнопку "Применить настройки". Произойдет переход на третий этап настройки фильтра.
Шаг 3. Финальная настройка фильтра
После нажатия на кнопку «Применить настройки» в окне выбора элементов для связи открывается окно «Финальная настройка фильтра».
В данном окне можно внести последние изменения в фильтр перед его добавлением на слой проекта:
- изменить название фильтра;
- добавить или изменить описание;
- добавить или изменить ключ;
- изменить расположение названия;
- изменить условие;
- изменить значение по умолчанию.
Также доступны настройки отображения фильтра на слое:
- Вынести на слой - при установке данной настройки фильтр будет отображаться в проекте и фильтровать связанные с ним компоненты.
- Скрыть фильтр - при установке данной настройки фильтр вообще не будет отображаться в проекте, только фильтровать связанные с ним компоненты значением по умолчанию.
- Запретить обновление - запрещает изменение шаблона фильтра при помощи кнопки настройки.
- Запретить изменение - запрещает пользователям выбирать значения фильтра в режиме просмотра проекта и тем самым фильтровать связанные с ним компоненты. Компоненты с таким фильтром будут всегда отфильтрованы значением по умолчанию.
- Запретить очистку значения фильтра - данная настройка доступна только для фильтра типа «Список». Она запрещает оставлять поле значения фильтра пустым.
- Передавать значения фильтра между слоями и проектами - включает функциональность переноса значения глобального фильтра, см. Глобальный фильтр. Активна, только если заполнено поле «Ключ».
Сохранение фильтра
Для отмены внесенных данных в окно для добавления фильтра следует нажать кнопку , расположенную в верхнем правом углу окна, или нажать левую кнопку мыши вне области окна.
Для сохранения внесенных данных следует нажать кнопку «Создать связь». Окно для добавления фильтра скроется, в окне создания фильтра в блоке со списком отобразится созданный фильтр. Для закрытия окна создания фильтра (окно со списком созданных фильтров и кнопкой «Добавить фильтр») следует нажать на кнопку или нажать левую кнопку мыши вне области окна.
Настроенный таким образом фильтр будет выдавать следующий результат: