Partager via

Gestionnaire de bureau CTI (contrôle hébergé)

  • Article

Utilisez le type de contrôle hébergé Gestionnaire de bureau CTI pour brancher un adaptateur CTI (couplage téléphonie-informatique) à Unified Service Desk afin de gérer l’affichage des écrans contextuels, l’acheminement des appels, le contrôle des téléphones logiciels et d’autres fonctions de CTI.

Créer un contrôle hébergé Gestionnaire de bureau CTI

Pour plus d’informations sur la création d’un Gestionnaire de bureau CTI et la configuration du contrôle hébergé correspondant, voir Créer un gestionnaire de bureau CTI.

Actions UII prédéfinies

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

Fermer

Cette action permet de fermer le contrôle hébergé. Contrairement à l’action CloseActive, si cet onglet (contrôle hébergé) contient plusieurs pages, elle fermera toutes les pages affichées dans l’onglet de votre application agent.

CloseAndPrompt

Cette action ferme le contrôle hébergé, mais invite l’utilisateur à enregistrer ou abandonner les modifications avant la fermeture.

DisableToolbarButton

Cette action désactive le bouton de barre d’outils spécifié dans la barre d’outils de votre application agent.

Paramètre Description
Nom du bouton de barre d’outils à désactiver.

EnableToolbarButton

Cette action active le bouton de barre d’outils spécifié dans la barre d’outils de votre application agent.

Paramètre Description
Nom du bouton de barre d’outils à activer.

Rechercher

Accédez à la vue de la liste de recherche rapide de l’entité spécifiée.

Paramètre Description
Le paramètre de données doit spécifier le nom logique de l’entité de la vue de la liste de recherche rapide à afficher. Il existe des valeurs spéciales pour les incidents :

- Utilisez case ou incident pour afficher la vue de liste de recherche rapide des incidents.
- Utilisez advfind pour afficher la vue de recherche avancée.
- Utilisez activities ou activity pour afficher la vue de liste de recherche rapide des activités.

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.

GoBack

Cette action revient à cliquer sur le bouton Précédent de l’instance de navigateur.

GoForward

Cette action revient à cliquer sur le bouton Suivant de l’instance de navigateur.

GoHome

Cette action permet d’accéder à l’URL initiale spécifiée pour cette instance de navigateur.

LoadArea

Cette action charge une zone spécifique à partir des applications pilotées par modèle. Cela revient à sélectionner une zone du volet de navigation (telle que Ventes, Service et Marketing). Le seul paramètre est le nom de la zone sur laquelle cliquer. Par exemple : areaService.

Paramètre Description
cadre Nom du cadre à affecter. Si aucun nom n’est spécifié, il visera automatiquement le premier cadre trouvé dans la page.

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.
panneau Panneau cible du contrôle hébergé.

Cette action permet d’accéder à l’URL des applications pilotées par modèle.

Paramètre Description
url URL à laquelle accéder. Ce paramètre est obligatoire.
Noscan Si ce paramètre est fourni et qu’il est défini sur Vrai, les paramètres de données ne seront pas capturés à partir de la page.
HideCommandBar Si ce paramètre est fourni et qu’il est défini sur Vrai, le cadre interne s’affiche sans charger la barre de commandes des applications pilotées par modèle.
HideNavigationBar Si ce paramètre est fourni et qu’il est défini sur Vrai, le formulaire interne s’affiche sans charger la barre de navigation des applications pilotées par modèle.
Cadre Lorsqu’il y a des cadres dans la page, ce paramètre spécifie le nom du cadre pour la navigation, plutôt que de naviguer via la fenêtre principale.
postdata Données envoyées au serveur dans le cadre d’une transaction HTTPPOST. Une transaction POST est généralement utilisée pour envoyer les données collectées par une page HTML. Dans Unified Service Desk, ces données peuvent être reçues de tout événement déclenché à l’aide de « <https://event/?> ». Exemple : [[postdata]+]

Par ailleurs, les données sont transmises en tant que chaîne encodée avec son type d’en-tête au format attendu.
header Valeur de chaîne contenant des en-têtes HTTP supplémentaires à envoyer au serveur. Lorsque le paramètre postdata est utilisé dans l’action Navigate, vous devez également spécifier la valeur appropriée pour le paramètre header. Exemple : Content-Type:application/x-www-form-urlencoded

Si un événement Unified Service DeskPOST déclenche l’action Navigate, la valeur par défaut de ce paramètre doit être header=[[header]+]

New_CRM_Page

Crée une page for pour créer un nouvel enregistrement des applications pilotées par modèle 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.

ReRoute

Cette action prend l’URL actuellement affichée et l’envoie via les règles de navigation dans la fenêtre, à partir du contrôle hébergé actuel, comme une fenêtre contextuelle.

RunScript

Cette action injecte JavaScript dans le cadre principal de l’application. Vous devez éviter d’utiliser les appels du Kit de développement logiciel du client Microsoft Dataverse avec cette action. Utilisez plutôt l’action RunXrmCommand.

Paramètre Description
Le paramètre de données est le JavaScript qui sera injecté dans le formulaire. Remarque : notez que les paramètres de remplacement peuvent être utilisés dans le script et qu’ils seront remplacés avant l’exécution du script.

RunXrmCommand

Cette action permet d’injecter un code Javascript SDK Dataverse au formulaire des applications pilotées par modèle.

Paramètre Description
Le paramètre de données est le JavaScript qui sera injecté dans le formulaire. Remarque : notez que les paramètres de remplacement peuvent être utilisés dans le script et qu’ils seront remplacés avant l’exécution du script.

Enregistrer

Cette action enregistre la page actuelle.

SaveAll

Cette action enregistre tous les formulaires d’un contrôle hébergé qui permet l’affichage de plusieurs pages (Autoriser plusieurs pages = Oui). Si le contrôle hébergé permet l’affichage d’une seule page (Autoriser plusieurs pages = Non), il est équivalent à l’action Enregistrer.

SaveAndClose

Cette action permet d’enregistrer les données modifiées dans le formulaire des applications pilotées par modèle, et ferme le contrôle hébergé.

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é.

ToggleNavigation

Cette action réduit ou développe le volet de navigation du panneau gauche de la fenêtre des applications pilotées par modèle. La navigation doit contenir un volet de navigation pour que cela fonctionne.

ToggleRibbon

Cette action réduit ou agrandit le ruban. Si vous masquez le ruban dans l’action Naviguer, il n’est pas affiché et cette action ne fonctionne pas. Cette action s’exécute uniquement lorsque le ruban a été initialement chargé.

WaitForComplete

Cette action permet de bloquer le traitement jusqu’à ce que l’URL ait terminé le chargement.

Note

Certaines pages web, en particulier les pages des applications pilotées par modèle, ont plusieurs cadres. Cette action attend uniquement la fin du chargement du cadre principal.

Paramètre Description
Millisecondes Paramètre facultatif pour indiquer la durée d’attente, en millisecondes, avant l’expiration du délai.

Événements prédéfinis

Ce sont les événements prédéfinis pour ce type de contrôle hébergé.

BrowserDocumentComplete

Survient lorsque le chargement de la page est terminé.

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

FrameLoadComplete

Survient à tout moment lorsque le chargement d’un cadre est terminé. Cet événement peut se produire plusieurs fois par chargement de page lorsqu’un iFrame ou un cadre est utilisé dans la page. Cet événement correspond aux événements BrowserDocumentComplete individuels dans le code.

Paramètre Description
cadre Nom du cadre dont le chargement est terminé.
URL URL du cadre 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

Assurer l’intégration aux systèmes CTI à l’aide d’adaptateurs CTI