Configuration des notifications dans Unified Service Desk

Configurez les notifications de pile dans Unified Service Desk pour afficher les messages de notification automatiques pour vos agents du service clientèle qui contient des informations générales, relatives aux clients ou à un processus sur lesquelles l’agent peut agir. La disposition et le comportement du message de notification sont définis au format XAML à l’aide de formulaires dans Unified Service Desk, et s’affichent sous forme de messages automatiques flottants à l’aide du nouveau type de contrôle hébergé, Popup Notification. Pour plus d’informations, voir Notification de fenêtre contextuelle (contrôle hébergé)

Les notifications prennent en charge les paramètres d’actions, d’événements et de remplacement Unified Service Desk pour que vous définissiez les messages automatiques qui apparaissent lorsque des événements particuliers se produisent, interagissent avec d’autres contrôles hébergés, et affichent les informations contextuelles d’une session. Vous pouvez définir que plusieurs notifications s’affichent simultanément. Vous pouvez définir l’emplacement où une notification peut être affichée dans l’application d’agent, et les informations de délai d’expiration après lequel la notification disparaît automatiquement.

Les notifications peuvent être globales ou basées sur une session. Les notifications générales sont affichées en dehors d’une session et seront masquées uniquement si elles expirent ou si elles sont explicitement fermées par l’utilisateur. les notifications basées sur une session apparaissent uniquement dans une session, et basculer vers une autre session masquera la notification. Revenir à la session avec une notification affiche une notification à nouveau jusqu’à son expiration ou qu’elle soit explicitement fermée par l’utilisateur.

Définir la disposition et le comportement de la notification à l’aide de formulaires

Utilisez des formulaires Unified Service Desk pour définir la disposition et le comportement de vos formulaires. Lorsque vous définissez un nouvel enregistrement de formulaire, vous devez spécifier votre XAML dans le champ Majoration de l’enregistrement du formulaire pour définir la disposition.

Liaison de commande pour effectuer des actions UII, des appels à l’action, et des événements de notification

Il existe des commandes personnalisées WPF disponibles dans Unified Service Desk (assembly Microsoft.Crm.UnifiedServiceDesk.Dynamics) qui peuvent être associées aux contrôles WPF telles que des boutons et des liens hypertexte dans le formulaire XAML à héberger dans le contrôle de notification. Les commandes peuvent être associées aux contrôles qui implémentent l’interface ICommandSource. Plus d’informations, voir Présentation de commande.

Les commandes peuvent être utilisées pour exécuter des actions sur n’importe quel contrôle hébergé ou déclencher des événements du contrôle de notification qui héberge le formulaire XAML.

• Action UII : pour effectuer une action UII dans le formulaire XAML, spécifiez les valeurs suivantes pour Command et CommandParameter.

  Command
  CCA:ActionCommands.DoActionCommand

  CommandParameter
  Le paramètre de commande doit contenir le nom du contrôle hébergé sur lequel l’action doit être exécutée, le nom de l’action UII et les données d’action facultatives. Ces valeurs doivent être spécifiées dans le format d’URL suivant : https://uii/[HostedControlName]/[UIIActionName]?[ActionData].

  Notez que les différentes parties de l’URL doivent être encodées si nécessaire conformément aux directives standard. Par exemple, le caractère d’espace doit être encodé comme « %20 » ou « + ».

  Exemple
  Supposons qu’il existe un contrôle hébergé nommé Contact de type Page CRM, et que vous souhaitez effectuer l’action Open_CRM_Page sur ce contrôle avec les données d’action suivantes :

  LogicalName=contact  
  id=[[contact.Id]]  
  

  Ensuite, vous devez transférer l’URL suivante en tant que valeur CommandParameter vers votre formulaire XAML :

  https://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5D  
  

  Vous pouvez ensuite associer la commande à un clic de bouton dans le formulaire XAML comme suit :

  <Button Command="CCA:ActionCommands.DoActionCommand"  
  CommandParameter="https://uii/Contact/Open_CRM_Page?LogicalName%3Dcontact%0D%0Aid%3D%5B%5Bcontact.Id%5D%5D"  
  

• Appel d’action : peut servir d’alternative pour exécuter une action UII sur un contrôle hébergé sur lequel vous ne souhaitez pas encoder les données d’action et les placer dans le XAML. Pour effectuer un appel d’action dans le formulaire XAML, spécifiez les valeurs suivantes pour Command et CommandParameter.

  Command
  CCA:ActionCommands.DoActionCommand

  CommandParameter
  Le paramètre de commande doit contenir le nom de l’appel d’action à exécuter, et doit être spécifié dans le format d’URL suivant : https://actioncall/[ActionCallName].

  Notez que le nom de l’appel d’action doit être une URL encodée s’il contient des espaces ou des caractères spéciaux. Par exemple, le caractère d’espace doit être encodé comme « %20 » ou « + ».

  Exemple
  Supposons que vous vouliez exécuter un appel d’action nommé Open Contact Page.

  Ensuite, vous devez transférer l’URL suivante en tant que valeur CommandParameter vers votre formulaire XAML :

  https://actioncall/Open+Contact+Page  
  

• Événement : pour exécuter un événement dans le formulaire XAML, spécifiez les valeurs suivantes pour Command et CommandParameter.

  Command
  CCA:ActionCommands.UIIEvent

  CommandParameter
  Le paramètre de commande doit contenir le nom de l’événement éventuellement suivi d’un point d’interrogation (?) et les paramètres de l’événement sous la forme d’une chaîne de requête. Chaque paramètre est spécifié comme une paire de « nom = valeur » où le nom et la valeur doivent être une URL encodée si nécessaire. De plus, les paramètres doivent être séparés par « & ».

  Spécifiez le paramètre de commande au format suivant : [EventName]?[Name]=[Value]&[Name]=[Value]

  Exemple
  Supposons que vous souhaitiez déclencher un événement nommé OK avec les paramètres suivants.

  Name1=Value1  
  Name2=My Value  
  

  Ensuite, vous devez transférer ce qui suit en tant que valeur CommandParameter vers votre formulaire XAML :

  OK?Name1=Value1&Name2=My+Value  
  

