ВыбратьОперацииСПроводками
Открывает выборку оперций с проводками за указанный период.
Синтаксис 1:
ВыбратьОперацииСПроводками(<НачалоПериода>, <КонецПериода>, <Фильтр>, <Валюта>,
<ПланСчетов>, <РазделительУчета>)
Синтаксис 2:
ВыбратьОперацииСПроводками(<НачалоПериода>, <КонецПериода>, <Счет>, <КорСчет>,
<Флаг>, <Валюта>, <ПланСчетов>, <РазделительУчета>)
Англоязычный синоним:
SelectOpersAndEntries
Параметры:
| <НачалоПериода>
| Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки операций. | ||
| <КонецПериода> | Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки операций. | ||
| <Фильтр> | Необязательный параметр. Строка — условие отбора проводок. | ||
| <ПланСчетов> | Необязательный параметр. Значение типа «План Счетов». Если параметр не указан — по всем планам счетов. | ||
| <РазделительУчета> | Необязательный параметр. Значение разделителя учета. Если параметр не указан — по всем значениям разделителя учета. | ||
| <Счет> | Необязательный параметр. Счет — счет, по которому будут отбираться проводки. | ||
| <КорСчет> | Необязательный параметр. Счет — корреспондирующий счет, по которому будут отбираться проводки. Параметр имеет смысл, если указан параметр <Счет>. | ||
| <Флаг> | Необязательный параметр. Число — признак вида оборота. Параметр может принимать значения:
1 — отбирать проводки только по дебету счета; 2 — отбирать проводки только по кредиту счета; 3 — отбирать проводки и по дебету, и по кредиту. По умолчанию 3. | ||
| <Валюта> | Необязательный параметр. Значание типа «справочник» (вида справочника используемого для валютного учета) — признак отбора проводок по валюте. |
Возвращаемое значение:
Число: 1 — действие выполнено и в выборке есть хотя бы одна проводка;
0 — действие не выполнено или в выборке нет ни одной проводки.
Описание:
Метод ВыбратьОперацииСПроводками служит для выбора проводок операций за период. Параметрами могут являеться различные условия отбора проводок.
После вызова данного метода метод ПолучитьПроводку выбирает очередную проводку из выборки удовлетворяющую заданным условиям, а метод ПолучитьОперацию выбирает первую проводку слудующей операции удовлетворяющую заданным условиям.
Метод может вызываться с двумя вариантами набора параметров. В первом варианте основные условия отбора задаются специальной строкой-фильтром, во втором указанием счета и корреспондирующего счета.
В параметре <Фильтр> задаются критерии отбора проводок для включения в выборку. Если параметр не заполнен, в выборку включаются все проводки. В общем случае в параметре <Фильтр> могут находиться одна или несколько корреспонденции счетов или символьных строк, разделяемых точкой с запятой «;». Символьные строки представляют собой наборы символов, заключенные в кавычки (при передаче строки в явном виде в параметре внутри строки двойные кавычки задаются двумя символами двойных кавычек). Корреспонденции имеют вид:
n — проводки со счетом n;
n, m — проводки в дебет счета n с кредита счета m.
Здесь в качестве n и m может указываться звездочка («*»), она обозначает любой счет. Например, *,51 — все проводки с кредита 51 счета.
В выборку включаются все проводки, удовлетворяющие следующим условиям:
Если в параметре <Фильтр> указаны корреспонденции счетов, то проводка должна соответствовать одной из этих корреспонденции.
Если параметре <Фильтр> указаны строки символов, то в проводке должна содержаться хотя бы одна из этих строк — либо в содержании операции, либо представлениях значений субконто и реквизитов проводки и операции.
Примеры:
|
50 |
— все проводки со счетом 50; |
|
50, * |
— все проводки в дебет 50 счета; |
|
* , 51 |
— все проводки с кредита 51 счета; |
|
50, 51 |
— все проводки в дебет 50 счета с кредита 51; |
|
51; 52 |
— все проводки со счетом 51 или счетом 52; |
|
46, 68.2 |
— все проводки в дебет 46 счета с кредита 68.2; |
|
"бумага" |
— все проводки, содержащие в содержании операции или в субконто или в реквизитах слово «бумага»; |
|
"бумага"; "картон" |
— все проводки, содержащие в содержании операции или в субконто или в реквизитах слово «бумага» или слово «картон»; |
|
*, 46; "бумага" |
— все проводки по кредиту 46 счета, содержащие в содержании операции или в субконто или в реквизитах слово «бумага»; |
Кроме того, в обоих вариантах задаются дополнительные условия: валюта, план счетов, разделитель учета.
Параметр <Валюта> является значением типа «Справочник» вида, определенного при настройке валютного учета в метаданных. Если параметр указан, в отбор будут включены проводки только по указанной валюте. При этом пустое значение типа «Справочник» соответствующего вида считается указанием отбора по пустой валюте. Для того, чтобы отбор по валюте не производился нужно либо опустить данный параметр, либо передать туда значение иного типа, например, пустую сроку.
Параметр <ПланСчетов> является значением типа «План Счетов». Если параметр указан, в отбор будут включены проводки только по указанному плану счетов.
Параметр <РазделительУчета> является значением объекта метаданных, выбранного в качестве разделителя учета.
Если указан параметр <РазделительУчета>, в отбор будут включены проводки с указанным значением разделителя учета.
Параметры <Счет> и <КорСчет> задают условние отбора проводок по счетам.
Если указан параметр <Счет>, будут отбраны проводки только по указанному счету. Дополнительным условие отбора является значением параметра <Флаг>.
Если указаны параметр <Счет> и <КорСчет>, будут отобораны проводки только по указанной креспонденции счетов.
Пример:
Опер = СоздатьОбъект("Операция");
Опер.ВыбратьОперацииСПроводками(ДатаНач, ДатаКон, "50, 51; ""По Чеку"" ");
Пока Опер.ПолучитьПроводку() = 1 Цикл
Сообщить("Сумма " + Опер.Сумма);
КонецЦикла;
