Gestionnaire global (contrôle hébergé)

Article
03/06/2017

Date de publication : novembre 2016

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Le type de contrôle hébergé Gestionnaire global est le coeur de Unified Service Desk, et une instance de ce contrôle hébergé est requise par Unified Service Desk. Ce contrôle hébergé charge et lit toutes les données de configuration de Unified Service Desk provenant de Microsoft Dynamics 365 au démarrage de l'application, il interprète les règles de navigation dans la fenêtre, il fournit des données aux composants de la barre d'outils et aux scripts de l'agent, et il gère les données de la session. Seule une instance du type de contrôle hébergé Gestionnaire global peut être chargée.

Important

Les trois exemples de packages d'application pour Unified Service Desk, New Environment, CRM Web Client, et Interactive Service Hub, sont préconfigurés avec une instance dont le type de contrôle hébergé est Gestionnaire global. Pour plus d'informations sur les exemples d'applications, voir TechNet : Déployer des exemples d'applications Unified Service Desk sur le serveur CRM à l'aide de Package Deployer.

En plus de fournir une interprétation pour la plupart des fonctionnalités de Unified Service Desk, le type de contrôle hébergé Gestionnaire global fournit des fonctionnalités multilingues dans le système afin de vous permettre de localiser des chaînes et des messages de l'interface utilisateur de votre application, dans plusieurs langues. Pour plus d'informations, voir Ajouter la prise en charge de plusieurs langues dans vos applications agent. Il fournit également le fournisseur de recherche, qui est conçu pour être générique et adaptable dans la configuration.

Contenu de la rubrique

Créer un contrôle hébergé Gestionnaire global

Actions UII prédéfinies

Événements prédéfinis

Créer un contrôle hébergé Gestionnaire global

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

Dans l'écran Nouveau contrôle hébergé, dans la zone Unified Service Desk, sélectionnez Gestionnaire global dans la liste déroulante Type de composant USD. En outre, veillez à définir la valeur Ordre de tri de ce contrôle hébergé sur 2 pour garantir qu'il est chargé par votre application agent immédiatement après que la connexion ait été établie avec Dynamics 365 à l'aide du contrôle hébergé Gestionnaire de la connexion. Pour plus d'informations sur les autres champs Général, voir Créer ou modifier un contrôle hébergé.

Une fois l'enregistrement sauvegardé, la zone Services linguistiques devient accessible lorsque vous ajoutez des ressources pour l'ajout de chaînes localisée pour l'interface utilisateur de votre application agent. Pour plus d'informations sur l'ajout de ressources linguistiques, voir Ajouter la prise en charge de plusieurs langues dans vos applications agent.

Actions UII prédéfinies

Le Gestionnaire global fournit une série d’actions prédéfinies qui vous permettent de manipuler les données d’enregistrement Dynamics 365 via les services Web. Ce code peut être utilisé lors de la configuration pour exécuter des fonctions avancées dans Dynamics 365.

Les actions UII prédéfinies suivantes sont disponibles pour le type de contrôle hébergé Gestionnaire global :

Audit

Ajoutez une entrée d'audit dans les journaux d'audit Unified Service Desk. Pour plus d'informations, voir TechNet : Configure auditing in Unified Service Desk (Configurer l'audit dans Unified Service Desk)

Paramètre	Description
Nom	Nom de l'entrée d'audit. Vous devez ajouter une option dans la zone Options (Paramètres > Unified Service Desk > Options (Comment y accéder ?)) avec la valeur définie sur 1.
Action	Chaîne représentant l'action qui est en cours d'audit.
TargetApplication	Chaîne représentant l'application cible pour l'audit.
CustomerId	Chaîne représentant l'ID du client.
ContextId	Chaîne représentant l'ID du contexte.
ApplicationId	GUID du contrôle hébergé pour l'audit.
AgentState	Chaîne représentant le statut de l'agent
ActionData	Données à inscrire vers l'entrée d'audit. Si ce paramètre n'est pas explicitement indiqué, il utilisera toutes les lignes restantes du champ Données de la définition d'appel à l'action.

CallDoAction

Appelle une action sur un autre contrôle hébergé.

