TempDB.Unload - Revision history

Admin: 1 revision imported

2021-06-28T07:05:21Z

1 revision imported

1>Admin: /* Синтаксис */

2021-04-23T08:22:53Z

‎Синтаксис

Admin: 1 revision imported

2021-02-07T06:54:42Z

1 revision imported

Admin at 09:16, 18 November 2019

2019-11-18T09:16:13Z

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Unload'''({{ByRef|''<Объект в который происходит копирование>''}}{{Optional|,<Наименования столбцов для копирования (STRING)>,<Стандартные фильтры>...}})
</code>

==== Аргументы ====
* <code>''<Объект в который происходит копирование>''</code> - {{ByRef}} Объект данных, в который будет произведена выгрузка записей временной таблицы базы данных. На данный момент принимаются объекты:
** '''Список значений'''. Во втором аргументе необходимо указать наименование одного столбца таблицы, данные из которого будут добавлены с список значений.
** '''Таблица значений'''. Если второй аргумент не задан, будут загружены все столбцы временной таблицы, иначе будут загружены столбцы, наименования которых перечислены во втором аргументе через запятые. При указании на наименования столбцов, имеется возможность использовать специальное имя '''@ID''', это имя позволяет получить также цифровой идентификатор записи временной таблицы (каждая запись временной таблицы пронумерована). Если загружаемые столбцы отсутствовали в заполняемой таблице значений, они будут созданы.
* <code>''<Наименования столбцов для копирования (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов таблицы для загрузки, разделенные запятыми. См. описание предыдущего аргумента.
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры отбора записей временной таблицы описаны в статье [[Стандартные фильтры]]. Важное отличие от фильтров функций объектов базы данных заключается в том, стандартные фильтры всегда работают в сложном (расширенном) режиме, при этом отсутствует требование, что первая строка фильтра должна начинаться на знак '''~'''. Выражения фильтров содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]), при указании наименование также применимы префиксы (типа ''':'''), как это описано в [[Временная таблица базы данных#Формулы при вычислении полей записей временной таблицы базы данных|статье по временной таблице базы данных]].

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами документа ЗаказНаПроизводство, при этом в ней также заполнено поле документа ВыпускПродукции.
// Документ ВыпускПродукции подчинен документу ЗаказНаПроизводство. Выборка документов происходит за период с НачДата по КонДата.
//Таблица номенклатуры из резервов с выпусками и заданиями
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5");
//Заказы на производство
аТемп.LoadFrom("Stor.Резервы","@LINK->зЗад,Номенклатура->зН,?(@EXPENSE=1,-Количество,Количество)->Количество",
"(BegOfDay(@DATE)>=НачДата)And(BegOfDay(@DATE)<=КонДата)","IsType(@LINK,Doc.ЗаказНаПроизводство)");
//Заполняем зДок (подчиненный документ -- ВыпускПродукции)
вТемп:=TempDB.Create("зДок2:DB,зЗад:DB");
//Выбираются только те документы выпусков, основания которых (ЗаказНаПроизводство) находятся в таблице аТемп
вТемп.LoadFrom("Doc.ВыпускПродукции","@ELEMENT->зДок2,@ELEMENT.ДокОснование->зЗад","@ELEMENT.ДокОснование IN аТемп.зЗад");
//Заполним столбец зДок оригинальной таблицы, объединение происходит по условию ":зЗад=зЗад".
аТемп.Update(вТемп,":зЗад=зЗад,зДок2->зДок");
//Выгрузим созданную таблицы в новую таблицу значений
aTab:=Tab.Create();
аТемп.CopyTo(aTab);
//В дальнейшем таблицу aTab можно, к примеру, вывести на экран.
</pre>

← Older revision	Revision as of 07:05, 28 June 2021
(No difference)

@@ Line 25: / Line 25: @@
 ** '''Таблица значений'''. Если второй аргумент не задан, будут загружены все столбцы временной таблицы, иначе будут загружены столбцы, наименования которых перечислены во втором аргументе через запятые. При указании на наименования столбцов, имеется возможность использовать специальное имя '''@ID''', это имя позволяет получить также цифровой идентификатор записи временной таблицы (каждая запись временной таблицы пронумерована). Если загружаемые столбцы отсутствовали в заполняемой таблице значений, они будут созданы.
 * <code>''<Наименования столбцов для копирования (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов таблицы для загрузки, разделенные запятыми. См. описание предыдущего аргумента.
-* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры отбора записей временной таблицы описаны в статье [[Стандартные фильтры]]. Важное отличие от фильтров функций объектов базы данных заключается в том, стандартные фильтры всегда работают в сложном (расширенном) режиме, при этом отсутствует требование, что первая строка фильтра должна начинаться на знак '''~'''. Выражения фильтров содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]), при указании наименование также применимы префиксы (типа ''':'''), как это описано в [[Временная таблица базы данных#Формулы при вычислении полей записей временной таблицы базы данных|статье по временной таблице базы данных]].
+* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры отбора записей временной таблицы описаны в статье [[Стандартные фильтры]]. Важное отличие от фильтров функций объектов базы данных заключается в том, что стандартные фильтры всегда работают в сложном (расширенном) режиме, при этом отсутствует требование, что первая строка фильтра должна начинаться на знак '''~'''. Выражения фильтров содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]), при указании наименование также применимы префиксы (типа ''':'''), как это описано в [[Временная таблица базы данных#Формулы при вычислении полей записей временной таблицы базы данных|статье по временной таблице базы данных]].
 == Примеры ==

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