Иллюстрированный самоучитель по языку системы 1С:Предприятие › Работа с бухгалтерскими итогами › Методы выборки результатов запроса [страница - 639] | Самоучители по бухгалтерским программам

Методы выборки результатов запроса

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

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

Синтаксис:

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

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

SelectPeriods

Параметры:

<ФлагВсе>	Необязательный параметр. 0 – отбирать те периоды, которые имели итоги на этом уровне обхода итогов запроса; 1 – включить в выборку все периоды, которые имели итоги в данном запросе; -1, -2 … – включить в выборку периоды, которые имели итоги в группировке n-го вышестоящего уровня. По умолчанию – 0.
<ФлагДК>	Необязательный параметр. 1 – включать в выборку периоды только с дебетовыми оборотами; 2 – включать в выборку периоды только с кредитовыми оборотами. 0 – включать в выборку периоды вне зависимости от дебетовых/кредитовых оборотов. По умолчанию 0.
<Номер>	Необязательный параметр. Положительное целое число – номер выборки. Если параметр не указан, выборке приваивается номер 0.
<РазвСальдо>	Необязательный параметр. Признак необходимости рассчитывать развернутое сальдо по субконто. Используется только если в запросе участвуют субконто. 1 – рассчитывать развернутое сальдо; 0 – не рассчитывать развернутое сальдо. По умолчанию 0.

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

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

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

Описание:

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

КонецЦикла;

КонецЦикла;