Критерии отбора на простом примере. Требования к критериям отбора 1с 8.3 критерии отбора связанные документы пример

В составе метаданных 1С:Предприятия 8 существует объект Критерий отбора.

Этот объект, в отличие от большинства прикладных объектов конфигурации, не описывает каких-либо самостоятельных данных, которые будут храниться в информационной базе 1С:Предприятия. Критерий отбора предназначен для того, чтобы описать условия отбора по некоторым объектам. Например, можно указать, что критерий отбора строится по типу данных СправочникСсылка.Номенклатура, и в этот критерий входят документы “ПоступлениеТоваровУслуг” и “РеализацияТоваровУслуг”. Конечно, все отборы мы можем делать с помощью запроса.

Особенностью (преимуществом) критерия отбора является то, что он может строиться в том числе по реквизирам табличных частей. Таким образом мы можем очень просто настроить отбор так, чтобы в его результат попадали лишь те документы, в табличной части которых есть интересующий нас элемент справочника “Номенклатура”.

Критерий отбора является прикладным объектом, для него, в частности, можно создать форму, которая будет отображаться в пользовательском режиме. Однако находится он в ветке “Общие” из-за того, что имеет узкоспециализированное назначение. Особенностью Критерия отбора является то, что он не входит в глобальный командный интерфейс.

Рассмотрим особенности критерия отбора на примере. Создадим новый критерий отбора “Документы с номенклатурой”. Настроим закладки “Данные” и “Состав”. На закладке “Данные” указывается тот тип данных, по которому будет осуществляться отбор. Причем тип данных может быть составным. Итак, выберем тип данных – СправочникСсылка.Номенклатура. На закладке состав мы выбираем объекты, которые будут являться результатом выполнения нашего отбора. Система предлагает нам отметить флажками интересующие нас объекты из списка, в который она включает все объекты, содержащие ссылку на справочник “Номенклатура”. На закладке формы мы можем для критерия отбора указать ФормуСписка, которая будет содержать динамический список объектов, удовлетворяющих нашему критерию. Кроме того, на закладке Права мы можем настроить “Просмотр” для определенных ролей. Следует отметить, что в пользовательском интерфейсе существует возможность просмотра результата отбора, т.е. ФормыСписка критерия отбора. В нашем случае это будет форма справочника “Номенклатура”, но, чтобы это работало, необходимо перейти в командный интерфейс ФормыЭлемента справочника “Номенклатура” и поставить флаг в колонке “Видимость” напротив “Документы с номенклатурой (Объект.Ссылка) .


Рассмотрим, как критерий отбора хранится в базе данных. Если мы в нашей Базе данных создадим запрос, то мы увидим таблицу, которая соответствует критерию отбора. Однако данная таблица является “виртуальной “. В процессе отладки мы можем вызвать метод ПолучитьСтруктуруХраненияБазыДанных() , и мы также не найдем таблиц, соответствующих критерию отбора. Таким образом, нет физической таблицы, соответствующей критерию отбора, но есть таблица виртуальная, к которой мы можем обратиться. Например, создав запрос и выгрузив результатЗапроса:

Запрос.Текст = "ВЫБРАТЬ | ДокументыСНоменклатурой.Ссылка |ИЗ | КритерийОтбора.ДокументыСНоменклатурой(&Номенклатура) КАК ДокументыСНоменклатурой"; Запрос.УстановитьПараметр("Номенклатура", Номенклатура); РезультатЗапроса = Запрос.Выполнить();

Мы получим документы, в которых содержится интересующая нас номенклатура.

Также следует отметить, что, несмотря на то, что при включении в конфигурацию критерия отбора система не создает никаких таблиц, однако для оптимизации поиска создается индекс по каждому реквизиту, который указан в составе критериев отбора. Индексы будут использоваться для оптимизации получения выборки при использовании критерия отбора. Таким образом, при описании критерия отбора нужно учитывать, что система будет тратить дополнительные ресурсы на поддержание необходимых индексов. Кстати, процесс “заполнения индекса поиска” можно увидеть, если мы просто переименуем созданный ранее критерий отбора. Сам процесс длится около минуты. А далее система выдает сообщение “Код модулей содержит возможные использования ссылки на изменяемый объект. Продолжить операцию переименования?” И если мы соглашаемся, то выдает нам ссылки на код, где встречаются упоминания нашего критерия отбора. Причем рядом с каждой ссылкой появляется команда “заменить”, при нажатии на которую автоматически происходит замена старого наименования критерия отбора на новое.

Каким же образом система получает искомый результат? Дело в том, что она формирует запрос для поиска объектов, которые включают искомое значение, и формирует выборку, состоящую из найденных ссылок на объекты. Формируемый запрос представляет собой объединение запросов по каждой таблице, в которой нужно осуществить поиск. Запросы формируются только к тем данным (таблицам), из числа описанных в критерии отбора, у которых в реквизите может быть значение того типа, значение которого в данный момент ищется. Например, критерий отбора включает ссылки на справочник физических лиц и справочник организаций, а в конкретном реквизите конкретного документа может быть ссылка только на справочник физических лиц. Тогда запрос по этому документу будет выполняться, только если в данный момент поиск выполняется по физическому лицу. Важно учитывать, что критерий отбора всегда выбирает все искомые данные. Ни в списке, ни в других режимах не поддерживается динамическая выборка, так как информация выбирается путем объединения данных из разных таблиц. Формируемый для критерия отбора индекс позволяет сделать это достаточно быстро, но если данных в выборке окажется очень много, то выборка не будет формироваться эффективно. Поэтому целесообразно создавать критерии отбора по данным, имеющим большой разброс значений, чтобы выборки получались не очень большие. В противном случае теряется смысл такого отбора и снижается его эффективность.

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

Поговорим о программной работе с критерием отбора. В синтакс-помощнике в ветке “Прикладные объекты” находится ветка “Критерии отбора”. Мы видим, что количество типов данных здесь не очень большое. Во-первых, это менеджер критериев отбора – КритерииОтбораМенеджер (FilterCriteriaManager) . Это свойство глобального контекста, которое позволяет через точку обратиться к конкретному критерию отбора. Далее мы получаем КритерийОтбораМенеджер.<Имя критерия> (FilterCriterionManager.<Имя критерия>) , у которого есть два метода – Найти(<ЗначениеПоиска>) и ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>) . И еще один тип данных – КритерийОтбораСписок.<Имя критерия> (FilterCriterionList.<Имя критерия>) . Он предназначен для управления списком отобранных документов и/или элементов справочников, отображаемых в табличном поле (списком критерия отбора). Как видим, методов для програмной работы не очень много, поэтому гораздо удобнее работать с критерием отбора при помощи запроса.
Рассмотрим на примере, как отобразить результат работы критерия отбора в форме. Для этого можно создать обработку.

Итак, создаем обработку и управляемую форму для неё. У формы будет два реквизита. Это “Номенклатура” – СправочникСсылка.Номенклатуры и “Список”, тип которого – “ДинамическийСписок “. В свойствах реквизита “Список” заполним “ОсновнаяТаблица” значением – “КритерийОтбора.ДокументыСНоменклатурой”. Перетаскиваем оба реквизита на форму. Кроме того, нам необходимо установить параметр “Значение” для нашего динамического списка. У динамического списка есть свойство “Параметры”, тип значения которого: ЗначенияПараметровДанныхКомпоновкиДанных. У которого в свою очередь есть метод: УстановитьЗначениеПараметра(<Параметр>, <Значение>) . Итак, в модуле формы у нас будет следующий код:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура НоменклатураПриИзменении(Элемент) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры

Сохраняем обработку и запускаем в пользовательском режиме.

Рассмотрим еще один пример работы с критерием отбора. На этот раз поработаем с ФормойСписка критерия отбора. Дело в том, что интерактивно открыть её пользователь не может. Попробуем открыть её программным образом. В нашей обработке создадим команду “ОткрытьФ”, перетащим её в форму нашей обработки, и создадим процедуру для нашей команды:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура НоменклатураПриИзменении(Элемент) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура ОткрытьФ(Команда) ОткрытьФорму("КритерийОтбора.ДокументыПоДоговоруКонтрагента.ФормаСписка"); КонецПроцедуры

Сохраняем нашу обработку, в пользовательском режиме нажимаем на кнопку “ОткрытьФ” , наша ФормаСписка открывается, но система при этом выдает ошибку. Дело в том, что система не может понять, по какому объекту ей нужно сделать отбор. Нам необходимо заполнить параметр Значение нашего динамического списка. В принципе, мы можем сделать это интерактивно. Для этого перейдем в ФормуСписка нашего критерия отбора, раскроем ветку “Список”, найдем там “Параметры” и перетащим их на нашу ФормуСписка критерия отбора. Теперь в пользовательском режиме мы можем поставить флажок перед параметром “Значение” в истину, ну и, собственно, заполнить и сам параметр “Значение”. Но лучше это сделать программно при открытии ФормыСписка критерия отбора. Программную установку мы будем делать в процедуре “ПриСозданииНаСервере() “. Если мы поставим точку останова в этой процедуре, то при отладке мы увидим: в параметрах нашего динамического списка есть коллекция “Элементы”, и у элемента “Использование” стоит значение “Ложь”. Чтобы установить его в истину, можно использовать следующий код, поскольку “Элементы” – это коллекция значений:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Использование = Истина; КонецПроцедуры

Мы можем также использовать обращение по имени параметра. Для этого мы можем использовать метод “Найти()” :

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Найти("Значение").Использование = Истина; КонецПроцедуры

Также мы можем передать в ФормуСписка критерия отбора значение “Номенклатуры” из формы вызывающей, т.е. нашей обработки. Для этого передадим из формы нашей обработки значение “Номенклатура”:

&НаКлиенте Процедура ОткрытьФ(Команда) ОткрытьФорму("КритерийОтбора.ДокументыСНоменклатурой.ФормаСписка", новый Структура("Номенклатура", Номенклатура); КонецПроцедуры

А в ФормеСписка критерия отбора воспользуемся переданным значением:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Найти("Значение").Использование = Истина; Список.Параметры.Элементы.Найти("Значение").Значение = Параметры.Номенклатура; КонецПроцедуры

Далее запускаем нашу обработку в пользовательском режиме, заполняем реквизит “Номенклатура” и нажимаем кнопку “ОткрытьФ”. В результате откроется ФормаСписка критерия отбора с переданным значением “Номенклатуры” из формы вызывающей, а также сформируется результат отбора.

На этом заканчиваем, надеюсь, материал будет полезен для понимания сути объекта “Критерий отбора”. Всем пока и удачи)

Был рассмотрен простой пример настройки и использования объекта конфигурации "критерий отбора". Подробнее узнать информацию о нем Вы можете в синтаксис-помощнике или на официальном сайте .

Сегодня в статье рассмотрим закулисную работу платформы 1С:Предприятие с СУБД при использовании критериев отбора. В примере будет использоваться Microsoft® SQL Server® 2008 Express with Advanced Services .

Что у нас есть?

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


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

В запросе

Для каждого критерия отбора создается виртуальная таблица, в которой имеется единственный параметр "Значение". В параметр передается ссылка на элемент, для которого нужно получить связанные элементы.

При выполнении запроса мы получим аналогичный результат, что и на скриншоте выше, если в качестве параметра передадим ссылку на элемент справочника товары.

"За кулисами"

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

Например, если мы выполним следующий запрос с ссылкой на элемент справочника "Товары" в параметре:


,

то платформа сформирует следующий SQL-запрос к СУБД:

На скриншоте выше подробно рассмотрен SQL-запрос, формируемый платформой. Наш пример усложнен тем, что для элемента справочника "Товары" ищутся документы по наличию ссылки на этот товар в их табличных частях. Поэтому в SQL-запросе присутствует конструкция "EXIST" для проверки наличия хотя бы одной ссылки на товар в табличной части документа.

Для каждой таблицы документа формируется отдельный SELECT. После результаты объединяются с помощью конструкции "UNION ALL". Из полученной таблицы во вложенном запросе получают все ссылки на документы, в табличных частях которых присутствует искомый элемент справочника.

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

Подобные SQL-запросы платформа формирует для всех случаев использования критерия отбора в конфигурации.

Выводы

Таким образом, критерий отбора - это механизм платформы, который выступает в качестве инструкции платформе для формирования SQL-запросов к базе данных на получения ссылок на связанные объекты информационной базы. В противном случае разработчику пришлось бы самостоятельно писать такие запросы и настраивать индексы для реквизитов объектов.

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

Влияние на производительность с их стороны незначительная. Из-за создания дополнительных индексов может увеличиться время записи, так как появляется необходимость в обновлении индекса при помещении данных в информационную базу.

Печать (Ctrl+P)

Критерии отбора

Критерии отбора – одна из составляющих механизма отбора информации. С их помощью специалист, осуществляющий конфигурирование системы, создает предопределенные правила отбора. В режиме 1С:Предприятие по этим правилам будет выполняться отбор информации в списках.
В окне редактирования объекта Критерий отбора нужно указать имя, синоним и комментарий.
Тип критерия отбора может быть любым из стандартных типов или определенных как объекты дерева конфигурации. Допускается включение реквизитов с составным типом, заданным как СправочникСсылка , ДокументСсылка и т. д., а также реквизитов с составным типом, определенным планом видов характеристик (Характеристика…).
При создании типа критерия отбора следует указать те типы, по которым требуется производить отбор. На закладке Состав по этому типу будет сформирован состав объектов конфигурации, содержащих данные, тип которых входит в тип критерия отбора. В списке требуется установить отметку для тех реквизитов, по которым будет производиться данный отбор.
Чтобы критерий отбора выполнял свои функции, в конфигураторе для него должен быть создан список (закладка Состав), состоящий из реквизитов справочников и документов. На состав списка не накладывается практически никаких ограничений: например, в отличие от графы журнала, для критерия отбора можно выбрать несколько реквизитов одного документа и реквизитов табличной части документа.
Критериев отбора может быть произвольное число, а каждый критерий может иметь несколько форм представления результатов отбора. Этот механизм полезен в случае поиска различной информации. Например, требуется отобрать все документы, в которых используется (в реквизитах и табличных частях) определенный контрагент. При этом можно учитывать и другие условия отбора информации (например, поиск ведется только среди проведенных документов или в определенном интервале дат и т. д.).
ПРИМЕЧАНИЕ. При открытии формы отбора следует передавать в нее параметр Отбор с установленным значением отбора (элемент Значение).
Критерий отбора может иметь произвольное число форм для визуального представления результатов отбора. Для оперативности получения информации по отбору вызов формы можно разместить в пользовательском меню или на панели инструментов.
Если форм критерия отбора несколько, то в свойстве Основная форма указывается та форма, которая будет вызываться по умолчанию.
Если в конфигурации определено несколько подсистем, нужно выбрать ту, к которой относится данный критерий отбора. Можно указать несколько различных подсистем.
Для вызова формы критерия отбора система размещает соответствующую команду в панели навигации формы.

В составе метаданных 1С:Предприятия 8 существует объект Критерий отбора.

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

Особенностью (преимуществом) критерия отбора является то, что он может строиться в том числе по реквизирам табличных частей. Таким образом мы можем очень просто настроить отбор так, чтобы в его результат попадали лишь те документы, в табличной части которых есть интересующий нас элемент справочника "Номенклатура".

Критерий отбора является прикладным объектом, для него, в частности, можно создать форму, которая будет отображаться в пользовательском режиме. Однако находится он в ветке "Общие" из-за того, что имеет узкоспециализированное назначение. Особенностью Критерия отбора является то, что он не входит в глобальный командный интерфейс.

Рассмотрим особенности критерия отбора на примере. Создадим новый критерий отбора "Документы с номенклатурой". Настроим закладки "Данные" и "Состав". На закладке "Данные" указывается тот тип данных, по которому будет осуществляться отбор. Причем тип данных может быть составным. Итак, выберем тип данных - СправочникСсылка.Номенклатура. На закладке состав мы выбираем объекты, которые будут являться результатом выполнения нашего отбора. Система предлагает нам отметить флажками интересующие нас объекты из списка, в который она включает все объекты, содержащие ссылку на справочник "Номенклатура". На закладке формы мы можем для критерия отбора указать ФормуСписка, которая будет содержать динамический список объектов, удовлетворяющих нашему критерию. Кроме того, на закладке Права мы можем настроить "Просмотр" для определенных ролей. Следует отметить, что в пользовательском интерфейсе существует возможность просмотра результата отбора, т.е. ФормыСписка критерия отбора. В нашем случае это будет форма справочника "Номенклатура", но, чтобы это работало, необходимо перейти в командный интерфейс ФормыЭлемента справочника "Номенклатура" и поставить флаг в колонке "Видимость" напротив "Документы с номенклатурой (Объект.Ссылка) .


Рассмотрим, как критерий отбора хранится в базе данных. Если мы в нашей Базе данных создадим запрос, то мы увидим таблицу, которая соответствует критерию отбора. Однако данная таблица является "виртуальной ". В процессе отладки мы можем вызвать метод ПолучитьСтруктуруХраненияБазыДанных() , и мы также не найдем таблиц, соответствующих критерию отбора. Таким образом, нет физической таблицы, соответствующей критерию отбора, но есть таблица виртуальная, к которой мы можем обратиться. Например, создав запрос и выгрузив результатЗапроса:

Запрос.Текст = "ВЫБРАТЬ | ДокументыСНоменклатурой.Ссылка |ИЗ | КритерийОтбора.ДокументыСНоменклатурой(&Номенклатура) КАК ДокументыСНоменклатурой"; Запрос.УстановитьПараметр("Номенклатура", Номенклатура); РезультатЗапроса = Запрос.Выполнить();

