Diese Art von Plugins ermöglicht es, in die Standardlogik aller CAATS-Dienste einzugreifen, und so das Verhalten der Standardfunktionen mit individuellen Programmierungen zu beeinflussen.

Die Standardfunktionen und Einsprungpunkte sind:

1. Abrufen einzelner Datensätze (vor Datenbankzugriff)
2. Abrufen einzelner Datensätze (nach Datenbankzugriff)
3. Abrufen einer Liste von Datensätzen (vor Datenbankzugriff)
4. Abrufen einer Liste von Datensätzen (nach Datenbankzugriff)
5. Neuen Datensatz mit Initialwerten anfordern
6. Anlegen (vor Speicherung)
7. Anlegen (nach Speicherung)
8. Aktualisieren (vor Speicherung)
9. Aktualisieren (nach Speicherung)
10. Löschen (vor Speicherung)

Wird eine dieser Standardfunktionen durch ein Plugin ergänzt, so steht es dem Autor des Plugins frei, die übergebenen Daten zu verwerfen, beizubehalten, abzuändern, oder durch eigene zu ersetzen.

Im Falle des Abrufens einer Liste von Datensätzen (Punkt 3) steht es dem Autor des Plugins außerdem frei, die übergebenen Filter-, Sortierungs- und Gruppierungskriterien vor dem Ausführen des Datenbankzugriffes zu ändern.

Dieses Beispiel ersetzt den Vornamen aller neu angelegten Klienten durch den Vornamen „Franz“. Es dient nur zu Schulungszwecken und sollte nicht in einem Echtsystem eingesetzt werden.

generic_plugin_example.cs

using Grpc.Core;
using System;
using System.Security.Cryptography;
using System.Threading.Tasks;
 
using Caats.Infrastructure.Authorization;
using Caats.Infrastructure.Constants;
using Caats.Infrastructure.Helper;
using Caats.Proto;
 
using Caats.Services.PersonAPI.Infrastructure;
using Caats.Services.PersonAPI.Repositories;
 
namespace Caats.Service.Infrastructure.Extensibility;
 
[PluginServiceDto(typeof(PersonDto))]
public class MyTestCaatsPersonPlugin : PluginBase
{
    private readonly IPersonRepository _repository;
 
    public MyTestCaatsPersonPlugin(IPersonRepository repository)
    {
        _repository = repository;
    }
 
    public override PluginDto Ident() => new() { };
 
    public async override Task<(RequestMsg, ResponseMsg?)> OnBeforeCreate(RequestMsg request, Lazy<IdentityBase> identity, ServerCallContext context)
    {
        var candidate = RequestMsgHelper.GetSingleOrDefault<PersonDto>(request);
 
        candidate.GivenName = "Alle heißen Franz";
 
        var modified = RequestMsgHelper.CreateWithSingle(candidate);
 
        modified.PartitionIndex = request.PartitionIndex;
 
        return (modified, null);
    }
}

Beim Programmieren von standarderweiternden Plugins können - abseits von den Warnungen und Fehlermeldungen des C# Compilers - folgende CAATS-spezifische Fehlercodes vorkommen: