Admin: 1 revision imported

2021-02-07T06:43:23Z

1 revision imported

Admin at 07:00, 30 September 2019

2019-09-30T07:00:49Z

New page

{{infobox function
|name=Totals, Gross
|object=[[Объект базы данных]]
|caption=Запросы к накопителям
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, дату, число, ошибка в фильтрах и пр.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция выполняет запрос к таблице остатков текущего накопителя, в разрезе заданных реквизитов-аккумуляторов, накапливая остатки по заданным реквизитам актива. Остатки будут получены на указанную дату и могут иметь режим ''начальный остаток'' или ''конечный остаток''. При вычислении остатков могут применяться фильтры по требуемым реквизитам-аккумуляторам. Функция возвращает таблицу значений, имеющую количество столбцов, совпадающих с количеством заданных реквизитов группировки и реквизитов агрегации. Имена столбцов соответствуют указанным реквизитам. Функция применима только к накопителям, имеющим таблицу остатков (записи накопителя датируются и имеется по крайней мере один реквизит-аккумулятор и один реквизит актива), для накопителей без таблицы остатков можно использовать функцию [[DB.Compute|Compute]].

== Синтаксис ==
<code>
{{Grey|DB.}}'''Totals'''(''<Список реквизитов группировки (STRING)>'',''<Список реквизитов суммирования (агрегации) (STRING)>''{{Optional|,<Остатки на дату (DATE)>,<Режим даты (INT)>,<Стандартные фильтры>...}}):''<Таблица итогов в требуемом разрезе (TAB)>''
</code>

==== Аргументы ====
* <code>''<Список реквизитов группировки (STRING)>''</code> - Задает наименования реквизитов группировки запроса. Каждый реквизит должен присутствовать в накопителе, каждый реквизит должен иметь признак ''аккумулятора''.
* <code>''<Список реквизитов суммирования (агрегации) (STRING)>''</code> - Задает наименования реквизитов агрегации запроса. Каждый реквизит должен присутствовать в накопителе, каждый реквизит должен иметь признак ''актив''.
* <code>''<Остатки на дату (DATE)>''</code> - Задает дату нахождения остатков.
* <code>''<Режим даты (INT)>''</code> - Задает режим нахождения остатков на дату, доступны следующие значения:
** '''0''' (по умолчанию) -- находить остатки на указанную дату (включая день даты). К примеру, для даты '31.12.2013 12:00:00' остатки будут найдены для периода с датами записей <= '31.12.2013 23:59:59.999', т.е. с записями < '01.01.2014'.
** '''1''' -- находить остатки до указанной даты (не включать день даты). К примеру, для даты '31.12.2013 12:00:00' остатки будут найдены для периода с датами записей < '31.12.2013'.
** '''2''' -- находить остатки на указанную дату и время (включая дату и время). К примеру, для даты '31.12.2013 12:00:00' остатки будут найдены для периода с датами записей <= '31.12.2013 12:00:00'.
** '''3''' -- находить остатки до указанной даты и времени (не включая дату и время). К примеру, для даты '31.12.2013 12:00:00' остатки будут найдены для периода с датами записей < '31.12.2013 12:00:00'.
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры описаны в статье [[Стандартные фильтры]]. Имеет смысл использовать только фильтры по реквизитам-аккумуляторам (не обязательно их присутствие в реквизитах группировки), иначе остаток будет найден неверно, так как таблица остатков содержит записи только в разрезе реквизитов-аккумуляторов.

==== Возвращаемое значение ====
Возвращается таблица, каждая запись которой содержит остаток указанных активов в разрезе указанных аккумуляторов.

== Примеры ==
<pre>
//Фрагмент заполняет строки документа текущими остатками склада документа за минусом резервов
//Переменные: aEl -- текущий документ
// aTab -- строчная часть документа
aTab.ClearLines();
Tab1:=Stor.ОстаткиТМЦ.Gross("Номенклатура","Количество",,0,"Склад",aEl.Склад);
Tab2:=Stor.РезервыТМЦ.Gross("Номенклатура","Количество",,0,"Склад",aEl.Склад);
Tab2.Select();
While Tab2.Next() Do
Tab2.Количество:=-Tab2.Количество;
EndDo;
//Добавим таблицу резервов к таблице текущих остатков
Tab1.FullJoin(Tab2,"Номенклатура","Количество");

Tab1.Select();
While Tab1.Next() Do
If Round(Tab1.Количество,6)>0 Then
aTab.AddLine("Номенклатура,Количество",Tab1.Номенклатура,Tab1.Количество);
EndIf;
EndDo;
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB.Totals - Revision history

Admin: 1 revision imported

Admin at 07:00, 30 September 2019