Основная страница

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Синтаксис:

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

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

UseChartOfAccounts

Параметры:

<ПланСчетов>

Необязательный параметр. Значение типа «План Счетов». Если не задан установка не меняется.

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

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

Описание:

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

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

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

Пример:

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

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

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

Синтаксис:

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

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

UseAccountingDivision

Параметры:

<РазделительУчета>

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Синтаксис:

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

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

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

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

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

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

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

IDB

ICB

FDB

FCB

TD

ТС

Параметры:

<Счет>

Значение типа «Счет» — счет расчета итогов. Может использоваться строка — код счета.

<ТипСуммы>

Необязательный параметр. Число или строка — тип возвращаемой суммы. Может принимать одно из следующих значений:

1 ("С", "S")— сумма;

2 ("В", "С")— валютная сумма;

3 ("К", "А")— количество.

Если параметр не указан, метод возвращает сумму.

<Валюта>

Необязательный параметр. Значение типа «Спра­вочник.Валюты». Если параметр не указан итоги выдаются без учета валюты.

<Субконто1>
<Субконто2>…

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

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

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

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

Описание:

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

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

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

Пример:

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

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

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

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

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

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

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

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

ОБ

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

Синтаксис:

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

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

TO

Параметры:

<СчетДеб>, <СчетКред>

Значения типа «Счет» — счета дебета и кредита, для которых необходимо выдать перекрестные обо­роты. Может использоваться строка — код счета.

<ТипСуммы>

Необязательный параметр. Число или строка — тип возвращаемой суммы. Может принимать одно из следующих значений:

1 ("С", "S")— сумма;

2 ("В", "С")— валютная сумма;

3 ("К", "А")— количество.

Если параметр не указан, метод возвращает сумму.

<Валюта>

Необязательный параметр. Значение типа «Спра­вочник.Валюты». Если параметр не указан итоги выдаются без учета валюты.

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

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

Описание:

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

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

Пример:

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

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

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

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

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

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

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

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

Синтаксис:

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

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

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

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

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

IDBR

ICBR

FDBR

FCBR

Параметры:

<Счет>

Значение типа «Счет» — счет, для которого необхо­димо рассчитать развернутое сальдо. Может использоваться строка — код счета.

<ТипСуммы>

Необязательный параметр. Число или строка — тип возвращаемой суммы. Может принимать одно из следующих значений:

1 ("С", "S")— сумма;

2 ("В", "С")— валютная сумма;

3 ("К", "А")— количество.

Если параметр не указан, метод возвращает сумму.

<Валюта>

Необязательный параметр. Значение типа «Спра­вочник. Валюты». Если параметр не указан итоги выдаются без учета валюты.

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

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

Описание:

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

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

Пример:

* Для помещения в бухгалтерский баланс вычисляется развернутое сальдо по 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

Параметры:

<Счет>

Значение типа «Счет» — счет, для которого необхо­димо рассчитать развернутое сальдо. Может ис­пользоваться строка — код счета.

<ТипСуммы>

Необязательный параметр. Число или строка — тип возвращаемой суммы. Может принимать одно из следующих значений:

1 ("С", "S")— сумма;

2 ("В", "С")— валютная сумма;

3 ("К", "А")— количество.

Если параметр не указан, метод возвращает сумму.

<Валюта>

Необязательный параметр. Значение типа «Спра­вочник. Валюты». Если параметр не указан итоги выдаются без учета валюты.

<Субконто1>

Необязательный параметр. Значение субконто 1.

<ТипФильтра1>

Необязательный параметр. Тип использования суб­конто 1. (Строка или число).

"*" (1) — Разворачивать по данному субконто.

"!" (2) — Отбирать по данному субконто.

" " (3) — Не учитывать данное субконто.

Значения по умолчанию: "*" (1) — для первого суб­конто, " " (3) — для остальных субконто.

<Субконто2>

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

ПериодД

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

Синтаксис:

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

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

PeriodD

Параметры:

<ДатаНачалаПериода>

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

<ДатаКонцаПериода>

Необязательный параметр. Конечная дата пе­риода выдачи итогов.

Описание:

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

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

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

Пример:

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

ПериодКВ

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

Синтаксис:

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

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

PeriodQ

Параметры:

<Дата>

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

<НомерКвартала>

Число от 1 до 4 — порядковый номер квартала.

<Год>

Год заданный числом (включая век). Используется только, если первый параметр — номер квартала.

Описание:

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

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

Пример:

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

ПериодКВН

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

Синтаксис:

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

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

PeriodQAccumY

Параметры:

<Дата>

Дата — любая дата квартала, устанавливаемого в качестве периода расчета итогов.

<НомерКвартала>

Число от 1 до 4 — порядковый номер квартала.

<Год>

Год заданный числом (включая век). Используется только, если первый параметр — номер квартала.

Описание:

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

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

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

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

Пример:

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

ПериодМ

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

Синтаксис:

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

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

PeriodM()

Параметры:

<Дата>

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

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

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

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

Пример:

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

ПериодМНК

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

Синтаксис:

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

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

PeriodMAccumQ

Параметры:

<Дата>

Дата — любая дата месяца, устанавливаемого в качестве периода расчета итогов.

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

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

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

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

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

Пример:

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

ПериодМНГ

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

Синтаксис:

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

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

PeriodMAccumY

Параметры:

<Дата>

Дата — любая дата месяца, устанавливаемого в качестве периода расчета итогов.

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

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

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

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

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

Пример:

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

НачПериода

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

Синтаксис:

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

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

BeginOfPeriod

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

Описание:

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

Пример:

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

КонПериода

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

Синтаксис:

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

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

EndOfPeriod

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

Описание:

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

Пример:

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

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

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

Синтаксис:

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

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

MainTotals

Описание:

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

