Глава 20-1
Работа с бухгалтерскими итогами

• Контекст работы с бухгалтерскими итогами
  • Общие свойства
• ИспользоватьПланСчетов
• ИспользоватьРазделительУчета
• Работа с основными итогами
• Остатки и обороты по счетам
• СНД, СНК, СКД, СКК, ДО, КО
• Обороты между счетами
• ОБ
• Развернутое сальдо по субсчетам
• СНДР, СНКР, СКДР, СККР
• Развернутое сальдо по субконто
• СНДРС, СНКРС, СКДРС, СККРС
• Установка периода итогов
• ПериодД
• ПериодКВ
• ПериодКВН
• ПериодМ
• ПериодМНК
• ПериодМНГ
• НачПериода
• КонПериода
• ОсновныеИтоги
• Работа с временными итогами
• Рассчитать
• Актуальность
• Работа в режиме запроса
• ВыполнитьЗапрос
• ВключатьСубсчета
• Опции
• ИспользоватьСубконто
• ИспользоватьКорСубконто

При наличии в системе 1С:Предприятие компоненты «Бухгалтерский учет» система автоматически реализует специальный механизм работы с бухгалтер­скими итогами. Данный механизм обеспечивает хранение, динамический пере­счет бухгалтерских итогов и их извлечение средствами встроенного языка.

Система хранения бухгалтерских итогов поддерживается системой 1С:Предприятие автоматически на основе существующих планов счетов. При редактировании планов счетов — в конфигураторе или при работе с системой 1С:Предприятие — для счета могут быть установлены ряд свойств, которые влияют на организацию хранения бухгалтерских итогов: это признаки ведения валютного и количственного учета, а также включение аналитического учета по субконто.

Изменение бухгалтерских итогов может производиться только проводками бухгалтерских операций.

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

Контекст работы с бухгалтерскими итогами

Обращение к бухгалтерским итогам выполняется посредством агрегатного объекта типа «БухгалтерскиеИтоги» (Англоязычный синоним: BookkeepingTotals). Объект такого типа должен быть создан при помощи функции СоздатьОбъект

БухИтоги = СоздатьОбъект("БухгалтерскиеИтоги");

Таких объектов может быть в системе несколько (любое необходимое коли­чество). Объект может создаваться непосредственно перед использованием или в глобальном модуле (с объявлением экспортируемой переменной). При этом следует иметь в виду, что различные установки, назначаемые объекту будут действовать до их переустановки или удаления объекта. Поэтому обычно данный объект создается перед его использованием.

Механизм бухгалтерских итогов, поддерживаемый компонентой «Бухгал­терский учет» системы 1С:Предприятие релизует хранение накопленных итогов для обеспечения быстрого обращения к ним при составлении отчетов и выпол­нения различных вычислений.

Хранение итогов поддерживается системой с детализацией до месяца. Кро­ме того, хранятся не все возможные итоги, а те, обращение к которым выполняется наиболее часто — это остатки и обороты по счетам с детализацией по объектам аналитики (субконто), а также обороты между счетам (без учета ана­литики).

Обращение к этим итогам выполняется системой непосредственно. Для по­лучения других итогов (с детализацией меньше месяца, с получением оборотов между различными объектами аналитики, а также сложных выборок) требуется выполнение предварительных действий — временного расчета или запроса.

Объект «БухгалтерскиеИтоги» может работать в 3-х различных режимах:

·                 работа с основными итогами;

·                 работа с временными итогами;

·                 работа в режиме запроса;

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

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

Общие свойства

Работа объекта «БухгалтерскиеИтоги» во всех режимах имеет некоторые общие особенности.

Значение типа «Счет» в параметры методов объекта может передаваться в виде строки, содержащей код счета. При этом счет определяется исходя из те­кущей установки используемого плана счетов основного плана счетов, заданно­го в метаданных.

Там, где методам объекта в качестве параметра должна передаваться валюта должно передаваться значение типа того справочника, который выбран в на­стройке планов счетов в качестве справочника валют. В тексте описания объек­та такие значения будут обозначаться как значение типа «Справочник.Валюты», хотя на прикатике идентификатор справочника может быть иным, в зависимости от выбранного в настройке планов счетов значения.

