5.7.3. Фильтры
Пред. 5.7. Очереди процессов След.

5.7.3. Фильтры

Одна или несколько записей вида:

filter.<id>.type=<type>
#дополнительные обязательные и необязательные параметры различные для разных фильтров
filter.<id>.<param1>=<value1>
..
filter.<id>.<paramX>=<valueX>

Где:

<id> - уникальный числовой идентификатор фильтра;
<type> - тип фильтра, единственный обязательный параметр, см. значения далее.

Пример. Фильтр по статусу с выбранным по-умолчанию значением и ограничениям на значения, фильтр по дате создания, по группам решения, исполнителям, коду и дате закрытия.

filter.1.type=status
filter.1.show=1
filter.1.availableValues=9,10,12
filter.1.defaultValues=10
#
filter.2.type=create_date
#
filter.3.type=groups
filter.3.defaultValues=17
#
filter.4.type=executors
#
filter.5.type=code
filter.6.type=close_date

Далее описываются фильтры по их типу (параметр <type>), обязательные и необязательные параметры.

5.7.3.1. "code" - код процесса

Необязательные параметры:

show - 0, если фильтр необходимо скрыть.
5.7.3.2. "description" - подстрока в описании процесса

Необязательные параметры:

show - 0, если фильтр необходимо скрыть.
5.7.3.3. "openClose" - открытые либо закрытые процессы

Вывод только открытых, только закрытых либо всех процессов, значительно ускоряет выборку.

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
defaultValue - "none", "open" либо "close" - значение фильтра по-умолчанию.
5.7.3.4. "create_date" - диапазон дат создания процесса, "close_date" - диапазон дат закрытия процесса

Необязательные параметры:

show - 0, если фильтр необходимо скрыть.
5.7.3.5. "status_date" - диапазон дат когда процесс последний раз был переведён в статус

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
availableValues - отображаемые в фильтре коды статусов, в порядке их отображения; если параметр не указан - отображаются все статусы.
5.7.3.6. "status" - статус

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях;
values - жёстко заданные в фильтре коды статусов, в этом случае фильтр имеет смысл только скрытым;
availableValues - отображаемые в фильтре коды статусов, в порядке их отображения; если параметр не указан - отображаются все статусы;
defaultValues - коды статусов, выбранные в фильтре по-умолчанию через запятую;
onEmptyValues - значения фильтра, используемые, если никакие значения пользователем не выбраны.
5.7.3.7. "type" - тип процесса

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях;
availableValues - отображаемые в фильтре коды типов процессов, в порядке их отображения; если параметр не указан - отображаются все типы процессов;
defaultValues - коды типов процессов, выбранных в фильтре по-умолчанию через запятую;
onEmptyValues - значения фильтра, используемые, если никакие значения пользователем не выбраны.
5.7.3.8. "groups" - группы, исполняющие процесс

Фильтр без учёта ролей групп.

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях;
availableValues - отображаемые в фильтре коды групп, в порядке их отображения; если параметр не указан - отображаются все группы;
defaultValues - коды типов групп, выбранных в фильтре по-умолчанию через запятую;
onEmptyValues - значения фильтра, используемые, если никакие значения пользователем не выбраны.
5.7.3.9. "executors" - исполнители процесса

Без учёта в составе какой группы участвует пользователь. Фильтр работает только совместно с фильтром groups, при этом в списке исполнителей отображаются пользователи, когда-либо состоявшие в группах, указанных в фильтре groups.

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях;
values - "current", если необходимо отображать только процессы с текущим пользователем в исполнителях, фильтр в этом случае желательно скрыть.
5.7.3.10. "grex" - совмещённый фильтр по группам и исполнителям процесса

Фильтрует с учётом роли групп в процессах.

Обязательные параметры:

roleId - код роли.

Необязательные параметры:

groups.show - 0, если выбор групп необходимо скрыть;
groups.width - ширина выбора групп в пикселях;
groups.availableValues - отображаемые в фильтре коды групп, в порядке их отображения; если параметр не указан - отображаются все группы;
groups.defaultValues - коды типов групп, выбранных в фильтре по-умолчанию через запятую;
groups.onEmptyValues - значения групп фильтра, используемые, если никакие значения пользователем не выбраны;
executors.show - 0, если выбор исполнителей необходимо скрыть;
executors.width - ширина выбора исполнителей в пикселях.
5.7.3.11. "param:<paramId>" - фильтр по параметру процесса с кодом <paramId>

Поддерживаются параметры одного из следующих типов: "list", "date", "datetime", "address".

Обязательные параметры:

title - подпись к фильтру.

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях; для параметров типа "list", "address";
availableValues - доступные значения спискового параметра;
defaultValues - выбранные по-умолчанию значения спискового параметра;
onEmptyValues - значения параметра, используемые, если никакие значения пользователем не выбраны.
5.7.3.12. "linkedCustomer:title" - подстрока в наименовании привязанного к процессу контрагента

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях.
5.7.3.13. "linkedCustomer:param:<paramId>" - параметр привязанного к процессу контрагента

Поддерживаются параметры только типа "list".

Обязательные параметры:

title - подпись к фильтру.

Необязательные параметры:

show - 0, если фильтр необходимо скрыть;
width - ширина фильтра в пикселях;
availableValues - доступные значения спискового параметра;
defaultValues - выбранные по-умолчанию значения спискового параметра;
onEmptyValues - значения параметра, используемые, если никакие значения пользователем не выбраны.
Пред. Уровень выше След.
5.7.2. Колонки Начало 5.7.4. Сортировка