ExecuteFunction - Revision history

Admin: 1 revision imported

2026-04-01T09:58:39Z

1 revision imported

1>Admin at 16:17, 8 January 2026

2026-01-08T16:17:54Z

Admin: 1 revision imported

2021-11-20T17:05:15Z

1 revision imported

1>Admin at 14:15, 27 July 2021

2021-07-27T14:15:15Z

Admin: 1 revision imported

2021-02-07T06:50:41Z

1 revision imported

Admin at 09:01, 10 December 2019

2019-12-10T09:01:30Z

New page

{{infobox function
|name=ExecuteFunction
|object=[[Функции общего назначения]]
|caption=Системные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, исключение внутри функции, неверные параметры вызова
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция инициирует исполнение функции с указанным именем в текущем контексте исполнения с заданными аргументами, способ поиска задается вторым аргументом. Если искомая функция не существует, пропущен обязательный аргумент или заданное количество аргументов слишком велико, будет создано исключение. Функции этой группы могут использоваться в макросах форм для вызова заранее определенных функций-событий. От использования [[Exec]] функции ''DoesFunctionExist'' и ''ExecuteFunction'' отличаются избирательным поиском функций, к примеру, ''Exec'' может исполнить функцию с таким же именем в глобальном модуле, тогда как, возможно, это нежелательно.

== Синтаксис ==
<code>
'''ExecuteFunction'''(''<Имя функции (STRING)>''{{Optional|,<Глубина поиска (INT)>{{Default|{{Eq}}0}}{{ByRef|,<Аргумент 1>,<Аргумент 2>...}}}}):''<Результат исполнения функции>''
</code>
==== Аргументы ====
* <code>''<Имя функции (STRING)>''</code> - Имя функции, которую необходимо исполнить
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
** 0 (по умолчанию) -- выполнять поиск по всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Аргумент ?>''</code> - {{Optional}} {{ByRef}} Аргументы, передаваемые исполняемой функции

==== Возвращаемое значение ====
Возвращает результат исполнения функции.

== Примеры ==
<pre>
//Визуальное событие OnClick в макросе, состоящем из группы кнопок
//Событие вызывает функции в локальном модуле, на форме которого размещен макрос

//Событие в локальном модуле может отменить обработку документа
//флПарам -- параметр, передаваемый в модуль обработки документа, может быть изменен функцией OnBeforeDocumentSaveOrPublish
//ФлТип -- если OnBeforeDocumentSaveOrPublish возвратит 0, обработка будет отменена
// 1 -- обработка будет выполнена
// 2 -- обработку выполнила сама функция OnBeforeDocumentSaveOrPublish, выполнять ее здесь не требуется
флПарам:=0;
ФлТип:=0;
If DoesFunctionExist("OnBeforeDocumentSaveOrPublish",1) Then
ФлТип:=Number(ExecuteFunction("OnBeforeDocumentSaveOrPublish",1,1,флПарам));
If ФлТип=0 Then
Exit;
EndIf;
EndIf;

//Далее следует блок обработки документа
If ФлТип<>2 Then
Try
If aEl.Status()<0 Then //Документ необходимо записать, если он новый
aEl.Save();
EndIf;
if not aEl.Publish(флПарам) Then
Exit;
EndIf;
Except
Message(глПодготовитьОшибкуОбработки(),"!");
Exit;
EndTry;
EndIf;

//Событие в локальном модуле может произвести действия, необходимые после обработки документа
If DoesFunctionExist("OnAfterDocumentSaveOrPublish",1) Then
ExecuteFunction("OnAfterDocumentSaveOrPublish",1,1,флПарам);
EndIf;
</pre>

← Older revision	Revision as of 09:58, 1 April 2026
(No difference)

@@ Line 22: / Line 22: @@
 * <code>''<Имя функции (STRING)>''</code> - Имя функции, которую необходимо исполнить
 * <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
 ** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
 ** 1 -- выполнять поиск только внутри текущего модуля.

← Older revision	Revision as of 17:05, 20 November 2021
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-'''ExecuteFunction'''(''<Имя функции (STRING)>''{{Optional|,<Глубина поиска (INT)>{{Default|{{Eq}}0}}{{ByRef|,<Аргумент 1>,<Аргумент 2>...}}}}):''<Результат исполнения функции>''
+'''ExecuteFunction'''(''<Имя функции (STRING)>''{{Optional|,<Глубина поиска или компилированная функция (INT, COMPILEDFUNCTION)>{{Default|{{Eq}}0}}{{ByRef|,<Аргумент 1>,<Аргумент 2>...}}}}):''<Результат исполнения функции>''
 </code>
 ==== Аргументы ====
 * <code>''<Имя функции (STRING)>''</code> - Имя функции, которую необходимо исполнить
 * <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
-** 0 (по умолчанию) -- выполнять поиск по всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
+** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
 ** 1 -- выполнять поиск только внутри текущего модуля.
 ** 2 -- выполнять поиск только внутри родительского модуля.
 ** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
 * <code>''<Аргумент ?>''</code> - {{Optional}} {{ByRef}} Аргументы, передаваемые исполняемой функции
@@ Line 69: / Line 70: @@
    ExecuteFunction("OnAfterDocumentSaveOrPublish",1,1,флПарам);
 EndIf;
 </pre>

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