Dialogue CRM (contrôle hébergé)

Utilisez le type de contrôle hébergé Dialogue CRM pour utiliser un dialogue. Vous pouvez appeler l’action StartDialog sur votre contrôle hébergé Dialogue CRM pour démarrer un dialogue dans Unified Service Desk.

Créer un contrôle hébergé Dialogue CRM

Lors de la création d’un contrôle hébergé, les champs de l’écran Nouveau contrôle hébergé varient selon le type de contrôle hébergé à créer. Cette section fournit des informations sur les champs spécifiques au type de contrôle hébergé Dialogue CRM. Pour obtenir des informations détaillées sur la création d’un contrôle hébergé, voir Créer ou modifier un contrôle hébergé.

Contrôle hébergé Dialogue CRM.

Dans l'écran Nouveau contrôle hébergé :

  • Dans la zone Unified Service Desk, sélectionnez Dialogue CRM dans la liste déroulante Type de composant USD.

  • La liste déroulante Type d'hébergement indique comment vous souhaitez que ce contrôle soit hébergé. Vous pouvez choisir WPF interne (valeur par défaut) ou Processus IE. Pour plus d'informations, voir Sélectionner une méthode d'hébergement pour les contrôles hébergés.

  • Dans la zone Propriétés courantes, activez la case à cocher Application globale pour définir le contrôle hébergé comme global. Les contrôles hébergés globaux peuvent être affichés en dehors de la session client. Des contrôles tels que le tableau de bord, le mur ou la recherche des agents sont des exemples courants de contrôles hébergés globaux. Les contrôles hébergés globaux n'ont pas de statut spécifique à une session, ainsi lorsque vous changez de session, ces mêmes contrôles hébergés globaux demeurent. Si la case à cocher est désactivée, le contrôle hébergé est basée sur la session. Les contrôles basés sur une session existent dans le contexte de la session client. Si l’utilisateur change de session, toutes les pages de session de la session précédente sont masquées.

  • Le champ Afficher le groupe présente le panneau où ce contrôle hébergé sera affiché. MainPanel est le plus courant pour ce type de contrôle hébergé. Pour plus d’informations sur les différents panneaux disponibles dans Unified Service Desk, voir Panneaux dans Unified Service Desk. Pour plus d’informations sur les autres champs Général, voir Créer ou modifier un contrôle hébergé.

Actions UII prédéfinies

Voici les actions prédéfinies pour ce type de contrôle hébergé.

Close

Cette action permet de fermer le contrôle hébergé.

FireEvent

Déclenche un événement défini par l’utilisateur à partir de ce contrôle hébergé.

Paramètre Description
nom Nom de l’événement défini par l’utilisateur.

Toutes les paires nom=valeur suivantes deviennent les paramètres de l’événement. Pour plus d’informations sur la création d’un événement défini par l’utilisateur, voir Créer un événement défini par l’utilisateur.

MoveToPanel

Cette action permet de déplacer les contrôles hébergés d’un panneau à l’autre au moment de l’exécution.

Paramètre Description
app Nom du contrôle hébergé à déplacer.
panel Panneau cible du contrôle hébergé.

New_CRM_Page

Crée une page for pour créer un enregistrement de l’entité spécifiée et traite la page comme une fenêtre contextuelle de l’hôte hébergé spécifié. Les règles de navigation dans la fenêtre sont évaluées afin de déterminer l’emplacement où la page de création de l’enregistrement d’entité est affichée.

Paramètre Description
Nom logique Nom logique de l’entité pour créer une nouvelle instance.

Note

Le reste des paramètres doit être composé de paires nom=valeur. Il s’agit des autres valeurs préremplies dans le formulaire pour créer un enregistrement pour l’entité spécifiée. Pour plus d’informations sur l’utilisation de cette action, voir l’étape 4 du Guide pas-à-pas 7 : Configuration de la génération de scripts d’agent dans votre application agent.

Open_CRM_Page

Ouvre une instance existante de l’entité spécifiée et identifiée par l’ID, et traite la page comme s’il s’agissait d’une fenêtre contextuelle provenant du contrôle hébergé spécifié. Les règles de navigation dans la fenêtre sont évaluées pour déterminer l’emplacement où la fenêtre contextuelle doit être affichée.

Paramètre Description
LogicalName Nom logique de l’entité à ouvrir.
id ID de l’enregistrement d’entité à ouvrir.

Ouvre une fenêtre contextuelle avec une URL à partir du contrôle hébergé et exécute les règles de navigation dans la fenêtre en fonction de cette URL, pour acheminer la fenêtre contextuelle à l’emplacement approprié.

Paramètre Description
URL Achemine une fenêtre contextuelle à partir de ce contrôle hébergé à l’aide de cette URL, comme s’il s’agissait d’une fenêtre contextuelle demandée à partir du contrôle affiché.
cadre Cadre d’où provient la fenêtre contextuelle.

RealignWindow

Affiche le contrôle hébergé à l’emplacement spécifié sur un moniteur. Vous pouvez afficher le contrôle hébergé sur deux moniteurs au maximum. Cette action s’applique aux instances de contrôle hébergé qui sont configurées pour être placées sur un volet de type USDFloatingPanel ou USDFloatingToolPanel.

Paramètre Description
écran Spécifie l’écran sur lequel afficher le contrôle hébergé. Les valeurs valides sont 1 ou 2. Si vous ne spécifiez pas ce paramètre, la valeur 1 est transmise par défaut.
gauche Spécifie la position, en pourcentage, à partir de la gauche de l’écran sur le moniteur cible où le contrôle hébergé doit être affiché. Les valeurs valides vont de 0 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 0 est transmise par défaut.
haut Spécifie la position, en pourcentage, à partir du haut de l’écran sur le moniteur cible où le contrôle hébergé doit être affiché. Les valeurs valides vont de 0 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 0 est transmise par défaut.
largeur Spécifie la largeur, en pourcentage, de la fenêtre du contrôle hébergé sur le moniteur cible. Les valeurs valides vont de 1 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 100 est transmise par défaut.
hauteur Spécifie la hauteur, en pourcentage, de la fenêtre du contrôle hébergé sur le moniteur cible. Les valeurs valides vont de 1 à 100. Si vous ne spécifiez pas ce paramètre, la valeur 100 est transmise par défaut.

SetSize

Cette action définit de façon explicite la largeur et la hauteur du contrôle hébergé. Ceci est particulièrement utile lorsque vous utilisez la fonction « automatique » dans vos dispositions de panneau.

Paramètre Description
width Largeur du contrôle hébergé.
height Hauteur du contrôle hébergé.

StartDialog

Cette action prend plusieurs paramètres, mais pour les dialogues qui ne sont pas relatifs à un enregistrement spécifique, vous pouvez spécifier simplement le paramètre Nom.

Paramètre Description
Name Nom du dialogue comme vu dans la section Paramètres>Processus de Microsoft Dataverse.
DialogId Vous pouvez également spécifier le dialogue par son ID. Si vous indiquez le paramètre DialogId, celui-ci sera utilisée par l'action au lieu du paramètre Nom.
Entity Il s'agit du seul type d'entité pour lequel le dialogue sera exécuté. Ceci est obligatoire si vous utilisez le paramètre DialogId. Il n'est pas obligatoire si le paramètre Nom est utilisé.
ID Il s'agit de l'ID de l'entité à laquelle la session de dialogue s'applique. Si ce paramètre n'est pas spécifié, le dialogue est exécuté sur la première entrée du type approprié dans le système.

Lorsque le dialogue est terminé, il invite l'utilisateur à fermer la fenêtre. Si l’utilisateur confirme, l’onglet de Unified Service Desk se fermera également, ce qui est intentionnel.

Événements prédéfinis

Les événements prédéfinis suivants sont associés à ce type de contrôle hébergé.

BrowserDocumentComplete

Survient lorsque le chargement de la page est terminé. Dans un type de contrôle hébergé Page CRM, cet événement se produit lorsque les données ont été enregistrées dans la liste des paramètres de remplacement. Cet événement se produit une seule fois, même si plusieurs cadres ont individuellement déclenché leurs événements BrowserDocumentComplete.

Paramètre Description
url URL de la page dont le chargement est terminé.

PopupRouted

Survient lorsqu'une fenêtre contextuelle a été acheminée par le système.

Paramètre Description
url URL de la fenêtre contextuelle qui a été acheminée.

Voir aussi

Page CRM (contrôle hébergé)
Actions UII
Événements
Guides pas-à-pas pour la configuration de Unified Service Desk
Types de contrôle hébergé et référence d'action/événement
Guide d'administration d'Unified Service Desk