Admin: 1 revision imported

2021-02-07T06:52:13Z

1 revision imported

Admin at 11:29, 30 October 2020

2020-10-30T11:29:51Z

New page

{{infobox function
|name=OnPublish
|object=
|caption=События объектов БД
|type=1
|status=0
|db=0
|location=Любой глобальный модуль
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Предопределенные события]]}}
<p>Событие, вызываемое при попытке [[Студия/Конфигурация данных проекта#Документы|обработать]] открытый для визуального редактирования документ. Параметр ''Разрешить действие'' может запретить обработку, однако сообщения об ошибке выведено не будет. Если же процедура вернет не пустую строку, действие также произведено не будет, а будет создано исключение с описанием, являющимся результатом исполнения функции.</p>
Каждый документ, для которого необходим контроль при записи в накопители (обработка), имеет подобное событие в контейнере метаданных, данное событие, если оно присутствует, будет вызвано до указанного и может содержать общие алгоритмы обработки.

== Синтаксис ==
<code>
'''OnPublish'''(''<Элемент>'',{{ByRef|''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''):<Текст возникшей ошибки (STRING)>
</code>
==== Аргументы ====
* <code>''<Элемент>''</code> - Документ, для которого производится попытка [[Студия/Конфигурация данных проекта#Документы|обработки]].
* <code>''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''</code> - {{ByRef}} При нулевом значении этого аргумента, обработка будет остановлена без вывода текста ошибки.
==== Возвращаемое значение ====
Функция должна возвратить пустое значение (или пустую строку) для того, чтобы разрешить обработку документа. Для создания исключения результат функции должен содержать текст сообщения о причине невозможности выполнения действия.

== Примеры ==
<pre>
Function OnPublish(Док,ByRef флРазрешить)
Result:=1;
If (Док.ФлагОбмена<>0)And(Док.ФлагОбмена<>9) Then
Док.ФлагОбмена:=0;
ElseIf Док.ФлагОбмена=9 Then
Exit "Документы, выгруженные из удаленной базы, не разрешается изменять в данной!";
EndIf;
EndFunction
</pre>

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

OnPublish - Revision history

Admin: 1 revision imported

Admin at 11:29, 30 October 2020