Иллюстрированный самоучитель по языку системы 1С:Предприятие

Общие методы регистров

УстановитьЗначениеФильтра

Установить значение фильтра для оптимизации расчетов.

Синтаксис:

УстановитьЗначениеФильтра(<ИзмерИлиРеквизит>, <3начен>, <Вариант>)

Англоязычный синоним:

SetFilterValue

Параметры:

<ИзмерИлиРеквизит> Идентификатор измерения или реквизита.
<3начен> Значение или список значений.
<Вариант> Необязательный параметр. Число: 0 – не фильтровать; 1 – фильтровать по значению; 2 – искать вхождение. Значение по умолчанию 1.
Для варианта "2":
  • если параметр <3начен> – это группа справочника, то осуществляется проверка вхождения в группу;
  • если параметр <3начен> – это простой элемент справочника или другой тип значения, то осуществляется просто фильтрация по значению;
  • для списка значений осуществляется проверка вхождения в список;
  • если пустое значение или пустой список значений, то условие не проверяется.

Описание:

Метод УстановитьЗначениеФильтра назначает фильтр для оптимизации расчетов. В качестве фильтра для измерения или реквизита регистра может задаваться либо конкретное значение, либо список значений либо группа для справочника.

Пример:

Для регистра с измерениями "Товар", "Склад", "МОЛ" запись:

Рег.УстановитьЗначениеФильтра("Товар", ВыбГруппаТоваров, 2);

…означает, что расчеты будут проводиться по товарам из группы ВыбГруппаТоваров.

Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.