ВыполнитьЗапрос

Выборка итогов в различных разрезах.

Синтаксис:

ВыполнитьЗапрос(<НачалоПериода>, <КонецПериода>, <ФильтрПоСчетам>,

       <ФильтрПоКоррСчет>, <Валюта>, <ТипИтогов>, <Периодичность>, <ТипСуммы>)

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

DoQuery

Параметры:

<НачалоПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа начала периода запроса. Если этот параметр не указан, будут вы­числяться начальные сальдо на момент, указан­ный в параметре <КонецПериода>
<КонецПериода>		Необязательный параметр. Выражение типа дата, документ или позиция документа конца периода запроса. Если этот параметр не указан, будут вычисляться начальные сальдо на момент, указанный в параметре  <НачалоПериода>.
<ФильтрПоСчетам>		Необязательный параметр. Счета, для которых будут отбираться итоги в запросе. Задается зна­чением типа «Счет» или объектом типа «Список-Значений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом ", " или ";". Если параметр не указан, отбор будет выполняться по всем сче­там.
<ФильтрПоКоррСчет>		Необязательный параметр. Значение типа «Счет» — корреспондирующий счет, в корреспон­денции с которым будут отбираться итоги счета, указанного в параметре <ФильтрПоСчетам>. Задается значением типа «Счет» или объектом типа «СписокЗначений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом "," или ";". Если параметр не указан, будут отбираться итоги в корреспонденции со всеми счетами.
<Валюта>		Необязательный параметр. Значение типа «Справочник.Валюты». Если параметр не указан итоги выдаются без учета валюты.
<ТипИтогов>		Необязательный параметр. Число — тип отбирае­мых итогов. Может принимать следующие значе­ния: 1 — остатки и обороты по счету в целом; 2 — обороты между счетами; Первое и второе вместе. По умолчанию — 1.
<Периодичность>		Необязательный параметр. Позволяет получить дополнительный разрез итогов по периодам. Чис­ло или символьная строка (См. ниже). По умол­чанию периодичность не задана.
<ТипСуммы>		Необязательный параметр. Число или строка — тип рассчитываемых итогов. Может принимать следующие значения (в скобках указаны строко­вые синонимы): 1 («С», «S») рассчитывать суммы; 2 («В», «С») рассчитывать валютные суммы; 4 («К», «А») рассчитывать количество. Если требуется одновременно рассчитывать раз­ные суммы, значение параметра получается путем сложения допустимых значений, например: 5 (1+4) — рассчитывать суммы и количество. При указании параметра строкой в ней указываются все символы, которые обозначают типы сумм, которые нужно рассчитывать. По умолчанию рассчитываются все типы сумм.

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

1 («Период», «Period»)	Промежуточные итоги не рассчиты­ваются;
2 («Операция», «Entry»)	Промежуточные итоги рассчитыва­ются по операциям;
3 («Проводка», «Operation»)	По проводкам;
4 («День», «Day»)	По дням;
5 («Неделя», «Week»)	По неделям;
6 («Декада», «Decade»)	По декадам;
7 («Месяц», «Month»)	По месяцам;
8 («Квартал», «Quorter»)	По кварталам
9 («Год», «Year»)	По годам.

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

Число: 1 — запрос выполнен; 0 — запрос не выполнен.

Описание:

Метод ВыполнитьЗапрос выполняет отбор и расчет итогов за период, за­даваемый параметрами <НачалоПериода> и <КонецПериода>.

В зависимости от переданных параметров итоги могут быть подготовлены методом ВыполнитьЗапрос в различных разрезах. Кроме того, на результат запроса влияют дополнительные установки, которые выполняются вызовами специальных методов объекта «Бухгалтерские Итоги».

Параметр <Периодичность> позволяет получить итоги запроса в разрезе периодов.

Метод ВключатьСубсчета позволяет получить итоги в разрезе субсчетов.

Применение метода ИспользоватьСубконто (перед вызовом ВыполнитьЗапрос) позволяет сформировать запрос в разрезе субконто.

После выполнения запроса обход запросов в различных разрезах выполня­ется соответствующими методами объекта.

Для доступа к итогам в разрезе периодов используются методы ВыбратьПериоды и ПолучитьПериод.

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

Данный метод может использовать предварительно выполненный времен­ный расчет. Для этого у временного расчета должен быть взведен флаг акту­альности, система должна находиться в монопольном режиме, или расчет про­изводится в модуле документа и в данном модуле выполняется запрос.

Пример:

В монопольном режиме:

// модуль обработки

ИтРасчет.Актуальность(1);

   ...

   Док.ВыбратьДокументы();

   Пока Док.ПолучитьДокумент() = 1 Цикл

      ИтРасчет.Рассчитать(, Док.ТекущийДокумент());

      ...

      Док.Провести();

   КонецЦикла;

   ...

// модуль документа

...

ИтЗапрос.ВыполнитьЗапрос(, Док.ТекущийДокумент(), СчетПоКоду("41"));

...

в данном случае ИтЗапрос.ВыполнитьЗапрос(...) воспользуется ре­зультатами временного расчета ИтРасчет. Данная возможность может исполь­зоваться при групповом перепроведении документов.

Пример:

БухИтоги.ВыполнитьЗапрос(ДатаНач, ДатаКон, "60", , 3);


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

---

---