Procédure pas à pas 5 : afficher les informations de session améliorées

Article
2025-01-22

Dans le guide pas-à-pas précédent, Guide pas-à-pas 4 : Affichage d’un enregistrement des applications (applications Unified Interface) dans une session de votre application agent, vous avez appris à afficher votre enregistrement de client stocké dans une session dans 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 d’applications Unified Interface dans une session de votre application agent.

Configuration requise

Vous devez avoir parcouru le Guide pas-à-pas 1 : Création d’une application agent simple pour les applications Unified Interface et Guide pas-à-pas 4: Affichage d’un enregistrement d’applications Unified Interface au cours d’une session dans 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. En savoir plus : Guide pas-à-pas 1 : Création d’une application agent simple pour les applications Unified Interface
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’administrateur de Unified Service Desk.
Sélectionnez Contrôles hébergés sous Paramètres de base.
Sélectionnez + 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
Sélectionnez 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’administrateur de Unified Service Desk.
Sélectionnez Lignes de session sous Paramètres de base.
Sélectionnez + 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.

Sélectionnez 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’application Administrateur Unified Service Desk.
Sélectionnez Lignes de session sous Paramètres de base.
Sélectionnez + 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.

Sélectionnez 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 pour les applications Unified Interface.

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’administrateur de Unified Service Desk.
Sélectionnez Configuration sous Paramètres avancés.
Sélectionnez Configuration Contoso pour ouvrir la définition.
Sélectionnez l’onglet Contrôles hébergés, évènements et appels à l’action.
Sélectionnez les points de suspension (...) dans la section Contrôles hébergés, sélectionnez Ajouter un contrôle hébergé existant. Le volet Rechercher des incidents s’affiche.
Tapez le nom de l’appel à l’action mentionné dans le tableau ci-dessus dans la zone de recherche. Les appels à l’action sont affichés dans les résultats de la recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.
Sélectionnez l’onglet Lignes de session, scripts de l’agent et scriptlets.
Sélectionnez les points de suspension (...) dans la section Lignes de session, puis sélectionnez Ajouter une ligne de session existante. Le volet Rechercher des incidents s’affiche.
Tapez le nom de la ligne de session mentionnée dans le tableau ci-dessus dans la zone de recherche. La ligne de session s’affiche dans les résultats de la recherche. Sélectionnez l’enregistrement à partir de la liste, et sélectionnez Ajouter.
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 les applications Unified Interface. 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 à partir de votre application pilotée par modèle.
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.