Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
product:triggers:new [24.01.2024 08:52] – [Вызов API в триггерах] Белугин Александрproduct:triggers:new [01.02.2024 11:41] (текущий) – Караваева Яна
Строка 28: Строка 28:
   - Дополнительная логика, прописанная в окне **"Условие"** для последней тонкой фильтрации событий.   - Дополнительная логика, прописанная в окне **"Условие"** для последней тонкой фильтрации событий.
  
-События, которые попали под условия фильтров, запускают написанный скрипт. Результатом работы скрипта могут быть небольшие вычисления, создание новых записей в справочнике, новых объектов, изменение статусов, изменение значений реквизитов, их блокировка и т.д. Здесь мы описали [[product/triggers/lib|примеры готовых решений]] на основе триггеров. +События, которые попали под условия фильтров, запускают написанный скрипт. Результатом работы скрипта могут быть небольшие вычисления, создание новых записей в справочнике, новых объектов, изменение статусов, изменение значений реквизитов, их блокировка и т.д. Здесь мы описали [[product/triggers/library|примеры готовых решений]] на основе триггеров. 
  
 В Системе можно создать [[product:linq:new|источник данных LINQ]] и задать ему референсный ключ, чтобы в дальнейшем по нему вызвать этот источник в **Условии** триггера или в самом **Скрипте**.  В Системе можно создать [[product:linq:new|источник данных LINQ]] и задать ему референсный ключ, чтобы в дальнейшем по нему вызвать этот источник в **Условии** триггера или в самом **Скрипте**. 
Строка 37: Строка 37:
 Перед вызовом API нужно везде указывать ''await'', иначе произойдет инициация кода вызова без ожидания результата. Перед вызовом API нужно везде указывать ''await'', иначе произойдет инициация кода вызова без ожидания результата.
  
-<code csharp | Создание нового объекта - пример> 
  
 +Создание нового объекта - пример: 
 +<code csharp [enable_line_numbers="false", highlight_lines_extra="7", enable_keyword_links="false"]>
 var newItem = new Api.Projects.CreateProjectDataContract var newItem = new Api.Projects.CreateProjectDataContract
 { {
Строка 44: Строка 45:
 }; };
  
 +// create new Item using ADVANTA API
 var  newItemID = await Api.Projects.CreateProjectAsync(newItem); var  newItemID = await Api.Projects.CreateProjectAsync(newItem);
 </code> </code>
Строка 53: Строка 55:
  
 ==== Локальные функции ==== ==== Локальные функции ====
-Если требуется определить локальную функцию / процедуру в скрипте триггера, то ее описание должно быть в формате \\ +Если требуется определить собственную локальную функцию/процедуру для использования в скрипте триггера, то ее описание должно быть сделано с использованием префикса ''async'' в следующем формате \\ 
-''async Task<string> MyFunctionName()'', \\ +<code csharp> 
-где вместо string соответственно указать тип переменной, которого необходимо возвращать из локальной функции.+async Task<string> MyFunctionName() 
 +{ 
 +   // your code ... 
 +   return result; 
 +} 
 +</code> 
 +где вместо ''string'' необходимо указать тип переменной, которая будет возвращаться из локальной функции.
  
  
 +\\
 Если возвращать из функции ничего не требуется, то определение функции будет в формате:\\ Если возвращать из функции ничего не требуется, то определение функции будет в формате:\\
-''async Task MyFunctionName()'' \\+<code csharp> 
 +async Task MyFunctionName() 
 +{ 
 +   // your code ... 
 +} 
 +</code>
 \\ \\
-Для вызова такой функции / процедуры внутри скрипта триггера, также рекомендуется использовать префикс ''await'', для ожидания ее завершения.+Для вызова созданной таким образом локальной функции/процедуры внутри скрипта триггера, рекомендуется использовать префикс ''await'' для ожидания ее завершения. 
 + 
 +<code csharp> 
 +var result = await MyFunctionName(); 
 +</code> 
 +\\ 
 + 
 +Пример объявления локальной функции и ее вызова: 
 +<code csharp> 
 +async Task CreateLog(string Text)  
 +{ 
 +    TriggerConsole.WriteLine(Text); 
 +    await System.Threading.Tasks.Task.Delay(1000); 
 +} 
 + 
 +for(int i = 0; i < 10; i++)  
 +{ 
 +    await CreateLog(i.ToString()); 
 +} 
 +</code>
 ==== Встроенные переменные ==== ==== Встроенные переменные ====