При ведении учета по нескольким планам счетов или с использованием разделителя учета на получение итогов в различных режимах запроса влияют установки методов ИспользоватьПланСчетов и ИспользоватьРазделительУчета.

ИспользоватьПланСчетов

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

Синтаксис:

ИспользоватьПланСчетов(<ПланСчетов>)

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

UseChartOfAccounts

Параметры:

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

Значение данной установки до вызова метода.

Описание:

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

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

Если план счетов не установлен функцией ИспользоватьПланСчетов, будет использоваться основной план счетов, заданный в метаданных.

Пример:

БухИтоги.ИспользоватьПланСчетов(ПланыСчетов.Рабочий);

ИспользоватьРазделительУчета

Установить значение разделителя учета.

Синтаксис:

ИспользоватьРазделительУчета(<РазделительУчета>)

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

UseAccountingDivision

Параметры:

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

Значение данной установки до вызова метода.

Описание:

Метод ИспользоватьРазделительУчета задает значения разделителя учета для методов получения итогов и ВыполнитьЗапрос.

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

Пример:

БухИтоги.ИспользоватьРазделительУчета(Константа.ОснФирма);

Работа с основными итогами

Основными итогами называются остатки и обороты по счетам и объектам аналитического учета, а также обороты между счетами за любой рассчитанный период с детализацией до месяца.

В пункте меню «Управление бухгалтерскими итогами» устанавливается по­следний рассчитанный период. В режиме работы с основными итогами обращение может выполняться только к итогам по рассчитанный период включитель­но.

В этом режиме работают два вида методов — получение остатков и оборотов, а также установка периода за который выдаются итоги.

По умолчанию используется период, выбранный пользователем интерак­тивно через меню «Сервис»-«Параметры»- «Бухгалтерские итоги».

Остатки и обороты по счетам

Для расчета остатков и обротов по счетам существует группа функций со сходным синтаксисом и набором параметров.

СНД, СНК, СКД, СКК, ДО, КО

СНД  дебетовое сальдо по счету на начало периода;

СНК  кредитовое сальдо по счету на начало периода;

СКД  дебетовое сальдо по счету на конец периода;

СКК  кредитовое сальдо по счету на конец периода;

ДО   дебетовый оборот по счету за период;

КО   кредитовый оборот по счету за период.

Синтаксис:

СНД (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...)

СНК (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...}

СКД (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...)

СКК (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...)

ДО (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...)

КО (<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>...)

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

IDB

ICB

FDB

FCB

TD

ТС

Параметры:

Все параметры кроме счета могут не указываться.

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

Число —сальдо или оборот.

Описание:

Функции СНД, СНК, СКД, СКК, ДО, КО возвращают суммы остатков и оборотов по указанному счету за период. Выдаваться может сумма или ва­лютная сумма или количество, в зависимости от параметра <ТипСуммы>.

Если указана валюта, то данные выдаются по конкретной валюте. Валютная сумма может выдаваться только по конкретной валюте.

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

Пример:

* Вычисляются остатки на счете 51 на начало и конец периода бухгалтерских итогов. Рассчитанные остатки присваиваются переменным.

// Создадим объект для работы с бухгалтерскими итогами

