Messages et entités pris en charge pour les plug-ins

Cette rubrique identifie les combinaisons de messages et d’entités qui prennent en charge l’exécution hors connexion de plug-ins pour Dynamics 365 for Microsoft Office Outlook avec Offline Access. Pour plus d’informations sur les plug-ins enregistrés sur le serveur qui n’ont pas l’exécution en mode hors connexion, voir Événements disponibles.

La colonne Disponibilité des messages du tableau affiché ci-dessous indique si un message est accessible en ligne, hors connexion, ou les deux. La colonne Déploiement d’entité indique si l’entité peut être déployée sur le serveur, sur le client, ou les deux. Une valeur null dans la colonne Entité principale signifie qu’il n’y a aucune entité principale associée au message. La même chose s’applique à la colonne Entité secondaire.

Dans le code de plug-in, vous pouvez envoyer un message aux services web sauf les messages qui créent ou mettent à jour les métadonnées.

Les entités personnalisées prennent en charge les mêmes messages de base que les entités système, selon que l’entité appartient à une organisation ou à un utilisateur. Pour plus d’informations, consultez Opérations sur les enregistrements d’entité.

Note

Le terme hors connexion s’applique à Dynamics 365 for Microsoft Office Outlook avec Offline Access. Le terme client peut s’appliquer à Dynamics 365 for Outlook Online ou Dynamics 365 for Microsoft Office Outlook avec Offline Access.

Si un message est accessible en ligne ou hors connexion, il peut être déterminé par programme ou via une requête en inspectant l’attribut SdkMessage.Availability. Pour afficher les métadonnées d’entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l’article Accès aux métadonnées de votre organisation. Vous pouvez également accéder à la documentation de référence pour les entités dans Référence d’entité.

Messages pris en charge pour les entités personnalisées

Les entités personnalisées peuvent soit appartenir à une organisation, soit appartenir à un utilisateur, ce qui définit l’ensemble des messages disponibles pour l’entité. Le tableau suivant répertorie les messages pour les entités personnalisées qui prennent en charge l’exécution de plug-ins.

Nom du message	Type de propriété	Disponibilité du message	Déploiement pris en charge par l’entité
Attribuer	Entités appartenant à un utilisateur uniquement	Serveur	Serveur
Créer	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur
Supprimer	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur
GrantAccess	Entités appartenant à un utilisateur uniquement	Serveur	Serveur
ModifyAccess	Entités appartenant à un utilisateur uniquement	Serveur	Serveur
Récupérer	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur
RetrieveMultiple	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur
RetrievePrincipalAccess	Entités appartenant à un utilisateur uniquement	Les deux	Serveur
RetrieveSharedPrincipalsAndAccess	Entités appartenant à un utilisateur uniquement	Les deux	Serveur
RevokeAccess	Entités appartenant à un utilisateur uniquement	Serveur	Serveur
SetState	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur
Mise à jour	Entités appartenant à un utilisateur et à une organisation	Les deux	Serveur

Messages pris en charge pour les entités par défaut

Avant d’envisager d’écrire un plug-in, vous devez vérifier que le message cible et la requête d’entité prennent en charge l’exécution des plug-ins. Comme Dynamics 365 est régulièrement mis à jour avec de nouveaux messages et entités, il est préférable d’interroger l’organisation pour ces informations. Cette opération s’effectue à l’aide de l’outil Plug-in Registration ou en exécutant une requête fetchXML comme décrit ci-dessous.

Pour contrôler si une combinaison de message et d’entité prend en charge l’exécution des plug-ins à l’aide de l’outil Plug-in Registration, procédez comme suit.

1. Exécutez l’outil et connectez-vous à une organisation D365.
2. Dans la liste Plug-ins enregistrés et activités de workflow personnalisées, développez l’assembly qui contient les plug-ins enregistrés. Vous pouvez même effectuer cette étape sur un assembly système car vous ne procèderez pas réellement l’inscription de l’étape.
3. Cliquez avec le bouton droit sur un plug-in de la liste et choisissez Inscrire une nouvelle étape.
4. Entrez le message cible et l’entité principale dans les champs appropriés pour voir si cette combinaison est prise en charge pour l’inscription du plug-in.
5. Annuler (fermer) le formulaire d’enregistrement de l’étape et quittez l’outil.

Pour contrôler si une combinaison de message et d’entité prend en charge l’exécution de plug-ins à l’aide d’une requête de base de données, utilisez la recherche avancée ou un outil de la communauté (par exemple, le Générateur FetchXML) pour exécuter la requête fetchXML suivante. Lorsque vous utilisez la Recherche avancée, vous devez créer la requête de manière interactive.

Pour les plug-ins hors connexion du client Outlook :

<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>

Voir aussi

Écrire des plug-ins pour étendre les processus d’entreprise
Événements disponibles
Développement de plug-ins