Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
ru:manual:filter:filter_element [2020/09/30 14:09] makarov [Использование системных констант в фильтре] |
ru:manual:filter:filter_element [2023/03/16 12:20] (текущий) |
||
---|---|---|---|
Строка 4: | Строка 4: | ||
- | [{{ ru/manual/filter/filter_element/autot_filter_element975.png?nolink |Рисунок 1. Окно фильтра}}] | + | [{{ ru/manual/filter/filter_element/autot_filter_element975.png?nolink |Рисунок 1. Окно фильтра }}] |
Описание назначения кнопок панели инструментов **Окна фильтра**, которые могут находиться в нажатом или отжатом состоянии, приведено в Таблице 1. | Описание назначения кнопок панели инструментов **Окна фильтра**, которые могут находиться в нажатом или отжатом состоянии, приведено в Таблице 1. | ||
Строка 20: | Строка 20: | ||
<endTableBox|Таблица 1. Кнопки панели инструментов окна фильтра> | <endTableBox|Таблица 1. Кнопки панели инструментов окна фильтра> | ||
- | **Объектом по умолчанию** называется корневой объект справочника. Любой справочник имеет объект по умолчанию. Например, объект "Физические лица" является корневым объектом для справочника "Физические лица". | + | Любой справочник имеет корневой объект. Например, объект "Физические лица" является корневым объектом для справочника "Физические лица". |
- | В поле "Группа фильтра" можно выбрать подгруппу справочника, имеющего иерархическую структуру. Это делается для того, чтобы в фильтрации участвовали только объекты, принадлежащие заданной группе. Например, для группы справочников "Объекты деятельности" может быть выбран справочник "Информация" (Рис. 2) или какая-либо из папок из справочника "Информация". Если структура справочника линейная, то группой фильтра всегда будет объект по умолчанию. | + | В поле "Группа фильтра" можно выбрать подгруппу справочника, имеющего иерархическую структуру. Это делается для того, чтобы в фильтрации участвовали только объекты, принадлежащие заданной группе. Например, для группы справочников "Функциональные объекты" может быть выбран справочник "Информация" (Рис. 2) или какая-либо из папок из справочника "Информация". Если структура справочника линейная, то группой фильтра всегда будет корневой объект. |
Строка 28: | Строка 28: | ||
== == | == == | ||
- | **Внимание!** Для хранимого фильтра (см. [[ru/manual/filter/stored_filter]]) с типом результата "Форма справочника" управление показом группы осуществляется установлением флажка для пункта меню **Показать группу** выпадающего меню кнопки **Действия**. | + | **Внимание!** Для фильтра (см. [[ru/manual/filter/stored_filter]]) с типом результата "Форма справочника" управление показом узла осуществляется установлением флажка для пункта меню **Показать узел** выпадающего меню кнопки **Действия**. |
==== ==== | ==== ==== | ||
\\ | \\ | ||
- | Кнопка {{common/icons/19.png?nolink}} сохраняет настроенный фильтр в справочнике **Хранимые фильтры** ({{bslink>Главное меню → Отчеты → Хранимые фильтры|ShowRibbonPageOrItem?c639ba43-ff15-4caf-ab36-0d938fe0a7a3;5f301d3f-d375-43a1-86d9-995ca3615998:Item}}) (подробнее см. [[ru/manual/filter/stored_filter]]). | + | Кнопка {{common/icons/19.png?nolink}} сохраняет настроенный фильтр в справочнике **Фильтры** ({{bslink>Главное меню → Отчеты → Фильтры|ShowRibbonPageOrItem?c639ba43-ff15-4caf-ab36-0d938fe0a7a3;5f301d3f-d375-43a1-86d9-995ca3615998:Item}}) (подробнее см. [[ru/manual/filter/stored_filter]]). |
- | Нажатие на кнопку **Сохранить** запускает выполнение фильтра. Нажатие на кнопку **Отмена** закрывает **Окно фильтра**. | + | Нажатие на кнопку **Выполнить** запускает выполнение фильтра. Нажатие на кнопку **Отмена** закрывает **Окно фильтра**. |
===== Вкладка "Условия" ===== | ===== Вкладка "Условия" ===== | ||
- | На вкладке **Условия** показана таблица со списком параметров класса и полями для ввода условий фильтра. Условия фильтра для параметра задаются в ячейках: **Тип**, **Оператор**, **Значение**, **Не**, **Потомки**. | + | На вкладке **Условия** показана таблица со списком параметров класса и полями для ввода условий фильтра. Условия фильтра для параметра задаются в ячейках: **Тип фильтрации**, **Оператор**, **Значение**, **Не**, **Потомки**. |
- | В ячейке **Тип** выбирается тип операции сравнения. Тип операции по умолчанию − "Нет", т.е. операция не задана. Чтобы задать условие фильтра, нужно выбрать тип операции "Значение", "Список значений" или "Диапазон" (последнее только для даты). | + | В ячейке **Тип фильтрации** выбирается тип операции сравнения. Тип фильтрации по умолчанию − "Нет", т.е. операция не задана. Чтобы задать условие фильтра, нужно выбрать тип фильтрации "Значение", "Список значений" или "Диапазон" (последнее только для даты). |
В ячейке **Оператор** из списка перечислений выбирается оператор сравнения: | В ячейке **Оператор** из списка перечислений выбирается оператор сравнения: | ||
Строка 50: | Строка 50: | ||
* **~ ** Операция подобия, используется только для строковых и текстовых параметров. Подробнее см. [[ru/manual/filter/filter_element#работа_с_операцией_подобия|Работа с операцией подобия "~"]] ниже. | * **~ ** Операция подобия, используется только для строковых и текстовых параметров. Подробнее см. [[ru/manual/filter/filter_element#работа_с_операцией_подобия|Работа с операцией подобия "~"]] ниже. | ||
- | В ячейке **Значение** вводится значение параметра. В зависимости от типа параметра это значение либо вводится с клавиатуры, либо выбирается из справочника, списка перечислений или календаря. Для типа операции "Список значений" значения выбираются из списка "Список значений". | + | В ячейке **Значение** вводится значение параметра. В зависимости от типа параметра это значение либо вводится с клавиатуры, либо выбирается из справочника, списка перечислений или календаря. Для типа фильтрации "Список значений" значения выбираются из списка "Список значений". |
- | Для параметра с типом "Дата" можно указать типы сравнения "Значение" или "Диапазон". Если выбран тип "Значение", то в ячейке **Значение** открывается календарь для выбора конкретной даты. Если выбран тип "Диапазон", то в ячейке "Значение" открывается окно "Выбор периода". Кроме того, для сравнения даты можно вводить специальные константы. Подробнее об этом сказано в [[ru/manual/filter/filter_element#использование_системных_констант_в_фильтре|Использование системных констант в фильтре]] ниже. | + | Для параметра с типом "Дата" можно указать типы сравнения "Значение" или "Диапазон". Если выбран тип фильтрации "Значение", то в ячейке **Значение** открывается календарь для выбора конкретной даты. Если выбран тип фильтрации"Диапазон", то в ячейке "Значение" открывается окно "Выбор периода". Кроме того, для сравнения даты можно вводить специальные константы. Подробнее об этом сказано в [[ru/manual/filter/filter_element#использование_системных_констант_в_фильтре|Использование системных констант в фильтре]] ниже. |
Опция **Не** служит для отрицания указанного условия, она включается и выключается щелчком мышкой в поле. Например, если выбрать оператор сравнения "=" и включить опцию "Не", то в результат фильтрации войдут все объекты, у которых значение параметра не равно заданному. | Опция **Не** служит для отрицания указанного условия, она включается и выключается щелчком мышкой в поле. Например, если выбрать оператор сравнения "=" и включить опцию "Не", то в результат фильтрации войдут все объекты, у которых значение параметра не равно заданному. | ||
Строка 58: | Строка 58: | ||
Опция **Потомки**. Использование в качестве значений также и потомков объекта, указанного в параметре "Значение". | Опция **Потомки**. Использование в качестве значений также и потомков объекта, указанного в параметре "Значение". | ||
- | Чтобы отменить условия фильтра, в ячейке **Тип** нужно выбрать − "Нет". | + | Чтобы отменить условия фильтра, в ячейке **Тип фильтрации** нужно выбрать − "Нет". |
== == | == == | ||
- | **Внимание!** Не рекомендуется настраивать условия по рассчитываемым параметрам из-за повышения нагрузки на аппаратные ресурсы. Например, вместо параметра "Название" в справочнике "Процессы" необходимо использовать хранимый параметр "Название процесса". | + | **Внимание!** Не рекомендуется настраивать условия по рассчитываемым параметрам из-за повышения нагрузки на аппаратные ресурсы. Например, вместо параметра "Название" в справочнике "Деятельность" необходимо использовать хранимый параметр "Название единицы деятельности". |
==== ==== | ==== ==== | ||
\\ | \\ | ||
Некоторые параметры класса имеют сложную структуру. У таких параметров значок «+», расположенный слева от названия, нарисован более насыщенным чёрным цветом, чем у остальных, и, в отличие от них, доступен для клика. Щелчок по значку «+» раскрывает структуру такого параметра, представляющую собой список параметров, для которых также можно задать условия фильтра. | Некоторые параметры класса имеют сложную структуру. У таких параметров значок «+», расположенный слева от названия, нарисован более насыщенным чёрным цветом, чем у остальных, и, в отличие от них, доступен для клика. Щелчок по значку «+» раскрывает структуру такого параметра, представляющую собой список параметров, для которых также можно задать условия фильтра. | ||
- | Если условие задано для параметра на одном из нижележащих уровней структуры, то для каждого параметра-владельца на вышележащих уровнях в ячейке **Тип** необходимо указать тип "Подфильтр". | + | Если условие задано для параметра на одном из нижележащих уровней структуры, то для каждого параметра-владельца на вышележащих уровнях в ячейке **Тип фильтрации** необходимо указать тип фильтрации "Подфильтр". |
Над областью задания условий фильтра находится 2 блока гиперссылок: | Над областью задания условий фильтра находится 2 блока гиперссылок: | ||
Строка 83: | Строка 83: | ||
<startTableBox> | <startTableBox> | ||
^ Комбинация символов ^ Описание ^ Пример ^ | ^ Комбинация символов ^ Описание ^ Пример ^ | ||
- | | % | Любая строка длиной от нуля и более символов | Фильтр по классу "Бумажные документы". На вкладке **Условия**: для параметра "Название" выбран Тип - "Значение", Оператор - "~", Значение - "%договор%". Результат: перечень всех документов, в которых встречается слово "договор". | | + | | % | Любая строка длиной от нуля и более символов | Фильтр по справочнику "Бумажные документы". На вкладке **Условия**: для параметра "Название" выбран Тип - "Значение", Оператор - "~", Значение - "%договор%". Результат: перечень всех документов, в которых встречается слово "договор". | |
- | | _ (подчеркивание) | Любой\\ одиночный\\ символ | Фильтр по классу "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "_етров". Результат: перечень всех физических лиц, фамилия которых состоит из шести букв и заканчивается сочетанием "етров" (Петров, Ветров и т.п.). | | + | | _ (подчеркивание) | Любой\\ одиночный\\ символ | Фильтр по справочнику "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "_етров". Результат: перечень всех физических лиц, фамилия которых состоит из шести букв и заканчивается сочетанием "етров" (Петров, Ветров и т.п.). | |
- | | _% | Любая строка длиной больше нуля символов | Фильтр по классу "Процессы". На вкладке **Условия**: для параметра "Содержание деятельности" выбран Тип - "Значение", Оператор - "~", Значение "_%". Результат: перечень всех процессов, у которых заполнен параметр "Содержание деятельности". | | + | | _% | Любая строка длиной больше нуля символов | Фильтр по справочнику "Деятельность". На вкладке **Условия**: для параметра "Содержание деятельности" выбран Тип - "Значение", Оператор - "~", Значение "_%". Результат: перечень всех единиц деятельности, у которых заполнен параметр "Содержание деятельности". | |
- | | [<перечень символов>] | Задает перечень символов, которые могут быть на указанной позиции в слове или тексте | Фильтр по классу "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "В[ои]лков". Результат: перечень всех физических лиц с фамилиями, начинающимися на "В", оканчивающимися на "лков" и имеющими в качестве второго символа букву "о" или "и" (Волков и Вилков). | | + | | [<перечень символов>] | Задает перечень символов, которые могут быть на указанной позиции в слове или тексте | Фильтр по справочнику "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "В[ои]лков". Результат: перечень всех физических лиц с фамилиями, начинающимися на "В", оканчивающимися на "лков" и имеющими в качестве второго символа букву "о" или "и" (Волков и Вилков). | |
- | | [%%^%%<перечень символов>] | Задает перечень символов, которые не могут быть на указанной позиции в слове или тексте | Фильтр по классу "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "В[%%^%%ои]лков". Результат: перечень всех физических лиц с фамилиями, начинающимися на "В", оканчивающимися на "лков" и не имеющими в качестве второго символа букву "о" или "и" (Вялков и т.п.). | | + | | [%%^%%<перечень символов>] | Задает перечень символов, которые не могут быть на указанной позиции в слове или тексте | Фильтр по справочнику "Физические лица". На вкладке **Условия**: для параметра "Фамилия" выбран Тип - "Значение", Оператор − "~", Значение - "В[%%^%%ои]лков". Результат: перечень всех физических лиц с фамилиями, начинающимися на "В", оканчивающимися на "лков" и не имеющими в качестве второго символа букву "о" или "и" (Вялков и т.п.). | |
<endTableBox|Таблица 2. Использование шаблонных символов для операции подобия> | <endTableBox|Таблица 2. Использование шаблонных символов для операции подобия> | ||
===== Использование системных констант в фильтре ===== | ===== Использование системных констант в фильтре ===== | ||
- | Условием фильтра может служить имя системной константы. Чтобы ввести в ячейку **Значение** константу, нажмите на строку параметра правой кнопкой мыши. В контекстном меню строки выберите команду **Вставить константу**. При этом в ячейке **Значение** появятся квадратные скобки. Установите курсор между скобками и введите системное название константы. В ячейке **Тип** выберите тип операции сравнения "Значение", выберите оператор сравнения. | + | Условием фильтра может служить имя системной константы. Чтобы ввести в ячейку **Значение** константу, нажмите на строку параметра правой кнопкой мыши. В контекстном меню строки выберите команду **Вставить константу**. При этом в ячейке **Значение** появятся квадратные скобки. Установите курсор между скобками и введите системное название константы. В ячейке **Тип фильтрации** выберите тип фильтрации сравнения "Значение", выберите оператор сравнения. |
<startTableBox> | <startTableBox> | ||
Строка 108: | Строка 108: | ||
- | [{{ ru/manual/filter/filter_element/change_filter_element999.png?nolink |Рисунок 4}}] | + | [{{ ru/manual/filter/filter_element/change_filter_element999.png?nolink |Рисунок 4 }}] |
<startTableBox> | <startTableBox> | ||
Строка 134: | Строка 134: | ||
| ПятьЛетНазад | В диапазон значений подставляется интервал на 5 лет назад, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | | | ПятьЛетНазад | В диапазон значений подставляется интервал на 5 лет назад, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | | ||
| ДесятьЛетНазад | В диапазон значений подставляется интервал на 10 лет назад, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | | | ДесятьЛетНазад | В диапазон значений подставляется интервал на 10 лет назад, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | | ||
- | | 1ДесятьЛетНазад | В диапазон значений подставляется дата следующего дня. | | + | | Завтра | В диапазон значений подставляется дата следующего дня. | |
- | | 2ДесятьЛетНазад | В диапазон значений подставляется следующая неделя. | | + | | СледующаяНеделя | В диапазон значений подставляется следующая неделя. | |
- | | 3ДесятьЛетНазад | В диапазон значений подставляется за следующий месяц. | | + | | СледующийМесяц | В диапазон значений подставляется за следующий месяц. | |
- | | 4ДесятьЛетНазад | В диапазон значений подставляется следующий квартал. | | + | | СледующийКвартал | В диапазон значений подставляется следующий квартал. | |
- | | 5ДесятьЛетНазад | В диапазон значений подставляется следующее полугодие. | | + | | СледующееПолугодие | В диапазон значений подставляется следующее полугодие. | |
- | | 6ДесятьЛетНазад | В диапазон значений подставляется следующий год. | | + | | СледующийГод | В диапазон значений подставляется следующий год. | |
- | | 7ДесятьЛетНазад | В диапазон значений подставляется интервал на неделю вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в Настройках пользователя на вкладке Дополнительно. | | + | | НеделюВперед | В диапазон значений подставляется интервал на неделю вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | |
- | | 8ДесятьЛетНазад | В диапазон значений подставляется интервал на месяц вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в Настройках пользователя на вкладке Дополнительно. | | + | | МесяцВперед | В диапазон значений подставляется интервал на месяц вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | |
- | | 9ДесятьЛетНазад | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в Настройках пользователя на вкладке Дополнительно. | | + | | КварталВперед | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | |
- | | 10ДесятьЛетНазад | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в Настройках пользователя на вкладке Дополнительно. | | + | | ПолугодиеВперед | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | |
- | | 11ДесятьЛетНазад | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в Настройках пользователя на вкладке Дополнительно. | | + | | ГодВперед | В диапазон значений подставляется интервал на квартал вперед, считая от даты актуальности, которая задается в строке состояния Business Studio или в параметре "Дата актуальности" в **Настройках пользователя** на вкладке **Дополнительно**. | |
<endTableBox|Таблица 4. Константы даты для подстановки в качестве диапазона> | <endTableBox|Таблица 4. Константы даты для подстановки в качестве диапазона> | ||
Строка 150: | Строка 150: | ||
== == | == == | ||
- | **Внимание!** Можно константу диапазона подставить для типа операции "Значение". В этом случае работа будет происходить с датой начала диапазона. | + | **Внимание!** Можно константу диапазона подставить для типа фильтрации "Значение". В этом случае работа будет происходить с датой начала диапазона. |
==== ==== | ==== ==== | ||
\\ | \\ | ||
== == | == == | ||
- | **Внимание!** Константы значений нельзя подставлять для типа операции "Диапазон". | + | **Внимание!** Константы значений нельзя подставлять для типа фильтрации "Диапазон". |
==== ==== | ==== ==== | ||
\\ | \\ | ||
- | В качестве констант можно использовать параметры Объекта по умолчанию любого класса (справочника) в виде: | + | В качестве констант можно использовать параметры Корневого любого класса (справочника) в виде: |
[<СистемноеНазваниеКласса>.<СистемноеНазваниеПараметра>] | [<СистемноеНазваниеКласса>.<СистемноеНазваниеПараметра>] | ||
Строка 171: | Строка 171: | ||
[<contextnavigator>] | [<contextnavigator>] | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | {(rater>id=ru_manual_filter_filter_element|name=Окно фильтра|type=vote|trace=ip|headline=off)} |