Guide pas-à-pas 5 : Affichage d’informations de session améliorées avec le nom de la session et les données de vue d’ensemble

Article
06/27/2024

Dans le guide pas-à-pas précédent, Guide pas-à-pas 4 : Affichage d’un enregistrement d’applications Unified Interface dans une session de votre application agent, vous avez appris à afficher votre enregistrement de client stocké dans une session de Unified Service Desk. Toutefois, l’expérience serait meilleure si vous pouviez identifier chaque session avec un nom unique et des informations de vue d’ensemble clés sur l’enregistrement d’une session.

Ce guide pas-à-pas explique comment afficher de façon dynamique le nom et les informations de vue d’ensemble d’une session pour améliorer l’expérience d’interaction avec les clients de vos agents. Ce guide pas-à-pas a été créé sur la base du guide précédent, Guide pas-à-pas 4 : Affichage d’un enregistrement dans une session de votre application agent.

Configuration requise

Vous devez avoir effectué le Guide pas-à-pas 1 : Création d’une application agent simple et Guide pas-à-pas 4: Affichage d’un enregistrement dans une session de votre application agent. Les configurations que vous avez effectuées dans ces guides pas-à-pas sont nécessaires pour ce guide.
Ce guide suppose que vous utilisiez les mêmes informations d’identification utilisateur que celles du guide 1 pour vous connecter à l’application agent à la fin du guide pour tester l’application. Si un autre utilisateur doit tester l’application, vous devez attribuer cet utilisateur à la Configuration Contoso. Plus d’informations : Guide pas-à-pas 1 : Création d’une application agent simple
Vous devez connaître les éléments suivants dans Unified Service Desk :
- Types de contrôle hébergé Lignes de session et Onglets de session. Plus d’informations : Lignes de session (contrôle hébergé) et Onglets de session (contrôle hébergé)
- Configurer le nom et les informations de vue d’ensemble de la session. Pour plus d’informations : Configurer les informations de session
- Filtrez l’accès à l’aide de la configuration d’Unified Service Desk. Pour en savoir plus : Gérer l’accès à l’aide de la configuration Unified Service Desk

Dans ce guide pas-à-pas

Étape 1 : création d’un type de contrôle hébergé Lignes de session pour afficher les informations de vue d’ensemble de la session

Étape 2 : définition des informations de nom de la session

Étape 3 : définition des informations de vue d’ensemble de la session

Étape 4 : ajout des contrôles à la configuration

Étape 5 : test de l’application

Conclusion

Étape 1 : création d’un type de contrôle hébergé Lignes de session pour afficher les informations de vue d’ensemble de la session

Pour afficher les informations de vue d’ensemble de la session dans votre application agent, créez une instance de type de contrôle hébergé Lignes de session dans votre application agent.

Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Contrôles hébergés.
Cliquez sur Nouveau.
Dans la page Nouveau contrôle hébergé, spécifiez les valeurs suivantes :

Champ Valeur

Nom Vue d’ensemble de la session Contoso

Type de composant USD Lignes de session

Afficher le groupe SessionExplorerPanel
Cliquez sur Enregistrer.

Champ	Valeur
Nom	Vue d’ensemble de la session Contoso
Type de composant USD	Lignes de session
Afficher le groupe	SessionExplorerPanel

Étape 2 : définition des informations de nom de la session

Pour afficher dynamiquement le nom de l’onglet de la session, vous allez configurer une règle de lignes de session à l’aide des paramètres de remplacement.

Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Lignes de session.
Cliquez sur Nouveau.

Dans la page Nouvelles informations de session, spécifiez les valeurs suivantes :

Champ	Valeur
Commande	Toute valeur aléatoire, comme 5
Nom	Nom de la session Contoso
Entité sélectionnée	compte
Type	Nom de la session
Écran d’affichage	Session : [[account.name]] Nous utilisons les paramètres de remplacement pour configurer le format du nom de l’onglet de la session. Dans ce cas, le nom de la session est Session : suivi du nom de l’enregistrement de compte affiché dans la session.

Définissez le texte et la mise en forme du nom de l’onglet de session.

Cliquez sur Enregistrer.

Étape 3 : définition des informations de vue d’ensemble de la session

Définissez les informations de vue d’ensemble de la session à afficher dans le type de contrôle hébergé Lignes de session que vous avez configuré à l’étape 1.

Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Lignes de session.
Cliquez sur Nouveau.

Dans la page Nouvelles informations de session, spécifiez les valeurs suivantes.

Ordre : Toute valeur aléatoire, comme 6.
Nom : Informations de vue d’ensemble de la session Contoso
Entité sélectionnée : compte
TYpe : vue d’ensemble de la session

