Registrieren eines Plug-Ins

Nachdem ein Plug-In geschrieben und kompiliert wurde, muss es beim Ereignisframework registriert werden, damit es ausgeführt wird, wenn eine bestimmte Entität (Tabellenzeile) und Nachricht (Vorgang) von Dataverse verarbeitet wird. Um ein Plug-In beim Dataverse-Ereignisframework zu registrieren, ist die Verwendung eines Tools erforderlich – Plug-In-Registrierungstool (PRT) oder der Power Platform Tools-Erweiterung für Visual Studio.

Das PRT erstellt Dataverse-Objektregistrierungen und unterstützt die Bearbeitung dieser Registrierungen. In diesem Artikel wird beschrieben, wie Sie mit dem Plug-In-Registrierungstool eine Plug-In-Assembly und einen Plug-In-Schritt registrieren, einer Lösung eine Assembly hinzufügen und andere allgemeine, mit Plug-Ins zusammenhängende Vorgänge ausführen.

Die Visual Studio-Erweiterung bietet eine funktionsreichere Entwicklungsumgebung und deckt den gesamten Codierungs-, Bereitstellungs- und Debugging-/Profiling-Entwicklungsprozess ab. Informationen zur Verwendung der Power Platform Tools-Erweiterung für Visual Studio finden Sie im Schnellstart.

Informationen zum Plug-In-Registrierungstool

Das Plug-In-Registrierungstool (PRT) unterstützt die Registrierung von Plug-In-Assemblys, Nachrichtenverarbeitungsschritten und anderen Objekttypen mit Dataverse. PRT ist eines von mehreren Dataverse-Tools, die von NuGet.org heruntergeladen werden können. Befolgen Sie die Anweisungen unter Dataverse-Entwicklungstools, um PRT und optional andere Entwicklungstools herunterzuladen.

Nachdem Sie das PRT heruntergeladen haben, befolgen Sie die Anweisungen unter Verbindung mithilfe des Plugin Registration Tool herstellen, um das Tool mit Ihrer Dataverse-Umgebung zu verbinden, wo Ihr Plug-In registriert wird.

Assembly-Registrierung

Zur Registrierung einer Assembly gehört das Hochladen der Assembly in die Dataverse-Datenbank, was vom Tool gehandhabt wird. Lesen Sie die Anweisungen unter Registrieren der Assembly im Lernprogramm: Schreiben und Registrieren eines Plugins

Hinweis

Sie finden die Optionen, die mit dem Isolationsmodus und Speicherort der Assembly verknüpft sind. Diese beziehen sich auf Optionen, die für lokale Bereitstellungen gelten. Dataverse ist nicht für lokale Bereitstellungen verfügbar. Deshalb akzeptieren Sie immer die Standardoptionen Sandbox und Datenbank für diese Optionen.

Wenn eine Assembly hochgeladen wird, wird sie in der PluginAssembly-Tabelle gespeichert. Die meisten Eigenschaften werden mithilfe der Reflektion der importierten Assembly festgelegt. Die Base64-codierten Bytes der Assembly werden in der Content-Spalte gespeichert. Während Sie die Eigenschaften der Assembly im PRT ansehen, können Sie nur den Wert Beschreibung bearbeiten. Alle kompilierten Klassen innerhalb der Assembly, die die IPlugin-Schnittstelle implementieren oder von CodeActivity ableiten, werden automatisch registriert.

Anzeigen registrierter Assemblys

Sie können Informationen über registrierte Plug-In-Assemblys im klassischen Power Apps Lösungs-Explorer unter Lösungen im linken Navigationsbereich von Power Apps und in der PRT-Assembly-Ansicht einsehen. Um auf den Lösungs-Explorer in Power Apps zuzugreifen, wählen Sie Lösungen und dann Zur klassischen Ansicht wechseln in der Symbolleiste. Um über Power Apps auf die Standardlösung zuzugreifen, wählen Sie Lösungen, die „Standardlösung“ aus der Liste und dann Plug-In-Assemblys im linken Objekte-Bereich aus.

Hinweis

