Guide pas-à-pas : Créer un contrôle hébergé personnalisé pour Unified Service Desk

Article
06/27/2024

Dans cette rubrique, vous allez apprendre à créer un contrôle hébergé personnalisé appelé My Custom Control avec une action personnalisée. Le contrôle hébergé personnalisé possède deux contrôles Windows Presentation Foundation (WPF) : un bouton qui appelle le contrôle hébergé du débogueur et une étiquette de texte affichant le nom d’utilisateur lorsqu’une action personnalisée MyCustomAction, est appelée.

Contenu de la section

Conditions préalables

Créer un contrôle hébergé personnalisé

Tester votre contrôle hébergé personnalisé

Conditions préalables

Microsoft .NET Framework 4.6.2
Application cliente Unified Service Desk ; l’application cliente est requise pour tester le contrôle hébergé
Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015
NuGet Package Manager pour Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015
Modèles SDK CRM pour Visual Studio qui contiennent le modèle de projet de contrôle hébergé personnalisé. Téléchargez les modèles CRM SDK depuis la galerie Visual Studio et double-cliquez sur le fichier CRMSDKTemplates.vsix pour installer le modèle dans Visual Studio.

Créer un contrôle hébergé personnalisé

Démarrez Visual Studio et créez un projet.
Dans la boîte de dialogue Nouveau projet :
1. Dans la liste des modèles installés, développez Visual C#, et sélectionnez Modèles CRM SDK>Unified Service Desk>Contrôle hébergé personnalisé USD.
2. Assurez-vous que .NET Framework 4.6.2 est sélectionné.
3. Spécifiez le nom et l’emplacement du projet, puis cliquez sur OK pour créer un nouveau projet.
Dans Explorateur de solutions, double-cliquez sur le fichier USDControl.xaml pour appeler le concepteur XAML.
Dans le concepteur, ajoutez les contrôles suivants à partir de la Boîte à outils :
- Étiquette : dans le volet Propriétés, définissez le Nom du contrôle sur « myLabel ».
- Bouton : dans le volet Propriétés, définissez le nom du contrôle sur « myButton » et le contenu sur Démarrer le débogueur.
  
  Voici à quoi ressemblent les contrôles dans le concepteur XAML.

Double-cliquez sur le bouton pour ajouter du code à l’arrière-plan de XAML. Vous serez dirigé vers la définition de l’événement Click de myButton dans le fichier USDControl.xaml.cs. Ajoutez la commande suivante.

private void myButton_Click(object sender, RoutedEventArgs e)
{
    if (!this.desktopAccess.AppExistsInUI("Debugger"))
    {
        this.desktopAccess.CreateDynamicApplication("Debugger");
    }
    this.FireRequestAction(new Microsoft.Uii.Csr.RequestActionEventArgs("Debugger", "default", null));
}

Définissez une action personnalisée pour le contrôle hébergé. Dans le fichier USDControl.xaml.cs, recherchez la définition remplacée de DoAction.
```
protected override void DoAction(Microsoft.Uii.Csr.RequestActionEventArgs args)
```
Ajoutez le code suivant dans la définition remplacée de DoAction pour définir une action personnalisée appelée MyCustomAction qui accepte un paramètre appelé username.
```
if (args.Action.Equals("MyCustomAction", StringComparison.OrdinalIgnoreCase))
{
    List<KeyValuePair<string, string>> actionDataList = Utility.SplitLines(args.Data, CurrentContext, localSession);
    string valueIwant = Utility.GetAndRemoveParameter(actionDataList, "username"); // assume there is a myKey=<value> in the data.

    if (!string.IsNullOrEmpty(valueIwant))
    {
        this.Dispatcher.Invoke(() => { this.myLabel.Content = valueIwant; });
    }
}
```
Pourboire

Le modèle fournit la plus grande partie du code sous forme de commentaires dans la définition remplacée de DoAction pour vous aider à vous familiariser rapidement avec le développement. Vous devez annuler les commentaires de la ligne de code et remplacer les valeurs d’espace réservé par vos valeurs.
Enregistrez votre projet, puis générez-le (Générer>Générer la solution) pour vérifier s’il se génère correctement.

Tester votre contrôle hébergé personnalisé

Lorsque votre projet se génère correctement, testez le contrôle hébergé personnalisé. Le test comporte deux parties : la définition du contrôle hébergé personnalisé sur le serveur, puis la connexion à Unified Service Desk sur le serveur, à l’aide de votre application cliente.

Définir le contrôle hébergé et l’action personnalisés

Connectez-vous à l’administrateur de Unified Service Desk.
Sélectionnez Contrôles hébergés sous Paramètres de base.
Sélectionnez + Nouveau.
Sur la page du contrôle hébergé, précisez ce qui suit :

Champ	Valeur
Nom	Mon contrôle hébergé personnalisé
Nom complet	Mon contrôle hébergé personnalisé
Type de composant Unified Service Desk	Contrôle hébergé USD
Application globale	Activée
Afficher le groupe	MainPanel

Sélectionnez l’onglet Hébergement et précisez ce qui suit :

Champ	Valeur
URI d’assembly	MyCustomControl
Type d’assembly	MyCustomControl.USDControl

Note

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

Sélectionnez Enregistrer pour créer le contrôle hébergé.
Créez l’action pour le contrôle hébergé que vous avez défini dans Visual Studio. Sélectionnez l’onglet Association, puis Actions UII.
Sélectionnez + Nouvelle action UII.
Tapez MyCustomAction dans le champ Nom, puis choisissez Enregistrer.

Votre contrôle hébergé et votre action personnalisés sont maintenant configurés sur le serveur Microsoft Dataverse.

Exécuter le client Unified Service Desk pour utiliser le contrôle hébergé personnalisé

Copiez l’assembly contenant la définition de votre contrôle hébergé personnalisé depuis le dossier de sortie du projet Visual Studio (<ProjectFolder>\bin\debug) vers le répertoire d’application du Unified Service Desk. Dans ce cas, vous allez copier le fichier MyCustomControl.dll dans le répertoire c:\Program Files\Microsoft Dynamics CRM USD\USD.
Exécutez le client Unified Service Desk à connecter à votre serveur Dataverse.
Une fois connecté, vous verrez le contrôle hébergé personnalisé, Mon contrôle hébergé personnalisé, sur votre bureau.
Cliquez sur Démarrer le débogueur pour lancer le contrôle hébergé Débogueur.
Pour tester l’action personnalisée, choisissez l’onglet Débogueur, puis cliquez sur la flèche vers le bas au-dessus de l’onglet Appels à l’action pour afficher la zone où vous pouvez tester les appels à l’action et les actions UII.
Choisissez l’onglet Action directe.
Dans la liste Contrôle hébergé, sélectionnez Mon contrôle hébergé personnalisé, et dans la liste Action, sélectionnez MyCustomAction.
Selon la définition de l’action personnalisée, cet appel à l’action requiert un paramètre appelé username ; ajoutez donc la valeur suivante dans le champ Données : Nom d’utilisateur=Sylvie Dubois.
Cliquez sur l’icône Exécuter l’action directe (), puis cliquez sur l’onglet Mon contrôle hébergé personnalisé. Le nom d’utilisateur spécifié s’affiche dans la zone d’étiquette.