ВыбратьПоЗначению
Открывает выборку операций или проводок, отобранных по значению отбора.
Синтаксис:
ВыбратьПоЗначению(<НачалоПериода>, <КонецПериода> , <ВидОтбора>, <3начение0тбора>)
Англоязычный синоним:
SelectByValue
Параметры:
<НачалоПериода> | Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки операций. |
| |
<КонецПериода> | Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки операций. | ||
<ВидОтбора> | Необязательный параметр. Символьная строка — название вида отбора (см. ниже). | ||
<3начение0тбора> | Необязательный параметр. Значение отбора вида, указанного в параметре <ВидОтбора>. |
Возвращаемое значение:
Число: 1 — действие выполнено и в выборке есть хотя бы одна операция или проводка; 0 — действие не выполнено или в выборке нет ни одной операции или проводки.
Описание:
Метод ВыбратьПоЗначению открывает выборку, содержащую операции или проводки за указанный период.
Данный метод позволяет достаточно быстро отобрать операции или проводки по критерию отбора. Возможные критерии отборов настраиваются в конфигураторе и имеют свои идентификаторы (системные или идентификаторы объектов метаданных). Вид отбора определяет будет открыта выборка операций или проводок.
Параметр <ВидОтбора> должен содержать название вида отборав виде символьной строки.
Параметр <ВидОтбора> для отбора операций может принимать следующие значения (в скобках указан английский синоним):
"СуммаОперации"
("OperSum") | Отбор по сумме операции. Доступно если в метаданных включен отбор по сумме операции. | ||
"Содержание"
("Description") | Отбор по содержанию операции. Доступно если в метаданных включен отбор по содержанию операции. | ||
<РеквизитОперации> | Отбор по дополнительному реквизиту операции. Идентификатор реквизита должен быть указан так, как это задано в метаданных. Доступно если в метаданных включен отбор по реквизиту операции. |
Параметр <ВидОтбора> для отбора проводок может принимать следующие значения (в скобках указан английский синоним):
"Счет" ("Account") |
Отбор по счету дебета или счету кредита проводки. Доступно если в метаданных включен отбор по счетам проводок. |
"СчетДт" ("AccountDt") |
Отбор по счету дебета проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок. |
"СчетКт" ("AccountKt") |
Отбор по счету кредита проводки. Доступно если в метаданных включен отбор по дебету/кредиту счетов проводок. |
"Валюта" ("Currency") |
Отбор по валюте проводки. Доступно если в метаданных включен отбор по валюте проводок. |
<ВидСубконто> |
Отбор по виду субконто. Идентификатор вида субконто должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому виду субконто. |
<РеквизитПроводки> |
Отбор по дополнительному реквизиту проводки. Идентификатор реквизита должен быть указан так, как он задан в метаданных. Доступно если в метаданных включен отбор по этому реквизиту проводки. |
После выполнения данного метода обход операций (проводок) осуществляется методами ПолучитьОперацию и ПолучитьПроводку.
Пример:
Опер = СоздатьОбъект("Операция");
Опер.ВыбратьПоЗначению(ДатаНач, ДатаКон, "Счет", СчетПоКоду("60"));
Пока Опер.ПолучитьПроводку() = 1 Цикл
Сообщить("Сумма " + Опер.Сумма);
КонецЦикла;