Paramètre	Description
panneau	Il s'agit du panneau où trouver l'application active, si aucune application n'est spécifiée.
action	Il s'agit de l'action permettant d'appeler le contrôle hébergé.
Données	Il s'agit du paramètre de données à transmettre à l'action.
application	Il s'agit du nom du contrôle hébergé pour lequel vous souhaitez exécuter un appel à l'action. S'il est spécifié, le paramètre panneau est ignoré.

ClearAppBar

Détache le contrôle hébergé spécifié de l'application cliente.

Paramètre	Description
ApplicationName	Nom du contrôle hébergé à détacher. Si ce paramètre n'est pas fourni, la fenêtre principale de l'application cliente est détachée.

ClearEntityList

Efface la liste des résultats de recherche accumulés et doit toujours être appelée avant d'appeler l'action DoSearch

Paramètre	Description
global	À définir sur True si vous souhaitez que les résultats de la recherche liés à la session globale soient effacés. Vous devez être prudent lorsque vous stockez des résultats de recherche dans la session globale, car ces derniers ne sont pas automatiquement effacés par le système. Dans ce cas, vous devez appeler l'action ClearEntityList avant d'appeler l'action DoSearch.

Fermer

Ferme le contrôle hébergé. Contrairement à l'action CloseActive, si cet onglet contient plusieurs pages, elle fermera toutes les pages affichées dans l'onglet de votre application agent.

CloseActive

Ferme le contrôle hébergé actif dans le panneau spécifié.

Paramètre	Description
	La première ligne de l'appel à l'action doit contenir le nom du panneau pour localiser l'application active. Si aucun paramètre n'est spécifié, on suppose qu'il s'agit du de MainPanel.

CopyToClipboard

Copie ou ajoute l'URL d'article dans le Presse-papiers.

Paramètre	Description
data	Données qui doivent être copiées. Vous pouvez également utiliser les paramètres de remplacement. Par exemple : data=[[$context.title]]
append	Indique si les données sont ajoutées ou non au Presse-papiers. Définissez true ou false. Par exemple : append=false.

CopyToContext

Copie une valeur ou une série de valeurs vers les variables de contexte. Les variables de contexte peuvent être sérialisées avec la session. Cette action prend une série de paires nom=valeur. Le nom est le nom de la variable de contexte.

CopyLogicalEntityToContext

Copie les valeurs provenant d'une section entière des paramètres de données dans le contexte.

Paramètre	Description
LogicalName	Type ou section de paramètres de données à partir duquel ou de laquelle copier les valeurs.

CloseActivity

Ferme un enregistrement d'activité dans Dynamics 365.

Paramètre	Description
ID	GUID de l’enregistrement d’activité à fermer.
LogicalName	Nom logique de l’entité à fermer.
StatusCode	Nom complet du code de statut final après la fermeture de l’activité.
StateCode	Nom complet du code d’état final après la fermeture de l’activité.

Par exemple, pour fermer une activité d’appel téléphonique, vous devez spécifier les éléments suivants :

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

Une fois l’enregistrement d’activité fermé, le paramètre de remplacement système $Return sera rempli avec une valeur booléenne indiquant si l’action a été terminée.

CreateEntity

Crée un enregistrement dans Dynamics 365.

Paramètre	Description
LogicalName	Nom logique de l'entité à créer

Chaque ligne suivante de la liste de paramètres contient une série de paires Nom=Valeur qui définiront vos autres champs à renseigner au moment de la création.

Les références d'entité peuvent être décrites comme suit :

Param=EntityReference(“logicalname”, “id”)

OptionSetValues peut être spécifié comme suit :

Param=OptionSetValue(value)

Les Valeurs booléennes peuvent être décrites comme suit :

Param=Boolean(value)

PartyList (utilisé avec le courrier électronique) peut être décrit comme suit :

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

Vous pouvez utiliser n'importe quel nombre de email ou d'entrées er pour représenter les adresses de messagerie et les références d'entité, respectivement.

Les autres valeurs, telles que les valeurs de chaîne, peuvent être spécifiées comme suit :

Param=value

Une fois l'enregistrement créé, la valeur $Return sera remplie avec le GUID de l'enregistrement qui vient d'être créé.

CreateSession

Crée une session.

DeleteEntity