Пример:

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

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

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

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

Рассчитать

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

Синтаксис:

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

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

Calculate

Параметры:

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

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

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

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

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

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

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

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

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

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

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

Описание:

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

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

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

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

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

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

Пример:

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

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

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

Синтаксис:

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

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

Actual

Параметры:

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

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

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

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

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

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

Описание:

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

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

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

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

Пример:

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

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

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

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

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

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

Синтаксис:

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

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

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

DoQuery

Параметры:

<НачалоПериода>

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

<КонецПериода>

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

<ФильтрПоСчетам>

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

<ФильтрПоКоррСчет>

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

<Валюта>

Необязательный параметр. Значение типа «Справочник.Валюты». Если параметр не указан итоги выдаются без учета валюты.

<ТипИтогов>

Необязательный параметр. Число — тип отбирае­мых итогов. Может принимать следующие значе­ния:

1 — остатки и обороты по счету в целом;

2 — обороты между счетами;

Первое и второе вместе.

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

<Периодичность>

Необязательный параметр. Позволяет получить дополнительный разрез итогов по периодам. Чис­ло или символьная строка (См. ниже). По умол­чанию периодичность не задана.

<ТипСуммы>

Необязательный параметр. Число или строка — тип рассчитываемых итогов. Может принимать следующие значения (в скобках указаны строко­вые синонимы):

1 («С», «S») рассчитывать суммы;

2 («В», «С») рассчитывать валютные суммы;

4 («К», «А») рассчитывать количество.

Если требуется одновременно рассчитывать раз­ные суммы, значение параметра получается путем сложения допустимых значений, например: 5 (1+4) — рассчитывать суммы и количество. При указании параметра строкой в ней указываются все символы, которые обозначают типы сумм, которые нужно рассчитывать. По умолчанию рассчитываются все типы сумм.

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

1 («Период», «Period»)

Промежуточные итоги не рассчиты­ваются;

2 («Операция», «Entry»)

Промежуточные итоги рассчитыва­ются по операциям;

3 («Проводка», «Operation»)

По проводкам;

4 («День», «Day»)

По дням;

5 («Неделя», «Week»)

По неделям;

6 («Декада», «Decade»)

По декадам;

7 («Месяц», «Month»)

По месяцам;

8 («Квартал», «Quorter»)

По кварталам

9 («Год», «Year»)

По годам.

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

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

Описание:

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

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

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

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

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

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

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

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

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

Пример:

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

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

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

   ...

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

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

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

      ...

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

   КонецЦикла;

   ...

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

...

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

...

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

Пример:

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

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

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

Синтаксис:

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

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

IncludeSubAccounts

Параметры:

<ФлагСчета>

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

0 — не разворачить по субсчетам;

1 — разворачивать по субсчетам;

-1 (минус единица) — не выдавать итоги по сче­там-группам.

Значение по умолчанию — 0.

<ФлагКоррСчета>

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

0 — не разворачить по субсчетам;

1 — разворачивать по субсчетам;

-1 (минус единица) — не выдавать итоги по кор­респондирующим счетам-группам.

Значение по умолчанию — 0.

Описание:

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

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

Пример:

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

Опции

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

Синтаксис:

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

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

Options

Параметры:

<ВключатьЗабалансовыеСуммы>

Признак включения в итоги сумм по забалансовым счетам. Число:

0 — не включаются суммы по забалансовым счетам;

1 — включаются суммы по забалансовым счетам.

<ВключатьОборотныеСу6контоСуммы>

Признак включения в итоги сумм по оборотным субконто. Число:

0 — не включаются суммы по оборотным субконто;

1 — включаются суммы по оборотным субконто.

Описание:

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

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

Пример:

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

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

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

Синтаксис:

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

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

UseSubconto

Параметры:

<ВидСубконто>

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

<Субконто>

Необязательный параметр. Здесь может быть за­дано или одно конкретное значение субконто, по которому будут отобраны итоги по аналитике или объект типа «Список значений», где можно задать несколько значений субконто. Если параметр не задан — то считается пустым значением субконто.

<ТипФильтра>

Необязательный параметр. Число — тип фильтра по субконто. Может принимать следующие значе­ния:

1 — разворачивать по данному субконто,

2 — отбирать по данному субконто,

3 — не учитывать это субконто вообще.

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

<ПоГруппам>

Необязательный параметр. Число — группировка др итогов по субконто. Параметр <ПоГруппам> имеет смысл, если параметр <ТипФильтра> равен 1, а вид субконто, заданный параметром <ВидСубконто>, имеет тип значения «Справочник». Параметр может принимать значения:

0 — не показывать итоги по группам справочника;

1 — показывать итоги по группам справочника.

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

Описание:

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

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

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

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

Пример:

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

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

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

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

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

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

Синтаксис:

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

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

UseCorSubconto

Параметры:

<ВидСубконто>

Значение типа «Вид Субконто» — расчет временных итогов будет выполнен только для субконто указанного вида.

<Субконто>

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

<ТипФильтра>

Необязательный параметр. Число — тип фильтра по субконто. Может принимать следующие значе­ния:

1 — разворачивать по данному субконто,

2 — отбирать по данному субконто,

3 — не учитывать это субконто вообще.

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

<ПоГруппам>

Необязательный параметр. Число — группировка итогов по субконто. Параметр <ПоГруппам> имеет смысл, если параметр <ТипФильтра> равен 1, а вид субконто, заданный параметром <ВидСубконто>, имеет тип значения «Справоч­ник». Параметр может принимать значения;

0 — не показывать итоги по группам справочника;

1 — показывать итоги по группам справочника.

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

Описание:

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

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

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

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

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

Пример:

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

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

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

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

 


Перейти  к оглавлению: Описание встроенного языка

Hosted by uCoz