Utiliser le contrôle commun de connexion de l’outil XRM dans vos applications clientes

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Le SDK Microsoft Dynamics CRM fournit un modèle pour Microsoft Visual Studio, qui vous permet d’utiliser le contrôle commun de connexion dans vos applications clientes. Le code pour l’authentification, le stockage et la récupération des informations d’identification et la journalisation des diagnostics Dynamics 365 est intégré dans le modèle afin que vous puissiez rapidement profiter de ces fonctionnalités dans vos applications clientes Windows pour Dynamics 365. Le contrôle commun de connexion est une implémentation de Microsoft.Xrm.Tooling.CrmConnectControl et le contrôle ressemble à l’image suivante.

Contenu de la rubrique

Conditions préalables

Créer une application WPF à l’aide du modèle de contrôle commun de connexion

Ajouter le modèle de contrôle commun de connexion à votre application WPF existante

Conditions préalables

• .NET Framework 4.5.2

• Microsoft Visual Studio 2012 ou Visual Studio 2013

• Gestionnaire de package NuGet pour Visual Studio 2012 ou Visual Studio 2013

• Modèles SDK Microsoft Dynamics CRM pour Visual Studio qui contiennent le modèle de contrôle commun de connexion. Vous pouvez l’obtenir de l’une des méthodes suivantes :

  • Télécharger le modèle de Kit de développement (SDK) Dynamics 365 à partir de la galerie Visual Studio, puis double-cliquer sur le fichier CRMSDKTemplates.vsix pour installer le modèle dans Visual Studio.

  • Télécharger et extraire le package (SDK) Dynamics 365. Le fichier de modèles, CRMSDKTemplates.vsix, est situé dans le dossier SDK\Templates. Double-cliquez sur le fichier CRMSDKTemplates.vsix pour installer le modèle dans Visual Studio.

Créer une application WPF à l’aide du modèle de contrôle commun de connexion

Voici un moyen rapide de créer une application Windows Presentation Foundation (WPF) qui tire profit du contrôle commun de connexion et du code sous-jacent pour l’authentification, le stockage et la réutilisation des informations d’identification et le traçage ou la journalisation par défaut.

1. Démarrez Microsoft Visual Studio et créez un projet.

2. Dans la boîte de dialogue Nouveau projet :

   1. Dans la liste des modèles installés, développez Visual C#, puis sélectionnez Modèles CRM SDK.

   2. Vérifiez que .NET Framework 4.5.2 est sélectionné.

   3. Sélectionnez Application WPF pour CRM.

   4. Spécifiez le nom et l’emplacement du projet, puis cliquez sur OK.

   

3. Pour tester le projet :

   1. Enregistrez le projet et appuyez sur F5, ou cliquez sur Débogage > Démarrer le débogage pour vérifier si la compilation du projet s’effectue correctement. Lorsque la compilation est réussie, une MainWindow s’affiche, avec le bouton Se connecter à CRM. Cliquez sur le bouton pour afficher le contrôle commun de connexion.

   2. Testez l’authentification en indiquant les informations d’identification pour vous connecter à Dynamics 365, puis cliquez sur Connexion. Un message affiche votre statut de connexion Dynamics 365.

Pour obtenir un exemple qui utilise le modèle de contrôle commun de connexion pour se connecter à Dynamics 365 et effectuer différentes opérations, voir Exemple : Démarrage rapide de l’API des outils XRM.

Ajouter le modèle de contrôle commun de connexion à votre application WPF existante

Si vous disposez déjà d’une application cliente WPF, vous pouvez facilement y ajouter le modèle de contrôle commun de connexion pour profiter de l’expérience de connexion uniforme et du code sous-jacent pour l’authentification, le stockage et la réutilisation des informations d’identification et le traçage ou la journalisation par défaut Dynamics 365. Dans ce cas, vous devez créer un contrôle dans l’interface utilisateur de votre application cliente existante pour appeler le contrôle commun de connexion, instancier une instance de l’objet de connexion Dynamics 365, puis utiliser l’objet de connexion pour effectuer plusieurs opérations dans Dynamics 365.

1. Ouvrez un projet d’application WPF existant dans Visual Studio. Dans cet exemple, supposons que le nom de votre projet d’application WPF est SampleWPFApp.

2. Ajoutez le modèle de contrôle commun de connexion à votre projet.

   1. Dans le volet Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Ajouter > Nouvel élément.

   2. Dans la boîte de dialogue Ajouter un nouvel élément, dans la liste des modèles installés, développez Visual C#, puis sélectionnez Modèles CRM SDK. Cliquez sur Formulaire de connexion CRM pour les applications WPF, puis cliquez sur OK.

      

3. Le contrôle de connexion CrmLoginForm1.xaml que vous venez d'ajouter s'affiche dans la zone du concepteur XAML. Si ce n'est pas le cas, double-cliquez sur le fichier CrmLoginForm1.xaml dans le volet Explorateur de solutions.

   

4. Vous devez désormais appeler le contrôle de connexion que vous venez d’ajouter à partir de votre application. Pour ce faire, ajoutez un contrôle Bouton dans votre fichier MainWindow.xaml, puis définissez respectivement le nom et le contenu sur btnSignIn et Se connecter à CRM.

   

5. Double-cliquez sur le bouton pour ajouter du code pour l’événement Click du bouton btnSignIn dans le fichier MainWindow.xaml.cs.

6. Ajoutez l’exemple de code suivant dans l’événement Click du bouton btnSignIn pour appeler le contrôle CrmLoginForm1, puis créez une instance de l’objet de connexion Dynamics 365.

   // Establish the Login control.
   CRMLoginForm1 ctrl = new CRMLoginForm1();
   
   // Wire event to login response. 
   ctrl.ConnectionToCrmCompleted += ctrl_ConnectionToCrmCompleted;
   
   // Show the login control. 
   ctrl.ShowDialog();
   
   // Handle the returned CRM connection object.
   // On successful connection, display the CRM version and connected org name 
   if (ctrl.CrmConnectionMgr != null && ctrl.CrmConnectionMgr.CrmSvc != null && ctrl.CrmConnectionMgr.CrmSvc.IsReady)
   {
       MessageBox.Show("Connected to CRM! Version: " + ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgVersion.ToString() + 
       " Org: " + ctrl.CrmConnectionMgr.CrmSvc.ConnectedOrgUniqueName, "Connection Status");
   
       // Perform your actions here
   }
   else
   {
       MessageBox.Show("Cannot connect; try again!", "Connection Status");
   }
   

7. Ajoutez la définition de l’événement ctrl_ConnectionToCrmCompleted sous l’événement Click du bouton :

   private void ctrl_ConnectionToCrmCompleted(object sender, EventArgs e)
   {
       if (sender is CRMLoginForm1)
       {
           this.Dispatcher.Invoke(() =>
           {
               ((CRMLoginForm1)sender).Close();
           });
       }
   }
   

8. Voici comment s’affiche votre fichier MainWindow.xaml.cs après l’ajout du code issu des deux étapes précédentes :

   

9. Pour tester le projet :

   1. Enregistrez le projet et appuyez sur F5, ou cliquez sur Débogage > Démarrer le débogage pour vérifier si la compilation du projet s’effectue correctement. Lorsque la compilation est réussie, une MainWindow s’affiche, avec le nouveau bouton Se connecter à CRM. Cliquez sur le bouton pour afficher le contrôle commun de connexion.

   2. Testez l’authentification en indiquant les informations d’identification pour vous connecter à Dynamics 365, puis cliquez sur Connexion. Si l’opération est réussie, un message s’affiche pour indiquer la version et le nom de l’organisation à laquelle vous êtes connecté. Cliquez sur OK pour fermer le message.

      

   3. Si vous cliquez à nouveau sur Se connecter à CRM, l’application vous invite à choisir les informations d’identification enregistrées lors de la dernière activité de connexion ou à entrer de nouvelles informations d’identification.

      

Voir aussi

Exemple : Démarrage rapide de l’API des outils XRM
Créer des applications clientes Windows à l’aide des outils XRM

© 2017 Microsoft. Tous droits réservés. Copyright