Supprime un enregistrement dans Dynamics 365.

Paramètre	Description
ID	ID de la valeur à supprimer. Ce doit être le GUID de l'enregistrement à supprimer.
LogicalName	Nom logique de l’entité à supprimer.

DoRoute

Permet de tester vos règles de navigation dans la fenêtre en simulant une fenêtre contextuelle à partir d'un contrôle hébergé spécifique. Elle peut être utilisée en production pour déclencher les règles de navigation dans la fenêtre manuellement, comme souhaité.

Paramètre	Description
nom	ID de l'entité qui est la cible de queueItem
Entité	Nom logique de l'entité qui est ouverte dans une fenêtre contextuelle.
id	ID de l'entité qui sera ouverte dans une fenêtre contextuelle.
cadre	Cadre à partir duquel la fenêtre contextuelle doit s'afficher.

DoSearch

Appelle les services Web de Dynamics 365 avec FetchXML défini comme recherche d'entité dans Unified Service Desk. Pour plus d'informations sur la définition d'une recherche d'entité, reportez-vous à Rechercher des données à l'aide de recherches d'entité dans le Centre de services unifié.

Paramètre	Description
name	Nom de la recherche d'entités à utiliser pour rechercher l'enregistrement.
global	À définir sur True si vous souhaitez que les résultats de la recherche liés à la session globale soient effacés. Vous devez être prudent lorsque vous stockez des résultats de recherche dans la session globale, car ces derniers ne sont pas automatiquement effacés par le système. Dans ce cas, vous devez appeler l'action ClearEntityList avant d'appeler cette action.
maxcount	Nombre maximal d'enregistrements à stocker dans les résultats de EntityList de cet appel.

Notes

