Runapp

Cette page d'aide concerne Desktop Studio. Ces informations sont également disponibles pour Studio.

Lance des fonctionnalités personnalisées à partir du script, en lançant spécifiquement un formulaire, une page Web ou une application. Toutes les URL ciblées vers un panneau de contact doivent être configurées pour permettre leur affichage dans une iframe. Les agents doivent avoir le paramètre Panneaux dans MAX défini sur Activé. Salesforce Agent et Salesforce Agent Lightning prennent en charge cette action.

Cette action soumet des informations via la branche Ondata.

Une utilisation courante de Runapp consiste à afficher un formulaire standard ou une URL personnalisée pour les agents avec l'événement ONANSWER (géré par l'action Onanswer).

Vous pouvez utiliser l'action PAGE pour envoyer des pages HTML simples à un agent. Page est utile pour créer une séquence d'éléments qui suivent des branches distinctes, alors que chaque fois que vous soumettez des informations avec Runapp, les informations passent par la branche Ondata.

Dans NiCE CXone Agent Workspace (Agent), cette action affiche uniquement le lien URL. Elle n'affiche pas la page via iframe. De plus, un formulaire personnalisé s'affiche sous forme de lien. Il est suggéré d'utiliser l'POPURL action à la place.

OpenURL est le seul Action Type prise en charge pour Salesforce Agent. Si vous souhaitez afficher un formulaire personnalisé, utilisez l'action Indiquer.

Types de scripts pris en charge

						``` ```
Générique	Email	Conversation	Téléphone	Élément de travail	SMS	Digital

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais avec quelques différences clés :

Runapp : Lance des fonctionnalités personnalisées à partir du script, en lançant spécifiquement un formulaire, une page Web ou une application.
PopURL : ouvre des URL de pages Web et propose des options pour l'emplacement et le style du panneau qui affiche la page Web.
Indicate : étend l'interface agent avec une fonctionnalité personnalisée, à savoir une icône sur laquelle l'agent clique pour déclencher la fonction personnalisée. Ceci est similaire à Runapp, sauf qu'avec Indicate, le ActionType est initié par le script plutôt que par l'agent.

