Бухгалтерский запрос
Для получения большого количества итогов в различных разрезах объект «Бухгалтерские Итоги» переключается в режим работы с запросом. Для переключения в этот режим вызывается метод ВыполнитьЗапрос в параметрах которого, а также дополнительными методами устанавливается состав итогов, которые будут получены запросом. Выполнение данного метода осуществляет выборку данных и их предварительную обработку.
После выполнения запроса с помощью специального набора методов объекта «Бухгалтерские Итоги» осуществляется получение итогов, полученных данным запросом. К этим методам относятся методы обхода итогов в различных разрезах (сформированных запросом) и методы для получения собственно итогов. Кроме того специальный набор атрибутов объекта «Бухгалтерские Итоги» позволяет обращаться процессе обхода результатов запроса к значениям полученных группировок.
Метод ВыполнитьЗапрос
Синтаксис: ВыполнитьЗапрос(<НачалоПериода>, <КонецПериода>, <ФильтрПоСчетам>, <ФильтрПоКоррСчет>, <Валюта>, <ТипИтогов>, <Периодичность>, <ТипСуммы>)
Параметр
|
Описание
|
||||||||||||||||||||||||||||||
<НачалоПериода> |
Необязательный параметр. Выражение типа дата, документ или позиция документа начала периода запроса. Если этот параметр не указан, будут вычисляться начальные сальдо на момент, указанный в параметре <КонецПериода> |
||||||||||||||||||||||||||||||
<КонецПериода> |
Необязательный параметр. Выражение типа дата, документ или позиция документа конца периода запроса. Если этот параметр не указан, будут вычисляться начальные сальдо на момент, указанный в параметре <НачалоПериода>. |
||||||||||||||||||||||||||||||
<ФильтрПоСчетам> |
Необязательный параметр. Счета, для которых будут отбираться итоги в запросе. Задается значением типа «Счет» или объектом типа «Список-Значений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом ", " или ";". Если параметр не указан, отбор будет выполняться по всем счетам. |
||||||||||||||||||||||||||||||
<ФильтрПоКоррСчет> |
Необязательный параметр. Значение типа «Счет» — корреспондирующий счет, в корреспонденции с которым будут отбираться итоги счета, указанного в параметре <ФильтрПоСчетам>. Задается значением типа «Счет» или объектом типа «СписокЗначений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом "," или ";". Если параметр не указан, будут отбираться итоги в корреспонденции со всеми счетами. |
||||||||||||||||||||||||||||||
<Валюта> |
Необязательный параметр. Значение типа «Справочник.Валюты». Если параметр не указан итоги выдаются без учета валюты. |
||||||||||||||||||||||||||||||
<ТипИтогов> |
Необязательный параметр. Число — тип отбираемых итогов. Может принимать следующие значения:
|
||||||||||||||||||||||||||||||
<Периодичность> |
Необязательный параметр. Позволяет получить дополнительный разрез итогов по периодам. Число или символьная строка. По умолчанию периодичность не задана. Параметр <Периодичность> может принимать следующие значения:
|
||||||||||||||||||||||||||||||
<ТипСуммы> |
Необязательный параметр. Число или строка — тип рассчитываемых итогов. Может принимать следующие значения (в скобках указаны строковые синонимы):
Если требуется одновременно рассчитывать разные суммы, значение параметра получается путем сложения допустимых значений, например: 5 (1+4) — рассчитывать суммы и количество. При указании параметра строкой в ней указываются все символы, которые обозначают типы сумм, которые нужно рассчитывать. По умолчанию рассчитываются все типы сумм. |
В зависимости от переданных параметров итоги могут быть подготовлены методом ВыполнитьЗапрос в различных разрезах. Кроме того, на результат запроса влияют дополнительные установки, которые выполняются вызовами специальных методов объекта «Бухгалтерские Итоги».
Метод ВключатьСубсчета позволяет получить итоги в разрезе субсчетов.
Применение метода ИспользоватьСубконто (перед вызовом ВыполнитьЗапрос) позволяет сформировать запрос в разрезе субконто.
После выполнения запроса обход запросов в различных разрезах выполняется соответствующими методами объекта. Для доступа к итогам в разрезе периодов используются методы ВыбратьПериоды и ПолучитьПериод.
Пример:
//рассчитать остатки и обороты по счету 60 за заданный период БухИтоги.ВыполнитьЗапрос(ДатаНач, ДатаКон, "60", , 3);
Метод ВключатьСубсчета
Метод ВключатьСубсчета должен вызываться до выполнения метода ВыполнитьЗапрос. Он устанавливает режим, при котором итоги отбираемые запросом будут разворачиваться по субсчетам соответвенно основных и корреспондирующих счетов.
Синтаксис: ВключатьСубсчета(<ФлагСчета>, <ФлагКоррСчета>}
Параметр
|
Описание
|
<ФлагСчета> |
Необязательный параметр. Признак развертывания сальдо по субсчетам основного счета. Число:
|
<ФлагКоррСчета> |
Необязательный параметр. Признак развертывания сальдо по субсчетам корреспондирующего счета. Число:
|
Метод ИспользоватьСубконто
Метод ИспользоватьСубконто устанавливает режим отбора итогов по субконто методом ВыполнитьЗапрос. Метод ИспользоватьСубконто слудет вызывать до вызова метода ВыполнитьЗапрос. После выполнения метода ВыполнитьЗапрос установки метода ИспользоватьСубконто сбрасываются и перед слудеющим запросом их нужно устанавливать заново.
Метод ИспользоватьСубконто может вызываться последовательно несколько раз. В этом случае установки, выполняемые этим методом суммируются.
Синтаксис: ИспользоватьСубконто(<ВидСубконто>, <Субконто>, <ТипФильтра>, <ПоГруппам>)
Параметр
|
Описание
|
<ВидСубконто> |
Значение типа «Вид Субконто» — расчет временных итогов будет выполнен только для субконто указанного вида. Задается значением типа «Вид Субконто» или строкой содержащей имя идентификатора вида субконто, как он назван в конфигураторе. |
<Субконто> |
Необязательный параметр. Здесь может быть задано или одно конкретное значение субконто, по которому будут отобраны итоги по аналитике или объект типа «Список значений», где можно задать несколько значений субконто. Если параметр не задан — то считается пустым значением субконто. |
<ТипФильтра> | Необязательный параметр. Число — тип фильтра по субконто. Может принимать следующие значения:
|
<ПоГруппам> | Необязательный параметр. Число — группировка др итогов по субконто. Параметр <ПоГруппам> имеет смысл, если параметр <ТипФильтра> равен 1, а вид субконто, заданный параметром <ВидСубконто>, имеет тип значения «Справочник». Параметр может принимать значения:
|
Пример:
* Данный запрос формирует итоги по счету 10 в разрезе материалов по одному складу.
БухИтоги.ИспользоватьСубконто(ВидыСубконто.Материалы, , 1); БухИтоги.ИспользоватьСубконто(ВидыСубконто.Склады, ВыбСклад, 2); БухИтоги.ВыполнитьЗапрос(ДатаНач, ДатаКон, "10");
Метод ИспользоватьКорСубконто
Метод ИспользоватьКорСубконто устанавливает режим отбора итогов по субконто методом ВыполнитьЗапрос. Метод ИспользоватьКорСубконто слудет вызывать до вызова метода ВыполнитьЗапрос. После выполнения метода ВыполнитьЗапрос установки метода ИспользоватьКорСубконто сбрасываются и перед слудеющим запросом их нужно устанавливать заново.
Метод ИспользоватьКорСубконто может вызываться последовательно несколько раз. В этом случае установки, выполняемые этим методом суммируются.
Синтаксис: ИспользоватьКорСубконто(<ВидСубконто>, <Субконто>, <ТипФильтра>, <ПоГруппам>)
Параметры аналогичны параметрам метода ИспользоватьСубконто.
Метод Опции
Синтаксис: Опции(<ВключатьЗабалансовыеСуммы>, <ВключатьОборотныеСубконтоСуммы>)
Метод Опции должен вызываться до выполнения метода ВыполнитьЗапрос. Он устанавливает режимы включения в итоги сумм по забалансовым счетам и оборотным субконто. Если метод не вызвался, суммы по забалансовым счетам и оборотным субконто не включаются в запрос.
Если параметр равен 1, то эти суммы включаются в запрос, если 0, то не включаются.
Обработка результатов запроса (обход группировок)
Методы обхода группировок результата запроса приведены ниже:
Методы
|
Описание
|
||||||||||||||||
ВыбратьСчета |
Синтаксис: ВыбратьСчета(<ФлагВсе>, <ФлагДК>, <Номер>, <РазвСальдо>)
Синтаксис: ПолучитьСчет(<Номер>, <Счет>)
Пример. БухИтоги.Запрос(Дата1, Дата2);
КонецЦикла; |
||||||||||||||||
ВыбратьКорСчета ПолучитьКорСчет |
Синтаксис БухИтоги.Запрос(Дата1, Дата2); КонецЦикла; |
||||||||||||||||
ВыбратьВалюты ПолучитьВалюту |
Синтаксис: Пример: БухИтоги.Запрос(Дата1, Дата2);
КонецЦикла; |
||||||||||||||||
ВыбратьПериоды ПолучитьПериод |
Синтаксис: Пример: БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");
КонецЦикла; |
||||||||||||||||
ВыбратьСубконто ПолучитьСубконто |
Синтаксис: Пример: БухИтоги.ИспользоватьСубконто(ВидыСубконто.Материалы, , 1);
КонецЦикла; |
||||||||||||||||
ВыбратьКорСубконто ПолучитьКорСубконто |
Синтаксис: БухИтоги.ИспользоватьСубконто(ВидыСубконто.Товары, , 1);
КонецЦикла; |
Атрибуты и методы результата запроса
При обходе группировок результата запроса возможно обращение к следующим атрибутам и методам:
Атрибут
|
Описание
|
Счет |
Текущий счет, выбранный функцией ПолучитьСчет |
КорСчет | Текущий корр. счет, выбранный функцией ПолучитьКорСчет |
Валюта | Текущая валюта, выбранная функцией ПолучитьВалюту |
НачДата КонДата |
Начальная и конечная дата текущего периода, выбранного функцией ПолучитьПериод |
Операция | Атрибут позволяет обращаться к текущей операции, если запрос получен с детализацией итогов по периоду «Операция» и «Проводка». |
Метод
|
Описание
|
Субконто КорСубконто ПредставлениеСубконто ПредставлениеКорСубконто |
Синтаксис Пример БухИтоги.ИспользоватьСубконто(ВидыСубконто.Товары, , 1); |
ЭтоГруппа | Для тех субконто, которые выбираются из иерархических справочников метод возвращает 1, если текущее значение является группой справочника. |
СНД СНК СКД СКК ДО КО |
СНД — дебетовое сальдо на начало периода; Синтаксис (у всех одинаковый): СНД(<ТипСуммы>) Параметр <ТипСуммы> может принимать следующие значения:
|
СНДРС |
СНДРС — дебетовое развернутое сальдо на начало периода; СКДРС — дебетовое развернутое сальдо на конец периода; СНКРС — кредитовое развернутое сальдо на начало периода; СККРС — кредитовое развернутое сальдо на конец периода; |
КорДО КорКО |
Возвращает дебетовый или кредитовый оборот между корреспондирующими счетами или субконто. |
ВыбранаПоДт ВыбранаПоКт |
Эти функции возвращают 1, если выбран итог по дебету / кредиту. |
Комментарии