Jede Assembly, die Sie registrieren, wird der Standardlösung hinzugefügt, die nicht mit der Common Data Services Standardlösung verwechselt werden sollte. Weitere Informationen zu Lösungen finden Sie unter Einführung in Lösungen.

Hinzufügen der Assembly zu einer Lösung

Wie in Anzeigen registrierter Assemblys beschrieben, wurde die Assemblyregistrierung, die Sie erstellt haben, der Standardlösung des Systems hinzugefügt. Sie sollten die Assembly einer nicht verwalteten Lösung hinzufügen, sodass Sie sie an andere Organisationen verteilen können. Mit dem PRT können Sie bei der Registrierung einer Assembly oder von Schritten keine Lösung angeben.

Weitere Informationen zu Lösungen und deren Erstellung finden Sie unter Überblick über Lösungen und Lösung erstellen. Sobald Sie eine Lösung erstellt haben, können Sie Ihre Plug-In-Assembly zu Power Apps hinzufügen, indem Sie zuerst die Lösung in der Lösungsliste und dann Vorhandene hinzufügen > Mehr > Entwicklungsfachkräfte > Plug-In-Assembly auswählen.

Hinweis

Vorhandene oder nachfolgende Schrittregistrierungen (siehe nächster Abschnitt) werden nicht zur nicht verwalteten Lösung hinzugefügt, die die Plug-In-Assemblys enthält. Sie müssen der Lösung jeden registrierten Schritt separat hinzufügen. Weitere Informationen: Hinzufügen eines Schritts zur Lösung

Schrittregistrierung

Wenn eine Assembly geladen oder aktualisiert wird, werden alle Klassen, die IPlugin implementieren, im PRT verfügbar gemacht. Verwenden Sie die Anweisungen unter Registrieren eines neuen Schritts im Lernprogramm: Schreiben und Registrieren eines Plugins, um eine neue Schrittregistrierung zu erstellen.

Wenn Sie einen Schritt registrieren, gibt es mehrere Registrierungsoptionen, die für Sie verfügbar sind, die von der Phase der Ereignispipeline und dem Typ des Vorgangs abhängen, für den Sie Ihren Code registrieren möchten.

Allgemeine Konfigurationsinformationsfelder

Feld	Beschreibung
Nachricht	PRT vervollständigt automatisch verfügbare Nachrichtennamen im System. Weitere Informationen: Nachrichten mit dem SDK für .NET verwenden
Primäre Entität	PRT vervollständigt automatisch gültige Tabellen, die auf die ausgewählte Nachricht zutreffen. Diese Meldungen enthalten einen Target-Parameter, der als Typ Entity oder EntityReference akzeptiert. Wenn gültige Tabellen zutreffen, sollten Sie diesen Feldwert festlegen, wenn Sie die Anzahl der Aufrufe des Plug-ins begrenzen wollen. Wenn Sie es für Kerntabellen-Meldungen wie Update, Delete, Retrieve und RetrieveMultiple oder jede Nachricht, die mit der Nachricht angewendet werden kann, leer lassen, wird das Plug-in für alle Tabellen aufgerufen, die diese Nachricht unterstützen.
Sekundäre Entität	Dieses Feld wird für Abwärtskompatibilität für veraltete Meldungen beibehalten, die den Array EntityReference als Target-Parameter akzeptierten. Dieses Feld wird in der Regel nicht mehr verwendet.
Filterattribute	Mit der Nachricht Update oder OnExternalUpdated schränkt das Filtern von Spalten beim Festlegen von Primäre Entität die Ausführung des Plug-Ins auf Fälle ein, in denen die ausgewählten Spalten in das Update eingeschlossen werden. Das Festlegen dieses Felds ist eine bewährte Methode für die Leistung. Schließen Sie den Primärschlüssel der Entität nicht in die Filterattribute ein. Der Primärschlüssel ist bei Aktualisierungsvorgängen immer enthalten, daher werden dadurch alle anderen gefilterten Attribute negiert.
Ereignishandler	Dieser Feldwert wird anhand des Namens der Assembly und der Plug-In-Klasse aufgefüllt.
Schrittname	Der Name des Schritts. Ein Wert wird auf der Basis der Konfiguration des Schritts automatisch aufgefüllt, aber dieser Wert kann überschrieben werden.
Im Kontext des Benutzers ausführen	Stellt Optionen zum Anwenden des Identitätswechsels für den Schritt bereit. Der Standardwert ist Aufrufender Benutzer. Wenn der aufrufende Benutzer keine ausreichenden Rechte besitzt, um Vorgänge im Schritt auszuführen, müssen Sie diesen Feldwert ggf. für einen Benutzer mit solchen Rechten festlegen. Weitere Informationen: Benutzeridentitätswechsel für einen Schritt festlegen
Ausführungsreihenfolge	Mehrere Schritte können für dieselbe Phase derselben Nachricht registriert werden. Die Zahl in diesem Feld legt die Reihenfolge, in der sie angewendet werden, vom niedrigsten zum höchsten fest. Hinweis: Sie sollten dies einstellen, um die Reihenfolge zu steuern, in der Plug-Ins im Stadium angewendet werden. Es wird nicht empfohlen, einfach den Standardwert zu übernehmen. Die tatsächliche Ausführungsreihenfolge der Plug-Ins mit demselben Ausführungsreihenfolgewert (für dieselbe Phase, Tabelle und Nachricht) ist nicht garantiert und kann zufällig sein.
Beschreibung	Eine Beschreibung des Schritts. Dieser Wert ist vorbelegt, kann aber überschrieben werden.

