Guide pas-à-pas : créer un contrôle hébergé Windows Forms UII

Date de publication : novembre 2016

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

Ce guide pas-à-pas montre comment créer un contrôle hébergé Windows Forms d’User Interface Integration (UII) qui interagit avec le Unified Service Desk et les applications externes autonomes ou Web.

Dans ce guide pas-à-pas, vous effectuerez les opérations suivantes :

• Créer un contrôle hébergé Windows Forms d’User Interface Integration (UII), Exemple de contrôle hébergé Windows Forms UII, qui affiche le prénom, le nom, l’adresse et l’ID d’un contact lorsque vous recherchez des contacts et cliquez sur un nom de contact pour l’ouvrir dans une session du Unified Service Desk. Ces valeurs sont affichées à partir du contexte Unified Service Desk.

• Modifier le prénom, le nom ou l’adresse dans une application externe et une application Web hébergées dans le Unified Service Desk à partir du contrôle hébergé Windows Forms UII que nous créons. Les applications externes et Web ont été créées dans les guides pas-à-pas décrits précédemment : Guide pas-à-pas : créer un adaptateur d’application UII et Guide pas-à-pas : créer un adaptateur d’application Web UII.

• Signaler les modifications apportées au contexte Unified Service Desk pour mettre à jour les valeurs.

Contenu de la rubrique

Conditions préalables

Étape 1 : créer un contrôle hébergé Windows Forms UII à l’aide de Visual Studio

Étape 2 : définir le contrôle hébergé dans le Centre de services unifié

Étape 3 : définir les actions UII pour les contrôles hébergés de l’application externe et de l’application Web dans le Centre de services unifié

Tester le contrôle hébergé

Conditions préalables

• Microsoft .NET Framework 4.5.2

• Application cliente Unified Service Desk ; requise pour tester le contrôle hébergé.

• 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

• Modèles de SDK de Microsoft Dynamics 365 pour Visual Studio qui contiennent le modèle de projet de contrôle hébergé Windows Forms UII. Vous pouvez l’obtenir de l’une des méthodes suivantes :

  • Téléchargez le modèle de Kit de développement logiciel (SDK) de CRM. Double-cliquez sur le fichier CRMSDKTemplates.vsix pour installer le modèle dans Visual Studio.

  • Téléchargez le package Kit de développement logiciel (SDK) de CRM. Accédez au dossier SDK\Templates. Double-cliquez sur le fichier CRMSDKTemplates.vsix pour installer le modèle dans Visual Studio.

• Vous devez avoir effectué le Guide pas-à-pas : créer un adaptateur d’application UII et le Guide pas-à-pas : créer un adaptateur d’application Web UII pour vous assurer que l’application externe et l’application Web ont été configurées avec les adaptateurs respectifs pour faciliter l’interaction avec ces applications.

Étape 1 : créer un contrôle hébergé Windows Forms UII à l’aide de Visual Studio

1. Démarrez 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 > Unified Service Desk > Contrôle hébergé Windows Forms UII.

   2. Spécifiez le nom et l'emplacement du projet, puis cliquez sur OK pour créer un nouveau projet.

      

3. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le fichier UiiWinformControl.cs et sélectionnez Ouvrir pour afficher le concepteur Windows Forms.

4. Dans le concepteur, ajoutez les contrôles suivants à partir de la Boîte à outils :

   Type de contrôle	Nom	Texte
   Étiquette	lblFirstName	Prénom
   Étiquette	lblLastName	Nom
   Étiquette	lblAddress	Rue
   Étiquette	lblID	ID
   Zone de texte	txtFirstName
   Zone de texte	txtLastName
   Zone de texte	txtAddress
   Zone de texte	txtID
   Bouton	btnUpdate	Mettre à jour les valeurs dans les applications hébergées
   Bouton	btnUpdateContext	Mettre à jour le contexte

   Voici comment les contrôles doivent être présentés dans le concepteur.

   

