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

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

ВыбратьСубконто

Открывает выборку по субконто.

Синтаксис:

ВыбратьСубконто(<Индекс>, <ФлагВсе>, <ФлагДК>, <Номер>, <РазвСальдо>,
<Сортировка>, <РежимОбхода>)

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

SelectSubconto

Параметры:

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

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

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

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

Описание:

Метод ВыбратьСубконто должен использоваться после вызова метода ВыполнитьЗапрос. Метод открывает выборку по субконто.

Если обработка по субконто задавалась путем нескольких вызовов метода ИспользоватьСубконто, то параметр <Индекс> позволяет сослаться на субконто конкретного вида в порядке вызова метода ИспользоватьСубконто. Для этого параметром <Индекс> задается номер вызова метода ИспользоватьСубконто.

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

Параметр <РазвСальдо> позволяет указать, рассчитывать ли равернутое сальдо для субконто выборки.

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

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

Пример:

БухИтоги.ИспользоватьСубконто(ВидыСубконто.Материалы, , 1);

БухИтоги.ИспользоватьСубконто(ВидыСубконто.Склады, , 1);

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

БухИтоги.ВыбратьСубконто(1);

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

БухИтоги.ВыбратьСубконто(2);

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

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

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

КонецЦикла;

КонецЦикла;