Admin: 1 revision imported

2021-02-07T06:43:22Z

1 revision imported

Admin at 14:58, 28 September 2019

2019-09-28T14:58:28Z

New page

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

== Синтаксис ==
<code>
{{Grey|DB.}}'''SaveStorage'''(''<Наименования накопителя (STRING)>'',''<Содержимое накопителя текущего документа (TAB)>''{{Optional|,<Установить дату записей (DATE)>}})
</code>

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

== Примеры ==
<pre>
//Пример для документа аДок, который обрабатывает документ вне стандартного события обработки документа.
//Пример демонстрирует алгоритм, описанный выше.
//Созданные заранее таблицы с накопителями документа содержатся в списке спНакопители
//Данный пример больше подходит для загрузки документов вместе с движения из внешнего источника, так как нет блока проверки корректности данных

//Флаг успешной транзакции
ФлОк:=0;
BeginTransaction();
Try
//Бесконечный цикл ожидания блокировки накопителей документа
While 0=0 Do
Try
аДок.ClearStorages();
Except
RollbackTransaction();
Sleep(100);
BeginTransaction();
Continue;
EndTry;
Break;
EndDo;
//Установка пометки обработки
аДок.PublishedMark(1);

//Запись движений в накопители
For i:=1 To спНакопители.Size() Do
aTab:=спНакопители.Get(i);
ИмяНак:=спНакопители.GetName(i);
If aTab.Size()>0 Then
аДок.SaveStorage(ИмяНак,aTab,аДок.DocDate);
EndIf;
EndDo;

//Сохранение документа
аДок.Save();
//Транзакция успешна
ФлОк:=1;
Finally
If ФлОк Then
CommitTransaction();
Else
RollbackTransaction();
EndIf;
EndTry;
</pre>

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

DB.SaveStorage - Revision history

Admin: 1 revision imported

Admin at 14:58, 28 September 2019