Erweiterte Konfiguration

WorkerSettings

Einstellung	Standard	Beschreibung
`WorkerId`	Zufällige GUID	Eindeutige Kennung des Workers
`MaxParallelWorkerCount`	`10`	Maximale gleichzeitige Task-Verarbeitung
`LongPollingDuration`	`60s`	Wie lange die Engine den Fetch-Request hält
`LockDuration`	`30s`	Initiale Sperrdauer pro Task
`IdleBetweenFetchesDuration`	`0s`	Pause zwischen Fetch-Zyklen
`BackOffMaximumDuration`	`30s`	Maximale Backoff-Wartezeit bei Fehlern
`MaxExpectedFetchCycleDuration`	`null`	Health-Check-Schwellwert (optional)
`PayloadFilter`	`null`	Regex-Filter auf den Task-Payload

Plattform-Konfiguration (Hosting-Extension)

Die Hosting-Extension erlaubt globale Defaults und topic-spezifische Overrides:


hostBuilder.UseExternalTaskWorkers((context, options) =>
{
    options.ConfigureWorkers(settings =>
    {
        settings.IsEnabled = true;
        settings.CorrelationIdHeaderName = "X-Correlation-ID";
        settings.InitialIdentityRetrievalTimeout = TimeSpan.FromSeconds(30);
 
        // Globale Defaults für alle Worker
        settings.Default.MaxParallelWorkerCount = 20;
        settings.Default.LockDuration = TimeSpan.FromSeconds(60);
 
        // Topic-spezifische Overrides
        settings.Overrides["LanglaeufigerImport"] = new()
        {
            MaxParallelWorkerCount = 2,
            LockDuration = TimeSpan.FromMinutes(5)
        };
    });
});

JSON-Konfiguration


{
  "ProcessCubeEngine": {
    "Url": "http://localhost:56000",
    "IsEnabled": true,
    "Default": {
      "MaxParallelWorkerCount": 10,
      "LockDuration": "00:00:30",
      "LongPollingDuration": "00:01:00"
    }
  }
}

Schnellkonfiguration für lokale Entwicklung


options.ConfigureForStudio(); // Konfiguriert für localhost:56000

Nächste Schritte

External Task Workers — Worker-Architektur und Konzepte
Authentifizierung — OAuth 2.0 und Identitätssystem