Описание встроенного языка системы 1С Предприятие


         

ВыбратьПоЗначению


Осуществляет выборку записей по значению в графе отбора.

Синтаксис:

ВыбратьПоЗначению(<ИмяГрафы>, <ЗначениеОтбора>, <ПериодНачала>,

                  <ПериодОкончания>)

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

SelеctByValue

Параметры:

<ИмяГрафы>

Строковое значение. Наименование графы от­бора, как она определена при конфигурирова­нии.



<ЗначениеОтбора>

Отбираемое значение.

<ПериодНачала>

Значение типа «период журнала расчетов» -первый расчетный период отбора.

<ПериодОкончания>

Значение типа «период журнала расчетов» -последний расчетный период отбора.

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

Число: 1 — если отбор успешно установлен; 0 — в противном случае.

Описание:

Метод предназначен для выборки записей журнала расчетов, которые со­держат в графе отбора <ИмяГрафы> заданное <ЗначеяиеОтбора>, период регистрации которых лежит в пределах, заданных параметрами <ПериодНачала> и <ПериодОкончания>.

Если первый параметр задан неверно — т. е. нет такой графы отбора, выбор­ка не будет выполнена и метод возвратит 0. Если заданное <ЗначениеОтбора> не содержится ни в одной строке журнала расчетов, вы­борка окажется пустой (т. е. в нее не попадет ни одна запись журнала расчетов), но метод возвратит значение 1.

Метод используется так же, как и другие методы создающие выборки запи­сей в журнале расчетов, такие как ВыбратьЗаписи, ВыбратьПериод и т. д. Как и все остальные методы выборки журнала расчетов, как правило, применяется перед циклом, в котором перебираются записи. Работает только для перемен­ных, созданных функцией СоздатьОбъект.

Замечание. Наименованиями граф отбора журнала расчетов могут служить реквизиты справочника объектов расчета, заданного для журнала расче­тов, а также значения «Владелец» и «Родитель» этого справочника. Это значит, что в общем случае, в качестве первого параметра, методу могут передаваться предопределенные имена «Родитель» и «Владелец», а также названия реквизитов справочника.

Какие именно графы отбора задействованы в журнале расчетов, задается при конфигурировании.

Данный метод работает так же как и метод формы журнала расчетов УстановитьОтбор, но, разумеется не осуществляет визуального управления формой журнала.

Пример:

// Рассчитаем все записи текщего расчетного периода по

// подразделению (переменная Подр)

Процедура РасчетПодразделения(Подр)

   ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

   ТекПер = ЖР.ТекущийПериод();

   ЖР.ВыбратьПоЗначению("Подразделение", Подр, ТекПер.ТекПер);

   Пока ЖР.ПолучитьЗапись() > 0 Цикл

      ЖР.Рассчитать();

   КонецЦикла;

КонецПроцедуры

См. также: УстановитьОтбор



Содержание раздела