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

       

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


Открывает выборку операций или проводок, отобранных по значе­нию отбора.

Синтаксис:

ВыбратьПоЗначению(<НачалоПериода>, <КонецПериода> , <ВидОтбора>, <3начение0тбора>)

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

SelectByValue

Параметры:

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

Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого уста­навливается начало выборки операций.



<КонецПериода>

Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором уста­навливается конец выборки операций.

<ВидОтбора>

Необязательный параметр. Символьная строка — название вида отбора (см. ниже).

<3начение0тбора>

Необязательный параметр. Значение отбора вида, указанного в параметре <ВидОтбора>.

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

Число: 1 — действие выполнено и в выборке есть хотя бы одна операция или проводка; 0 — действие не выполнено или в выборке нет ни одной опера­ции или проводки.

Описание:

Метод ВыбратьПоЗначению открывает выборку, содержащую операции или проводки за указанный период.

Данный метод позволяет достаточно быстро отобрать операции или провод­ки по критерию отбора. Возможные критерии отборов настраиваются в конфи­гураторе и имеют свои идентификаторы (системные или идентификаторы объ­ектов метаданных). Вид отбора определяет будет открыта выборка операций или проводок.

Параметр <ВидОтбора> должен содержать название вида отборав виде символьной строки.

Параметр <ВидОтбора> для отбора операций может принимать следующие значения (в скобках указан английский синоним):

"СуммаОперации"

("OperSum")

Отбор по сумме операции. Доступно если в метаданных включен отбор по сумме опера­ции.

"Содержание"

("Description")

Отбор по содержанию операции. Доступно если в метаданных включен отбор по содер­жанию операции.

<РеквизитОперации>

Отбор по дополнительному реквизиту операции. Идентификатор реквизита должен быть указан так, как это задано в метаданных. Доступно если в метаданных включен отбор по реквизиту операции.




Параметр <ВидОтбора> для отбора проводок может принимать следующие значения (в скобках указан английский синоним):

"Счет" ("Account")

Отбор по счету дебета или счету кредита проводки. Доступно если в метаданных вклю­чен отбор по счетам проводок.

"СчетДт" ("AccountDt")

Отбор по счету дебета проводки. Доступно если в метаданных включен отбор по дебе­ту/кредиту счетов проводок.

"СчетКт" ("AccountKt")

Отбор по счету кредита проводки. Доступно если в метаданных включен отбор по дебе­ту/кредиту счетов проводок.

"Валюта" ("Currency")

Отбор по валюте проводки. Доступно если в метаданных включен отбор по валюте прово­док.

<ВидСубконто>

Отбор по виду субконто. Идентификатор вида субконто должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому виду субконто.

<РеквизитПроводки>

Отбор по дополнительному реквизиту проводки. Идентификатор реквизита должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому реквизиту проводки.

Параметр <3начениеОтбора> задает значение отбора.

После выполнения данного метода обход операций (проводок) осуществля­ется методами ПолучитьОперацию и ПолучитьПроводку.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.ВыбратьПоЗначению(ДатаНач, ДатаКон, "Счет", СчетПоКоду("60"));

Пока Опер.ПолучитьПроводку() = 1 Цикл

   Сообщить("Сумма " + Опер.Сумма);

КонецЦикла;


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