Registrieren Sie ein Plug-in, das lokal bereitgestellt werden soll.

Plug-Ins und benutzerdefinierte Workflowaktivitäten sind in benutzerdefiniertem Code erstellt, den Sie zur Erweiterung der vorhandenen Funktionalität von Dynamics 365 Customer Engagement (on-premises) entwickeln. Bevor ein Plug-In oder eine benutzerdefinierte Workflowaktivität verwendet werden kann, ist eine Registrierung auf dem Server erforderlich. Ein Plug-in und ein benutzerdefiniertes Tool zur Registrierung von Workflow-Aktivitäten stehen zum Download bereit.

Allgemeine Informationen zur Registrierung von Plug-Ins und benutzerdefinierten Workflow-Assemblies finden Sie in den Dataverse Themen Registrieren eines Plug-Ins und Registrieren Ihrer Assembly. Die folgenden Informationen sind spezifisch für die lokale Entwicklung von Plug-Ins.

Während das Augenmerk in diesem Thema hauptsächlich auf Plug-Ins liegt, sind die meisten Informationen auch auf benutzerdefinierte Workflowaktivitäten anwendbar. Der Unterschied liegt darin, dass für benutzerdefinierte Workflowaktivitätsassemblys nur die Assembly registriert wird. Für Plug-Ins registrieren Sie die Plug-In-Assembly und mindestens einen oder mehrere Schritte pro Plug-In. Ausführliche Informationen zu benutzerdefinierten Workflowaktivitäten finden Sie unter Benutzerdefinierte Aktivitäten (Workflow-Aktivitäten).

Wichtig

Registrieren Sie keine Plug-Ins oder benutzerdefinierten Workflowaktivitäten, es sei denn, sie stammen von einer zuverlässigen und vertrauenswürdigen Quelle.

Plug-In-Speicher

 

Bei einer lokalen Bereitstellung können Plug-Ins, die nicht in der Sandbox registriert sind, in der Datenbank des Dynamics 365 Server oder im Dateisystem auf der Festplatte gespeichert werden. Es wird dringend empfohlen, die einsatzbereiten Plug-Ins in der Dynamics 365 Customer Engagement (on-premises)-Datenbank zu speichern, statt auf einem Datenträger. In der Datenbank gespeicherte Plug-Ins werden automatisch auf mehrere Dynamics 365 Server in einem Rechenzentrums-Cluster verteilt. Speicherplatz auf dem Datenträger ist zum Debuggen von Plug-Ins mithilfe von Visual Studio nützlich. Sie können jedoch ein Plug-In debuggen, das in der Datenbank gespeichert wurde. Ausführliche Informationen finden Sie unter Debuggen eines Plug-In.

Plug-Ins, die im Sandkasten registriert wurden, müssen in der Datenbank unabhängig von der Dynamics 365 Customer Engagement (on-premises)-Bereitstellung (lokal, IFD oder online) registriert werden.

Bereitstellung

 

Bei firmeninternen oder Internet-orientierten (IFD) Dynamics 365 Customer Engagement (on-premises)-Installationen muss bei der Bereitstellung von Plugins von einem anderen Computer auf der Festplatte des Dynamics 365 Server (On-Disk-Bereitstellung) die Plugin-Assembly vor der Registrierung manuell auf den Server kopiert werden. Die Assembly muss im <installdir>\Program Files\Microsoft CRM\server\bin\assembly auf jedem Server bereitgestellt werden, in dem das Plug-In ausgeführt wird.

Die Plug-In-Registrierung sollte erfolgen, nachdem die Assembly in den Ordner …\bin\assembly auf dem Server kopiert wurde, um eine Situation zu verhindern, in der ein Systembenutzer ein Ereignis in Dynamics 365 Customer Engagement (on-premises) auslöst, während die registrierte Plug-In-Assembly noch nicht auf dem Server vorhanden ist. Für die Bereitstellung auf der Serverdatenbank wird die Plug-In-Assembly automatisch bei der Plug-In-Registrierung kopiert, damit kein Problem durch die zuvor beschriebene Situation entsteht.

Je nach Entwurf des Plug-Ins müssen ggf. weitere Assemblys, auf die verwiesen wird, ausgeführt werden. Unabhängig davon, ob Sie das Plug-In in einer Datenbank oder auf einem Datenträger bereitstellen – wenn Ihr Plug-In die Ausführung anderer Assemblys erfordert, müssen Sie Kopien dieser Assemblys im globalen Assemblycache der einzelnen Server platzieren, auf denen das Plug-In ausgeführt wird.

So verschieben Sie ein Plug-In von einer Entwicklungsumgebung zu einem Staging- oder Produktionsserver

1. Erstellen Sie den Plug-In-Code auf dem Entwicklungscomputer. Geben Sie keine Debuginformationen an. Optimieren Sie das Plug-In in Bezug auf Leistung.
2. Registrieren Sie das Plug-In in der Datenbank von Dynamics 365 Server.
3. Erstellen Sie mithilfe der Dynamics 365 Customer Engagement (on-premises)-Webanwendung eine Lösung, oder verwenden Sie eine bereits vorhandene Lösung, und fügen Sie das Plug-In zu dieser Lösung hinzu.
4. Nachdem Sie alle weiteren gewünschten Komponenten zur Lösung hinzugefügt haben, exportieren Sie die Lösung.
5. Importieren Sie die Lösung auf den Staging- oder Produktionsserver.

Sicherheitsbeschränkungen

Es gibt eine Sicherheitsbeschränkung, die nur berechtigten Benutzern die Registrierung von Plug-Ins ermöglicht. Für Plug-Ins, die nicht isoliert registriert werden, muss das Systembenutzerkonto, unter dem das Plug-In in der Sandbox (Isolation) registriert wurde, in der Gruppe Bereitstellungsadministratoren des Bereitstellungs-Managers vorhanden sein. Nur das Benutzerkonto des Systemadministrators oder ein beliebiges Benutzerkonto, das in der Gruppe Bereitstellungsadministratoren enthalten ist, kann den Bereitstellungs-Manager ausführen.

Wichtig

Bei nicht isolierten Plug-Ins wird bei der Plug-In-Registrierung eine Ausnahme ausgelöst, wenn das zu registrierende Benutzerkonto nicht in die Gruppe Bereitstellungsadministratoren aufgenommen werden kann. Die Ausnahmebeschreibung lautet: "Erforderliche Rechte zum Abschließen des Erstellungsvorgangs für eine SDK-Entität nicht vorhanden".

Für im Sandkasten (Isolationsmodus) registrierte Plug-Ins muss das Systembenutzerkonto, unter dem das Plug-In registriert ist, über die Systemadministratorrolle verfügen. Die Mitgliedschaft in der Gruppe Bereitstellungsadministratoren ist nicht erforderlich.

Siehe auch

Plug-In-Entwicklung
Debuggen eines Plug-Ins
Packen und Verteilen von Erweiterungen mithilfe von Dynamics 365 Customer Engagement (on-premises) Lösungen