Unterstützte Meldungen für Entitäten und Plug-Ins

Dieses Thema identifiziert die Kombinationen von Nachrichten und Entitäten, die die Offline-Ausführung von Plug-ins für Dynamics 365 for Microsoft Office Outlook mit Offline Access unterstützen. Informationen zu serverseitig registrierten Plugins, die keine Offline-Ausführung erfordern, finden Sie unter Verfügbare Ereignisse.

Die Spalte Meldungs-Verfügbarkeit der Tabelle gibt an, ob eine Meldung im online, offline oder auf beide Arten verfügbar ist. In der Spalte Entitäts-Bereitstellung wird angegeben, ob die Entität auf dem Server, auf dem Client oder auf beiden bereitgestellt werden kann. Ein Wert von NULL in der Spalte Primäre Entität bedeutet, dass keine primäre Entität vorhanden ist, die der Meldung zugeordnet ist. Das gleiche gilt für die Spalte Sekundäre Entität.

Im Plug-In-Code können Sie beliebige Meldungen an die Webdienste senden, außer solchen Meldungen, mit denen Metadaten erstellt oder aktualisiert werden.

Benutzerdefinierte Entitäten unterstützt die gleichen Grundmeldungen wie Systementitäten, je nach dem, ob die Entität organisationseigen oder benutzereigen ist. Weitere Informationen finden Sie unter Actions on Entity Records.

Notiz

Der Begriff offline gilt für die Dynamics 365 for Microsoft Office Outlook mit Offline Access. Der Begriff Client kann entweder für Dynamics 365 for Outlook Online oder Dynamics 365 for Microsoft Office Outlook mit Offline Access gelten.

Ob eine Meldung online oder offline verfügbar ist, kann programmgesteuert oder über eine Abfrage ermittelt werden, indem das Attribut SdkMessage.Availability untersucht wird. Zum Anzeigen der Entitätsmetadaten für Ihre Organisation installieren Sie die Metadatenbrowserlösung, die in Durchsuchen der Metadaten für Ihre Organisation beschrieben ist. Sie können die Referenzdokumentation für Entitäten auch in der Entitätsreferenz durchsuchen.

Unterstützte Meldung für benutzerdefinierte Entitäten

Benutzerdefinierte Entitäten können entweder organisationseigen oder benutzereigen sein. Das definiert den Satz an Meldungen, der für die Entität verfügbar ist. Die folgende Tabelle enthält die Meldungen für benutzerdefinierte Entitäten, die die Ausführung von Plug-Ins unterstützen.

Name der Nachricht	Besitztyp	Meldungs-Verfügbarkeit	Entitätsunterstützte Bereitstellung.
Zuweisen	Nur benutzereigene Entitäten	Server	Server
Erstellen	benutzereigene und organisationseigene Entitäten	Beide	Server
Löschen	benutzereigene und organisationseigene Entitäten	Beide	Server
GrantAccess	Nur benutzereigene Entitäten	Server	Server
ModifyAccess	Nur benutzereigene Entitäten	Server	Server
Abrufen	benutzereigene und organisationseigene Entitäten	Beide	Server
RetrieveMultiple	benutzereigene und organisationseigene Entitäten	Beide	Server
RetrievePrincipalAccess	Nur benutzereigene Entitäten	Beide	Server
RetrieveSharedPrincipalsAndAccess	Nur benutzereigene Entitäten	Beide	Server
RevokeAccess	Nur benutzereigene Entitäten	Server	Server
SetState	benutzereigene und organisationseigene Entitäten	Beide	Server
Aktualisieren	benutzereigene und organisationseigene Entitäten	Beide	Server

Unterstützte Meldungen für Standardentitäten

Bevor Sie erwägen, ein Plug-in zu schreiben, sollten Sie überprüfen, ob die Ziel-Message und Entity-Request die Ausführung von Plug-Ins unterstützt. Da Dynamics 365 regelmäßig mit neuen Nachrichten und Entitäten aktualisiert wird, ist es am besten, das Unternehmen nach diesen Informationen zu fragen. Dies kann mit dem Plug-in-Registrierungstool oder mit einer fetchXML-Abfrage wie unten beschrieben geschehen.

Um zu überprüfen, ob eine Kombination aus Nachricht und Entität die Ausführung von Plugins mit dem Plug-in-Registrierungstool unterstützt, führen Sie diese Schritte aus.

1. Führen Sie das Tool aus und verbinden Sie sich mit einem D365-Unternehmen.
2. Erweitern Sie in der Liste Registrierte Plug-ins & angepasste Workflow-Aktivitäten eine Assembly, die registrierte Plug-ins enthält. Sie können diesen Schritt sogar auf einer Systembaugruppe durchführen, da Sie die Schrittregistrierung nicht tatsächlich abschließen werden.
3. Klicken Sie mit der rechten Maustaste auf ein Plugin in der Liste und wählen Sie Neuen Schritt registrieren.
4. Geben Sie die Ziel-Message und die primäre Entität in die entsprechenden Felder ein, um zu prüfen, ob diese Kombination für die Plugin-Registrierung unterstützt wird.
5. Abbrechen (Schließen) des Registrierungsformulars und Verlassen des Tools.

Um zu überprüfen, ob eine Kombination aus Nachricht und Entität die Ausführung von Plug-Ins mit einer Datenbankabfrage unterstützt, verwenden Sie die erweiterte Suche oder ein Community-Tool (z. B. FetchXML Builder), um die folgende fetchXML-Abfrage auszuführen. Wenn Sie die erweiterte Suche verwenden, müssen Sie die Abfrage interaktiv erstellen.

Für Outlook-Client Offline-Plugins:

<fetch>
  <entity name='sdkmessage' >
    <attribute name='name' />
    <link-entity name='sdkmessagefilter' alias='filter' to='sdkmessageid' from='sdkmessageid' link-type='inner' >
      <filter type='and' >
        <condition attribute='iscustomprocessingstepallowed' operator='eq' value='1' />
        <condition attribute='isvisible' operator='eq' value='1' />
        <condition attribute='availability' operator='ne' value='0' />
      </filter>
      <attribute name='primaryobjecttypecode' />
    </link-entity>
    <filter>
      <condition attribute='isprivate' operator='eq' value='0' />
      <condition attribute='name' operator='not-in' >
        <value>SetStateDynamicEntity</value>
        <value>RemoveRelated</value>
        <value>SetRelated</value>
        <value>Execute</value>
      </condition>
    </filter>
    <order attribute='name' />
  </entity>
</fetch>

Siehe auch

Schreiben von Plug-Ins, um Geschäftsprozesse zu erweitern
Folgende Ereignisse sind verfügbar
Plug-In-Entwicklung