Описание встроенного языка системы 1С Предприятие


ВыбратьПериоды


Открывает выборку периодов.

Синтаксис:

ВыбратьПериоды(<ФлагВсе>, <ФлагДК>, <Номер>, <РазвСальдо>)

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

SelectPeriods

Параметры:

<ФлагВсе>

Необязательный параметр.

0 — отбирать те перио­ды, которые имели итоги на этом уровне обхода итогов запроса;



1 — включить в выборку все периоды, которые имели итоги в данном запросе;

-1, -2 ... — включить в выборку периоды, которые имели итоги в группировке n-го вышестоящего уровня.

По умолчанию — 0.

<ФлагДК>

Необязательный параметр.

1 — включать в вы­борку периоды только с дебетовыми оборотами;

2 — включать в выборку периоды только с креди­товыми оборотами.

0 — включать в выборку периоды вне зависимо­сти от дебетовых/кредитовых оборотов.

По умолчанию 0.

<Номер>

Необязательный параметр. Положительное целое число — номер выборки. Если параметр не ука­зан, выборке приваивается номер 0.

<РазвСальдо>

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

1 — рассчитывать развернутое сальдо;

0 — не рассчитывать развернутое сальдо.

По умолчанию 0.

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

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

0 — если действие не выполнено или в выборке нет ни одного периода.

Описание:

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

Дополнительные условия на содержание выборки могут накладываться па­раметрами <ФлагВсе> и <ФлагДК>.

Параметр <РазвСальдо> может указываться только, если в запросе уста­новлено участие субконто. Позволяет указать, рассчитывать ли равернутое сальдо для субконто выборки. Результаты расчета могут быть получены при помощи функций СНДРС , СНКРС , СКДРС , СККРС.

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

Выборке, открываемой методом ВыбратьПериоды, может быть присвоен номер — «метка» выборки. Номер может использоваться для обращения к ре­зультатам выборки при помощи метода ПолучитьПериод. Использование этой метки необходимо, если требуется получить две группировки по периоду. Это позволяет получить две группировки но с одной периодичностью.

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

   БухИтоги.ВыбратьПериоды();

   Пока БухИтоги.ПолучитьПериод() = 1 цикл

      Деб = БухИтоги.ДО();

      Кред = БухИтоги.КО();

   КонецЦикла;

КонецЦикла;



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