5. Double-cliquez sur le bouton Mettre à jour les valeurs dans les applications hébergées (btnUpdate) pour ajouter le code de l’événement click pour ce bouton, puis ajoutez le code suivant.

   private void btnUpdate_Click(object sender, EventArgs e)
   {
      // This is how you fire an action to other hosted applications. 
      // The DoAction() code in the other application or application adapter 
      // will be called.
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateFirstName", txtFirstName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateLastName", txtLastName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateAddress", txtAddress.Text)); // For the external application
   
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateFirstName", txtFirstName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateLastName", txtLastName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateAddress", txtAddress.Text)); // For the external web application
   }
   

6. Accédez à la vue de conception, double-cliquez sur le bouton Mettre à jour le contexte (btnUpdateContext) pour ajouter le code de l’événement click pour ce bouton. Ajoutez le code suivant.

   private void btnUpdateContext_Click(object sender, EventArgs e)
   {
      // Get the current context and create a new context object from it.
      string temp = Context.GetContext();
      Context updatedContext = new Context(temp);
   
      // Update the new context with the changed information.
      updatedContext["firstname"] = txtFirstName.Text;
      updatedContext["lastname"] = txtLastName.Text;
      updatedContext["address1_line1"] = txtAddress.Text;
   
      // Notify Unified Service Desk of this new context information
      FireChangeContext(new ContextEventArgs(updatedContext));
   
      // Notify this UII hosted control about the change
      NotifyContextChange(updatedContext);
   }
   

7. Dans le même fichier (UiiWinformControl.cs), mettez à jour la définition remplacée de la méthode NotifyContextChange comme suit :

   public override void NotifyContextChange(Context context)
   {
      // Populating text fields from context information.
      txtFirstName.Text = context["firstname"];
      txtLastName.Text = context["lastname"];
      txtAddress.Text = context["address1_line1"];
      txtID.Text = context["CustomerID"];
   
      base.NotifyContextChange(context);
   }
   

8. Enregistrez votre projet, puis générez-le (Générer > Générer la solution). Lorsque le projet se génère correctement, un assembly (fichier .dll) est généré avec le même nom que le nom de votre projet (dans ce cas, UIIWindowsFormHostedConrol1.dll) dans le dossier /bin/debug de votre projet.

9. Copiez le fichier dans le répertoire d’installation de votre application cliente Unified Service Desk (généralement C:\Program Files\Microsoft Dynamics CRM USD\USD). Ce fichier est nécessaire pour tester, et éventuellement utiliser ce contrôle à partir de votre application cliente.

   Conseil

   Notez le nom de la classe utilisée pour générer votre contrôle hébergé UII dans le fichier UiiWinformControl.cs. Dans ce cas, il s’agit d’UiiWinformControl. Vous aurez besoin de ces informations dans l’étape suivante.

Étape 2 : définir le contrôle hébergé dans le Centre de services unifié

Pour héberger le contrôle hébergé Windows Forms UII dans le Unified Service Desk, vous devrez le définir et le configurer.

1. Connectez-vous à Microsoft Dynamics 365.

2. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres > Centre de services unifié.

3. Sur la page Centre de services unifié, cliquez sur Contrôles hébergés.

4. Sur la page Contrôles hébergés, cliquez sur Nouveau.

5. Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes :

   Champ	Valeur
   Nom	UIIWindowsFormHostedControl
   Nom complet	Exemple de contrôle hébergé Windows Forms UII
   Type de composant USD	Application hébergée CCA
   Application hébergée	Contrôle hébergé
   Application globale	Sélectionnée
   Afficher le groupe	MainPanel
   Adaptateur	N'utiliser aucun adaptateur
   URI d'assembly	UIIWindowsFormHostedControl1
   Type d'assembly	UIIWindowsFormHostedControl1.UiiWinformControl

   Notes

   URI d'assembly est le nom de votre assembly et Type d'assembly est le nom de votre assembly suivi d'un point (.), puis du nom de la classe dans votre projet Visual Studio. Dans cet exemple, le nom de l’assembly est UIIWindowsFormHostedControl1 et le nom de la classe est UiiWinformControl, qui est le nom de classe par défaut lorsque vous créez un contrôle hébergé Windows Forms UII.

   

