Admin: 1 revision imported

2021-02-07T06:43:22Z

1 revision imported

Admin: Created page with "{{infobox function |name=SelectEx |object=Объект базы данных |caption=Выборка объектов |type=1 |status=2 |db=2 |exception=Ошибка в ф..."

2019-09-23T09:54:23Z

Created page with "{{infobox function |name=SelectEx |object=Объект базы данных |caption=Выборка объектов |type=1 |status=2 |db=2 |exception=Ошибка в ф..."

New page

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

== Синтаксис ==
<code>
{{Grey|DB.}}'''SelectEx'''({{Optional|<Режим загрузки (INT)>{{Default|{{Eq}}0}},<Доп. реквизиты при загрузке заголовков (STRING)>{{Default|{{Eq}}""}},<Стандарные фильтры>...}}):''<В выборке есть по крайней мере один элемент (INT)>''
</code>

==== Аргументы ====
* <code>''<Режим загрузки (INT)>''</code> - {{Optional}} Определяет способ (полноту) загрузки объектов выборки (см. [[Объект базы данных]]). Аргумент может принимать следующие значения:
** '''0''' (по умолчанию) -- производится полная загрузка объектов выборки.
** '''1''' -- производится выборка объектов в режиме только заголовка.
** '''2''' -- производится выборка объектов в режиме частичной загрузки. Второй аргумент используется, как список реквизитов для загрузки.
** '''3''' -- объекты будут позиционированы, но не будут загружены.
* <code>''<Доп. реквизиты при загрузке заголовков (STRING)>''</code> - {{Optional}} Список наименований дополнительных реквизитов при выборке объектов в режиме частичной загрузки (2).
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры позиционирования описаны в статье [[Стандартные фильтры]].

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

== Примеры ==
<pre>
//Пример из функции Select, с более быстрой выборкой за счет запроса в режиме частичной загрузки
//Пример производит выборку по подчиненному справочнику ЛицензииКонтрагентов, чтобы найти самую свежую лицензию из диапазона дат НачДата..КонДата.
аДата:=0;
аЭл:=Ref.ЛицензииКонтрагентов;
//Выбрать не удаленные элементы подчиненные элементу зК, запрос будет содержать только перечисленные реквизиты
// для справочников с большим количеством реквизитов это сильно ускоряет запрос и выборку
аЭл.SelectEx(2,"ТипЛицензии,ДатаВыдачиЛицензии,ДатаНачалаДействияЛицензии,ДатаОкончанияДействияЛицензии","@Parent,@Status",зК,0);
аРез:=0;
While аЭл.Next() Do
If (аЭл.ТипЛицензии<>Enum.ТипыЛицензий.АлкогольнаяРозничная)And(аЭл.ТипЛицензии<>Enum.ТипыЛицензий.АлкогольнаяОптовая) Then
Continue;
EndIf;

If (аЭл.ДатаВыдачиЛицензии<=КонДата)And(аЭл.ДатаНачалаДействияЛицензии<=КонДата)And(аЭл.ДатаОкончанияДействияЛицензии>=НачДата) Then
If _Or(аДата=0,аДата<аЭл.ДатаОкончанияДействияЛицензии) Then
аДата:=аЭл.ДатаОкончанияДействияЛицензии;
//ВАЖНО: результат должен быть копией текущего объекта аЭл,
// так как иначе он будет изменен в момент, когда текущий объект аЭл будет загружен заново при выполнении аЭл.Next()
аРез:=аЭл.Copy();
EndIf;
EndIf;
EndDo;
</pre>

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

DB.SelectEx - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=SelectEx |object=Объект базы данных |caption=Выборка объектов |type=1 |status=2 |db=2 |exception=Ошибка в ф..."