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

Методы справочников

ВыбратьЭлементыПоРеквизиту

Открыть выборку элементов справочника по значению реквизита.

Синтаксис:

ВыбратьЭлементыПоРеквизиту(<ИмяРеквизита>, <3начение>, <РежимИерархии>,
<РежимГрупп>)

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

Select ItemsByAttribute

Параметры:

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

Возвращаемое значение:

Число; 1 – если действие выполнено и в выборке есть хотя бы один элемент; 0 – если действие не выполнено или в выборке нет ни одного элемента.

Описание:

Метод ВыбратьЭлементыПоРеквизиту предоставляет возможность выбирать элементы (открывает выборку) при помощи метода ПолучитьЭлемент.

Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника, имеющих значение реквизита <ИмяРеквизита> равным <3начение>, в порядке, установленном параметрами <РежимИерархии> и <РежимГрупп>, а также согласно установкам, сделанным заранее при помощи методов:

  • ПорядокНаименований,
  • ПорядокКодов,
  • ВключатьПодчиненные,
  • ИспользоватьРодителя,
  • ИспользоватьВладельца,
  • ИспользоватьДату.

Данный метод может использоваться только в том случае, если в конфигураторе при описании данного реквизита установлен признак "Сортировка" (Свойства реквизита – Дополнительные – Сортировка).

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Акц = СоздатьОбъект("Справочник.Акционеры");

Таб = СоздатьОбъект("Таблица");

Акц.ИспользоватьДату(ДатаОтчета);

Таб.ВывестиСекцию("Отчет");

// Открываем выборку

Акц.ВыбратьЭлементыПоРеквизиту("Отдел", НомерОтдела, 1, 0);

// Цикл получения элементов справочника

Пока Акц.ПолучитьЭлемент() > 0 Цикл

Если Акц.ЭтоГруппа() = 1 Тогда

Таб.ВывестиСекцию("Группа");

Таб.ВывестиСекцию("Акционер");

КонецЕсли;

КонецЦикла;

См. также: ПолучитьЭлемент, ПорядокНаименований, ПорядокКодов, ОбратныйПорядок, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату.

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