Cílem plánovaných úloh je provádění automatických operací bez interakce uživatele.

GrillBot má aktuálně integrovány následující plánované úlohy:

• Archivace a mazání starých záznamů z audit logu (každé 2 dny).
• Upozorňování na narozeniny uživatele (každý den v 8:00).
• Údržba cache zpráv v paměti (každých 5 minut).
• Údržba informace o přihlášených uživatelích do webových administrací (každých 15 minut).
• Rozesílání upozornění (Reminder) v termínu (každých 5 minut).
• Vrácení přístupu po skončení unverify/selfunverify (každých 30 vteřin).
• Údržba cache databáze (každých 5 minut)
• Slučování transakcí bodů (každé 2 hodiny)
• Archivace a mazání starých záznamů z unverify logu (každé 2 dny)

Kromě výše uvedených časů se úlohy, které nejsou definovány pomocí cron expression, spouští ještě při startu aplikace. Tyto úlohy se nastavují v konfiguračním souboru (appsettings.json).

Vytvoření nové naplánované úlohy

• Je třeba nadefinovat v konfiguračním souboru appsettings.json, jak často (nebo kdy) se má úloha spouštět. Je možné zadat hodnotu ve formátu pro objekt typu TimeSpan, nebo jako cron expression specifický přímo pro Quartz.NET. Cron examples.
• Implementovat příslušnou úlohu. Viz kód níže:

using Quartz;
using GrillBot.Infrastructure.Jobs;

[DisallowConcurrentExecution]
public class YourJob : Job
{
    public YourJob(IServiceProvider provider) : base(provider)
    {
    }

    public override async Task RunAsync(IJobExecutionContext context)
    {
        // Your implementation
    }
}

Doporučuje se na úlohy atribut DisallowConcurrentExecution, aby nedošlo k paralelnímu spuštění jedné úlohy. Pokud chcete, aby úloha nebyla spuštěna, než dojde ke kompletní inicializaci bota, tak stačí nastavit na třídu úlohy atribut DisallowUninitialized. Do úlohy je možné vkládat závislosti pomocí konstruktoru z DI kontejneru. Již je tak třeba naimportovat služby pro základní chod úlohy.

• Nakonec je třeba úlohu registrovat v souboru Startup.cs V tomto souboru nalezněte volání funkce AddQuartz(...). Do této funkce po vzoru ostatních úloh doplňte odkaz na úlohu. Přepis funkce je q.AddTriggeredJob(Configuration, "Your:Path:To:Time:Configuration", bool). Pokud chcete ve vaší funkci použít cron expressions, tak jako poslední parametr zadejte hodnotu true, jinak false.