Ereignis-Pipeline-Phase der Ausführung

Wählen Sie die Phase in der Ereignis-Pipeline aus, die für den Zweck Ihres Plug-Ins optimal geeignet ist.

Option	Beschreibung
PreValidation	Beim Erstbetrieb tritt diese Phase vor dem Betrieb des Hauptsystems auf. Auf diese Weise kann Logik eingebunden werden, mit der sich der Vorgang vor der Datenbanktransaktion abbrechen lässt. Nachfolgende Vorgänge, die von Erweiterungen ausgelöst werden, die in anderen Phasen registriert sind, passieren diese Phase auch, werden aber in die Transaktion der aufrufenden Erweiterungen aufgenommen. Diese Phase tritt vor der Durchführung sämtlicher Sicherheitsprüfungen auf, um zu überprüfen, ob der aufrufende oder angemeldete Benutzer berechtigt ist, den gewünschten Vorgang durchzuführen.
PreOperation	Tritt vor Betrieb des Hauptsystems und während der Datenbanktransaktion auf. Wenn Sie die Werte einer in einer Nachricht enthaltenen Entität ändern möchten, tun Sie dies hier. Brechen Sie an dieser Stelle besser keinen Vorgang ab. Andernfalls wird die Transaktion rückabgewickelt, und es kommt zu erheblichen Leistungseinbußen.
PostOperation	Tritt nach Betrieb des Hauptsystems und während der Datenbanktransaktion auf. Mit dieser Phase können Sie die Eigenschaften der Nachricht ändern, bevor sie an den Anrufer zurückgeht. Die Entitäten in einer Nachricht sollten nicht geändert werden, weil das ein neues Update-Ereignis auslöst. In der PostOperation-Phase können Sie Schritte zur Nutzung des asynchronen Ausführungsmodus aufzeichnen. Diese Schritte erfolgen mithilfe des asynchronen Dienstes außerhalb der Datenbanktransaktion. Sie müssen beim Registrieren Ihres Plug-Ins den asynchronen Modus verwenden, wenn das Plug-In für die Durchführung eines Aktualisierungsvorgangs konzipiert ist und in der Nachricht „Create” der Entität User (SystemUser) registriert ist. Weitere Informationen: Asynchroner Dienst.

Weitere Informationen: Ereignisausführungspipeline

Ausführungsmodus

Es gibt zwei Modi der Ausführung, asynchron und synchron.

Option	Beschreibung
Asynchron	Der Ausführungskontext und die Definition der Geschäftslogik, die angewendet werden soll, werden zum Systemauftrag verschoben, der ausgeführt wird, wenn der Vorgang abgeschlossen wurde.
Synchron	Plug-Ins werden sofort gemäß der Phase der Ausführung und der Ausführungsreihenfolge ausgeführt. Der gesamte Vorgang wartet, bis sie ausgeführt wurden.

