TempDB.Select - Revision history

Admin: 1 revision imported

2021-06-28T07:05:21Z

1 revision imported

1>Admin: /* Аргументы */

2021-04-23T08:23:13Z

‎Аргументы

Admin: 1 revision imported

2021-02-07T06:54:39Z

1 revision imported

Admin: Created page with "{{infobox function |name=Select |object=Временная таблица базы данных |caption=Выборка из временных таблиц |type=1 |statu..."

2019-11-18T09:40:39Z

Created page with "{{infobox function |name=Select |object=Временная таблица базы данных |caption=Выборка из временных таблиц |type=1 |statu..."

New page

{{infobox function
|name=Select
|object=[[Временная таблица базы данных]]
|caption=Выборка из временных таблиц
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, неверные аргументы, ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Временная таблица базы данных]]}}
Функция открывает выборку записей из временной таблицы базы данных. К выборке применяется заданный фильтр, записи сортируются в соответствии с заданным направлением сортировки. Для продолжения выборки применяют функцию [[TempDB.Next|Next]]. При сортировке объектов базы данных нужно учитывать, что сортировка на сервере осуществляется только по внутреннему коду базы данных, а не по реквизиту сортировки объекта. Чтобы осуществить сортировку по требуемому реквизиту сортировки (к примеру, по наименованию или по дате документа), необходимо добавить столбец в таблицу и заполнить его значением требуемого реквизита и осуществлять сортировку по новому столбцу. Пример: в столбце ''Ном'' хранятся элементы справочника ''Номенклатура'', по реквизиту ''Name'' которых нужно осуществлять сортировку при выборке записей таблицы. Добавим и заполним столбец ''Name'' в таблице, чтобы осуществлять сортировку по нему <code>aTemp.AddColumns("Name->Ref.Номенклатура.Name");aTemp.Update("Ref.Номенклатура:Ном","Name->Name");aTemp.Select("Name");...</code>.

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

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

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

== Примеры ==
<pre>
//Пример показывает рабочий цикл с объектами из временной таблицы, используя сборщик объектов для уменьшения расхода памяти
//MainTab -- визуальная таблица, в которую будут копироваться результаты обработки временной таблицы БД

//Создание сборщика объектов
ObjC:=ObjectCollector.Create();

MainTab.Lock();
Try
//Очистка визуальной таблицы
MainTab.ClearLines();

//Создание и загрузка сложной временной таблицы БД, детали загрузки не имеют особого значения для нашего примера
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зВып:DB,зДата:DATE,зНомерСтроки:NUMBER.10,Номенклатура:DB,Смена:DB,Работники:STRING.200,Количество:NUMBER.15.5");
аТемп.LoadFrom("Doc.РегистрацияВыпускаПродукции.Содержание","@HEADER->зДок,@HEADER.DocDate->зДата,@HEADER.ВыпускПродукции->зВып,@HEADER.ВыпускПродукции..Doc.ВыпускПродукции.ДокОснование->зЗад,"+
"@LINE->зНомерСтроки,Материал->Номенклатура,КоличествоОпераций->Количество,Работники->Работники,Смена->Смена",
"ТипЗаписи=1","not isEmpty(@HEADER.ВыпускПродукции)","IsType(@HEADER.ВыпускПродукции,Doc.ВыпускПродукции)");

Всего:=аТемп.Size();
aNum:=0;
аТемп.Select("зВып+,зДата+,зДок+,зНомерСтроки+");
While аТемп.Next() Do
aNum:=aNum+1;
If aNum%20=0 Then
Form.StatusText("Обработано строк: "+aNum+" из "+Всего);
EndIf;
зНом:=ObjC.Get(аТемп.Номенклатура);
зЗад:=ObjC.Get(аТемп.зЗад);
зВып:=ObjC.Get(аТемп.зВып);
зДок:=ObjC.Get(аТемп.зДок);
MainTab.AddLine("Документ,Номенклатура,Ед,Количество,Смена,зДок,НомСтр,зВып,зЗад,Работники,Индекс",зЗад.DocNum+" от "+зЗад.DocDate,зНом,ObjC.Get(зНом.базЕдиница),аТемп.Количество,
ObjC.Get(аТемп.Смена),зДок,аТемп.зНомерСтроки,зВып,зЗад,ПолучитьСписокРаботников(Trim(аТемп.Работники),ТРаботники),зДок.DocNum+"@"+зДок.DocDate+"@"+аТемп.зНомерСтроки);
EndDo;
MassLoadObjects(MainTab);
Finally
MainTab.Unlock();
EndTry;
Form.MainTab.SetFocus();
</pre>

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

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

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