Admin: 1 revision imported

2021-02-07T06:43:23Z

1 revision imported

Admin: Created page with "{{infobox function |name=Total, Gross1 |object=Объект базы данных |caption=Запросы к накопителям |type=1 |status=2 |db=2 |exception=Не..."

2019-09-30T07:02:27Z

Created page with "{{infobox function |name=Total, Gross1 |object=Объект базы данных |caption=Запросы к накопителям |type=1 |status=2 |db=2 |exception=Не..."

New page

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

== Синтаксис ==
<code>
{{Grey|DB.}}'''Total'''(''<Реквизит суммирования (агрегации) (STRING)>''{{Optional|,<Остатки на дату (DATE)>,<Режим даты (INT)>,<Стандартные фильтры>...}}):''<Остаток указанного актива (NUMBER)>''
</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>
//Фрагмент выводит текущий остаток номенклатурной позиции аНоменклатура на складе аСклад за минусом резерва.
Ост:=Max(Storage.ОстаткиТМЦ.Gross1("Количество",,0,"Склад,Номенклатура",аСклад,аНоменклатура)-Storage.РезервыТМЦ.Gross1("Количество",,0,"Склад,Номенклатура",аСклад,аНоменклатура),0);
Message("Остаток позиции "+аНоменклатура+" на складе "+аСклад+": "+Ост);
</pre>

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

DB.Total - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=Total, Gross1 |object=Объект базы данных |caption=Запросы к накопителям |type=1 |status=2 |db=2 |exception=Не..."