1с как работают критерии отбора
Создал критерий отбора. Но как его использовать в форме?
В версии 8.2 реализована механика перехода к информации, связанной с объектом. Команды, которые вызывают переход к такой информации, автоматически размещаются платформой в панели навигации формы объекта.
Критерий отбора как раз является одним из объектов конфигурации, который может поставлять информацию, связанную с теми или иными объектами базы данных. Поэтому, платформа автоматически предоставляет команду перехода к списку критерия отбора и вставляет ее в форму объекта, ссылка на который определяет тип критерия отбора, в панель навигации в группу Перейти . Эта команда невидима по умолчанию.
Рассмотрим ситуацию, когда открыв форму контрагента, нам нужно иметь возможность перейти к списку документов, в которых указан выбранный контрагент.
Для этого создадим критерий отбора ДокументыКонтрагента . На закладке Данные зададим тип этого критерия - СправочникСсылка.Контрагенты . (Справочник Контрагенты уже существует в конфигурации.)
На закладке Состав укажем список объектов, входящих в состав критерия отбора. В данном случае это реквизиты документов ПриходнаяНакладная, РасходнаяНакладная имеющих тип СправочникСсылка.Контрагенты .
Чтобы установить видимость команды открытия списка критерия отбора, создадим форму элемента справочника Контрагенты и на закладке Командный интерфейс в панели навигации формы в группе Перейти включим видимость этой команды.
Теперь в режиме 1С:Предприятие откроем любой элемент справочника Контрагенты , и выполнив команду ДокументыКонтрагента в панели навигации формы мы увидим список документов, где указан выбранный контрагент.
Демонстрационный пример находится в каталоге 1CITS/EXE/FAQ/КритерийОтбора.dt. Пример выполнен на версии платформы 8.2.9.356.
Нужно заметить, что в списках документов отбор по критерию отбора не реализован. Можно реализовать его программно, примерно так, как описано в вопросе Как открыть форму списка с некоторым отбором (3-ий вариант).
Назначение и устройство критериев отбора
В составе метаданных 1С:Предприятия 8 существует объект Критерий отбора . Этот объект, в отличие от большинства прикладных объектов конфигурации, не описывает каких-либо самостоятельных данных, которые будут храниться в информационной базе 1С:Предприятия. Он предназначен исключительно для описания некоторого правила выборки информации из объектных данных различных типов.
Суть решаемой задачи очень проста – нужно найти ссылки на все объекты заданных типов, которые хранят некоторое искомое значение в указанных реквизитах. Например, нужно найти все документы, связанные с определенным контрагентом, то есть имеющие в своих реквизитах (или реквизитах табличной части) ссылку на конкретный элемент справочника Контрагенты.
При описании в конфигурации критерия отбора нужно задать список реквизитов различных объектных данных, по которым будет формироваться отбор.
Например, если, мы будем искать по контрагенту документы "ПриходнаяНакладная", "РасходнаяНакладная" и "Взаимозачет", то нужно выбрать реквизиты:
- Документ.ПриходнаяНакладная.Реквизит.Поставщик;
- Документ.РасходнаяНакладная.Реквизит.Покупатель;
- Документ. Взаимозачет.ТабличнаяЧасть.Состав.Реквизит.Кто;
- Документ. Взаимозачет.ТабличнаяЧасть.Состав.Реквизит.Кому.
На примере документа "Взаимозачет" заметим, что можно выбирать реквизиты из табличных частей и можно выбирать несколько реквизитов в одном объекте. Данный критерий отбора позволит найти все документы указанных трех типов, содержащие ссылку на искомого контрагента в указанных реквизитах. Фактически, критерий отбора описывает некоторую область поиска.
При описании критерия отбора в конфигурации можно задать тип критерия отбора, тогда при настройке состава критерия отбора будут предлагаться реквизиты только подходящих типов.
При включении в конфигурацию критерия отбора система не создает никаких таблиц, однако для оптимизации поиска создается индекс по каждому реквизиту, который указан в составе критериев отбора. Индексы будут использоваться СУБД для оптимизации получения выборки при использовании критерия отбора. Таким образом, при описании критерия отбора нужно учитывать, что система будет тратить дополнительные ресурсы на поддержание необходимых индексов.
Критерий отбора может использоваться несколькими способами.
- может быть получена выборка с помощью метода Найти() менеджера критерия отбора;
- может быть выполнено обращение к виртуальной таблице критерия отбора в запросе (КритерийОтбора.<имя>);
- можно сделать форму критерия отбора или вставить в любую форму табличное поле, связанное с объектом КритерийОтбораСписок.<имя> , для отображения выборки в табличном поле;
- можно использовать критерий отбора в отборе списка документов.
Во всех случаях выборка выполняется одним и тем же способом. Система формирует запрос к СУБД для поиска объектов, которые включают искомое значение, и формирует выборку, состоящую из найденных ссылок на объекты. Формируемый запрос представляет собой объединение запросов по каждой таблице, в которой нужно осуществить поиск.
Запросы формируются только к тем данным (таблицам), из числа описанных в критерии отбора, у которых в реквизите может быть значение того типа, значение которого в данный момент ищется. Например, критерий отбора включает ссылки на справочник физических лиц и справочник организаций, а в конкретном реквизите конкретного документа может быть ссылка только на справочник физических лиц. Тогда запрос по этому документу будет выполняться, только если в данный момент поиск выполняется по физическому лицу.
Важно учитывать, что критерий отбора всегда выбирает все искомые данные. Ни в списке, ни в других режимах не поддерживается динамическая выборка, так как информация выбирается путем объединения данных из разных таблиц. Формируемый для критерия отбора индекс позволяет сделать это достаточно быстро, но если данных в выборке окажется очень много, то выборка не будет формироваться эффективно. Поэтому целесообразно создавать критерии отбора по данным, имеющим большой разброс значений, чтобы выборки получались не очень большие. В противном случае теряется смысл такого отбора и снижается его эффективность.
Таким образом, критерий отбора является сервисной возможностью, предлагаемой разработчику конфигурации. Фактически, он позволяет интерактивно описать условие выборки, автоматически создать необходимые индексы, автоматически сформировать сложный запрос, включающий обращение к большому количеству данных и автоматически задействовать выборку по данному критерию в интерфейсе прикладного решения.
В статье будут рассмотрены варианты установки отбора в управляемых формах 1С 8.3. Отбор для динамического списка может быть установлен статически или динамически, в пользовательском интерфейсе или конфигураторе. Все варианты отборов мы рассмотрим ниже.
- Установка отбора в пользовательском режиме
- Установка отбора в конфигураторе
- Фиксированный отбор
- Динамический (программный) отбор
Установка отбора в пользовательском режиме
Динамический список в отличие от таблицы или дерева значений – более подходящее решение для реализации форм содержащих какие-либо списки, т.к. динамический список предоставляет наиболее широкий набор инструментов для работы с отбором, группировкой полей, сортировкой. Данный отбор можно установить при работе в пользовательском режиме или конфигураторе, принцип одинаков.
Для установки отбора в режиме предприятия необходимо вызвать команду «Настроить список».
На вкладке «отбор» представлен список полей, который есть в текущем списке. Выбираем поля списка, по которым будем фильтровать. Сделать это можно двойным кликом или используя drag and drop.
Задаем вид сравнения и значение, жмем «Завершить редактирование», отбор установлен.
Отбор также можно группировать по логическим условиям «И», «ИЛИ».
Рис.4 Отбор также можно группировать по логическим условиям «И», «ИЛИ»![Рис.4 Отбор также можно группировать по логическим условиям «И», «ИЛИ»]()
При установке отбора в режиме предприятия на форме списка автоматически создаются поля так называемых быстрых отборов.
Чтобы платформа 1С автоматически создавала поля быстрых отборов, при разработке формы в конфигураторе необходимо указать группу пользовательских настроек.
Данный отбор будет сохранен только для текущего пользователя, что позволяет гибко производить кастомизированные настройки динамического списка. Однако если стоит задача сделать фиксированный отбор для определенного списка для всех пользователей системы, ее мы сможем решить только через конфигуратор.
Установка отбора в конфигураторе
Работая в конфигураторе, мы можем устанавливать отбор динамического списка двух видов – фиксированный и динамический. Фиксированный отбор настраивается один раз, динамический или программный – можно устанавливать в зависимости от каких-либо данных в системе.
Фиксированный отбор
Принцип установки фиксированного отбора в конфигураторе не отличается от установки в пользовательском режиме описанном выше. Чтобы установить отбор, мы должны открыть настройки динамического списка.
Отбор задается так же, как в пользовательском режиме.
Опция «Включать в пользовательские настройки» определяет, будет ли установленный в конфигураторе отбор доступен в пользовательском режиме через пункт меню «Настроить список».
Динамический (программный) отбор
Зачастую возникает необходимость устанавливать отбор программно, например, при открытии формы выбора, когда нам необходимо открыть управляемую форму с отбором. В форму передается параметр и по этому параметру устанавливается отбор. Частый пример этого – отбор элементов справочника по владельцу.
Методы
Если в разрабатываемой конфигурации присутствует подсистема БСП «БазоваяФункциональность», программный отбор в динамическом списке можно установить используя типовой метод:
Сигнатура данного метода:
ДинамическийСписок Тип: ДинамическийСписок – Список, в котором требуется установить отбор.
ИмяПоля Тип: Строка – Поле, по которому необходимо установить отбор.
ПравоеЗначение Тип: Произвольный – Значение отбора (Необязательный. Значение по умолчанию: Неопределено. Внимание! Если передать Неопределено, то значение не будет изменено).
ВидСравнения Тип: ВидСравненияКомпоновкиДанных – Условие отбора.
Представление Тип: Строка – Представление элемента компоновки данных (Необязательный. Значение по умолчанию: Неопределено. Если указано, то выводится только флажок использования с указанным представлением (значение не выводится). Для очистки, чтобы значение снова выводилось, следует передать пустую строку).
Использование Тип: Булево – Флажок использования этого отбора (Необязательный. Значение по умолчанию: Неопределено).
РежимОтображения Тип: РежимОтображенияЭлементаНастройкиКомпоновкиДанных – Способ отображения этого отбора пользователю. Возможные значения:
- РежимОтображенияЭлементаНастройкиКомпоновкиДанных.БыстрыйДоступ – В группе быстрых настроек над списком.
- РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный – В настройка списка (в подменю Еще).
- РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Недоступный – Запретить пользователю менять этот отбор.
ИдентификаторПользовательскойНастройки Тип: Строка – Уникальный идентификатор этого отбора (Используется для связи с пользовательскими настройками).
Для удаления какого-то значения отбора необходимо воспользоваться типовым методом:
Сигнатура данного метода:
ДинамическийСписок Тип: ДинамическийСписок – реквизит формы, для которого требуется установить отбор.
ИмяПоля Тип: Строка – имя поля компоновки (не используется для групп).
Представление Тип: Строка – представление поля компоновки.
В случае отсутствие в системе БСП отбор можно установить самостоятельно, используя объект ПолеКомпоновкиДанных.
Данный отбор отберет строки, в которых значение «ФИО» = «Иванов».
Для использования логических «И», «ИЛИ», «НЕ» предназначен тип данных ГруппаЭлементовОтбораКомпоновкиДанных
Данный отбор отберет строки, в которых значение «ФИО» = «Иванов» или «Петров».
Отбор в динамическом списке также можно производить через изменение текста запроса динамического списка. Этот вариант работает, когда динамический список сделан через «произвольный запрос».
Для этого к тексту запроса добавляем условие «ГДЕ Истина»…
Как видно, такой подход более компактный с точки зрения написания кода. Чем сложнее условия отбора в табличной части мы хотим установить, тем более громоздким будет вариант с использованием отбора через ЭлементОтбораКомпоновкиДанных. Однако у примера с изменением текста запроса есть свои недостатки – эта реализация не устойчива к изменениям кода. Например, вы сделали такую реализацию и забыли, но если в будущем вы захотите модифицировать текст запроса, добавив в него какой-либо оператор после ГДЕ (УПОРЯДОЧИТЬ, СГРУППИРОВАТЬ), вам нужно не забыть про то, что в программном коде есть:
Если этого не учесть будет ошибка, но чтобы этого избежать, можно переделать на другую реализацию. В текс запроса добавляем такое условие:
ГДЕ (НЕ &ОтборУстановлен ИЛИ СправочникПользователи.ФИО В (&РазрешенныеФИО))
Тут ФИО – массив.
Ка видно, 2 строчки кода против 10. Какой из способов выбрать, зависит от конкретной прикладной задачи.
![Анна Викулина]()
Критерии отбора 1С – это объект метаданных, позволяющий осуществить отбор информации в базе 1С по заданным условиям. Это, своего рода, предопределенные правила, по которым в пользовательском режиме в списках осуществляется отбор информации по какому-либо значению. Например, установив отбор по контрагенту, можно найти любые документы (или справочники), в которых фигурирует указанный контрагент.
Отбор в журнале по полю «Контрагент»:
Этот прием используется и при формировании структуры подчиненности, которую можно увидеть, воспользовавшись кнопкой на панели инструментов «Перейти к иерархическому списку связанных документов».
Разберем, что представляют собой связанные критерии отбора 1С на примере 1С:Бухгалтерия предприятия версии 3.0.
Откроем программу в режиме «Конфигуратор» и, сделав это, найдем в дереве метаданных нужный раздел критериев.
Настройки
В «Данных» задается «Тип» – это тип значения для отбора, по которому и будет осуществляться поиск. К примеру, «ДокументыПоКонтрагенту» имеет тип СправочникСсылка.Контрагенты, а «ДокументыСотрудников», имеют тип СправочникСсылка.ФизическиеЛица.
При этом можно задать любой тип из стандартных или определить объект из дерева конфигурации, указав любую ссылку.
Мы указываем тот тип, по которому будет производиться отбор. Преимущество критерия отбора заключается в том, что он может использовать также реквизиты табличных частей. Так, например, мы можем выбрать все документы с определенной номенклатурой в табличной части.
На закладке «Состав» отображаются те элементы, в которых содержатся данные указанного типа. В этом окне необходимо установить галочки для тех элементов, по которым будет осуществляться отбор. Только после определения этого списка, критерий отбора будет выполнять свою функцию.
Критериев отбора можно создавать множество, но для работы с ними нужно создавать формы, которые можно размещать и на панели инструментов, и в пользовательском меню. Критерии будут доступны по кнопке «Еще» во всех отмеченных объектах.
Пример создания критерия отбора
Создадим «ДокументыПоНоменклатуре», нажав правой кнопкой мышки и выбрав команду «Добавить».
На «Данных» укажем для него тип «СправочникСсылка.Номенклатура».
На закладке «Состав» пересмотрим все документы и в нужных нам установим галочку «Номенклатура», т.е. это тот элемент, по которому у нас определен отбор. Например, если нам достаточно формировать отбор только по счетам, то мы можем указать только этот вид документа.
Чтобы в режиме «1С:Предприятие» наше новшество работало, его необходимо включить в интерфейс пользователя, где мы хотим его видеть. Найдем в дереве метаданных справочник «Номенклатура», откроем ее форму элемента. На закладке «Командный интерфейс», прокрутив вниз, в разделе «Перейти» мы видим строку «Документы по номенклатуре (Объект.Ссылка)». Установим там галочку.
Далее выполняем команду «Обновить конфигурацию базу данных» (пункт меню «Конфигурация») и проверяем наш результат. Откроем любой элемент справочника «Номенклатура» и, нажав на гиперссылку «Еще», мы увидим пункт «Документы по номенклатуре».
Нажимаем на эту ссылку и получаем список документов, где была задействована эта позиция.
Рис.14 Список документов, где была задействована эта позиция![Рис.14 Список документов, где была задействована эта позиция]()
Таким образом, программа формирует запрос поиска, используя данные тех таблиц, которые указаны в критерии отбора, имеющие реквизит заданного типа, по которому осуществляется отбор (в нашем примере элемент справочника «Номенклатура»). Критерий отбора позволяет динамически произвести отбор, отображая все найденные данные, указанные в критерии отбора, что нельзя получить ни в других отборах, ни используя список, так как поиск осуществляется из разных таблиц. Чтобы выборка была эффективной, не надо задавать слишком много критериев отбора, иначе не будет смысла в таком отборе.
Связанные документы
По такому же принципу в программах 1С реализована возможность создавать документы на основании других. Между ними образуется связь, и пользователь может увидеть связанные документы, нажав на кнопку на панели инструментов «Перейти к иерархическому списку связанных документов».
Рис.15 Перейти к иерархическому списку связанных документов![Рис.15 Перейти к иерархическому списку связанных документов]()
Для того чтобы эту связь увидел пользователь, в настройках критерия отбора «СвязанныеДокументы» (на закладке «Данные») определяется список возможных связанных документов, а в «Составе» – тех, которые могут служить основанием для других документов.
Механизм критериев дает связанные элементы и отображает их список для пользователя. При этом, описав критерии выборки, автоматом создаются все нужные запросы и индексы. Это облегчает возможность создания любого критерия отбора для реализации автоматической выборки по заданным параметрам, но если у вас остались вопросы, обращайтесь к нашим специалистам по обслуживанию программ 1С, написав нам на сайте или позвонив по телефону. Мы с радостью вам поможем!
Читайте также:
