1С Предприятие 8.0. Описание встроенного языка

         

Таблица получения остатков и оборотов


Синтаксис:

РегистрНакопления.<Имя регистра>.ОстаткиИОбороты(<Начало периода> , <Конец периода> , <Периодичность> , <Условие>, <Измерение>)

Описание:

Виртуальная таблица. Предназначена для получения остатков и оборотов за период по регистру накопления. Данные представля­ют собой итоги ресурсов, подсчитанные по комбинации измере­ний, указанной в параметре <Измерения>. Если параметр не за­дан, то итоги подсчитываются по полному набору измерений.

При расчете итогов учитываются только активные записи. Таблица существует только для регистров остатков.

Предоставляемые поля:

Период (Period)

Тип: Дата. Содержит период, к которому относятся итоги реги­стра.

Примечание: Содержит начальную дату и время периода.

Существует только в случае, если используется разворот по пе­риодам, т.е. параметр Периодичность имеет значения Год, Квартал, Неделя, День, Регистратор, Запись.

Данное поле не может быть использовано в условии отбора запи­сей.

Регистратор (Recorder)

Тип: Любая ссылка на объект ИВ. Содержит ссылку на документ-регистратор движения.



Примечание: Существует только в случае, если параметр

Периодичность имеет значения Регистратор, Запись.

Данное поле не может быть использовано в условии отбора запи­сей.

НомерСтроки (LineNumber)

Тип Число. Содержит номер строки, определяемый как поряд­ковый номер записи в наборе записей.

<Имя измерения>

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

<Имя ресурса>Оборот (<Имя ресурсa>Turnover)

Тип Число. Набор полей содержит обороты по ресурсам регист­ра. Имена полей соответствуют именам ресурсов, как они заданы в конфигураторе, с добавлением слова Оборот.

Для регистров оборотов оборот подсчитывается как сумма всех движений. Для регистров остатков оборот подсчитывается как сумма всех движений Приход со знаком + (плюс) и Расход со знаком - (минус).




<Ими ресурса>Приход (<Имя pecypca>Receipt)
Тип: Число. Набор полей содержит суммы всех движений Приход по ресурсам регистра. Имена полей соответствуют име­нам ресурсов, как они заданы в конфигураторе, с добавлением слова Приход.
<Имя ресурса>Расход (<Имя pecypca>Expense)
Тип: Число. Набор полей содержит суммы всех движений Расход по ресурсам регистра. Имена полей соответствуют име­нам ресурсов, как они заданы в конфигураторе, с добавлением слова Расход.
<Имя ресурса>НачальныйОстаток (<Имя pecypca>InitialBalance)
Тип: Число. Набор полей содержит начальные остатки ресурсов регистра. Имена полей соответствуют именам ресурсов, как они заданы    в     конфигураторе, с добавлением
слова НачальныйОстаток.
<Имя ресурса>КонечныйОстаток (<Имя pecypca>FinalBalance)
Тип: Число. Набор полей содержит конечные остатки ресурсов регистра. Имена полей соответствуют именам ресурсов, как они заданы    в     конфигураторе,
с добавлением слова КонечныйОстаток.
Параметры:
<Начало периода>     Необязательный
Тип параметра: Значение. Тип: Дата,  МоментВремени, Граница. Указывается начало периода расчета итогов. Значение начала периода по умолчанию включается в период расчета ито­гов. Для исключения значения из периода его следует задавать объектом Граница с исключением граничного значения.
Значение по умолчанию: Если параметр не задан, итоги рассчи­тываются с самой первой записи.
<Конец периода>    Необязательный
Тип параметра; Значение. Тип: Дата, МоментВремени, Граница. Указывается конец периода расчета итогов. Значение конца периода по умолчанию включается в период расчета ито­гов. Для исключения значения из периода его следует задавать объектом Граница с исключением граничного значения.
Значение по умолчанию: Если параметр не задан, итоги рассчи­тываются по самую последнюю запись.
<Периодичность>    Необязательный
Тип параметра: Конструкция. Указывается дополнительный раз­ворот итогов по периодичности. Задается один из следующих ва­риантов:


• Период (Period) - только за период (не разворачивать);
• Запись (Record) - разворачивать по записям регистра;
• Регистратор (Recorder) - разворачивать по регистра­тору;
• День (Day) - разворачивать по дням;
• Неделя (Week) - разворачивать по неделям;
• Месяц (Month) - разворачивать по месяцам;
• Квартал (Quarter) - разворачивать по кварталам;
• Год (Year) - разворачивать по годам.
Значение по умолчанию: Период
<Условие>     Необязательный
Тип параметра: Конструкция. Указывается условие на языке за­просов. Условие может оперировать полями регистра накопления. Оно будет использовано для ограничения состава записей, по ко­торым будут выбираться итоги. То есть условие будет применять­ся к исходным записям, а не к уже отобранным.
Значение по умолчанию: Если параметр не задан, анализируются все активные записи регистра.
<Измерение>     Необязательный
Тип параметра: Конструкция. Указывается список измерений, по которым будут развернуты итоги.
Значение по умолчанию: Если не указан, то по всем измерениям.
Пример:
// Получение всех остатков и оборотов регистра остатков

ВЫБРАТЬ * ИЗ РегистрНакопления.УчетНокенклатуры.ОстаткиИОбороты()
// Получение остатков и оборотов регистра остатков за указанный период по указанному складу

ВЫБРАТЬ * ИЗ РегистрНакоплевия.УчетНоменклатуры.ОстаткиИОбороты(&НачПериода,&КонПериода, Склад = &ПарСклад)

«««««««««« 1С:Предприятие 8.0 »»»»»»»»»»
Содержание раздела