Afficher :

<Grid Margin="0"      xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"      xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics">  
  <Grid.RowDefinitions>  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
  </Grid.RowDefinitions>  
  <Grid.ColumnDefinitions>  
    <ColumnDefinition Width="80"/>  
    <ColumnDefinition Width="*" />  
    <ColumnDefinition Width="auto" />  
  </Grid.ColumnDefinitions>  
  <TextBlock Margin="5,0,0,0" Grid.Row="0" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="Primary Contact: [[account.primarycontactid.name]x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="1" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Text="[[account.address1_line1]x]"/>  
  <TextBlock Margin="5,0,0,0" Grid.Row="2" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_line2]+x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="3" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_line3]+x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="4" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_city]x], [[account.address1_stateorprovince]x] [[account.address1_postalcode]x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="5" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="Phone: [[account.telephone1]x]" />  
</Grid>

Note

Cet exemple utilise XAML et les paramètres de remplacement pour définir les informations de vue d’ensemble de la session qui affichent le contact principal, l’adresse et le numéro de téléphone du compte actif dans la zone de vue d’ensemble de la session.

Définir les informations de vue d’ensemble de la session.

Cliquez sur Enregistrer.

Étape 4 : ajout des contrôles à la configuration

Dans cette étape, vous allez ajouter le contrôle hébergé et les règles de lignes de session créés dans ce guide pas-à-pas à la Configuration Contoso pour montrer ces contrôles à l’utilisateur attribué à la configuration. Configuration Contoso a été créé dans Guide pas-à-pas 1 : Création d’une application agent simple.

Ajoutez les éléments suivants à la Configuration Contoso.

Nom du contrôle	Type de contrôle
Vue d’ensemble de la session Contoso	Contrôle hébergé
Nom de la session Contoso	Ligne de session
Informations de vue d’ensemble de la session Contoso	Ligne de session

Pour ajouter un contrôle à la configuration :

Connectez-vous à l’instance de Dynamics 365.
Accédez à Paramètres>Unified Service Desk.
Cliquez sur Configuration.
Cliquez sur Configuration Contoso pour ouvrir la définition.
Dans la barre de navigation, cliquez sur la flèche vers le bas en regard de Configuration Contoso, puis sélectionnez Contrôles hébergés.
À la page suivante, cliquez sur Ajouter le contrôle hébergé existant, tapez « Contoso Session Overview » dans la barre de recherche, puis appuyez sur ENTRÉE ou cliquez sur l’icône de recherche.
Dans la zone de résultats de recherche, cliquez sur le contrôle hébergé pour l’ajouter à la Configuration Contoso.
De même, ajoutez les contrôles de ligne de session en cliquant sur la flèche vers le bas en regard de Configuration Contoso, puis en cliquant sur Lignes de session.
Cliquez sur Enregistrer.

Étape 5 : test de l’application

Démarrez l’application cliente Unified Service Desk et connectez-vous à l’instance de Dynamics 365 où vous avez configuré Unified Service Desk en utilisant les mêmes informations d’identification utilisateur que vous avez attribuées à la Configuration Contoso dans Guide pas-à-pas 1 : Création d’une application agent simple. Pour plus d’informations sur la connexion à une instance de Dataverse à l’aide de l’application cliente Unified Service Desk, voir Se connecter à une instance d’application pilotée par modèle avec le client Unified Service Desk
Cliquez sur la flèche vers le bas en regard du bouton Rechercher dans la barre d’outils, puis cliquez sur Compte pour afficher les enregistrements de compte de votre instance de Dataverse.
Cliquez sur le développeur pour afficher le volet gauche (SessionExplorerPanel).
Cliquez sur l’un des enregistrements de compte pour afficher les informations de compte correspondantes dans une session de l’application agent. Notez que le nom de l’onglet de session affiche automatiquement le mot Session : suivi du nom du compte actif. Le volet gauche affiche les informations de vue d’ensemble de session qui ont été définies précédemment.
Si vous ouvrez un autre enregistrement de compte, il sera affiché dans une autre session de votre application cliente. Pour ouvrir un autre compte, cliquez sur la flèche vers le bas en regard du bouton Rechercher, cliquez sur Compte, puis cliquez sur un nom de compte pour afficher les informations de compte dans une autre session.

Conclusion

Dans ce guide pas-à-pas, vous avez vu comment utiliser les règles de configuration de lignes de session pour afficher de façon contextuelle le nom de l’onglet de la session et les informations de vue d’ensemble clés de l’enregistrement d’une session dans votre application agent. Vous avez également appris à filtrer l’accès aux contrôles du Unified Service Desk à l’aide de la configuration.