Afficher le compte à rebours d’affichage dans les notifications

Vous pouvez utiliser le paramètre TimeoutProperty pour afficher un compte à rebours pour votre message de notification jusqu’à ce que le message s’affiche. La valeur du délai d’expiration d’un contrôle de notification est définie lorsque vous configurez l’action pour afficher le contrôle. Pour plus d’informations : Comment configurer une notification ?

Par exemple, vous pouvez ajouter un élément d’étiquette dans le formulaire XAML lié au paramètre TimeoutProperty pour afficher le compte à rebours en secondes après lequel le message de notification sera fermé. Par exemple :

<TextBlock Foreground="White" x:Name="lblElapsedTime" Margin="0,0,9,0"   
           HorizontalAlignment="Right" VerticalAlignment="Center" FontSize="20"   
           Grid.Column="1" Text="{Binding TimeoutProperty}" FontFamily="Calibri" />  

Exemple de XAML de notification

L’exemple de XAML suivant affiche une notification basée sur le nombre maximal de valeur de sessions configuré dans le paramètre de remplacement de votre instance, et affiche une notification lorsque vous atteignez la limite de session.

<Border xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"  
        xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"   
xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics"  
BorderBrush="Blue" BorderThickness="1">  
        <Grid Background="AliceBlue" Height="100" Width="400">  
<Grid.Resources>  
 <CCA:CRMImageConverter x:Key="CRMImageLoader" />  
<Style x:Key="ImageLogo" TargetType="{x:Type Image}">  
<Setter Property="Width" Value="16" />   
<Setter Property="Height" Value="16" />   
<!--<Setter Property="Margin" Value="5" /> -->  
</Style>  
    </Grid.Resources>   
            <Grid.RowDefinitions>  
                <RowDefinition Height="75"/>  
                <RowDefinition Height="*"/>  
            </Grid.RowDefinitions>  
            <Grid.ColumnDefinitions>  
            </Grid.ColumnDefinitions>  
            <Grid Grid.Row="0">  
                <Grid.ColumnDefinitions>  
                    <ColumnDefinition Width="50"/>  
                    <ColumnDefinition Width="350"/>  
                </Grid.ColumnDefinitions>  
<Image Style="{DynamicResource ImageLogo}" Source="{Binding Source=msdyusd_Email16, Converter={StaticResource CRMImageLoader}}" Grid.Column="0" />  
                <TextBlock TextWrapping="Wrap" Grid.Column="1" Text="You can have a maximum of [[$Global.maxNumberOfSessions]+] concurrent sessions open. To open a new session, close at least one of the existing ones."/>  
            </Grid>  
            <Grid Background="SkyBlue" Grid.Row="1">  
                <Grid.ColumnDefinitions>  
                    <ColumnDefinition Width="300"/>  
                    <ColumnDefinition Width="100"/>  
                </Grid.ColumnDefinitions>  
                <TextBlock Grid.Column="0">  
                    <Run Text="The notification closes in " />  
                    <Run Text="{Binding TimeoutProperty}" />  
                    <Run Text=" seconds"/>  
                </TextBlock>  
                <Button Height="20" Width="90" Grid.Column="1" Foreground="Black" Command="CCA:ActionCommands.UIIEvent" CommandParameter="Cancel">Close</Button>  
            </Grid>  
        </Grid>  
    </Border>  

Afficher des notifications à l’aide du contrôle automatique de notification

Utilisez les actions prédéfinies pour le contrôle Popup Notification pour afficher, masquer et fermer un message de notification.

À l’aide de l’action Show, vous pouvez spécifier le nom du formulaire à afficher, la position sur l’écran où vous souhaitez que le message de notification soit affiché, et la durée pendant laquelle la notification est affichée. Pour plus d’informations : Actions UII prédéfinies.

Utilisez les événements prédéfinis pour que le contrôle Popup Notification réponde aux actions de l’utilisateur effectuées dans le message de notification comme décrit précédemment. Vous pouvez également ajouter des actions supplémentaires pour un événement qui s’exécute lorsque l’événement se produit. Pour plus d’informations : Événements prédéfinis.

Utiliser les paramètres d’événements dans le formulaire utilisé pour les notifications

Le formulaire utilisé dans l’action Show du contrôle automatique de notification peut également utiliser les paramètres de l’événement qui a déclenché l’appel à l’action Show.

Les appels à l’action dans Unified Service Desk peuvent utiliser les paramètres d’événements sous la forme de paramètres de remplacement dans les données d’action. Pour rendre disponibles certains ou tous ces paramètres d’événements dans le formulaire XAML, vous pouvez ajouter des paramètres supplémentaires dans l’action Show différents de ceux prédéfinis. Par exemple, un paramètre d’action Show supplémentaire peut être ajouté en tant que :

Param1 = [[EventParam1]+] où EventParam1 représente un des paramètres de l’événement qui a déclenché l’appel à une action Show.

Le paramètre personnalisé ajouté peut être utilisé dans le formulaire XAML comme paramètre de remplacement comme tout autre paramètre de remplacement. Dans l’exemple ci-dessus, [[Param1]] peut être utilisé dans le formulaire XAML pour afficher les données.

Contrôles de notification multiples

Voir aussi

Notification de fenêtre contextuelle (contrôle hébergé)
Ajouter des appels à l’action à un événement

Se familiariser avec la configuration de votre application agent