Мы получим документы, в которых содержится интересующая нас номенклатура.

Также следует отметить, что, несмотря на то, что при включении в конфигурацию критерия отбора система не создает никаких таблиц, однако для оптимизации поиска создается индекс по каждому реквизиту, который указан в составе критериев отбора. Индексы будут использоваться для оптимизации получения выборки при использовании критерия отбора. Таким образом, при описании критерия отбора нужно учитывать, что система будет тратить дополнительные ресурсы на поддержание необходимых индексов. Кстати, процесс "заполнения индекса поиска" можно увидеть, если мы просто переименуем созданный ранее критерий отбора. Сам процесс длится около минуты. А далее система выдает сообщение "Код модулей содержит возможные использования ссылки на изменяемый объект. Продолжить операцию переименования?" И если мы соглашаемся, то выдает нам ссылки на код, где встречаются упоминания нашего критерия отбора. Причем рядом с каждой ссылкой появляется команда "заменить", при нажатии на которую автоматически происходит замена старого наименования критерия отбора на новое.

Каким же образом система получает искомый результат? Дело в том, что она формирует запрос для поиска объектов, которые включают искомое значение, и формирует выборку, состоящую из найденных ссылок на объекты. Формируемый запрос представляет собой объединение запросов по каждой таблице, в которой нужно осуществить поиск. Запросы формируются только к тем данным (таблицам), из числа описанных в критерии отбора, у которых в реквизите может быть значение того типа, значение которого в данный момент ищется. Например, критерий отбора включает ссылки на справочник физических лиц и справочник организаций, а в конкретном реквизите конкретного документа может быть ссылка только на справочник физических лиц. Тогда запрос по этому документу будет выполняться, только если в данный момент поиск выполняется по физическому лицу. Важно учитывать, что критерий отбора всегда выбирает все искомые данные. Ни в списке, ни в других режимах не поддерживается динамическая выборка, так как информация выбирается путем объединения данных из разных таблиц. Формируемый для критерия отбора индекс позволяет сделать это достаточно быстро, но если данных в выборке окажется очень много, то выборка не будет формироваться эффективно. Поэтому целесообразно создавать критерии отбора по данным, имеющим большой разброс значений, чтобы выборки получались не очень большие. В противном случае теряется смысл такого отбора и снижается его эффективность.

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

Поговорим о программной работе с критерием отбора. В синтакс-помощнике в ветке "Прикладные объекты" находится ветка "Критерии отбора". Мы видим, что количество типов данных здесь не очень большое. Во-первых, это менеджер критериев отбора - КритерииОтбораМенеджер (FilterCriteriaManager) . Это свойство глобального контекста, которое позволяет через точку обратиться к конкретному критерию отбора. Далее мы получаем КритерийОтбораМенеджер.<Имя критерия> (FilterCriterionManager.<Имя критерия>) , у которого есть два метода - Найти(<ЗначениеПоиска>) и ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>) . И еще один тип данных - КритерийОтбораСписок.<Имя критерия> (FilterCriterionList.<Имя критерия>) . Он предназначен для управления списком отобранных документов и/или элементов справочников, отображаемых в табличном поле (списком критерия отбора). Как видим, методов для програмной работы не очень много, поэтому гораздо удобнее работать с критерием отбора при помощи запроса.
Рассмотрим на примере, как отобразить результат работы критерия отбора в форме. Для этого можно создать обработку.

Итак, создаем обработку и управляемую форму для неё. У формы будет два реквизита. Это "Номенклатура" - СправочникСсылка.Номенклатуры и "Список", тип которого - "ДинамическийСписок ". В свойствах реквизита "Список" заполним "ОсновнаяТаблица" значением - "КритерийОтбора.ДокументыСНоменклатурой". Перетаскиваем оба реквизита на форму. Кроме того, нам необходимо установить параметр "Значение" для нашего динамического списка. У динамического списка есть свойство "Параметры", тип значения которого: ЗначенияПараметровДанныхКомпоновкиДанных. У которого в свою очередь есть метод: УстановитьЗначениеПараметра(<Параметр>, <Значение>) . Итак, в модуле формы у нас будет следующий код:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура НоменклатураПриИзменении(Элемент) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры

Сохраняем обработку и запускаем в пользовательском режиме.

