Admin: 1 revision imported

2021-02-07T06:43:20Z

1 revision imported

Admin at 08:44, 6 June 2020

2020-06-06T08:44:16Z

New page

{{infobox function
|name=LoadPeriodicalValues
|object=[[Объект базы данных]]
|caption=Работа с периодическими реквизитами
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку или дату, неверный реквизит
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция загружает полную или частичную таблицу периодических значений реквизита текущего объекта и возвращает ее в таблице значений. Объект не может быть новым несохраненным объектом для получения такой таблицы. Таблицу можно изменить и записать с помощью функции [[DB.SavePeriodicalValues|SavePeriodicalValues]]. Данная функция также может использоваться с интерфейсом ''DBVar'' для получения таблицы периодических значений переменной БД (в этом случае, наименование переменной указывается в первом аргументе). Таблица содержит следующие столбцы:
* '''_Date''' -- дата значения периодического реквизита.
* '''_Value''' -- значение периодического реквизита на указанную дату

== Синтаксис ==
<code>
{{Grey|DB.[DBVar.]}}'''LoadPeriodicalValues'''(''<Указание на реквизит или наименование DBVar (STRING)>''{{Optional|,<Дата начала чтения периодического реквизита (DATE)>,<Дата окончания чтения периодического реквизита (DATE)>}}):''<Таблица значений реквизита (TAB)>''
</code>

==== Аргументы ====
* <code>''<Указание на реквизит (STRING)>''</code> - Задает наименование реквизита, таблицу периодических реквизитов которого необходимо получить, если реквизит находится в строчной части, указывает также на наименование строчной части и номер строки. Общий формат аргумента: <code>[<Наименование строчной части>.<Номер строки строчной части>.]<Наименование реквизита></code>. Для интерфейса переменных БД, этот аргумент содержит наименование переменной БД.
* <code>''<Дата начала чтения периодического реквизита (DATE)>''</code> - {{Optional}} Аргумент задает дату начала выборки для таблицы значений. Значения ранее этой даты не будут загружены в таблицу. Если этот аргумент опущен, таблица возвращает значения, начиная с самого раннего.
* <code>''<Дата окончания чтения периодического реквизита (DATE)>''</code> - {{Optional}} Аргумент задает дату окончания выборки для таблицы значений. Значения позже этой даты не будут загружены в таблицу. Если этот аргумент опущен, таблица возвращает значения, заканчивая самым поздним.

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

== Примеры ==
<pre>
//Фрагмент устанавливает новое значение периодического реквизита "Цена" элемента зН на дату пДата,
// если значение на эту дату уже не равно аЦена, если до этого момента реквизит не содержал
// значений вообще, фрагмент устанавливает первое значение, начиная с '01.01.1981'.
Таб:=зН.LoadPeriodicalValues("Цена");
if _Or(Таб.Size()=0,Таб.Sum("_VALUE")=0) Then
зН.SetValue("Цена",аЦена,'01.01.1981');
Else
//Уже установлена?
пДата:=BegOfDay(пДата);
зЦ:=аЦена-1;
Таб.Select();
While Таб.Next() Do
If Таб._DATE>пДата Then
Break;
EndIf;
зЦ:=Таб._VALUE;
EndDo;
If зЦ<>Цена Then
зН.SetValue("Цена",аЦена,пДата,пДата);
EndIf;
EndIf;
</pre>

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

DB.LoadPeriodicalValues - Revision history

Admin: 1 revision imported

Admin at 08:44, 6 June 2020