Формирование выборки объектов

Рис. 2. "Ручной" способ формирования выборки объектов.

sql-запрос

Является основным (хотя и не обязательным) полем, позволяющим задать произвольное условие выборки наиболее гибким образом, используя синтаксис MySQL.. Синтаксис SQL-выражений, которые можно использовать в данном поле описан в Приложении Синтаксис SQL-выражений. Если в данном поле указаны только числа через запятую, то это условие трактуется как список идентификаторов объектов. Это является аналогом SQL-запроса id in (число1, число2, число3). В выборку попадут объекты, идентификаторы которых присутствуют в списке.

текст

Позволяет производить выборку по произвольному тексту. В выборку попадут объекты, в заголовке, аннотации или тексте которых присутствует указанный текст. Текст также может присутствовать и в значениям текстовых параметров объектов.

количество

Позволяет задать ограничение на количество выбираемых объектов. В этом поле обязательно должно быть указано число, иначе выборка не будет сформирована. Правый клик мышью по этому полю добавляет к значению 10. Допускается использование одного из двух допустимых синтаксисов для данного поля:

1. Указывается одно простое число: N. В этом случае после получения из базы данных всех объектов, соответствующих условию выборки, и выполнения сортировки этих объектов по заданному правилу в выборку фильтра попадут N первых из всех объектов, удовлетворяющих заданному условию.

2. Указываются два простых числа через запятую: M,N. При этом логика работы фильтра остается такой же, как и в первом случае, с той лишь разницей, что из общей выборки будут отобраны не первые N объектов, а N объектов, начиная с позиции M. Необходимо иметь в виду, что первый объект в списке является по счету нулевым, т.е. если необходимо выбрать в фильтр 10 объектов, начиная со 2-го, необходимо указать в поле количество: 1,10.

владелец

Позволяет выбирать объекты, владельцем которых является конкретный пользователь. В списке присутствуют все пользователи зарегистрированные на сайте, кроме тех, что входят только в одну группу "по умолчанию".

группа

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

сортировка

Позволяет управлять порядком следования объектов в выборке. В настоящий момент доступны следующие варианты сортировки:

Натуральная – Порядок объектов в выборке соответствует их расположению в дереве сайта (атрибут tree_order).
По алфавиту – Объекты следуют в алфавитном порядке (атрибут mess_header).
По дате публикации – Объекты сортируются по убыванию даты публикации, введенной администратором (атрибут publish_date).
По дате ввода –  Объекты сортируются по убыванию даты ввода (атрибут enter_date).
По дате модификации – Объекты сортируются по убыванию даты последней модификации (атрибуту modify_date).
По идентификатору – Объекты сортируются по возрастанию их идентификатора (атрибут id).
Случайно – Объекты располагаются в случайном порядке.
По владельцу – Объекты сгруппированы по их владельцу (атрибут user_id).
По размеру контента – Объекты располагаются в порядке уменьшения размеров контента (атрибут mess_content).

Также для каждого варианта сортировки предусмотрено инверсное правило, т.е. "по возрастанию", или "в обратном порядке".

показать

Позволяет ввести имя параметра или список параметров через запятую, значения которых администратор желает видеть у выбранных объектов при работе с фильтром.

не брать
из Trash

При установке данного флага в выборку не будут включаться удаленные объекты, т.е. находящиеся в ветви Trash (id=99).

только
количество

При установке данного флага будет выведено только количество объектов сайта, соответствующих условию выборки без их отображения в линейном дереве ФИЛЬТРА.

Рис. 1. Контекстное меню и контрольная панель для групповых операций в панели ФИЛЬТР.