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