Asynchrone Plug-Ins können nur für die Phase PostOperation registriert werden. Weitere Informationen darüber, wie Systemaufträge funktionieren, finden Sie unter Asynchroner Service.

Spezielle Schrittregistrierungsszenarien

Es gibt bestimmte Szenarien, in denen eine Kombination aus Schrittregistrierung und Tabelle nicht offensichtlich ist. Dies ist das Ergebnis des internen Entwurfs des Systems, bei dem eine besondere Beziehung zwischen Tabellen oder Vorgängen besteht. Die folgenden Informationen identifizieren diese Fälle und bieten Anleitungen zur Schrittregistrierung.

• Es gibt bestimmte Fälle, in denen für das Ereignis Update registrierte Plug-Ins zweimal aufgerufen werden können. Weitere Informationen: Verhalten spezieller Vorgänge mithilfe Update
• Registrieren Sie einen Plugin-Schritt auf Konto oder Kontakt, wenn Sie Datenänderungen an den Datensätzen customeraddress, leadaddress, publisheraddress oder competitoraddress verarbeiten möchten.

Bereitstellung

Option	Beschreibung des Dataflows
Server	Das Plug-In wird auf dem Dataverse-Server ausgeführt.
Offline	Das Plug-In wird innerhalb des Dynamics 365 for Outlook-Clients ausgeführt, wenn der Benutzer im Offlinemodus ist.

Konfigurationsdaten festlegen

Die Felder Unsichere Konfiguration und Sichere Konfiguration im PRT lassen die Angabe von Konfigurationsdaten zu, die für einen bestimmten Schritt an das Plug-In übergeben werden.

Hinweis

Sichere Konfigurationsdaten sind nicht in der Schrittregistrierung enthalten, wenn Sie eine Lösung exportieren.

Sie können Ihr Plug-In so schreiben, dass es Zeichenfolgenwerte im Konstruktor annimmt, um mit diesen Daten zu steuern, wie das Plug-In für den Schritt verwendet werden soll. Weitere Informationen: Konfigurationsdaten Ihrem Plug-In übergeben

Definieren von Entitätsbildern

In Ihrem Plug-In möchten Sie möglicherweise auf primäre Tabelleneigenschaftswerte verweisen, die nicht in einem Vorgang enthalten waren. Beispielweise möchten Sie in einem Update-Vorgang ggf. wissen, was der Wert war, bevor er geändert wurde, aber der Ausführungskontext bietet diese Informationen nicht, er enthält lediglich den geänderten Wert.

Wenn Ihr Plug-In-Schritt in den Phasen PreValidation oder PreOperation der Ausführungspipeline registriert ist, könnten Sie die IOrganizationService-Instanz verwenden, um den aktuellen Wert der Eigenschaft abzurufen. Diese Vorgehensweise ist jedoch nicht gut für die Leistung. Eine bessere Praxis ist es, bei der Registrierung des Plug-Ins ein Vorabbild zu definieren. Dadurch wird eine „Momentaufnahme“ der Tabelle mit den für Sie interessanten Feldern erstellt, wie sie vor dem Vorgang vorhanden waren, die Sie zum Vergleichen mit den geänderten Werten verwenden können.

Wichtig

Das Standardverhalten beim Erstellen eines Entitätsbilds besteht darin, alle Spalten auszuwählen. Verwenden Sie dieses Standardverhalten nicht. Dies wird sich negativ auf die Leistung auswirken. Schließen Sie nur die Spalten ein, die für die Logik Ihres Plug-Ins erforderlich sind.

Nachrichten, die Entitätsbilder unterstützen

In Dataverse unterstützen nur die folgenden Meldungen Entitätsbilder:

