Gestionnaire global (contrôle hébergé)
Le type de contrôle hébergé Gestionnaire global est le cœur 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 la plateforme Microsoft Dataverse 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 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.
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é.
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 Unified Service Desk. 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 Dataverse à 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é.
Ensuite, sélectionnez l’onglet Services linguistiques pour ajouter des ressources permettant d’ajouter des chaînes localisées pour l’interface utilisateur de votre application d’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 Dataverse via les services Web. Les actions prédéfinies peuvent être utilisées pendant la configuration pour exécuter des fonctions avancées dans Dataverse.
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 aux journaux d’audit du Unified Service Desk. Pour plus d’informations, voir 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 | Volet où trouver l’application active, si aucune application n’est spécifiée. |
| action | Action à appeler sur le contrôle hébergé. |
| données | Paramètre de données à transmettre à l’action. |
| application | Nom du contrôle hébergé pour lequel vous souhaitez exécuter un appel à l’action. Si le nom du contrôle hébergé est spécifié, le paramètre volet 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 panneau 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 les applications pilotées par modèle.
| 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 paramètres et valeurs 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 les applications pilotées par modèle.
| Paramètre | Description |
|---|---|
LogicalName |
Nom logique de l’entité pour créer l’enregistrement. |
RunAsync |
Définissez le paramètre sur True pour créer l’enregistrement d’entité de manière asynchrone afin que Unified Service Desk ne soit pas bloqué et reste réactif lors de l’exécution de l’action. Remarque : les appels à action secondaire associés et les appels à action consécutifs à l’action CreateEntity n’attendent pas que l’opération de création asynchrone soit terminée. Par conséquent, vous devez vous assurer que, si vous exécutez l’action CreateEntity de manière asynchrone, les appels à action secondaire qui dépendent de l’enregistrement créé sont configurés pour ne s’exécuter que lorsque l’enregistrement cible est terminé. Cela est possible grâce à l’action ExecuteOnDataAvailable du contrôle hébergé Gestionnaire global. |
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.
| Paramètre | Description |
|---|---|
| BackGround | Définissez la valeur du paramètre sur True. Une session est créée mais le focus n’est pas modifié immédiatement sur la nouvelle session. Toutes les sous-actions de cet appel d’action ne sont alors exécutées que lorsque vous passerez manuellement à cette session. |
| SessionName | Onglet Nom de la session nouvellement créée. Ce paramètre dépend du paramètre BackGround. |
DeleteEntity
Supprime un enregistrement dans les applications pilotées par modèle.
| Paramètre | Description |
|---|---|
| ID | ID (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 la plateforme Dataverse 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é, voir Rechercher des données à l’aide de recherches d’entité dans Unified Service Desk.
| Paramètre | Description |
|---|---|
| nom | 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. |
Note
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. Plus d’informations : Gérer les 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, voir : $Return.
DisplayMessage
Affiche une zone de message à l’utilisateur.
| Paramètre | Description |
|---|---|
| texte | 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 | Sous-titre affiché dans la zone de message. Si aucune légende n’est spécifiée, Message Dataverse 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. En savoir plus : 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]] |
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. En savoir plus : 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 |
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. En savoir plus : 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 fonction 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 |
| Type d’entité | 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 |
|---|---|
| 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. |
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
Réinitialise 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 les applications pilotées par modèle.
| 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 |
|---|---|
| name | 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. En savoir plus : Utiliser des thèmes pour 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 de la plateforme Dataverse 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. |
TriggerEdgeWebView2PoolCleanUp
Nettoie le pool Edge WebView2.
TriggerChromePoolCleanUp
Nettoie le pool Chrome.
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 clés de remplacement, voir Utiliser des paramètres de remplacement pour configurer Unified Service Desk. |
| 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 d’Azure pour les services de traduction. Pour plus d’informations sur la journalisation avec Azure. |
| clientsecret | Secret client obtenu à partir d’Azure pour les services de traduction. Pour plus d’informations sur la journalisation avec Azure. |
La valeur traduite s’affiche sous le paramètre de remplacement $Return.
UpdateEntity
Met à jour un enregistrement dans les applications pilotées par modèle.
| 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 | ID de queueitem. Voir LookupQueueItem pour plus d’informations sur la manière d’obtenir l’ID d’une entité cible. |
| Pour | 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 à Dataverse 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énementsAfficher les actions et les événements prédéfinis pour un contrôle hébergéAfficher l’aide intégrée pour les actions et les événementsGuides pas-à-pas pour la configuration de Unified Service DeskTypes de contrôle hébergé et référence d’action/événement