Admin: 1 revision imported

2021-02-07T06:43:22Z

1 revision imported

Admin at 08:44, 6 June 2020

2020-06-06T08:44:17Z

New page

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

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

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

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

== Примеры ==
<pre>
//Фрагмент загружает таблицу периодического реквизита "Цена" элемента зН из строки СтрЗначения, где значения и даты разделены знаком "@"
// Значения сохраняются начиная с даты ДНач, если она задана, иначе с '01.01.1981'.
СпЗначения:=Tab.Create("_Date,_Value");
While СтрЗначения<>"" Do
пДт:=Date(TearStr(СтрЗначения,"@"));
пЗн:=Trim(TearStr(СтрЗначения,"@"));
СпЗначения.AddLine("_Date,_Value",пДт,пЗн);
EndDo;
СпЗначения.Sort("_Date+");
ДНач:=?(isEmpty(ДНач),'01.01.1981',ДНач);
зН.SavePeriodicalValues("Цена",СпЗначения,ДНач);
</pre>

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

DB.SavePeriodicalValues - Revision history

Admin: 1 revision imported

Admin at 08:44, 6 June 2020