Nachricht	Anforderungs-Klassen-Eigenschaft	Beschreibung
Assign	Target	Die zugewiesene Tabelle.
Create	Target	Die erstellte Tabelle.
Delete	Target	Die gelöschte Tabelle.
DeliverIncoming	EmailId	Die zugestellte E-Mail-ID.
DeliverPromote	EmailId	Die zugestellte E-Mail-ID.
Merge	Target oder SubordinateId	Die übergeordnete Tabelle, in die die Daten aus der untergeordneten Tabelle zusammengeführt werden, oder die untergeordnete Tabelle, die in die übergeordnete Tabelle zusammengeführt wird.
Route	Target	Das Element, das weitergeleitet wird.
Send	FaxId, EmailId oder TemplateId	Das Element, das gesendet wird.
SetState	EntityMoniker	Die Tabelle, für die der Status festgelegt ist.
Update	Target	Die aktualisierte Tabelle.

Typen von Entitätsbildern

Es gibt zwei Typen von Entitätsbildern: Vorheriges Bild und Späteres Bild. Wenn Sie sie konfigurieren, sind diese Bilder im Ausführungskontext als Eigenschaft PreEntityImages bzw. Eigenschaft PostEntityImages verfügbar. Wie die Namen vermuten lassen, stellen diese Momentaufnahmen dar, wie die Tabelle vor dem Vorgang und nach dem Vorgang aussieht. Wenn Sie ein Entitätsbild konfigurieren, definieren Sie einen Tabellenalias*-Wert, der der Schlüsselwert ist, den Sie für den Zugriff auf ein bestimmtes Entitätsbild der PreEntityImages- oder PostEntityImages-Eigenschaften verwenden.

Verfügbarkeit von Bildern

Wenn Sie ein Entitätsbild konfigurieren, ist es wichtig, dass Sie erkennen, dass die Art der verfügbaren Entitätsbilder von der Stufe des registrierten Schritts und der Art des Vorgangs abhängt. Zum Beispiel:

• Sie können kein Vorabbild für die Create-Nachricht erhalten, weil die Tabelle noch nicht existiert.
• Sie können kein Nachherbild für die Delete-Nachricht erhalten, weil die Tabelle nicht mehr existiert.
• Sie können ein Nachherbild nur für Schritte erhalten, die in der PostOperation-Phase der Ausführungspipeline registriert sind, da es keine Möglichkeit gibt, die Tabelleneigenschaften zu kennen, bevor die Transaktion abgeschlossen ist.
• Für einen Update-Vorgang, der in der Phase PostOperation registriert ist, können Sie ein Vorheriges Bild UND ein Späteres Bild haben.

Hinzufügen eines Entitätsbilds

Verwenden Sie die Power Platform Tools-Erweiterung für Visual Studio, um einem Plug-In-Schritt ein Entitätsbild hinzufügen.

Alternativ können Sie das Plug-In-Registrierungstool verwenden, um einem Schritt ein Entitätsbild hinzuzufügen, indem Sie die Anweisungen in Tutorial: Aktualisieren eines Plug-Ins im Abschnitt Bild hinzufügen befolgen.

Hinzufügen eines Schritts zur Lösung

Wie unter Hinzufügen einer Assembly zu einer Lösung beschrieben, sind Plug-In-Assemblys Lösungskomponenten, die einer nicht verwalteten Lösung hinzugefügt werden können. SDK-Nachrichtenverarbeitungsschritte sind auch Lösungskomponenten und müssen zu einer nicht verwalteten Lösung hinzugefügt werden, damit sie verteilt werden können.

Die Vorgehensweise zum Hinzufügen eines Schritts zu einer Lösung ist mit dem Hinzufügen einer Assembly vergleichbar. Sie verwenden den Befehl Vorhandenes Element hinzufügen, um es in die gewünschte nicht verwaltete Lösung zu verschieben. Der einzige Unterschied besteht darin, dass Sie aufgefordert werden, fehlende erforderliche Komponenten hinzuzufügen, wenn Sie versuchen, einen Schritt hinzuzufügen, aber die Assembly noch nicht hinzugefügt haben, die die im Schritt verwendete Klasse enthält.

Wenn dies auftritt, sollten Sie normalerweise OK auswählen, um die Assembly mit der nicht verwalteten Lösung zu übertragen. Sie würden dies nur dann nicht auswählen, wenn Ihre Lösung für die Installation in einer Umgebung konzipiert ist, in der bereits eine andere Lösung installiert ist, die die Assembly enthält.

Ebenso sollten Sie beachten, dass durch das Entfernen der Assembly aus der Lösung keine davon abhängigen Schritte entfernt werden.

