Admin: 1 revision imported

2021-02-07T06:52:28Z

1 revision imported

Admin at 09:18, 2 November 2019

2019-11-02T09:18:12Z

New page

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

== Синтаксис ==
<code>
{{Grey|Query.}}'''Compute'''(''<Наименование переменной запроса (STRING)>''{{Optional|,<Операция агрегации (STRING)>{{Default|{{Eq}}"SUM"}},<Строки превращать в числа (INT)>{{Default|{{Eq}}0}},<Вычислять для уровня (INT)>{{Default|{{Eq}}<Текущий линейный уровень обхода>}}}}):''<Результат вычисления (NUMBER)>''
</code>

==== Аргументы ====
* <code>''<Наименование переменной запроса (STRING)>''</code> - Задает наименование переменной (столбца) запроса для агрегации значений текущего уровня обхода таблицы запроса. Переменная может не быть переменной агрегации в оригинальном запросе, но должна содержать числовые значения.
* <code>''<Операция агрегации (STRING)>''</code> - {{optional}} Задает наименование операции агрегации. Доступны следующей значения:
** '''SUM''' (по умолчанию) -- нахождения значения агрегации путем суммирования требуемых на этом уровне группировки строк.
** '''AVG''' -- нахождения значения агрегации путем нахождения среднего значения среди значений требуемых на этом уровне группировки строк.
** '''MIN''' -- нахождения значения агрегации путем нахождения минимального значения среди значений требуемых на этом уровне группировки строк.
** '''MAX''' -- нахождения значения агрегации путем нахождения максимального значения среди значений требуемых на этом уровне группировки строк.
** '''COUNT''' -- нахождения количества значений на этом уровне группировки строк.
* <code>''<Строки превращать в числа (INT)>''</code> - {{optional}} Может принимать значения: 0 (по умолчанию) -- производить операции только над числовыми значениями (как над целыми, так и над вещественными числами), 1 -- производить операции над числовыми значениями и над строковыми значениями, предварительно превращая строки в числа (фактические значения ячеек при этом не будут изменены).
* <code>''<Вычислять для уровня (INT)>''</code> - {{optional}} Аргумент имеет разную функцию для линейных и для обычных запросов:
** Для '''линейных''' запросов, аргумент форсирует текущий уровень для нахождения значения. По умолчанию этот уровень соответствует текущему уровню обхода. Действие аргумента соответствует операции: <code>аТемп:=З.LinearLevelPos;З.LinearLevelPos:=<Вычислять для уровня>;аРезультат:=З.Compute(<Наименование переменной запроса>);З.LinearLevelPos:=аТемп;</code>.
** Для '''обычных''' запросов, аргумент указывает, строки какого уровня необходимо использовать для нахождения итогов переменной агрегации. По умолчанию используются оригинальные строки нулевого уровня, но, если строки выли удалены из запроса (см. опцию ''RemoveLev0Lines''), можно использовать строки уровня ''1'', либо можно использовать строки больших уровней для небольшого ускорения вычисления (будет сложено меньшее количество строк). Однако, вычисление операции типа ''AVG'' и ''COUNT'' будет делать неверные результаты.

==== Возвращаемое значение ====
Возвращает числовое значение-результат вычисления.

== Примеры ==
<pre>
Var З Export;

//Функция обхода группировок на основе рекурсии
Function ОбходГруппировок(Уровень)
If Уровень>З.GroupCount Then
Exit;
EndIf;

While З.Next(Уровень) Do
//Получить значение текущей группировки
зЭл:=З.Get(З.Groups(Уровень));

//Получить сальдо агрегации для текущей строки
зНачОст:=З.зНачОст;
зКонОст:=З.зКонОст;
зПриход:=З.зПриход;
зРасход:=З.зРасход;

//Вывод информации в печатную форму отчета
...

//Перейти к следующей группировке
ОбходГруппировок(Уровень+1);
EndDo;
EndFunction

//Выполним запрос с произвольным количеством группировок
ТЗ:=...

З:=Query.Create();
З.Execute(ТЗ);

//Вывести заголовок в печатную форму отчета
...

//Вывод строк группировок
ОбходГруппировок(1);

//Вывод строки итого, работает как линейных, так и для обычных запросов
зНачОст:=З.BegTotals("зНачОст");
зКонОст:=З.EndTotals("зКонОст");
зПриход:=З.Compute("зПриход");
зРасход:=З.Compute("зРасход");

...

</pre>

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

Query.Compute - Revision history

Admin: 1 revision imported

Admin at 09:18, 2 November 2019