6. Cliquez sur Enregistrer pour créer le contrôle hébergé.

Étape 3 : définir les actions UII pour les contrôles hébergés de l’application externe et de l’application Web dans le Centre de services unifié

Les adaptateurs des applications externes autonomes et Web exposent les trois actions suivantes : UpdateFirstName, UpdateLastName et UpdateAddress. Ces adaptateurs et les contrôles hébergés pour les applications externes autonomes et Web ont été créés dans les guides pas-à-pas décrits précédemment (Guide pas-à-pas : créer un adaptateur d’application UII et Guide pas-à-pas : créer un adaptateur d’application Web UII).

Pour mettre à jour les informations dans les applications externes à partir du contrôle hébergé UII Windows Forms, vous devrez définir trois actions UII avec le même nom que celui défini précédemment dans les adaptateurs pour chacune des applications externes. Dans les guides pas-à-pas décrits précédemment (Guide pas-à-pas : créer un adaptateur d’application UII et Guide pas-à-pas : créer un adaptateur d’application Web UII), vous avez défini les deux contrôles hébergés suivants dans le Unified Service Desk pour afficher les applications externes dans le Unified Service Desk : QsExternalApp et QsExternalWebApplication. Dans cette étape, vous allez ajouter trois actions UII pour chaque contrôle hébergé.

1. Connectez-vous à Microsoft Dynamics 365.

2. Sur la barre de navigation, choisissez Microsoft Dynamics 365 > Paramètres > Centre de services unifié.

3. Sur la page Centre de services unifié, choisissez Contrôles hébergés.

4. Sur la page Contrôles hébergés, recherchez QsExternalApp et ouvrez-le pour modification.

5. Sur la page QsExternalApp, cliquez sur la flèche vers le bas en regard du nom du contrôle hébergé, puis cliquez sur Actions UII.

6. Dans la page suivante, cliquez sur Ajouter une nouvelle action UII.

7. Saisissez le nom UpdateFirstName, puis cliquez sur Enregistrer et fermer. Cela ajoutera l’action dans la page précédente.

8. De même, ajoutez les deux actions suivantes : UpdateLastName et UpdateAddress. Toutes les trois actions deviennent disponibles pour le contrôle hébergé QsExternalApp.

   

9. Suivez les étapes 4 à 8 pour créer trois actions UII portant les mêmes noms pour le contrôle hébergé QsExternalWebApp.

Tester le contrôle hébergé

Avant de tester le contrôle hébergé Windows Forms UII, vérifiez que votre exemple d’application Web est en cours d’exécution afin qu’il s’affiche dans le Unified Service Desk.

1. Exécutez le client Unified Service Desk pour vous connecter à votre serveur Dynamics 365.

2. Une fois connecté, vous verrez trois contrôles hébergés : Exemple de contrôle hébergé Windows Forms UII, Exemple d’application Web externe et Exemple d’application externe.

   

3. Choisissez Rechercher, puis Contacts. Choisissez l’un des contacts pour afficher les informations du contact dans une session. Cela affiche également le prénom, le nom, l’adresse et l’ID de l’enregistrement de contact actuellement affiché dans tous les trois exemples de contrôle, comme indiqué dans l’illustration suivante :

   

4. Modifiez les valeurs dans l’Exemple de contrôle hébergé Windows Forms UII, puis cliquez sur Mettre à jour les valeurs dans les applications hébergées pour mettre à jour les valeurs dans les deux autres applications externes.

   

5. Dans l’Exemple de contrôle hébergé Windows Forms UII, cliquez sur Mettre à jour le contexte pour mettre à jour les informations de contexte dans le Unified Service Desk.

   

Voir aussi

Utiliser les contrôles hébergés UII avec le Centre de services unifié
Guide pas-à-pas : créer un contrôle hébergé WPF UII

Unified Service Desk 2.0

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