Runapp

Cette page d'aide s'applique à Desktop Studio. Ces informations sont aussi disponibles pour Studio.

Lance une fonctionnalité personnalisée depuis le script, en particulier en lançant 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 leur paramètre Panneaux dans MAX réglé sur Activé. Salesforce Agent et Salesforce Agent Lightning prennent en charge cette action.

Cette action soumet des informations par l’intermédiaire de 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é avec l’action Onanswer).

Vous pouvez utiliser l’PAGE action pour afficher des pages HTML simples à un agent. Page est utile pour créer une séquence d’éléments qui suivent des branches distinctes, tandis 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 par l’intermédiaire d’une iframe. De plus, un formulaire personnalisé s’affiche sous forme de lien. Il est suggéré d’utiliser plutôt l’action POPURL action.

OpenURL est le seul Type d’action pris en charge pour Salesforce Agent. Si vous voulez afficher un formulaire personnalisé, utilisez l’Indiquer action.

Types de scripts pris en charge


Générique	courriel	Clavardage	Téléphone	Élément de travail	SMS	Digital

Comparaison des actions similaires

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

Runapp : Lance une fonctionnalité personnalisée depuis le script, en particulier en lançant un formulaire, une page Web ou une application.
PopURL : Ouvre des URL de pages Web et offre des options pour l’emplacement et le style du panneau qui affiche la page Web en incrustation.
Indicate : Étend l’interface de l’agent avec une fonctionnalité personnalisée, plus précisément une icône sur laquelle l’agent clique pour lancer la fonction personnalisée. Cela est semblable à 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 de façon unique cette action dans le script. La légende apparaît sur le canevas du 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. Entrée un ID ou un type pour trouver un agent en particulier. Vous pouvez utiliser une Variable pour ce champ, comme {agentId}. Les compétences sortantes ont un script personnalisé attribué, par conséquent, lorsque Runapp se déclenche dans le script personnalisé sortant, il utilise l’action Begin puisqu’il « connaît » 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 « connaît » pas qui est l’agent tant que Onanswer ne se déclenche pas, ce qui définit la variable de l’id de l’agent sur AGENTID. Vous pouvez utiliser l’éditeur Propriété RunApp pour configurer cette propriété en double-cliquant sur l’action.
ActionType	RunExe : NiCE CXone ne prend pas en charge. Cela nécessite un exécutable local qui réside dans le chemin Windows ou avec le chemin d’accès complet saisi dans le champ ActionValue. Le chemin d’accès 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 champ ActionValue. ShowCustomForm : lance un formulaire HTML personnalisé créé dans Studio. Les données capturées 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’accès à un fichier exécutable Windows. Le chemin d’accès 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. Par exemple, http://www.example.com/file.asp?ANI={ANI}. Vous pouvez également personnaliser le titre de l’onglet qui s’affiche dans l’interface MAX en ajoutant le paramètre icAgentPanelTitle= à l’URL. Ce paramètre n’est pas pris 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 des champs deviennent des variables dans le script. Les valeurs des Champs 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'un bouton de 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 pour é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 de soumission de la part de l'agent. Lorsque cette option est définie sur True, le système attend l'action de soumission de l'agent. Les noms des Champs deviennent des variables dans le script, la valeur du champ étant la valeur de la variable. Lorsque cette option est définie sur False, vous devez inclure l'action Ondata dans le script, qui retourne les noms et les valeurs des champs au script sous forme de variables. WaitForSubmit s'applique uniquement 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 formulaire a atteint le dépassement de délai.
WaitTimeout	Nombre de secondes qui déclenchera la branche OnTimeout si le Type d’action est ShowCustomForm.

Conditions de la branche de 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.
OnError	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.

Assistant Runapp

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.
Afficher l’image
Entrez l’id de l’agent devant recevoir 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
Exécuter un programme exécutable	Exécute un exécutable local. Cette option utilise un plugiciel Java qui n’est fonctionnel qu’avec Internet Explorer, que NiCE CXone ne prend pas en charge. Cela nécessite un exécutable local qui réside dans le chemin Windows ou avec le chemin complet entré dans le champ ActionValue. Le chemin d’accès du fichier doit inclure des barres obliques inverses doubles (\\) dans le chemin d’accès. 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	Entrez l’URL complète de la page Web dans le champ Commande d’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 Commande d’action. Il n’est pas nécessaire d’inclure les balises d’ouverture et de fermeture <form>. Cliquez sur Prévisualisation pour voir le formulaire.

Cliquez sur OK.