Admin: 1 revision imported

2022-08-09T09:44:00Z

1 revision imported

1>Admin: /* Примеры */

2022-07-21T11:06:55Z

‎Примеры

Admin: 1 revision imported

2021-02-07T06:43:21Z

1 revision imported

Admin at 06:38, 17 October 2020

2020-10-17T06:38:46Z

New page

{{infobox function
|name=Publish
|object=[[Объект базы данных]]
|caption=Обработка документа
|type=1
|status=2
|db=2
|exception=Ошибка обработки, ошибка сервера и пр.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция выполняет процедуру обработки документа. Обработка -- условное название процесса изменения состояния документа. Обработанным называется документ, когда он имеет движения в накопителях (документ может иметь движения только в накопителях, закрепленных за ним в Студии), и его [[DB.Status|статус]] больше ''1''. Функция помогает свести совокупность изменений, происходящих при обработке документа в один вызов. При необходимости можно полностью эмулировать поведение этой функции, к примеру, когда необходимо загрузить документ с движениями из внешнего источника. Существует возможность также вызвать заданный в конфигурации обработчик без вызова самой функции (см. [[DB.InvokeEvent|InvokeEvent]]). Функция не может быть вызвана для удаленных документов (имеющих статус 1). Функция последовательно выполняет следующие действия:
* Если для документа указан режим автоматической транзакции, функция инициирует режим транзакции и сохраняет состояние текущего документа во внутреннем буфере.
* Функция производит вызов события ''OnPublish'', если оно задано в структуре метаданных проекта (см. [[Студия/Конфигурация данных проекта|Конфигурация данных проекта]]). Ожидается, что событие произведет проверку корректности и заполненности данных в документе, после чего, либо вернет ошибку (будет вызвано исключение), либо заблокирует нужные накопители и произведет их заполнение на основе информации документа.
* Если для документа указан режим автоматической транзакции, функция проверяет состояние документа. Если он имеет состояние ''изменен'', функция производит вызов события метаданных ''OnSave''. Событие может отменить попытку обработки (будет вызвано исключение).
** Также, если объект открыт для визуального редактирования и он имеет обязательные для заполнения реквизиты, эти реквизиты будут проверены на заполненность, если хотя бы один из них не заполнен, будет вызвано исключение.
** Будет произведена попытка сохранения измененного документа в базе данных (см. функцию [[DB.Save|Save]]).
* Будет установлена пометка обработки документа, если она пока не установлена на данном документе (см. [[DB.PublishedMark|PublishedMark]])
* Будет произведено фиксирование транзакции [[CommitTransaction]]
* Если предусмотрено установками, создается соответствующая запись в таблице журнала регистрации событий. Функция заканчивает работу и возвращает управление вызвавшей программе.
* При наличии исключения на любом из этапов работы функции, если для документа указан режим автоматической транзакции, функция отменяет транзакцию и возвращает предыдущее состояние документа из внутреннего буфера.

== Синтаксис ==
<code>
{{Grey|DB.}}'''Publish'''({{Optional|<Параметр>,<Опция>}})
</code>

==== Аргументы ====
* <code>''<Параметр>'',''<Опция>''</code> - {{Optional}} Два необязательных параметра, которые будут доступны, как переменные ''Param'' и ''Option'' внутри обработчика события ''OnPublish''.

== Примеры ==
<pre>
//Пример производит обработку документа с дополнительным параметром
//Если обработка неудачна, событие ''OnPublish'' вернет текст ошибки, из которого функция Publish создает исключение
//Чтобы отличить ошибку обработки от системных ошибок и ошибок сервера, пример проверяет код ошибки и, если это ошибка обработки,
// оставляет только текст, удаляя из сообщения ошибки лишнюю информацию.
сп:=List.Create();
сп.SetByName("ФорсироватьОбработку",1);
Try
аДок.Publish(сп);
Except
Стр:=PeekError();
If Pos("(80 at",Стр)=1 Then
Стр:=PopError(4);
EndIf;
Стр:=PopError();
Message(Стр,"!");
EndTry;
</pre>

← Older revision	Revision as of 09:44, 9 August 2022
(No difference)

@@ Line 46: / Line 46: @@
    If Pos("(80 at",Стр)=1 Then
      Стр:=PopError(4);
    EndIf;
    Message(Стр,"!");
 EndTry;
 </pre>

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

DB.Publish - Revision history

Admin: 1 revision imported

1>Admin: /* Примеры */

Admin: 1 revision imported

Admin at 06:38, 17 October 2020