Shaunebu.Bussiness.ReportGenerator.Scheduler 1.0.0

Shaunebu.Bussiness.ReportGenerator.Scheduler

Automate report generation with Cron expressions & background scheduling

This package enables automatic report execution using:

• ⏰ Cron expressions (0 9 * * *)

• 🔁 Interval recurrence

• 📌 Manual triggers

• 🧠 Persistent scheduler registry

• 🧩 Full integration with Shaunebu.Bussiness.ReportGenerator

It works seamlessly inside:

• ASP.NET Core

• Worker Services

• Console apps

• Background services

🚀 Features

⏰ Flexible Scheduling

• Cron-based (0 0 * * MON-FRI)

• Fixed intervals (Every 15 minutes)

• Daily/weekly/monthly jobs

• Tenant-aware execution

🧩 Report Pipeline Integration

You can schedule:

• PDF reports

• HTML, Word, Excel, Markdown

• Any DataSource

• Any Exporter (email, cloud, REST)

📝 Register Jobs at Startup

services.AddShaunebuScheduler();

🔧 Configuration (Optional)

Add in appsettings.json:

{
  "ReportScheduler": {
    "Jobs": [
      {
        "ReportId": "DailyInvoice",
        "Cron": "0 8 * * *",
        "Tenant": "contoso"
      }
    ]
  }
}

📥 Installation

dotnet add package Shaunebu.Bussiness.ReportGenerator.Scheduler

🧪 Example — Schedule a Daily Report

var scheduler = provider.GetRequiredService<IReportSchedulerService>();

await scheduler.ScheduleReportAsync(
    reportId: "DailyInvoiceReport",
    cronExpression: "0 9 * * *"
);

📌 Trigger Manually

await scheduler.TriggerNowAsync("DailyInvoiceReport");

🗂️ List All Scheduled Jobs

foreach (var job in scheduler.GetScheduledReports())
{
    Console.WriteLine($"{job.ReportId} → {job.CronExpression} | Next: {job.NextRun}");
}

🔁 Example: Interval Schedule (Every 10 minutes)

await scheduler.ScheduleIntervalAsync("QuickSales", TimeSpan.FromMinutes(10));

🔐 Secure & Tenant-Aware

Jobs can target a tenant:

await scheduler.ScheduleReportAsync(
    "TenantAReport",
    "0 */2 * * *",
    tenantId: "tenant-a"
);

🧠 How It Works

The scheduler:

1. Loads registered jobs

2. Evaluates cron expressions

3. Fires the ReportBuilder pipeline

4. Logs audit & telemetry automatically

5. Supports concurrent executions

6. Handles failures & retries

💡 Typical Use Cases

• Daily invoice reports

• HR weekly summaries

• Automated Excel data exports

• REST/webhook reports

• Monthly financial PDFs

• Daily cloud backups of data snapshots

🧩 Integration with ReportGenerator

var result = await factory.Create()
    .WithName("DailySales")
    .FromSql("SELECT * FROM Sales WHERE Date = Today")
    .ToPdf()
    .ExportAsync();

Then schedule it:

await scheduler.ScheduleReportAsync("DailySales", "0 7 * * *");