1С Предприятие 7.7. Документация

       

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


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

Синтаксис:

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

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

SelectByValue

Параметры:

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

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



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

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

<ВидОтбора>

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

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

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

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

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

Описание:

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

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

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

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

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

("OperSum")

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

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

("Description")

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

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

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


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

"Счет" ("Account")

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

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

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

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

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

КонецЦикла;


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