Admin: 1 revision imported

2021-02-07T06:52:28Z

1 revision imported

Admin: Created page with "{{infobox function |name=CreateFromTable |object=Запрос базы данных |caption=Создание запрос..."

2019-11-02T11:42:32Z

Created page with "{{infobox function |name=CreateFromTable |object=Запрос базы данных |caption=Создание запрос..."

New page

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

== Синтаксис ==
<code>
{{Grey|Query.}}'''CreateFromTable'''(''<Таблица для создания результата запроса (TAB)>'',''<Столбцы группировки с настройками (STRING)>'',''<Столбцы агрегации с операциями (STRING)>''{{Optional|,<Режим запроса (INT)>{{Default|{{Eq}}1}}}}):''<Новый объект запроса (QUERY)>''
</code>

==== Аргументы ====
* <code>''<Таблица для создания результата запроса (TAB)>''</code> - Аргумент, имеющий тип таблица значений, служащий для создания запроса. Внимание: таблица будет использована, как основа запроса, она не будет скопирована. Дальнейшие изменения в таблице будут равнозначны изменениям таблицы результата обычного запроса.
* <code>''<Столбцы группировки с настройками (STRING)>''</code> - Список столбцов группировки запроса через запятую с дополнительными суффиксами. Формат записи информации о столбце следующий: <code><Наименование столбца>[[ Horizontal][ With Folders Ref.<Наименование справочника>]]</code>. Суффикс ''Horizontal'' создает горизонтальную группировку (по умолчанию все группировки вертикальные), Суффикс ''With Folders'' создает дополнительную группировку по папкам справочника. Необходимо также указать справочник, по папкам которого происходит группировка.
* <code>''<Столбцы агрегации с операциями (STRING)>''</code> - Список столбцов для выполнения агрегации с дополнительными суффиксами операций. {{Planned}} В текущей реализации суффиксы не принимаются и будет выполняться только агрегация суммированием.
* <code>''<Режим запроса (INT)>''</code> - {{optional}} Задает режим выполнения запроса, возможны следующие значения:
** '''1''' (по умолчанию) -- Выполнить постобработку в режиме обычного запроса.
** '''2''' -- Выполнить постобработку в линейном режиме

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

== Примеры ==
<pre>
//Пример выполняет простой запрос к логам базы данных за период с НачДата по КонДата и превращает результат в объект запроса
Var З Export;

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

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

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

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

//Стр1 -- список переменных фильтра
//Стр2 -- их значения (список переменных со значениями фильтров)
//СтрГруппы -- список группировок запроса, выбранных оператором
Стр1:=...
Стр2:=...
СтрГруппы:=...

aTab:=Eval("Logs.Query(НачДата,КонДата,,"""+Стр1+""","+Стр2+")");
З:=Query.CreateFromTable(aTab,СтрГруппы,"");

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

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

//Вывод строки итого
...

</pre>

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

Query.CreateFromTable - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=CreateFromTable |object=Запрос базы данных |caption=Создание запрос..."