DB.UseOption - Revision history

Admin: 1 revision imported

2025-01-22T06:51:18Z

1 revision imported

1>Admin at 06:53, 22 December 2024

2024-12-22T06:53:34Z

Admin: 1 revision imported

2021-02-07T06:43:24Z

1 revision imported

Admin at 09:50, 20 September 2019

2019-09-20T09:50:45Z

New page

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

== Синтаксис ==
<code>
{{Grey|DB.}}'''UseOption'''(''<Наименование установки (STRING)>''{{Optional|,<Значение установки>}}):''<Текущее значение установки>''
</code>

==== Аргументы ====
* <code>''<Наименование установки (STRING)>''</code> - Задает наименование режима, который нужно прочитать или изменить. Доступы следующие значения:
** '''LinePartsLoading''', '''LineParts''' или '''Opt1''' - загрузка все строчных частей объекта в момент его позиционирования и загрузки такими функциями, как [[DB.Find|Find]] или [[DB.Select|Select]]. Возможные значения: '''0''' -- не загружать (по умолчанию), '''1''' -- загружать.
** '''PeriodicalPropertiesLoading''', '''PeriodicalProperties''' или '''Opt2''' - загрузка периодических реквизитов объекта в момент его позиционирования и загрузки такими функциями, как [[DB.Find|Find]] или [[DB.Select|Select]]. Возможные значения: '''0''' -- не загружать (по умолчанию), '''1''' -- загружать. Значения будут загружаться на дату, которую можно изменить или получить функциями [[DB.UseDate|UseDate]] или [[DB.EndPeriodDate|EndPeriodDate]].
* <code>''<Значение установки>''</code> - {{Optional}} При наличии этого аргумента, функция изменяет режим загрузки объекта, иначе происходит только чтение режима. Значение параметра зависит от устанавливаемого (получаемого) режима.

==== Возвращаемое значение ====
Возвращается указанный текущий режим загрузки.

== Примеры ==
<pre>
//Пример обработчика визуального события OnBeforeLoadElements, который подставляет особую таблицу загрузки
// при выводе элементов таблицы простого справочника в случае, когда ограничения для текущего пользователя не
// позволяют ему видеть все элементы.
//Элементы справочника содержат периодические реквизиты, которые необходимо отразить в таблице, поэтому, нам необходимо
// загружать их совместно с остальными реквизитами.
Стр:=Trim(Пользователь.ЗапрещенныеТипыЦен);
If Стр="" Then
//Выполнить загрузку по умолчанию, если ограничений нет.
Exit 0;
EndIf;

aEl:=Ref.цЦены;
//Сортировка совпадает с визуальной
aEl.UseOrder(Form.MainTab.SortString);
//Загружать периодические реквизиты
aEl.UseOption("PeriodicalPropertiesLoading",1);
//Произведем загрузку в список
aList:=aEl.Load(0,"@Parent,@Status",Form.MainTab.ParentElement,0);

//Создадим список цен (bList) только с разрешенными типами цен
bList:=List.Create();
For i:=1 to aList.Size() Do
Эл:=aList.Get(i);
Код:=Trim(Эл.ТипЦен.Code)+"@";
If Pos(Код,Стр1)>0 Then
Continue;
EndIf;
bList.Add(Эл);
Enddo;

//Копирует результат в основную таблицу в скрытое поле "элемент", остальные поля система заполнит самостоятельно
bList.CopyTo(Form.MainTab.Value,1,bList.Size(),"@ELEMENT");
//Признак: таблица уже загружена
Result:=1;
</pre>

← Older revision	Revision as of 06:51, 22 January 2025
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Объект базы данных]]}}
-Функция получает или устанавливает значение дополнительных режимов загрузки текущего объекта базы данных. Доступны такие режимы, как загрузка периодических реквизитов и загрузка строчных частей. При создании объекта, все режимы устанавливаются на значения по умолчанию, после изменения режимов, они сохраняются для данного объекта до его удаления из системы.
+Функция получает или устанавливает значение дополнительных режимов загрузки или работы текущего объекта базы данных. Доступны такие режимы, как загрузка периодических реквизитов, загрузка строчных частей и ограничения количества запрашиваемых за один раз элементов при выборке. При создании объекта, все режимы устанавливаются на значения по умолчанию, после изменения режимов, они сохраняются для данного объекта до его удаления из системы.
 == Синтаксис ==
@@ Line 24: / Line 24: @@
 ** '''LinePartsLoading''', '''LineParts''' или '''Opt1''' - загрузка все строчных частей объекта в момент его позиционирования и загрузки такими функциями, как [[DB.Find|Find]] или [[DB.Select|Select]]. Возможные значения: '''0''' -- не загружать (по умолчанию), '''1''' -- загружать.
 ** '''PeriodicalPropertiesLoading''', '''PeriodicalProperties''' или '''Opt2''' - загрузка периодических реквизитов объекта в момент его позиционирования и загрузки такими функциями, как [[DB.Find|Find]] или [[DB.Select|Select]]. Возможные значения: '''0''' -- не загружать (по умолчанию), '''1''' -- загружать. Значения будут загружаться на дату, которую можно изменить или получить функциями [[DB.UseDate|UseDate]] или [[DB.EndPeriodDate|EndPeriodDate]].
 * <code>''<Значение установки>''</code> - {{Optional}} При наличии этого аргумента, функция изменяет режим загрузки объекта, иначе происходит только чтение режима. Значение параметра зависит от устанавливаемого (получаемого) режима.
 ==== Возвращаемое значение ====
-Возвращается указанный текущий режим загрузки.
+Возвращается указанный текущий режим (значение режима) загрузки или работы.
 == Примеры ==

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