Рассмотрим еще один пример работы с критерием отбора. На этот раз поработаем с ФормойСписка критерия отбора. Дело в том, что интерактивно открыть её пользователь не может. Попробуем открыть её программным образом. В нашей обработке создадим команду "ОткрытьФ", перетащим её в форму нашей обработки, и создадим процедуру для нашей команды:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура НоменклатураПриИзменении(Элемент) Список.Параметры.УстановитьЗначениеПараметра("Значение",Номенклатура); КонецПроцедуры &НаКлиенте Процедура ОткрытьФ(Команда) ОткрытьФорму("КритерийОтбора.ДокументыПоДоговоруКонтрагента.ФормаСписка"); КонецПроцедуры

Сохраняем нашу обработку, в пользовательском режиме нажимаем на кнопку "ОткрытьФ" , наша ФормаСписка открывается, но система при этом выдает ошибку. Дело в том, что система не может понять, по какому объекту ей нужно сделать отбор. Нам необходимо заполнить параметр Значение нашего динамического списка. В принципе, мы можем сделать это интерактивно. Для этого перейдем в ФормуСписка нашего критерия отбора, раскроем ветку "Список", найдем там "Параметры" и перетащим их на нашу ФормуСписка критерия отбора. Теперь в пользовательском режиме мы можем поставить флажок перед параметром "Значение" в истину, ну и, собственно, заполнить и сам параметр "Значение". Но лучше это сделать программно при открытии ФормыСписка критерия отбора. Программную установку мы будем делать в процедуре "ПриСозданииНаСервере() ". Если мы поставим точку останова в этой процедуре, то при отладке мы увидим: в параметрах нашего динамического списка есть коллекция "Элементы", и у элемента "Использование" стоит значение "Ложь". Чтобы установить его в истину, можно использовать следующий код, поскольку "Элементы" - это коллекция значений:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Использование = Истина; КонецПроцедуры

Мы можем также использовать обращение по имени параметра. Для этого мы можем использовать метод "Найти()" :

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Найти("Значение").Использование = Истина; КонецПроцедуры

Также мы можем передать в ФормуСписка критерия отбора значение "Номенклатуры" из формы вызывающей, т.е. нашей обработки. Для этого передадим из формы нашей обработки значение "Номенклатура":

&НаКлиенте Процедура ОткрытьФ(Команда) ОткрытьФорму("КритерийОтбора.ДокументыСНоменклатурой.ФормаСписка", новый Структура("Номенклатура", Номенклатура); КонецПроцедуры

А в ФормеСписка критерия отбора воспользуемся переданным значением:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Список.Параметры.Элементы.Найти("Значение").Использование = Истина; Список.Параметры.Элементы.Найти("Значение").Значение = Параметры.Номенклатура; КонецПроцедуры

Далее запускаем нашу обработку в пользовательском режиме, заполняем реквизит "Номенклатура" и нажимаем кнопку "ОткрытьФ". В результате откроется ФормаСписка критерия отбора с переданным значением "Номенклатуры" из формы вызывающей, а также сформируется результат отбора.

На этом заканчиваем, надеюсь, материал будет полезен для понимания сути объекта "Критерий отбора". Всем пока и удачи)

Критерии отбора 1C — объект метаданных, служащий для отбора различной информации в информационной базе по установленным отборам. С помощью критерия отбора можно быстро получить список документов и справочников, связанных с заданным объектом. Обычно используется для отображения структуры подчиненности и других целей.

Рассмотрим использование, настройку и свойства критериев отбора в 1С 8.3.

Свойства критерия отбора в 1С

Основные свойства критериев отбора — тип (вкладка Данные) и состав (вкладка Состав).

Получите 267 видеоуроков по 1С бесплатно:

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

Пример настройки критерия отбора

Например, мы хотим получить список банковских счетов по выбранному банку.

Для этого на вкладке Данные необходимо указать тип — СправочникСсылка.Банки. А на вкладке Состав выбрать справочник БанковскиеСчета:



Последние материалы раздела:

Промокоды летуаль и купоны на скидку
Промокоды летуаль и купоны на скидку

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

Отслеживание DHL Global Mail и DHL eCommerce
Отслеживание DHL Global Mail и DHL eCommerce

DHL Global Mail – дочерняя почтовая организация, входящая в группу компаний Deutsche Post DHL (DP DHL), оказывающая почтовые услуги по всему миру и...

DHL Global Mail курьерская компания
DHL Global Mail курьерская компания

Для отслеживания посылки необходимо сделать несколько простых шагов. 1. Перейдите на главную страницу 2. Введите трек-код в поле, с заголовком "...