Exemple : Créer un courrier électronique à l’aide d’un modèle

  • Article

Cet exemple indique comment instancier un enregistrement de courrier électronique à l’aide d’un message InstantiateTemplateRequest. Vous pouvez télécharger l’exemple ici.

Note

Cet exemple s'applique à Dynamics 365 Customer Engagement (on-premises) et Dataverse.

Comment exécuter cet exemple

  1. Téléchargez ou clonez le référentiel Dynamics365-Apps-Samples pour avoir une copie locale.
  2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l’instance Common Data Service à laquelle vous souhaitez vous connecter.
  3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s’ouvre chaque fois que vous exécutez l’exemple et vous devez entrer des informations sur l’instance Dataverse à laquelle vous souhaitez vous connecter et sur les informations d’identification que vous souhaitez utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

Les exemples de ce référentiel qui nécessitent une connexion à une instance Common Data Service pour s’exécuter incluent une référence liée au fichier dataverse/App.config.

En quoi consiste cet exemple

Le message InstantiateTemplateRequest doit être utilisé dans un scénario où il instancie un enregistrement de courrier électronique.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :

Installation

  1. Vérifie la version actuelle de l’organisation.
  2. Crée un enregistrement de compte.
  3. Définit le corps et l’objet du modèle de courrier électronique au format XML.
  4. Crée un modèle de courrier électronique.

Démontrer

  1. Le message InstantiateTemplateRequest est utilisé pour créer un message de courrier électronique avec un modèle.
  2. Sérialisez le message électronique vers XML enregistrez-le dans un fichier.

Nettoyer

Affichez une option pour supprimer l’enregistrement créé lors de l’Installation. La suppression est facultative si vous souhaitez vérifier les entités et les données créées par l’exemple. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.