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