Шаг 1. Создание шаблона фильтра

Для добавления фильтра в проект необходимо нажать кнопку , расположенную в правом меню кнопок в режиме редактирования проекта:



После нажатия на кнопку появляется окно просмотра связей на слое:


Для доступа к созданию нового фильтра следует нажать на кнопку "Новая связь".

После нажатия на кнопку откроется первый шаг настройки связи:

 

В окне можно выбрать шаблон фильтра из уже готовых, либо элемент слоя для фильтрации. Также доступна кнопка "Выбрать на слое", которая позволяет напрямую перейти на слой и выбрать элемент.

Для добавления принципиально нового фильтра на вкладке "Шаблоны фильтров" следует нажать на кнопку-ссылку "Добавить новый фильтр".

После нажатия на кнопку откроется окно для добавления нового шаблона фильтра:


Окно содержит следующие поля:

  • Название - наименование фильтра. Обязательное поле.
  • Ключ - произвольная комбинация латинских букв верхнего и нижнего регистра, цифр и нижнего подчеркивания "_". Одинаковые значения ключа позволяют передавать значения фильтра между слоями и проектами, как описано в разделе "Глобальный фильтр".
  • Расположение - не показывать, сверху, снизу, слева или справа от ближайшего элемента.
  • Тип фильтра - обязательное поле. О типах фильтров см. руководство пользователя Manager, раздел "Фильтры".
  • Отображение - обязательное поле. Зависит от типа фильтра. О настройке отображения см. руководство пользователя Manager, раздел "Фильтры".

После выбора типа и отображения в окне настройки большинства фильтров появляются поля:

  • Датасет - набор данных, на котором построен фильтр. Фильтр и виджет могут быть построены на разных датасетах, главное, чтобы оба содержали колонки, по которым будет осуществляться фильтрация. Для примера, виджет построен на датасете "Города РФ с кодами", а фильтр - "Города РФ" (см рисунок выше).
  • Отображаемое значение - колонка, присутствующая в обоих датасетах, и содержащая человекочитаемые значения, которые будут отображаться пользователю в  фильтре. Для примера, колонка "Город", выбранная на рисунке выше, содержит названия городов.
  • "Ключ" - колонка, присутствующая в обоих датасетах, и не отображающаяся пользователю, но фактически осуществляющая фильтрацию. Для примера, колонка "Кодгорода", выбранная на рисунке выше, содержит числовые коды городов. 
  • Условие - обязательное поле. Зависит от типа фильтра.  О настройке условия см. руководство пользователя Manager, раздел "Фильтры".
  • Права доступа к фильтру - см. Работа с расширенным фильтром.

После настройки следует нажать на кнопку "Создать". Новый шаблон фильтра будет добавлен в список шаблонов, и отобразится вкладка "Шаблоны фильтров".

Шаг 2. Связывание фильтра и виджета

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


В окне нужно установить чек-бокс у элемента, с которым будет создана связь.

Далее есть два варианта связи:

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


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



Далее необходимо нажать на кнопку "Применить настройки". Произойдет переход на третий этап настройки фильтра.

Шаг 3. Финальная настройка фильтра

После нажатия на кнопку «Применить настройки» в окне выбора элементов для связи открывается окно «Финальная настройка фильтра». 


В данном окне можно внести последние изменения в фильтр перед его добавлением на слой проекта:

  • изменить название фильтра;
  • добавить или изменить описание;
  • добавить или изменить ключ;
  • изменить расположение названия;
  • изменить условие;
  • изменить значение по умолчанию.

Также доступны настройки отображения фильтра на слое:

  1. Вынести на слой - при установке данной настройки фильтр будет отображаться в проекте и фильтровать связанные с ним компоненты.
  2. Скрыть фильтр - при установке данной настройки фильтр вообще не будет отображаться в проекте, только фильтровать связанные с ним компоненты значением по умолчанию.
  3. Запретить обновление - запрещает изменение шаблона фильтра при помощи кнопки настройки.   
  4. Запретить изменение - запрещает пользователям выбирать значения фильтра в режиме просмотра проекта и тем самым фильтровать связанные с ним компоненты. Компоненты с таким фильтром будут всегда отфильтрованы значением по умолчанию.
  5. Запретить очистку значения фильтра - данная настройка доступна только для фильтра типа «Список». Она запрещает оставлять поле значения фильтра пустым.
  6. Передавать значения фильтра между слоями и проектами - включает функциональность переноса значения глобального фильтра, см. Глобальный фильтр. Активна, только если заполнено поле «Ключ».

Сохранение фильтра

Для отмены внесенных данных в окно для добавления фильтра следует нажать кнопку , расположенную в верхнем правом углу окна, или нажать левую кнопку мыши вне области окна. 

Для сохранения внесенных данных следует нажать кнопку «Создать связь». Окно для добавления фильтра скроется, в окне создания фильтра в блоке со списком отобразится созданный фильтр. Для закрытия окна создания фильтра (окно со списком созданных фильтров и кнопкой «Добавить фильтр») следует нажать на кнопку или нажать левую кнопку мыши вне области окна.

Настроенный таким образом фильтр будет выдавать следующий результат: