Dataverse plug-in
Konzept
Benutzerdefinierter serverseitiger Code, der in der Dataverse-Ereignispipeline registriert ist und ausgeführt wird, wenn Datenoperationen stattfinden. In Dynamics 365 wird er für transaktionale Validierungen und Berechnungen verwendet.
Ebenfalls besprochen
In Folgen zu Dataverse plug-in geht es auch um Saga pattern, Transactional outbox pattern, Database normalization, Dataverse business skills, Dataverse business units und PSDataverse.
Beschreibung
Ein Dataverse-Plug-in ist ein benutzerdefinierter Ereignishandler, der während der Verarbeitung einer Datenoperation in Microsoft Dataverse auf ein bestimmtes Ereignis reagiert. Es wird als Klasse in einer .NET-Framework-Assembly geschrieben, und diese Assembly wird anschließend in Dataverse registriert. Eine Assembly kann mehrere Klassen enthalten, von denen jede einem anderen Schritt des Ereignisframeworks zugeordnet wird. In Dynamics 365 werden Plug-ins für serverseitige Logik eingesetzt, etwa für transaktionale Validierungen und Berechnungen, die ausgeführt werden müssen, wenn Daten erstellt, aktualisiert oder anderweitig verarbeitet werden.
Jede Plug-in-Klasse implementiert die Schnittstelle IPlugin, die eine einzige Methode Execute definiert. Wenn das registrierte Ereignis eintritt, ruft Dataverse diese Methode auf und übergibt Kontextdaten zur verarbeiteten Operation. Der Code kann danach die laufende Pipeline-Operation abbrechen, die verarbeiteten Geschäftsdaten ändern, weitere Datenoperationen auslösen, externe Systeme kontaktieren oder Informationen an nachfolgende Plug-ins in derselben Pipeline weitergeben. Plug-ins können synchron ausgeführt werden, wobei die Operation auf deren Abschluss wartet, oder asynchron nach Abschluss der Operation.
Die Wahl zwischen diesen Modi ist in der Praxis wichtig. Logik, die das Speichern fehlerhafter Daten verhindern muss, gehört in den synchronen Teil der Pipeline, während Arbeiten, die nach dem Speichern erfolgen können, asynchron ausgeführt werden können. Microsoft Learn weist darauf hin, dass synchrone Plug-ins schnell laufen müssen und die Ausführung einer harten Zeitbegrenzung unterliegt. Schlecht geschriebener Code kann zudem die Leistung beeinträchtigen, und die Entwicklung von Plug-ins erfordert Entwicklerkenntnisse. Dadurch entstehen Kosten, die deklarative Optionen nicht verursachen.
Wegen dieser Nachteile empfiehlt die Microsoft-Dokumentation, zunächst deklarative Optionen zu prüfen. Zu den genannten Alternativen gehören benutzerdefinierte Aktionen, berechnete und Rollup-Spalten, Webhooks und Power Automate. Ein Plug-in ist dann das geeignete Werkzeug, wenn diese Optionen die Anforderung nicht abdecken, etwa wenn die Logik innerhalb der Transaktion selbst durchgesetzt werden muss.
Die M365.FM-Folge "Customize Dataverse for Complex Business Apps" ordnet das Dataverse-Plug-in in eine Entscheidungsmatrix für Geschäftsregeln ein. Laut der Folge verlaufen die Fragen etwa so: Muss eine Regel fehlerhafte Daten blockieren, verwendet man synchrone serverseitige Logik. Kann sie nach dem Speichern laufen, verwendet man asynchrone serverseitige Logik. Für appübergreifende Nachrichten oder Genehmigungen nutzt man Flow oder Teams, und für aufwendige Berechnungen oder komplexe Verknüpfungen ein Dataverse-Plug-in oder einen Dataflow. Die Folge empfiehlt außerdem einen Regelkatalog, der für jede Regel Tabelle, Auslöser, Bedingung, Aktion und Verantwortlichen festhält, und rät dazu, für deterministische Berechnungen und Summen über verknüpfte Datensätze berechnete und Rollup-Felder zu verwenden, statt Code zu schreiben.
Die Folge "Why Power Platform Is Your Real Automation Layer — Not Custom Code" betrachtet dasselbe Thema aus der Perspektive der Anpassungshistorie. Sie beschreibt das traditionelle Dynamics-Modell, in dem jeder Unterschied zwischen der Standardanwendung und dem Geschäftsprozess zu einer weiteren Anpassung wird: ein Dataverse-Plug-in, an ein Formular angehängtes JavaScript, eine benutzerdefinierte Workflow-Aktivität, ein geplanter Job oder ein weiterer Integrationsdienst. Die Folge stellt fest, dass jede Funktion für sich korrekt funktionieren mag, der gesamte Prozess aber nach und nach auf Assemblies, Skripte, Workflows, APIs, Konfigurationswerte und Spezialwissen verteilt wird. Dadurch versteht der Prozessverantwortliche die Richtlinie, kann aber nicht nachvollziehen, wie sie umgesetzt ist. Das ist das wichtigste Argument dafür, Plug-ins als bewusste Entscheidung zu behandeln und nicht als Standardreaktion auf jede Prozessänderung.
Überblick, mit KI aus M365.FM-Folgen und den Fakten dieser Seite zusammengestellt. Du kannst ihn unten über „Bearbeiten“ verbessern.
| Typ | Konzept |
|---|
Häufige Fragen
Mit KI markierte Fragen wurden mit KI aus den Fakten dieser Seite geschrieben.
Was ist ein Dataverse-Plug-in? (KI)
Ein Dataverse-Plug-in ist ein benutzerdefinierter Ereignishandler, der als Klasse in einer .NET-Framework-Assembly geschrieben und in Dataverse registriert wird und während einer Datenoperation auf ein bestimmtes Ereignis reagiert. Jede Klasse implementiert die Schnittstelle IPlugin mit einer einzigen Methode Execute.
Kann ein Dataverse-Plug-in synchron und asynchron ausgeführt werden? (KI)
Ja. Plug-ins können synchron ausgeführt werden, sodass die Operation auf sie wartet, oder asynchron nach Abschluss der Operation. Microsoft Learn weist darauf hin, dass synchrone Plug-ins schnell laufen müssen und die Ausführung einer harten Zeitbegrenzung unterliegt.
Wann sollte ein Dataverse-Plug-in anstelle anderer Optionen verwendet werden? (KI)
Microsoft Learn empfiehlt, zuerst deklarative Optionen zu prüfen, etwa benutzerdefinierte Aktionen, berechnete und Rollup-Spalten, Webhooks und Power Automate. Die Folge "Customize Dataverse for Complex Business Apps" schlägt für aufwendige Berechnungen oder komplexe Verknüpfungen ein Plug-in oder einen Dataflow vor.
Community-Wiki
Oben die Kurzinfo, unten das Wissen der Community: ergänze praktische Tipps, Beispiele oder Korrekturen. Neue Beiträge werden zuerst geprüft, bewährte Mitglieder veröffentlichen direkt.
Experten und Firmen zu diesem Thema
Dieses Thema hat noch niemand im Profil angegeben. Trag es in deinem Profil ein.
Gepflegt von Mirko Peters (Microsoft MVP) · Zuletzt aktualisiert: