Partager via

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

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Le SDK de Microsoft Dynamics 365 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.

Contrôle commun de connexion des outils XRM

Contenu de la rubrique

Configuration requise

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

Configuration requise

  • .NET Framework 4.5.2

  • Microsoft Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015

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

  • Connecté à Internet afin de pouvoir télécharger/restauration les packages Nuget requis lors de l'utilisation du modèle de projet.

  • Modèles de SDK de Microsoft Dynamics 365 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 Kit de développement (SDK) CRM dans la galerie Visual Studio, double-cliquez sur le fichier CRMSDKTemplates.vsix pour installer le mdoè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 Dynamics 365 SDK.

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

    3. Sélectionnez Application WPF pour Dynamics 365.

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

    Modèle d'Application WPF pour CRM

  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 à Dynamics 365. 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 Dynamics 365 SDK. Cliquez sur Formulaire de connexion Dynamics 365 pour les applications WPF, puis cliquez sur OK.

      Ajouter le modèle de contrôle commun de connexion

  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.

    Vérifier que le contrôle de connexion s'affiche correctement

  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 à Dynamics 365.

    Ajouter un contrôle pour appeler le formulaire de connexion

  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 :

    Exemple de code

  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 à Dynamics 365. 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.

      Résultats du test du projet

    3. Si vous cliquez à nouveau sur Se connecter à Dynamics 365, 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.

      Informations d'identification stockées

Voir aussi

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

Microsoft Dynamics 365

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