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 (Operation) verarbeitet wird Microsoft Dataverse. Zum Registrieren eines Plug-Ins ist die Verwendung eines Tools erforderlich – entweder des Plug-In Registration Tool (PRT) oder der Tools-Erweiterung für Dataverse . Power Platform 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 Nachrichtenverarbeitung Schritt registrieren, einer Lösung eine Assembly hinzufügen und andere allgemeine Plug-In-bezogene 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 in Power Apps und in der PRT-Assembly-Ansicht auf Informationen zu registrierten Plug-In-Assemblys und Schritten zugreifen. Um auf Plug-In-Informationen in Power Apps zuzugreifen, wählen Sie im linken Navigationsbereich Lösungen und wählen Sie dann eine verfügbare Lösung aus der Liste aus. Wählen Sie als Nächstes Plug-In-Assemblys oder Plug-In-Schritte im linken Bereich Objekte 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: Fügen Sie Schritt zur Lösung hinzu
Schrittregistrierung
Durch die Registrierung einer Nachrichtenverarbeitung Schritt wird darüber informiert, Dataverse unter welchen Bedingungen Ihr Plug-In ausgeführt werden soll und wie dies geschehen soll. Mit Bedingungen meinen wir die Tabellen- und Nachrichtenoperation, die von Dataverse verarbeitet wird. Andere Konfigurationsoptionen wie synchrone oder asynchrone Ausführung, vor oder nach dem Kernvorgang und mehr können während der Schritt-Registrierung angegeben werden. Diese Laufzeitkonfigurationsoptionen werden im nächsten Abschnitt ausführlich beschrieben.
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.
Allgemeine Konfigurationsinformationsfelder
| Feld | Eigenschaft |
|---|---|
| Nachricht | Die Nachricht, deren Verarbeitung durch Dataverse zur Ausführung des Plug-Ins führt. Wenn für Kernnachrichten wie |
| Primäre Entität | Die Entität (Tabelle), deren Verarbeitung durch Dataverse zur Ausführung des Plug-Ins führt. Nachrichten haben einen |
| 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 | Wenn Sie für die Meldung Update, OnExternalUpdated oder eine andere Meldung die primäre Entität festlegen, beschränkt das Filtern von Attributen (Spalten) die Ausführung des Plug-Ins auf Fälle, in denen die angegebenen Spalten in der Aktualisierung enthalten sind.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 im PRT basierend auf dem Namen der Assembly und der Plug-In-Klasse aufgefüllt. |
| Schrittname | Der Name der Nachrichtenverarbeitung Schritt. 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 | Für dieselbe Phase und Nachricht können mehrere Schritte registriert werden. Die Zahl in diesem Feld bestimmt die Reihenfolge, in der die Schritte innerhalb einer Phase vom niedrigsten bis zum höchsten angewendet werden. Sie sollten dies festlegen, um die Reihenfolge zu steuern, in der Plug-Ins in derselben Phase ausgeführt werden. Es wird nicht empfohlen, einfach den Standardwert zu übernehmen. Die tatsächliche Ausführungsreihenfolge von Plug-Ins mit demselben Ausführungsreihenfolgewert (für dieselbe Phase, Tabelle und Nachricht) ist nicht garantiert und kann zufällig sein. |
| Description | Eine Beschreibung für Schritt. 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. Die Präfixe „Pre“ und „Post“ beziehen sich auf die Zeit vor bzw. nach der Dataverse Hauptoperation (Kernoperation). Der Hauptvorgang ist die Phase, in der die Kombination aus Nachricht und Entität verarbeitet wird.
| Option | Eigenschaft |
|---|---|
| Vorabüberprüfung | 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 Ausführungsmodi: asynchron und synchron.
| Option | Eigenschaft |
|---|---|
| Asynchron | Der Ausführungskontext und die Definition der anzuwendenden Geschäftslogik werden in die Systemauftragswarteschlange verschoben, die einige Zeit nach Abschluss des Hauptvorgangs ausgeführt wird. |
| 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.
- In bestimmten Fällen können für das Ereignis Update registrierte Plug-Ins zweimal aufgerufen werden. 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 andeuten, stellen diese Snapshots dar, wie die Tabelle vor und nach der Hauptoperation 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.
Einen Schritt zu einer Lösung hinzufügen
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:
- Erweitern Sie den Ziel-Plug-In-Assembly-Knoten in der Assembly-Ansicht, bis Sie den gewünschten (Schritt-)Registrierungsknoten sehen.
- Wählen Sie den Schrittknoten aus und wählen Sie dann entweder im Kontextmenü oder in der Symbolleiste Aktualisieren aus.
- Wählen Sie einen Benutzenden aus der Dropdownliste der verfügbaren Benutzenden neben der Bezeichnung Im Kontext des Benutzenden ausführen aus.
- 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:
- Erweitern Sie den Ziel-Plug-In-Assembly-Knoten in der Assembly-Ansicht, bis Sie den gewünschten Schrittregistrierungsknoten sehen.
- 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.
Deaktivieren oder aktivieren Sie in Power Apps Plug-In-Schritte mit den Optionen „Ausschalten“ und „Einschalten“ des ausgewählten Schritt. Sie können auf die Optionen von Schritt zugreifen, indem Sie zuerst zu Lösungen navigieren, eine Lösung auswählen und dann im linken Bereich Objekte die Option Plug-In-Schritte auswählen.
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,
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).