Benutzeridentitätswechsel für einen Schritt festlegen

Wenn das Plug-In-Registrierungstool ausgeführt wird und in der Dataverse-Zielumgebung angemeldet ist, können Sie mit dem Festlegen oder Ändern einer Plug-In-Schrittregistrierung fortfahren. In diesem Abschnitt besprechen wir die Änderung des Benutzers, in dessen Namen das Plug-In seine Vorgänge ausführt. Das heißt, der tatsächliche Benutzer, der die vom Plug-In initiierten Datenvorgänge ausführt. Standardmäßig ist der aufrufende Benutzer (der Benutzer, der einen Vorgang in Dataverse aufgerufen hat) der Besitzer dieser Vorgänge. Bei der Schrittregistrierung kann jedoch ein anderer Benutzer angegeben werden. Sie müssen über die Sicherheitsrolle „Systemadministrator“ oder „Systemanpasser“ verfügen, um diesen Vorgang auszuführen.

So legen Sie den Benutzerkontext in einem Plug-In-Schritt fest:

1. Erweitern Sie den Ziel-Plug-In-Assembly-Knoten in der Assembly-Ansicht, bis Sie den gewünschten (Schritt-)Registrierungsknoten sehen.
2. Wählen Sie den Schrittknoten aus und wählen Sie dann entweder im Kontextmenü oder in der Symbolleiste Aktualisieren aus.
3. Wählen Sie einen Benutzenden aus der Dropdownliste der verfügbaren Benutzenden neben der Bezeichnung Im Kontext des Benutzenden ausführen aus.
4. Wählen Sie Schritt aktualisieren.

Weitere Informationen: Annehmen der Identität eines Benutzers

Eine Assembly aktualisieren

Wenn Sie eine zuvor registrierte Assembly ändern und neu erstellen, müssen Sie sie aktualisieren. Weitere Schritte finden Sie unter dem Schritt Aktualisieren der Plug-In-Assemblyregistrierung im Lernprogramm: Aktualisieren eines Plug-Ins.

Assemblyversionsverwaltung

Wenn Sie Änderungen an einer Plug-In-Assembly vornehmen, die Teil einer bereitgestellten verwalteten Lösung ist, müssen Sie die Auswirkungen berücksichtigen, die Ihre Änderungen haben können, wenn Sie diese verwaltete Lösung aktualisieren. Die Version der Assembly steuert das Verhalten.

Die Version von Plug-In-Assemblys kann mit Hilfe des semantischen Versionsverwaltungsformats major.minor.build.revision verwaltet werden, das in der Datei Assembly.info des Microsoft Visual Studio-Projekts definiert wurde. Abhängig vom Teil der Assemblyversionsnummer, der für eine neuere Lösung geändert wird, gilt das folgende Verhalten, wenn eine vorhandene Lösung durch einen Import aktualisiert wird.

• Die Versionsnummer des Builds oder der Revisionsassembly wird geändert

  Dies wird als direktes Upgrade bezeichnet. Die ältere Version der Assembly wird beim Import der Lösung entfernt, die die aktualisierte Assembly enthält. Alle bereits vorhandenen Schritte der älteren Lösung werden automatisch auf die neuere Version der Assembly geändert.

• Die Haupt- oder Nebenversionsnummer wird geändert

  Wenn eine aktualisierte Lösung importiert wird, die die überarbeitete Assembly enthält, wird die Assembly als eine andere Assembly angesehen als die vorherige Version dieser Assembly in der vorhandenen Lösung. Die Registrierungsschritte für Plug-Ins in der vorhandenen Lösung beziehen sich weiterhin auf die frühere Version der Assembly. Wenn vorhandene Plug-In-Registrierungsschritte für die vorherige Assembly auf die überarbeitete Assembly verweisen sollen, müssen Sie das Plug-In-Registrierungstool verwenden, um die Schrittkonfiguration manuell zu ändern, damit sie auf den überarbeiteten Assemblytyp verweist. Dies sollte durchgeführt werden, bevor Sie die aktualisierte Assembly für den späteren Import in eine Lösung exportieren.