Par défaut, le nombre de pages (nombre d'enregistrements par page) pour un ensemble de résultats est défini sur 50. Cela implique qu'en présence de plus de 50 enregistrements renvoyés, il sera affiché en pages. Si vous souhaitez spécifier une valeur de nombre de pages différente pour l'action DoSearch, spécifiez la nouvelle valeur dans l'option EntitySearchPageCount.Pour plus d'informations :TechNet : Gérer des options pour Unified Service Desk

Lorsque vous appelez l'action DoSearch, le paramètre de remplacement $Return affiche le nombre d'enregistrements trouvés et stockés dans EntityList suite à cette recherche.Pour plus d'informations :$Return.

DisplayMessage

Affiche une zone de message à l'utilisateur.

Paramètre	Description
texte	Il s'agit du texte affiché dans la zone de message. Si ce paramètre n'est pas spécifié, n'importe quel texte restant (paramètre restant) ou chaîne vide est utilisé.
légende	Il s'agit de la légende affichée dans la zone de message. Si aucune légende n'est spécifiée, Message Dynamics 365 est utilisé.

ExecuteOnDataAvailable

Retarde l'exécution des sous-actions jusqu'à ce qu'un ensemble spécifié de paramètres de remplacement devienne disponible. Une valeur de délai d'attente peut être spécifiée pour limiter le délai d'attente avant que les paramètres de remplacement deviennent disponibles. Si aucun délai d'attente n'est spécifié, il devra attendre indéfiniment ou la fin de la session.Pour plus d'informations :Blog : Comment utiliser les actions spéciales, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Paramètre	Description
milliseconds	Temps, en millisecondes, pour indiquer le délai d'attente avant l'expiration de cette action et son annulation. Les paramètres restants doivent contenir les paramètres de remplacement qui doivent être disponibles avant l'exécution des sous-actions. Exemple de paramètre de données : milliseconds=5000 [[account.Id]] [[incident.Id]]

milliseconds

Temps, en millisecondes, pour indiquer le délai d'attente avant l'expiration de cette action et son annulation. Les paramètres restants doivent contenir les paramètres de remplacement qui doivent être disponibles avant l'exécution des sous-actions.

Exemple de paramètre de données :

milliseconds=5000
[[account.Id]]
[[incident.Id]]

Important

Cette action s'applique à tous les types de contrôles hébergés. Elle n'est pas exposée par défaut lorsque vous créez une instance de type de contrôle hébergé. Pour utiliser l'action ExecuteOnDataAvailable avec une instance de type de contrôle hébergé, vous devez explicitement ajouter une action UII appelée ExecuteOnDataAvailable à l'instance de contrôle hébergé respective.Pour plus d'informations :Ajouter une action UII à un contrôle hébergé

ExecuteOnTimeout

Retarde l'exécution des sous-actions jusqu'à ce que le temps spécifié soit écoulé. Une valeur de délai d'attente est nécessaire pour indiquer quand les sous-actions doivent être exécutées.Pour plus d'informations :Blog : Comment utiliser les actions spéciales, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Paramètre	Description
milliseconds	Temps, en millisecondes, pour indiquer le délai d'attente avant l'exécution des sous-actions. Exemple de paramètre de données : milliseconds=5000

milliseconds

Temps, en millisecondes, pour indiquer le délai d'attente avant l'exécution des sous-actions.

Exemple de paramètre de données :

milliseconds=5000

Important

Cette action s'applique à tous les types de contrôles hébergés. Elle n'est pas exposée par défaut lorsque vous créez une instance de type de contrôle hébergé. Pour utiliser l'action ExecuteOnTimeout avec une instance de type de contrôle hébergé, vous devez explicitement ajouter une action UII appelée ExecuteOnTimeout à l'instance de contrôle hébergé respective.Pour plus d'informations :Ajouter une action UII à un contrôle hébergé

ExecuteOnExpressionTrue

Retarde l'exécution des sous-actions jusqu'à ce qu'une expression JavaScript spécifiée retourne true. Une valeur de délai d'attente peut être spécifiée pour limiter le délai d'attente avant l'expiration. Si aucun délai d'attente n'est spécifié, il devra attendre indéfiniment ou la fin de la session.Pour plus d'informations :Blog : Comment utiliser les actions spéciales, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Paramètre	Description
milliseconds	Temps, en millisecondes, pour indiquer le délai d'attente avant l'expiration de cette action et son annulation. Le paramètre restant est une expression JavaScript à évaluer. Lorsque cette expression a la valeur true, les sous-actions s'exécutent. Exemple de paramètre de données : milliseconds=5000 function IsAccountLoaded() { return “[[account.Id]$+]” != “”; } IsAccountLoaded();

milliseconds

Temps, en millisecondes, pour indiquer le délai d'attente avant l'expiration de cette action et son annulation. Le paramètre restant est une expression JavaScript à évaluer. Lorsque cette expression a la valeur true, les sous-actions s'exécutent.

Exemple de paramètre de données :

milliseconds=5000
function IsAccountLoaded()
{
return “[[account.Id]$+]” != “”;
}
IsAccountLoaded();

Important

Cette action s'applique à tous les types de contrôles hébergés. Elle n'est pas exposée par défaut lorsque vous créez une instance de type de contrôle hébergé. Pour utiliser l'action ExecuteOnExpressionTrue avec une instance de type de contrôle hébergé, vous devez explicitement ajouter une action UII appelée ExecuteOnExpressionTrue à l'instance de contrôle hébergé respective.Pour plus d'informations :Ajouter une action UII à un contrôle hébergé

ExecuteScriptlet

Exécute le scriptlet spécifié.

Paramètre	Description
	Spécifiez le nom du scriptlet à exécuter dans le champ Données.

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.

GetTemplate

Récupère le contenu d'un modèle de courrier électronique fusionné.

Paramètre	Description
nom	Nom du modèle à récupérer.
id	ID de l'entité à associer avec ce modèle pour l'opération de fusion.

InvokeCTI

Simule les événements CTI

Paramètre	Description
type	Il s'agit du type d'événement CTI, par exemple un appel téléphonique et une conversation.
appname	Nom du gestionnaire de bureau à utiliser pour cette simulation de fenêtre contextuelle.
ani	Enregistrement automatique des numéros (EAN) ou numéro de téléphone des appelants.
dnis	DNIS ou numéro composé.
	Tous les paramètres restants seront transmis comme paramètres au processeur d'événement de CTI.

LaunchURL

Lance une URL dans Internet Explorer en dehors de l'application Unified Service Desk. Vous devez spécifier l'URL sous la forme d'un paramètre dans le champ Données.

LookupQueueItem

Recherche un queueitem dans le système et obtient des informations.

Paramètre	Description
ID	ID de l'entité qui est la cible de queueItem
EntityType	Type ou nom logique de l'entité indiquée dans le champ ID.

Les détails queueitem obtenus sont placés dans le paramètre de remplacement queueitem et peuvent être référencés ultérieurement.

MoveApplicationToPanel

Déplace un contrôle hébergé vers le panneau spécifié dans l'application cliente.

Paramètre	Description
Application	Nom du contrôle hébergé à déplacer.
panneau	Nom du panneau cible.

MoveToPanel

Déplace les contrôles hébergés d'un panneau à l'autre au moment de l'exécution.

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

New_CRM_Page

Crée une page for pour créer un nouvel enregistrement Dynamics 365 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
LogicalName	Nom logique de l'entité pour créer une nouvelle instance.

Notes

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.

Suspendre

Suspend l'exécution de l'action sans bloquer le traitement des messages. Cette action est différente de l'interruption du thread actuel pour la durée spécifiée (Thread.Sleep) car l'action permet au traitement de se poursuivre. Cette opération est utile lorsque vous attendez l'exécution d'opérations Web.

Paramètre	Description
milliseconds	Nombre de millisecondes d'interruption.

Fenêtre contextuelle

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.

ReadSettings

Lit les paramètres précédemment enregistrés à partir du paramètre de remplacement $Settings.

Paramètre	Description
readfromcache	True si vous voulez lire la version mise en cache locale de ces paramètres.False ou Manquant.

RedoScreenPop

Affiche à nouveau le dernier écran contextuel. Elle peut vous être utile lorsque la limite de session a été atteinte et que l'écran contextuel n'a pas été correctement affiché, ou si vous avez fermé la session avant que le travail ne soit terminé. Cette action ne requiert aucun paramètre.

ResetLocalCache

Définit le cache de configuration dans Unified Service Desk. Au prochain démarrage du Unified Service Desk, elle téléchargera la configuration à partir du serveur. L'utilisateur doit avoir un accès en écriture à l'entité msdyusd_usersettings pour que cette action fonctionne.

RouteToQueue

Achemine une entité vers une file d'attente dans Dynamics 365.

Paramètre	Description
destination	ID de la file d'attente cible. Ce paramètre et le paramètre destinationqueuename s'excluent mutuellement
destinationqueuename	Nom de la file d'attente vers laquelle acheminer l'entité.
entitytype	Nom logique de l'entité à acheminer
entityid	GUID/ID de l'entité à placer dans la file d'attente.

SaveAll

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.

SaveSetting

Stocke un paramètre d'utilisateur spécifique.

Paramètre	Description
nom	Nom du paramètre. Il apparaît dans le paramètre de remplacement$Settings.
valeur	Valeur du paramètre à enregistrer.

SetTheme

Applique un thème pour modifier la disposition ou l'apparence des composants de l'interface utilisateur.Pour plus d'informations :Personnaliser l'apparence de votre application

Paramètre	Description
clear	À définir sur True si vous souhaitez complètement effacer le thème actuel avant d'appliquer le thème spécifié. Si ce paramètre est défini sur Faux ou non spécifié, les informations du nouveau thème sont fusionnées au thème actuel.
	Le paramètre restant (ce qui reste une fois que les autres paramètres ont été supprimés) doit contenir le nom du thème à utiliser. Ce doit être le nom de la ressource Web d'un fichier XAML (renommé XML et téléchargé en tant que ressource Web), l'URL d'un serveur d'accès anonyme, ou le fichier XAML brut représentant le thème.

SetAppBar

Attache un contrôle hébergé sur le bord spécifié de la fenêtre principale de l'application cliente.

Paramètre	Description
ApplicationName	Nom du contrôle hébergé à attacher. Si ce paramètre est spécifié, la fenêtre parente qui héberge ce contrôle hébergé est attachée.
width	Largeur en pixels de la fenêtre attachée. Si ce paramètre n'est pas spécifié, la largeur actuelle de la fenêtre est utilisée.
height	Hauteur en pixels de la fenêtre attachée. Si ce paramètre n'est pas spécifié, la hauteur actuelle de la fenêtre est utilisée.
Edge	Bord où la fenêtre est attachée. Si aucun bord n'est spécifié, celui du Haut est utilisé. Spécifiez l'une des valeurs suivantes : Haut, Bas, Gauche ou Droite.

SetEventTimer

Règle le minuteur d'événement à démarrer.

Paramètre	Description
nom	Nom du minuteur d'événement.

SetSize

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

SetWindowProperty

Définit le statut de la fenêtre pour la fenêtre principale de l'application cliente.

Paramètre	Description
WindowState	Une des valeurs suivantes : agrandie, réduiteou normale.

ShellExecute

Cette action permet de lancer une URL ou une ligne de commande. Notez que l'utilisateur doit disposer de droits pour exécuter l'application.

Paramètre	Description
	Le seul paramètre est la ligne de commande ou l'URL de l'application à exécuter.

ShowAbout

Affiche la norme sur la boîte de dialogue du Unified Service Desk contenant des informations telles que le nom de l'utilisateur actuel, le serveur Dynamics 365 et l'organisation à laquelle l'utilisateur est connecté, le numéro de version de l'application cliente du Unified Service Desk et l'URL de site du support technique.

ShowTab

Définit l'attention sur un onglet (contrôle hébergé) dans votre application agent.

Paramètre	Description
	La première ligne de l'appel à l'action doit contenir le nom du contrôle hébergé à afficher au premier plan. N'utilisez pas le nom complet du contrôle hébergé. Pour plus d'informations sur l'utilisation de cet appel à l'action, voir l'étape 4 du Guide pas-à-pas 2 : Affichage d'une page Web externe dans votre application agent.

StopEventTimer

Arrête un minuteur d'événement.

Paramètre	Description
nom	Nom du minuteur d'événement à arrêter.

Traduire

Vous permet d'effectuer une traduction à l'aide de Microsoft Translator.

Paramètre	Description
valeur	Il s'agit du texte à traduire. Cette valeur peut être ignorée pour le support multiligne. Quelques exemples valides : `value=$Escaped("my string<br>new line\\\"my text\\\"")` `value=[[myapp.myparam]^]` `value=$Escaped([[myapp.myparam]$])` Pour plus d’informations sur ces touches de remplacement, voir Utiliser des paramètres de remplacement pour configurer le Centre de services unifié.
fromlanguage	Nom de la langue à partir de laquelle la traduction se fait. Si ce champ est vide, le système tente de détecter la langue de la valeur spécifiée à traduire avant traduire. Pour obtenir la liste des valeurs de langue valides, voir Codes de langues de traduction.
tolanguage	Nom de la langue vers laquelle la traduction se fait. Pour obtenir la liste des valeurs de langue valides, voir Codes de langues de traduction.
clientId	ID client obtenu à partir de Microsoft Azure pour les services de traduction. Pour plus d'informations sur l'enregistrement avec Azure, voir https://datamarket.azure.com.
clientsecret	Secret client obtenu à partir de Microsoft Azure pour les services de traduction. Pour plus d'informations sur l'enregistrement avec Azure, voir https://datamarket.azure.com.

La valeur traduite s'affiche sous le paramètre de remplacement $Return.

UpdateEntity

Actualise un enregistrement dans Dynamics 365.

Paramètre	Description
ID	ID de la valeur à mettre à jour. Ce doit être le GUID de l'enregistrement à mettre à jour.
LogicalName	Nom logique de l'entité à mettre à jour

Chaque ligne suivante de la liste de paramètres contient une série de paires Nom=Valeur qui définiront vos autres champs à renseigner au moment de la mise à jour.

Les références d'entité peuvent être décrites comme suit :

Param=EntityReference(“logicalname”, “id”)

OptionSetValue peut être spécifié comme suit :

Param=OptionSetValue(value)

Les Valeurs booléennes peuvent être décrites comme suit :

Param=Boolean(value)

PartyList (utilisé avec le courrier électronique) peut être décrit comme suit :

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

Vous pouvez utiliser n'importe quel nombre de courriers électroniques ou d'entrées pour représenter les adresses de messagerie et les références d'entité, respectivement.

Les autres valeurs, telles que les valeurs de chaîne, peuvent être spécifiées comme suit :

Param=value

Travail en cours

Cette action revient à sélectionner un élément de file d'attente dans une file d'attente et à cliquer sur le bouton WorkOn dans le ruban. Elle marque l'élément de file d'attente comme étant traité par un agent spécifique.

Paramètre	Description
ID	Il s'agit de l'ID de queueitem. Voir LookupQueueItem pour plus d'informations sur la manière d'obtenir l'ID d'une entité cible.
Action	Paramètre facultatif permettant à l'administrateur de spécifier qu'il souhaite supprimer l'attribut WorkOn pour le renvoyer dans la file d'attente. Valeurs correctes : Supprimer – Supprime l'attribut WorkOn et déplace l'élément vers la file d'attente pour qu'il soit traité par d'autres utilisateurs.

Il s'agit de l'ID de queueitem. Voir LookupQueueItem pour plus d'informations sur la manière d'obtenir l'ID d'une entité cible.

Action

Paramètre facultatif permettant à l'administrateur de spécifier qu'il souhaite supprimer l'attribut WorkOn pour le renvoyer dans la file d'attente.

Valeurs correctes :

Supprimer – Supprime l'attribut WorkOn et déplace l'élément vers la file d'attente pour qu'il soit traité par d'autres utilisateurs.

Événements prédéfinis

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

DesktopReady

Se produit au démarrage lorsque toutes les initialisations de bureau sont terminées et que les connexions à Dynamics 365 ont été établies. Cet événement est déclenché une seule fois, et il est courant de l'utiliser pour définir des thèmes et effectuer d'autres actions de démarrage.

SessionActivated

Se produit lorsqu'une session est activée.

Paramètre	Description
SessionId	ID de la session actuellement active.
IsGlobal	Indique si cet événement s'applique à la session globale. Retourne True ou False.
Activer	Est défini sur True.

SessionClosed

Se produit lorsqu'une session est fermée.

Paramètre	Description
SessionId	ID de la session qui a été fermée.
IsGlobal	Indique si cet événement s'applique à la session globale. Retourne True ou False.

SessionDeactivated

Se produit lorsqu'une session est désactivée.

Paramètre	Description
SessionId	ID de la session inactive.
IsGlobal	Indique si cet événement s'applique à la session globale. Retourne True ou False.
Activer	Est défini sur False.

SessionNew

Se produit lorsqu'une session est créée.

Paramètre	Description
SessionId	ID de la session nouvellement créée.
IsGlobal	Renvoie True si la nouvelle session est une session globale. Sinon, renvoie False.

Voir aussi

Actions UII
Événements
Afficher les actions et événements prédéfinis d'un contrôle hébergé
Afficher l'aide intégrée pour les actions et les événements
Guides pas-à-pas pour la configuration d'Unified Service Desk
Types de contrôle hébergé et référence d'action/événement
TechNet : Guide d'administration d'Unified Service Desk pour Microsoft Dynamics CRM

Unified Service Desk 2.0

Partager via

Gestionnaire global (contrôle hébergé)

Contenu de la rubrique

Créer un contrôle hébergé Gestionnaire global

Actions UII prédéfinies

Audit

CallDoAction

ClearAppBar

ClearEntityList

Fermer

CloseActive

CopyToClipboard

CopyToContext

CopyLogicalEntityToContext

CloseActivity

CreateEntity

CreateSession

DeleteEntity

DoRoute

DoSearch

DisplayMessage

ExecuteOnDataAvailable

ExecuteOnTimeout

ExecuteOnExpressionTrue

ExecuteScriptlet

FireEvent

GetTemplate

InvokeCTI

LaunchURL

LookupQueueItem

MoveApplicationToPanel

MoveToPanel

New_CRM_Page

Open_CRM_Page

Suspendre

Fenêtre contextuelle

RealignWindow

ReadSettings

RedoScreenPop

ResetLocalCache

RouteToQueue

SaveAll

SaveSetting

SetTheme

SetAppBar

SetEventTimer

SetSize

SetWindowProperty

ShellExecute

ShowAbout

ShowTab

StopEventTimer

Traduire

UpdateEntity

Travail en cours

Événements prédéfinis

DesktopReady

SessionActivated

SessionClosed

SessionDeactivated

SessionNew

Voir aussi

Ressources supplémentaires