Runapp

This help page is for Desktop Studio. This information is also available for CXone 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 le paramètre Panels dans MAX défini sur On. Salesforce Agent et Salesforce Agent Lightning prennent en charge cette action.

Cette action permet de soumettre des informations par l’intermédiaire de la branche Ondata.

Une utilisation courante de Runapp consiste à ouvrir 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 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.

Types de scripts pris en charge


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

Comparaison d’actions similaires

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

Runapp : Lance une fonctionnalité personnalisée depuis le script, en particulier en lançant un formulaire, une page Web ou une application.
PopURL : Ouvre les URL des pages Web et fournit des options pour l’emplacement et le style du panneau qui affiche la page Web.
Indicate : Extension de l’interface agent avec des fonctionnalités personnalisées, notamment une icône sur laquelle l’agent clique pour lancer 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 d’entrée

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

Propriété	Description
Légende	Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action. The default is the action name.
AgentID	L’ID de l’agent. Vous pouvez utiliser une variable pour ce champ, par exemple {agentId}. Les compétences sortantes sont associées à un script personnalisé. Par conséquent, lorsque Runapp se déclenche dans le script personnalisé sortant, il utilise l’action Begin puisqu’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 donne à la variable d’ID de l’agent la valeur AGENTID. Vous pouvez utiliser l’éditeur Propriété RunApp pour configurer cette propriété en double-cliquant sur l’action.
ActionType	RunExe : Non pris en charge par CXone. Cela nécessite un programme exécutable local qui réside dans le chemin Windows ou avec le chemin complet entré dans le champ ActionValue. Le chemin du fichier doit inclure des barres obliques doubles (\\) dans le chemin d'accès. Par exemple, C:\\Program Files\\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 saisies dans le formulaire personnalisé déclenchent l’événement ONDATA dans le script. Vous pouvez utiliser l’éditeur RunApp Property pour configurer cette propriété en double-cliquant sur l’action.
ActionValue	La valeur requise par la ActionTypespécifiée. 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 d’un fichier exécutable Windows. Le chemin du fichier doit inclure des barres obliques doubles (\\) dans le chemin d'accès. Par exemple, C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}. OpenURL : Doit être un nom de domaine et une URL pleinement qualifiés. Les paramètres de la 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 apparaît dans l’interface MAX en ajoutant le paramètre icAgentPanelTitle= à l’URL. ShowCustomForm : Ce champ permet de créer un formulaire HTML personnalisé. Tous les champs de saisie de formulaire standard peuvent être utilisés, y compris l’Entrée de Données, la Zone de Texte, le Mot de Passe, la Case à Cocher, la Radio, la Sélection, le Bouton et Soumettre. N’incluez pas les balises <form>. Chaque zone d'entrée 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. Propriété WaitForSubmit : Si elle est incluse et définie surTrue, les noms de champ 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 Sélectionner, 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 souhaitez un bouton qui ne soumets pas, alors utilisez plutôt un bouton. 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 sera lié à un JavaScript externe, mais le contenu doit être 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 RunApp Property Editor pour configurer cette propriété en double-cliquant sur l’action.
WaitForSubmit	True ou False. True signifie que le système attend une action de soumission de la part de l’agent. De plus, les noms de champ deviennent des variables dans le script, avec les valeurs de champ comme contenu de variable. WaitForSubmit n’est applicable que si Action Type est ShowCustomForm. Fonctionne en conjonction avec WaitTimeout. Lorsque WaitForSubmit est défini sur False, vous devez inclure l’action Ondata dans le script, qui renvoie les noms et les valeurs des champs au script sous forme de variables. Détermine si le système attend une action de soumission de la part de l’agent. Lorsque cette option est activée, 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. Lorsqu’elle est désactivée, vous devez inclure l’action Ondata dans le script, qui renvoie les noms et les valeurs des champs au script sous forme de variables. Définissez sur True pour l’activer ou False pour la désactiver. Cette option n’est applicable que si Action Type est ShowCustomForm. Fonctionne en conjonction avec WaitTimeout.
WaitTimeout	Le nombre de secondes qui déclenchera la branche OnTimeout si Action Type 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
Default	Chemin emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.
Submit	Chemin emprunté si WaitForSubmit est défini sur True (Vrai).
Timeout	Chemin emprunté s'il n'y a pas de réponse pour le nombre de secondes spécifié.
OnError	Chemin emprunté lorsque l’action ne s’exécute pas correctement. Par exemple, en cas de problème inattendu tel qu’une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un seul caractère de soulignement, doit être remplie avec une explication condensée du problème.

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 RunApp Property Editor.
Afficher l’image
Saisissez l’ID de l’agent qui doit recevoir l’action Runapp. Pour les scripts sortants, utilisez {__agentID} comme nom de variable; pour tous les autres scripts, utilisez {AGENTID}.

Sélectionnez le type d’action.

Champ	Description
Run an executable program	Exécute un fichier exécutable local. Cette option utilise un plugiciel Java qui n’est fonctionnel qu’avec Internet Explorer, que CXone ne prend pas en charge. Cela nécessite un programme exécutable local qui réside dans le chemin Windows ou avec le chemin complet entré dans le champ ActionValue. Le chemin du fichier doit inclure des barres obliques doubles (\\) dans le chemin d'accès. Par exemple, C:\\Program Files\\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.
Pop open a web page	Saisissez l’URL complète de la page Web dans le champ Action Command. La page sera ouverte avec le navigateur par défaut sur l’ordinateur local de l’agent.
Prompt the user with a web page like form	Saisissez le code HTML pour générer un formulaire dans le champ Action Command. Vous n’avez pas à inclure les balises d’ouverture et de fermeture <form>. Cliquez sur Preview pour afficher le formulaire.

Cliquez sur OK.