ВыбратьЭлементыПоРеквизиту
Открыть выборку элементов справочника по значению реквизита.
Синтаксис:
ВыбратьЭлементыПоРеквизиту(<ИмяРеквизита>, <3начение>, <РежимИерархии>,
<РежимГрупп>)
Англоязычный синоним:
Select ItemsByAttribute
Параметры:
|
<ИмяРеквизита> |
Строковое выражение с именем реквизита справочника, который задает порядок обхода элементов справочника. |
|
<3начение> |
Значение реквизита для выборки. |
|
<РежимИерархии> |
Необязательный параметр. Числовое выражение: 1 — выбирать элементы с учетом иерархии; 0 — выбирать элементы без учета иерархии. Значение по умолчанию — 1. |
|
<РежимГрупп> |
Числовое выражение: 1 — выбирать среди групп справочника; 0 — выбирать среди элементов справочника. |
Возвращаемое значение:
Число; 1 — если действие выполнено и в выборке есть хотя бы один элемент; 0 — если действие не выполнено или в выборке нет ни одного элемента.
Описание:
Метод ВыбратьЭлементыПоРеквизиту предоставляет возможность выбирать элементы (открывает выборку) при помощи метода ПолучитьЭлемент.
Дальнейшая выборка при помощи метода ПолучитьЭлемент будет происходить среди элементов текущего справочника, имеющих значение реквизита <ИмяРеквизита> равным <3начение>, в порядке, установленном параметрами <РежимИерархии> и <РежимГрупп>, а также согласно установкам, сделанным заранее при помощи методов:
ПорядокНаименований,
ПорядокКодов,
ВключатьПодчиненные,
ИспользоватьРодителя,
ИспользоватьВладельца,
ИспользоватьДату.
Данный метод может использоваться только в том случае, если в конфигураторе при описании данного реквизита установлен признак «Сортировка» (Свойства реквизита - Дополнительные - Сортировка).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Акц = СоздатьОбъект("Справочник.Акционеры");
Таб = СоздатьОбъект("Таблица");
Акц.ИспользоватьДату(ДатаОтчета);
Таб.ВывестиСекцию("Отчет");
// Открываем выборку
Акц.ВыбратьЭлементыПоРеквизиту("Отдел", НомерОтдела, 1, 0);
// Цикл получения элементов справочника
Пока Акц.ПолучитьЭлемент() > 0 Цикл
Если Акц.ЭтоГруппа() = 1 Тогда
Таб.ВывестиСекцию("Группа");
Таб.ВывестиСекцию("Акционер");
КонецЕсли;
КонецЦикла;
См. также: ПолучитьЭлемент, ПорядокНаименований, ПорядокКодов, ОбратныйПорядок, ВключатьПодчиненные, ИспользоватьРодителя, ИспользоватьВладельца, ИспользоватьДату