БухИтоги = СоздатьОбъект("БухгалтерскиеИтоги);

// Вычислим остаток на расчетном счете (счет 51) на начало периода

П2623 = БухИтоги.СНД("51");

// Вычислим остаток на расчетном счете (счет 51) на конец периода

П2624 = БухИтоги.СКД("51");

Обороты между счетами

ОБ

Расчет оборотов между счетами.

Синтаксис:

ОБ(<СчетДеб>, <СчетКред>, <ТипСуммы>, <Валюта>)

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

TO

Параметры:

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

Число —оборот с дебета счета <СчетДеб> в кредит счета <СчетКред>.

Описание:

Функция ОБ предназначена для выдачи перекрестных оборотов между сче­тами. Коды счетов, оборот между которыми требуется рассчитать, передаются функции в качестве парметров.

Если указана валюта, то данные выдаются по конкретной валюте. Валютная сумма может выдаваться только по конкретной валюте.

Пример:

КассаБанк = БухИтоги.ОБ("50", "51");

Развернутое сальдо по субсчетам

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

СНДР, СНКР, СКДР, СККР

СНДР дебетовое развернутое сальдо по субсчетам на начало периода;

СНКР кредитовое развернутое сальдо по субсчетам на начало периода;

СКДР дебетовое развернутое сальдо по субсчетам на конец периода;

СККР кредитовое развернутое сальдо по субсчетам на конец периода.

Синтаксис:

СНДР(<Счет>, <ТипСуммы>, <Валюта>)

СНКР(<Счет>, <ТипСуммы>, <Валюта>)

СКДР(<Счет>, <ТипСуммы>, <Валюта>)

СККР(<Счет>, <ТипСуммы>, <Валюта>}

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

IDBR

ICBR

FDBR

FCBR

Параметры:

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

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

Описание:

Функции СНДР, СНКР, СКДР, СККР предназначены для расчета остатков по счетам, у которых учет ведется на субсчетах. Каждая функция из этой груп­пы возвращает остаток как сумму соответствующих остатков (дебетовых или кредитовых) всех субсчетов указанного счета. При этом учитываются остатки по субсчетам являющихся собственно счетами, а не группами.

Если указана валюта, то данные выдаются по конкретной валюте. Валютная сумма может выдаваться только по конкретной валюте.

Пример:

* Для помещения в бухгалтерский баланс вычисляется развернутое сальдо по 68 счету, учет на котором ведется на субсчетах. Дебетовая составляющая должна попасть в актив баланса, кредитовая составляющая — в пассив.

// Создадим объект для работы с бухгалтерскими итогами

БухИтоги = СоздатьОбъект( "БухгалтерскиеИтоги);

// Вычислим дебетовое сальдо на 68 счете на начало периода

П2463 = БухИтоги.СНДР("68");

// Вычислим дебетовое сальдо на 68 счете на конец периода

П2464 = БухИтоги.СКДР("68");

// Вычислим кредитовое сальдо на 68 счете на начало периода

П6263 = БухИтоги.СНКР("68");

// Вычислим кредитовое сальдо на 68 счете на конец периода

П6264 = БухИтоги.СККР("68");

Развернутое сальдо по субконто

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

СНДРС, СНКРС, СКДРС, СККРС

СНДРС    дебетовое развернутое сальдо по субконто на начало периода;

СНКРС    кредитовое развернутое сальдо по субконто на начало периода;

СКДРС    дебетовое развернутое сальдо по субконто на конец периода;

СККРС    кредитовое развернутое сальдо по субконто на конец периода.

Синтаксис:

СНДРС(<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>, <ТипФильтра1>, <Субконто2>,

             <ТипФильтра2>...)

СНКРС(<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>, <ТипФильтра1>, <Субконто2>,

             <ТипФильтра2>...)

СКДРС(<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>, <ТипФильтра1>, <Субконто2>,

             <ТипФильтра2>...)

СККРС(<Счет>, <ТипСуммы>, <Валюта>, <Субконто1>, <ТипФильтра1>, <Субконто2>,

             <ТипФильтра2>...}

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

IDBRS

ICBRS

FDBRS

FCBRS

Параметры:

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

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

Описание:

Функции СНДРС, СНКРС, СКДРС, СККРС предназначены для расчета ос­татков по счетам, у которых ведется аналитический учет по субконто. Каждая функция из этой группы возвращает остаток как сумму соответствующих ос­татков (дебетовых или кредитовых) по всем объектам аналитического учета.

Если аналитический учет по счету ведется по двум и более субконто, то для развернутого сальдо параметр <ТипФильтра> устанавливает участие данног вида субконто в получении развернутого сальдо. В зависимости от значения этого параметра данное субконто может участвовать в «развороте» остатка, или накладывать дополнительное ограничение (отбирать) на анализируемые остат­ки, или никак не влиять на результат функции.

Пример:

* Получим развернутое сальдо дебетовое на начало периода по счету 60, учет ведется по субконто Организации.

СР60 = БухИтоги.СНДРС("60");

* Получим развернутое сальдо дебетовое на начало периода по счету 10 кон­кретному складу в разрезе материалов, учет ведется по субконто «Мате­риалы» и «Склады».

СР10 = БухИтоги.СНДРС("10", 1, , , "*", ВыбСклад, "!");

Установка периода итогов

ПериодД

Устанавливает произвольный период в качестве периода расчета ито­гов.

Синтаксис:

ПериодД(<ДатаНачалаПериода>, <ДатаКонцаПериода>)

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

PeriodD

Параметры:

Описание:

Метод ПериодД задает период расчета итогов для функций режима основ­ных итогов.

Период, установленный методом ПериодД, действует до конца вызова дру­гого метода установки периода для этого объекта.

Если параметры не заданы — значения периода берется из периода, заданно­го пользователем интерактивно в меню «Сервис»-«Параметры»-«Бухгалтерские итоги».

Пример:

БухИтоги.ПериодД('07.01.98', '17.01.98');

ПериодКВ

Устанавливает квартал в качестве периода расчета итогов.

Синтаксис:

ПериодКВ(<Дата>|<НомерКвартала>, <Год>)

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

PeriodQ

Параметры:

Описание:

Метод ПериодКВ задает период расчета итогов для функций режима основ­ных итогов. В качестве параметра метода может передаваться либо дата, лежа­щая в том квартале, который будет назачен в качестве периода рачета итогов, либо номер квартал — цифра от 1 до 4. Номер квартала задает квартал года, указанного вторым параметром.

Период, установленный методом ПериодКВ, действует до вызова другго ме­тода установки периода.

Пример:

БухИтоги.ПериодКВ('07.01.98');

ПериодКВН

Устанавливает в качестве периода расчета итогов период с начала го­да до конца указанного квартала.

Синтаксис:

ПериодКВН(<Дата>|<НомерКвартала>, <Год>)

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

PeriodQAccumY

Параметры:

Описание:

Метод ПериодКВН задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов метод устанавливает период с начала года до конца квартала, задаваемого параметрами.

В качестве параметра метода может передаваться либо дата, лежащая в том квартале, который будет назачен в качестве периода рачета итогов, либо номер квартал — цифра от 1 до 4. Номер квартала задает квартал года, указанного вторым параметром.

Периодом расчета итогов считается период с начала года до конца указан­ного квартала.

Период, установленный методом ПериодКВН, действует до вызова другого метода установки периода.

Пример:

БухИтоги.ПериодКВН('07.01.98');

ПериодМ

Устанавливает в качестве периода расчета итогов месяц.

Синтаксис:

ПериодМ(<Дата>|<НомерМесяца>, <Год>)

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

PeriodM()

Параметры:

Описание:

Метод ПериодМ задает период расчета итогов для функций режима основ­ных итогов. В качестве параметра метода может передаваться либо дата месяца, который будет назначен в качестве периода рачета итогов, либо номер месяца — число от 1 до 12. Номер месяца задет месяц года переданного в качестве второ­го пареметра.

Период, установленный методом ПериодМ, действует до вызова другого ме­тода установки периода.

Пример:

БухИтоги.ПериодМ('07.01.98');

ПериодМНК

Устанавливает в качестве периода расчета итогов период с начала квартала до конца указанного месяца.

Синтаксис:

ПериодМНК(<Дата>|<НомерМесяца>, <Год>)

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

PeriodMAccumQ

Параметры:

Описание:

Метод ПериодМНК задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов метод устанавливает период с начала квартала до конца месяца, задаваемого параметрами.

В качестве параметра метода может передаваться либо дата месяца, который будет использован в качестве периода расчета итогов, либо номер месяца — число от 1 до 12. Номер месяца задает месяц года, заданного вторым парамет­ром.

Периодом расчета итогов считается период с начала квартала до конца ука­занного месяца.

Период, установленный методом ПериодМНК, действует до вызова другой функции установки периода.

Пример:

БухИтоги.ПериодМНК('07.08.98');

ПериодМНГ

Устанавливает в качестве периода расчета итогов период с начала го­да до конца указанного месяца.

Синтаксис:

ПериодМНГ(<Дата>|<НомерМесяца>, <Год>}

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

PeriodMAccumY

Параметры:

Описание:

Метод ПериодМНГ задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов функция устанавливает пе­риод с начала года до конца месяца, задаваемого параметрами.

В качестве параметра метода может передаваться либо дата месяца, который будет использован в качестве периода расчета итогов, либо номер месяца — число от 1 до 12. Номер месяца задает месяц года, заданного вторым парамет­ром.

Периодом расчета итогов считается период с начала года до конца указан­ного месяца.

Период, установленный функцией ПериодМНГ, действует до вызова другой функции установки периода.

Пример:

БухИтоги.ПериодМНГ('07.08.98');

НачПериода

Выдает начальную дату установленного в данный момент периода основных итогов.

Синтаксис:

НачПериода()

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

BeginOfPeriod

Возвращаемое значение: Начальная дата периода.

Описание:

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

Пример:

Сообщить(ПериодСтр(БухИтоги.НачПериода(), БухИтоги.КонПериода());

КонПериода

Выдает конечную дату установленного в данный момент периода основных итогов.

Синтаксис:

КонПериода()

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

EndOfPeriod

Возвращаемое значение: Конечная дата периода.

Описание:

Метод КонПериода используется для определения конечной даты основ­ных итогов выдаваемых объектом.

Пример:

Сообщить(ПериодСтр(БухИтоги.НачПериода(), БухИтоги.КонПериода());

ОсновныеИтоги

Переводит объект в режим работы с основными итогами.

Синтаксис:

ОсновныеИтоги()

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

MainTotals

Описание:

Метод ОсновныеИтоги переводит объект в режим работы с основными итогами. Вызов этого метода имеет смысл тогда, когда был выполнен расчет временных итогов или запрос, и нужно вернуть объект к работе с основными итогами. При этом результаты запроса или расчета временных итогов теряются.

Пример:

БухИтоги.ОсновныеИтоги();

Работа с временными итогами

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

Для получения временных итогов используются теже методы, что и для по­лучения основных итогов (СНД, СНК , СКД , СКК, ДО, КО, ОБ и другие). Параметры метода Рассчитать определяют итоги, которые будут доступны для получения этими методами.

Рассчитать

Расчет временных итогов.

Синтаксис:

Рассчитать(<НачалоПериода>, <КонецПериода> , <ФильтрПоСчетам>, <ТолькоСинтетика> , <ПланСчетов>, <РазделительУчета>)

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

Calculate

Параметры:

<НачалоПериода> Необязательный параметр. Выражение типа дата, документ или позиция документа начала периода расчета временных итогов. Если этот параметр не указан, будут вычисляться конечные сальдо на момент, указанный в параметре <КонецПериода>.

<КонецПериода> Необязательный параметр. Выражение типа дата, документ или позиция документа конца периода расчета временных итогов. Если этот параметр не указан, будут вычисляться начальные сальдо на момент, указанный в параметре <НачалоПериода>.

<ФильтрП, рСчетам> Необязательный параметр. Счета, для которых

будет выполняться временный расчет итогов. За­дается значением типа «Счет» или объектом типа «СписокЗначений», содержащим значения типа «Счет», либо строкой содержащей список кодов счетов, разделенных символом ", " или ";".

<ТолькоСинтетика> Необязательный параметр:

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

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

<ПланСчетов> Необязательный параметр. Значение типа «План Счетов». Ограничение расчета одним планом сче­тов.

<РазделительУчета> Необязательный параметр. Значение разделителя учета. Ограничение расчета одним значением раз­делителя учета.

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

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

Описание:

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

Если из двух параметров периода задан только параметр начала периода, метод Рассчитать вычислит начальные остатки — без оборотов. Наоборот, если задан параметр конца периода, будут вычисленные конечные остатки.

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

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

Если параметр <ТолькоСинтетика> не указан или равен 0, временный расчет итогов будет выполнен и по счетам, и по субконто.

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

Пример:

БухИтоги.Рассчитать(ДатаНач, ДатаКон);

Актуальность

Устанавливает или сбрасывает признак актуальности временных итогов.

Синтаксис:

Актуальность(<Флаг>)

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

Actual

Параметры:

<Флаг> Необязательный параметр. Число — признак актуаль­ности временного расчета итогов. Параметр может принимать значения:

1 — поддерживать временный расчет в актуальном состоянии;

О—не поддерживать временный расчет в актуальном состоянии;

Если параметр не задан, то значение не меняется.

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

Значение признака актуальности на момент до вызова функции.

Описание:

Данный метод позволяет организовать поддержку временного расчета ито­гов в актуальном состоянии. При установке объекту «БухгалтерскиеИтоги»

признака поддержки в актуальном состоянии, в нем будут отражаться все из­менения в итогах, выполняемые операциями. При этом данный актуальный объект «БухгалтерскиеИтоги» смогут автоматически использовать временные расчеты и запросы других объектов «БухгалтерскиеИтоги» с аналогичными фильтрами, что позволяет оптимизировать время расчета.

Данную возможность следует использовать только в специальных случаях, например, для оптимизации больших регламентных расчетов.

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

Пример:

БухИтоги.Актуальность(1);

Работа в режиме запроса

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

После выполнения запроса с помощью специального набора методов объек­та «Бухгалтерские Итоги» осуществляется получение итогов, полученных дан­ным запросом. К этим методам относятся методы обхода итогов в различных разрезах (сформированных запросом) и методы для получения собственно ито­гов. Кроме того специальный набор атрибутов объекта «Бухгалтерские Итоги» позволяет обращаться процессе обхода результатов запроса к значениям полу­ченных группировок.

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

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

Синтаксис:

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

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

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

DoQuery

Параметры:

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

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

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

Описание:

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

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

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

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

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

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

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

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

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

Пример:

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

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

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

   ...

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

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

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

      ...

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

   КонецЦикла;

   ...

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

...

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

...

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

Пример:

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

ВключатьСубсчета

Устанавливает режим отбора итогов методом ВыполнитьЗапрос по субсчетам.

Синтаксис:

ВключатьСубсчета(<ФлагСчета>, <ФлагКоррСчета>}

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

IncludeSubAccounts

Параметры:

Описание:

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

Если метод не вызвался, разворот итогов по субсчетам не производится.

Пример:

БухИтоги.ВключатьСубсчета(1, 1);

Опции

Устанавливает режим включения сумм в итоги.

Синтаксис:

Опции(<ВключатьЗабалансовыеСуммы>, <ВключатьОборотныеСубконтоСуммы>)

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

Options

Параметры:

Описание:

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

Если метод не вызвался, суммы по забалансовым счетам и оборотным суб­конто не включаются в запрос.

Пример:

БухИтоги.Опции(1, 1);

ИспользоватьСубконто

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

Синтаксис:

ИспользоватьСубконто(<ВидСубконто>, <Субконто>, <ТипФильтра>, <ПоГруппам>)

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

UseSubconto

Параметры:

Описание:

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

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

Метод ИспользоватьСубконто может вызываться последовательно не­сколько раз. В этом случае установки, выполняемые этим методом суммируют­ся.

Использование параметра <ТипФильтра> со значением 1 (разворачивать) в сочетании с выбранной группой справочника в параметре <Субконто> позво­ляет получить итоги по всем элементам данной группы.

Пример:

* Данный запрос формирует итоги по счету 10 в разрезе материалов по од­ному складу.

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

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

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

ИспользоватьКорСубконто

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

Синтаксис:

ИспользоватьКорСубконто(<ВидСубконто>, <Субконто>, <ТипФильтра>, <ПоГруппам>)

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

UseCorSubconto

Параметры:

Описание:

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

Метод ИспользоватьКорСубконто слудет вызывать до вызова метода ВыполнитьЗапрос. После выполнения метода ВыполнитьЗапрос установки метода ИспользоватьКорСубконто сбрасываются и перед слудеющим запро­сом их нужно устанавливать заново.

Метод ИспользоватьКорСубконто может вызываться последовательно несколько раз. В этом случае установки, выполняемые этим методом сумми­руются.

Использование параметра <ТипФильтра> со значением 1 (разворачивать) в сочетании с выбранной группой справочника в параметре <Субконто> по­зволяет получить итоги по всем элементам данной группы.

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

Пример:

* Данный запрос формирует итоги по корреспонденции субконто Товары и Клиенты.

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

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

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

---

---