Контрол используется для выбора сущности заданного типа. Может отображаться в виде:

•выпадающего списка;

•отдельной формы-списка, которая открывается при нажатии на кнопку .

Рекомендуется скрывать значения, которые неактуальны для текущего списка. Например, в списке «Реестр договоров» можно выбрать только договорные виды документов:

// Показать только договорные виды документов.

var query = query
  .Where(d => d.Status == CoreEntities.DatabookEntry.Status.Active)
  .Where(d => d.DocumentFlow == Docflow.DocumentKind.DocumentFlow.Contracts);

Контрол используется для выбора одного или нескольких значений из фиксированного набора возможных значений. Может отображаться в виде:

•переключателя – для выбора одного значения;

•набора флажков – для выбора нескольких значений одновременно.

Переключатель рекомендуется использовать, если критерии фильтрации взаимно исключают друг друга:

Набор флажков рекомендуется использовать, если у свойства сущности есть несколько значений и нужно выбирать их в различных комбинациях. Например, в списке «Финансовые документы» используется фильтрация по состоянию и типам документов:

Для флажков рекомендуется выбирать такие значения, чтобы они покрывали все возможные значения связанного критерия. Если значений критерия слишком много, то выделите 3-4 наиболее популярных варианта, а остальные отнесите к флажку «Прочие»:

Набор флажков также можно использовать для свойства типа Логическое. Например, нарушение срока возврата – свойство логического типа. Панель фильтрации в списке «Документы к возврату» позволяет найти выданные документы, у которых истек возврата:

При написании обработчика фильтрации рекомендуется учитывать выбранные флажки по логическому условию «ИЛИ». При этом, если не выбран ни один флажок, условие по этому набору флажков накладывать не нужно. Например:

// Если выбрано хоть одно значение, то искать записи, в которых встречается

// хотя бы один выбранный статус.
if (_filter.Registered || _filter.Reserved || _filter.NotRegistered)
  query = query.Where(l => 
    (_filter.Registered && l.RegistrationState == 
        OfficialDocument.RegistrationState.Registered) ||
    (_filter.Reserved && l.RegistrationState == 
        OfficialDocument.RegistrationState.Reserved) ||
    (_filter.NotRegistered && l.RegistrationState == 
        OfficialDocument.RegistrationState.NotRegistered));

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

Используйте контрол «Период дат» вместе с контролом «Набор флажков». В этом случае флажки набора соответствуют наиболее частым периодам, по которым фильтруются сущности в списке: последние 7/30/90 дней и др. При этом «Период дат» становится доступным, если установлен определенный флажок, например, Произвольный период.

Рекомендуемые предопределенные периоды:

•для большинства типов документов в качестве периодов используются последние 7/30/90 дней. Подобные относительные периоды удобны тем, что позволяют вывести недавние объекты за постоянный период.

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

•для задач и заданий обычно используются периоды 30/90/180 дней.

Рекомендуется оставить возможность указать произвольный период дат, если это не критично для скорости открытия списка. Например, для ускорения открытия такая фильтрация отключена в папках потоков входящих заданий.