Aufheben der Registrierung oder Deaktivieren von Plug-Ins und Komponenten

Mit dem Plug-In-Registrierungstool (PRT) können Sie die Plug-Ins und deren Komponenten deaktivieren oder ihre Registrierung aufheben.

Wichtig

Eine Aufhebung der Registrierung oder Deaktivierung von Plug-Ins und Schritten von Microsoft oder vorinstallierten Systemen ist nicht mehr möglich. Zuvor konnten Sie die Registrierung einiger Microsoft.*- und anderer standardmäßiger System-Plug-Ins aufheben oder diese deaktivieren. Wir haben dieses Verhalten geändert, um dies nicht mehr zuzulassen. Die Funktionsänderung wurde vorgenommen, da die Aufhebung der Registrierung oder Deaktivierung dieser Plug-Ins oder Schritte dazu führen kann, dass Produktfunktionen nicht wie erwartet funktionieren. Wenn Sie die Registrierung eines solchen Plug-Ins oder Schritts aufheben oder es/ihn deaktivieren müssen, reichen Sie eine Microsoft-Supportanfrage ein.

Einen Plug-In-Schritt deaktivieren oder aktivieren

Wenn das Plug-In-Registrierungstool ausgeführt wird und in der Dataverse-Zielumgebung angemeldet ist, können Sie mit dem Deaktivieren oder Aktivieren eines Plug-In-Schritts fortfahren. Durch das Deaktivieren eines Schritts wird die Ausführung des Plug-Ins effektiv deaktiviert, wenn Dataverse die in der Schrittregistrierung angegebene Entitäts- und Nachrichtenkombination verarbeitet.

Wichtig

Das Deaktivieren eines Plug-Ins kann sich negativ auf die Funktionalität Ihrer App, einer Lösung oder des Dataverse-Systems auswirken. Stellen Sie sicher, dass Sie die Auswirkungen verstehen, bevor Sie fortfahren.

So deaktivieren oder aktivieren Sie einen registrierten Plug-In-Schritt:

1. Erweitern Sie den Ziel-Plug-In-Assembly-Knoten in der Assembly-Ansicht, bis Sie den gewünschten Schrittregistrierungsknoten sehen.
2. Wählen Sie den Schritt aus und wählen Sie dann entweder im Kontextmenü oder in der Symbolleiste Aktualisieren oder Deaktivieren aus.

Sie können auch Schritte in der Benutzerschnittstelle des alten Dataverse-Projektmappen-Explorers deaktivieren oder aktivieren, indem Sie die Befehlsoptionen Aktivieren und Deaktivieren verwenden.

Aufheben der Registrierung von Komponenten

Das PRT bietet Befehle zum Aufheben der Registrierung von Assemblys, Typen, Schritten und Images. Die Vorgehensweise finden Sie unter den Anweisungen Aufheben der Registrierung für Assembly, Plug-In und Schritt im Lernprogramm: Aktualisieren eines Plug-Ins.

Dies sind Löschvorgänge für die Tabellen PluginAssembly, PluginType, SdkMessageProcessingStep und SdkMessageProcessingStepImage.

Sie können auch Plug-In-Assemblys und SDK-Nachrichtenverarbeitungsschritte im Projektmappen-Explorer löschen, um dasselbe Ergebnis zu erzielen. In der Abbildung unten wird eine benutzerdefinierte Lösung mit dem Namen Common Data Service Standardlösung angezeigt.

Hinweis

Sie können keine Plug-In-Assemblys löschen (Registrierung aufheben), während vorhandene SDK-Nachrichtenverarbeitungsschritte davon abhängig sind. Entitätsbilder sind nicht zum separaten Löschen verfügbar, aber sie werden gelöscht, wenn Schritte, die sie verwenden, gelöscht werden.

Nächste Schritte,

Debuggen von Plug-Ins

Siehe auch

Schreiben von Plug-Ins zur Erweiterung von Geschäftsprozessen
Schreiben eines Plug-Ins
Lernprogramm: Schreiben und Registrieren eines Plugins
Lernprogramm: Debuggen eines Plug-Ins
Lernprogramm: Aktualisieren eines Plug-Ins

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).