Фонові завдання в платформі

[Lion-killer]

Необхідна документація та/або приклад використання механізму "фонових завдань (код, який викликається згідно з розкладом незалежно від логіну користувача)": https://github.com/alex-kukhtin/A2v10/tree/master/Web/A2v10.Web.Mvc/Quartz

[Lion-killer]

Залишу тут опис функціоналу, який зробив Сергій:

Процедура, на якій я тестував роботу:
create or alter procedure samples.BgTest @PartnerId bigint = null, @Memo nvarchar(32) = null as begin update samples.Partners set Memo = @Memo where Id = @PartnerId; end go

Параметри Quartz в web.config:
<add key="quartz" value="[ {'id':'sql1','dataSource':'Default', 'cron': '0 /15 * * * ?', 'invoke': 'sql', 'procedure': 'samples.BgTest', 'parameters': {'PartnerId': 1, 'Memo': 'TestMemo'} }, {'id':'cmd', 'dataSource':'Default', 'cron': '0 /3 * * * ?', 'invoke': 'commands' } ]" />

В цьому прикладі рядок з 'invoke': 'sql' запускає виконання sql процедури samples.BgTest кожні 15 хвилин із вказаними в parameters параметрами. Розклад задається в параметрі cron, опис формату: https://www.quartz-scheduler.net/documentation/quartz-3.x/tutorial/crontriggers.html#cron-expressions

А рядок з 'invoke': 'commands' запускає виконання команд (в даному прикладі - кожні три хвилини).
Список запланованих команд зберігається в таблиці a2bg.[Commands]. Команда виконується тільки один раз, після виконання встановлюється флаг Complete = 1.

Приклад додавання команди:
`declare @DaTa nvarchar(1024);
set @DaTa = N'{"Procedure": "samples.BgTest", "Parameters": {"PartnerId": 2, Memo: "Test"}}';

insert into a2bg.Commands(Kind, Complete, [Data]) values
(N'ExecuteSql', 0, @DaTa);
`

Така команда виконує вказану процедуру із зазначеними параметрами і буде виконана при першій можливості.

Приклад додавання команди з відкладеним виконанням:
`declare @utcRunAt datetime, @DaTa nvarchar(1024);
set @utcRunAt = '2024-01-29 23:15';
set @DaTa = N'{"Procedure": "samples.BgTest", "Parameters": {"PartnerId": 2, Memo: "TestRunAt"}}';

insert into a2bg.Commands(Kind, Complete, UtcRunAt, [Data]) values
(N'ExecuteSql', 0, @utcRunAt, @DaTa);
`

Така команда буде виконана після настання зазначеного часу (UtcRunAt).

Приклад виклику clr, але як їх робити я не знаю:
declare @data nvarchar(1024); set @data = N'{"clrType": "clr-type:ImportImagesLib.ImageLoaderHandler;assembly=ImportImagesLib"}'; insert into a2bg.Commands(Kind, Complete, [Data]) values (N'InvokeClr', 0, @data);

Ще є команда SendMail для відправки email, але з цим я теж не експериментував. Подивитись параметри можна тут: https://github.com/alex-kukhtin/A2v10/blob/master/Web/A2v10.Web.Mvc/Quartz/Handlers/SendMailHandler.cs