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