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