Propriétés de saisie

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété	Description
Légende	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. La valeur par défaut est le nom de l’action.
AgentID	L'ID de l'agent. Entrez un ID ou tapez pour trouver un agent spécifique. Vous pouvez utiliser une variable pour ce champ, telle que {agentId}. Les compétences sortantes ont un script personnalisé assigné, par conséquent lorsque Runapp se déclenche dans le script personnalisé sortant, il utilise l'action Begin car il « sait » déjà qui est l'agent (celui qui effectue l'appel sortant). Par conséquent, une fenêtre contextuelle ne fonctionnera que si {__agentID} est utilisé comme nom DE variable. Pour les scripts entrants, le script ne « sait » pas qui est l'agent jusqu'à ce que Onanswer se déclenche, ce qui définit la variable id de l’agent sur AGENTID. Vous pouvez utiliser l’éditeur de propriétés RunApp pour configurer cette propriété en double-cliquant sur l’action.
ActionType	RunExe : NiCE CXone n'offre pas de soutien. Cela nécessite un exécutable local qui réside dans le chemin Windows ou avec le chemin complet saisi dans le champ ActionValue. Le chemin du fichier doit inclure des doubles barres obliques inverses (\\) dans le chemin. Par exemple, C:\\ Program Files\\NiCE CXone\\ studio.exe. La plupart des navigateurs modernes ne prennent pas en charge l'exécution de programmes exécutables. Si vous souhaitez utiliser ce type, assurez-vous que vos agents utilisent un navigateur compatible. OpenURL : ouvre un navigateur Web par défaut à l'URL spécifiée dans le ActionValue champ. ShowCustomForm : Lance un formulaire HTML personnalisé créé dans Studio. Les données capturées à partir du formulaire personnalisé déclencheront l'événement ONDATA dans le script. Vous pouvez utiliser l'éditeur Propriété RunApp pour configurer cette propriété en double-cliquant sur l'action.
ActionValue	La valeur requise par le ActionType spécifié. Les variables sont prises en charge dans cette propriété en encapsulant la variable entre {accolades}. RunExe : le nom ou le chemin d'un fichier exécutable Windows. Le chemin du fichier doit inclure des doubles barres obliques inverses (\\) dans le chemin. Par exemple, C: \\ Program Files \\ MyCompany \\ myApp.exe -h {ANI}. OpenURL : doit être un nom de domaine complet et une URL. Les paramètres de chaîne de requête sont pris en charge. http://www.example.com/file.asp?ANI={ANI}. Vous pouvez également personnaliser le titre de l'onglet qui apparaît dans le MAX interface en ajoutant le paramètre icAgentPanelTitle = à l'URL. Ce paramètre n'est pas prise en charge dans NiCE CXone Agent Workspace (Agent). ShowCustomForm: This field offers the ability to build a custom HTML form. Any standard form input fields may be used, including Input, Textarea, Password, Checkbox, Radio, Select, Button, and Submit. Don't include the <form> tags. Chaque champ de saisie doit contenir un nom. Les Champs sans nom seront ignorés. Exemple, <input type="text" name="phone">. Le script doit contenir l'un des éléments suivants pour que votre formulaire personnalisé fonctionne : Ondataaction : les noms et les valeurs sont renvoyés au script sous forme de variables à l'aide de cette action. WaitForSubmit propriété : lorsqu'elle est incluse et définie sur True, les noms de champ deviennent des variables dans le script. Les valeurs de Champ deviennent le contenu des variables. Les champs de formulaire qui prennent en charge plusieurs valeurs, par exemple Case à cocher et Select, contiendront un tableau séparé par des virgules. Les boutons de soumission multiples peuvent être utilisés avec des noms identiques ou différents, mais tout bouton de soumission soumettra les données et fermera la fenêtre. Si vous voulez un bouton qui ne soumet pas, utilisez un bouton plutôt qu'une soumission. Les feuilles de style liées ne sont pas prises en charge, vous pouvez utiliser des styles en ligne. Par exemple, <div style="position: absolute: left: 10px: top: 100px:">. JavaScript fonctionnera lorsqu'il est lié à un JavaScript externe, mais le contenu doit être en HTTPS afin d'éviter les erreurs. Par exemple : <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)"> Vous pouvez utiliser l'Éditeur de propriétés RunApp pour configurer cette propriété en double-cliquant sur l'action.
WaitForSubmit	Détermine si le système attend une action soumettre de l’agent. Lorsque ce paramètre est défini sur True, le système attend l'action de validation de l'Agent. Les noms des champs deviennent des variables dans le script, la valeur du Champ étant la valeur de la variable. Lorsque défini sur False, vous devez inclure l'action Ondata dans le script, qui renvoie les noms et valeurs de champ au script en tant que variables. WaitForSubmit ne s'applique que si le Type d'action est ShowCustomForm. Il fonctionne conjointement à WaitTimeout. Désactivez cette propriété lorsque vous utilisez cette action dans un script qui intègre un CRM systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de soutien et les historiques de cas. à une application NiCE CXone Agent Workspace (Agent). Lorsque cette propriété est activée, le formulaire est vide lorsqu'il est soumis si le délai du formulaire a expiré.
WaitTimeout	Nombre de secondes qui déclenchera la branche OnTimeout si le Type d’action est ShowCustomForm.

Conditions de branche résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Par défaut	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Soumettre	Path taken if WaitForSubmit is set to True.
Dépassement DE délai	Path taken if there is no response for the number of seconds specified.
En cas d'erreur	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Runapp Wizard

Vous pouvez également configurer l'action directement dans les propriétés de l'action.

Double-cliquez sur l'action Runapp pour ouvrir l'assistant Éditeur de propriétés RunApp.
Voir l'image
Saisissez l'ID de l'agent pour que l'agent reçoive l'action Runapp. Pour les scripts sortants, utilisez {__agentID} comme nom DE variable, pour tous les autres scripts, utilisez {AGENTID}.

Select the action type.

Champ	Description
Run an executable program	Exécute un exécutable local. Cette option utilise un plugin Java qui n'est fonctionnel qu'avec Internet Explorer, quiNiCE CXone ne supporte pas. Cela nécessite un exécutable local qui se trouve dans le chemin Windows ou dont le chemin complet est saisi dans le champ ActionValue. Le chemin du fichier doit inclure des doubles barres obliques inverses (\\) dans le chemin. Par exemple, C:\\ Program Files\\NiCE CXone\\ studio.exe. La plupart des navigateurs modernes ne prennent pas en charge l'exécution de programmes exécutables. Si vous souhaitez utiliser ce type, assurez-vous que vos agents utilisent un navigateur compatible.
Ouvrir une page Web dans une fenêtre contextuelle	Entrez l'URL complète de la page Web dans le champ Commande Action. La page sera ouverte avec le navigateur par défaut sur l'ordinateur local de l'agent.
Invitez l'utilisateur avec un formulaire similaire à une page Web	Entrez le code HTML pour générer un formulaire dans le champ Action Commande. Il n'est pas nécessaire d'inclure les balises d'ouverture et de fermeture <form>. Cliquez sur Aperçu pour voir le formulaire.

Cliquez sur OK.