Runapp

This help page is for Desktop Studio. This information is also available for CXone Studio.

Initiiert benutzerdefinierte Funktionen aus dem Skript, insbesondere das Starten eines Formulars, einer Webseite oder Anwendung. Alle URLs, die auf ein Kontaktfeld ausgerichtet sind, müssen so konfiguriert werden, dass sie in einem Iframe angezeigt werden können. Für Agenten muss die Panels-Einstellung in MAX auf On festgelegt sein. Salesforce Agent und Salesforce Agent Lightning unterstützen diese Aktion.

Bei dieser Aktion werden die Informationen über die Verzweigung Ondataübermittelt.

Runapp wird häufig verwendet, um ein Standardformular oder eine benutzerdefinierte URL für Agenten mit dem Ereignis ONANSWER einzublenden (mit der Onanswer-Aktion verwaltet).

Sie können die PAGEaction- verwenden, um einfache HTML-Seiten für einen Agenten einzublenden. Page ist nützlich, um eine Reihe von Elementen zu erstellen, die separaten Zweigen folgen, während jedes Mal, wenn Sie Informationen mit Runapp übermitteln, die Informationen die Verzweigung Ondata durchlaufen.

Unterstützte Skripttypen


Allgemein	E-Mail-Adresse	Chat	Telefon	Arbeitselement	SMS

Vergleich ähnlicher Aktionen

Die folgenden Aktionen haben ähnliche Funktionen, aber mit einigen wichtigen Unterschieden:

Runapp: Initiiert benutzerdefinierte Funktionen aus dem Skript, insbesondere das Starten eines Formulars, einer Webseite oder einer Anwendung.
PopURL: Öffnet Webseiten-URLs und bietet Optionen für die Position und das Design des Bereichs, in dem die Webseite angezeigt wird.
Indicate : Erweitert die Agenten-Benutzeroberfläche um benutzerdefinierte Funktionen, speziell um ein Symbol, auf das der Agent klicken kann, um die benutzerdefinierte Funktion aufzurufen. Dies ähnelt Runapp, abgesehen davon, dass bei Indicate der ActionType vom Skript und nicht vom Agenten eingeleitet wird.

Eingabeeigenschaften

Diese Eigenschaften definieren Daten, die von der Aktion bei der Ausführung verwendet werden.

Eigenschaft	Beschreibung
Caption	Geben Sie eine kurze Phrase ein, mit der diese Aktion im Skript eindeutig identifiziert wird. Die Beschriftung wird im Skript-Arbeitsbereich unter dem Symbol der Aktion angezeigt. The default is the action name.
AgentID	Die Agenten-ID. Sie können für dieses Feld eine Variable verwenden, wie beispielsweise {agentId}. Ausgehenden Skills ist ein benutzerdefiniertes Skript zugewiesen. Wenn Runapp im ausgehenden benutzerdefinierten Skript ausgelöst wird, verwendet es daher die Begin-Aktion, da es bereits "weiß", wer der Agent ist (derjenige, der den ausgehenden Anruf tätigt). Daher funktioniert ein Bildschirm-Popup nur, wenn {__agentID} als Variablenname verwendet wird. Bei eingehenden Skripten "weiß" das Skript erst, wer der Agent ist, wenn Onanswer ausgelöst wird, wodurch die Agent-ID-Variable auf AGENTID gesetzt wird. Sie können den Editor RunApp Property verwenden, um diese Eigenschaft durch Doppelklicken auf die Aktion zu konfigurieren.
ActionType	RunExe: Wird von CXone nicht unterstützt. Dies erfordert eine lokale ausführbare Datei, die im Windows-Pfad gespeichert ist oder deren vollständiger Pfad im Feld ActionValue angegeben ist. Der Dateipfad muss zwei umgekehrte Schrägstriche (\\) im Pfad enthalten. Beispiel: C:\\Programme\\CXone\\studio.exe. Die meisten modernen Browser unterstützen die Ausführung ausführbarer Programme nicht. Wenn Sie diesen Typ verwenden möchten, stellen Sie sicher, dass Ihre Agenten einen kompatiblen Browser verwenden. OpenURL: öffnet einen Standard-Webbrowser mit der URL, die im ActionValue-Feld angegeben ist. ShowCustomForm: startet ein benutzerdefiniertes HTML-Formular, das in Studio erstellt wurde. Die im benutzerdefinierten Formular erfassten Daten lösen das ONDATA -Ereignis im Skript aus. Sie können den Editor RunApp Property verwenden, um diese Eigenschaft zu konfigurieren, indem Sie auf die Aktion doppelklicken.
ActionValue	Der vom angegebenen ActionType-Parameter benötigte Wert. Variablen werden in dieser Eigenschaft unterstützt, indem die Variable in {geschweifte Klammern} eingeschlossen wird. RunExe: Name oder Pfad einer ausführbaren Windows-Datei. Der Dateipfad muss zwei umgekehrte Schrägstriche (\\) im Pfad enthalten. Beispiel: C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}. OpenURL: muss ein vollständig qualifizierter Domänenname und eine URL sein. Die Abfrage der Zeichenfolgenparameter wird unterstützt. Beispiel: http://www.example.com/file.asp?ANI={ANI}. Sie können auch den Titel der Registerkarte anpassen, die in der MAX-Benutzeroberfläche angezeigt wird, indem Sie den Parameter icAgentPanelTitle= an die URL anhängen. ShowCustomForm: Mit diesem Feld kann ein benutzerdefiniertes HTML-Formular erstellt werden. Es können alle Standard-Eingabefelder verwendet werden wie z. B. Eingabefelder, Textbereiche, Passwort, Kontrollkästchen, Optionsschaltflächen, Auswahl, Schaltfläche und Senden. Fügen Sie die <form>-Tags nicht ein. Jedes Eingabefeld muss einen Namen enthalten. Felder ohne Name werden ignoriert. Beispiel: <input type="text" name="phone">. Das Skript muss eines dieser Elemente enthalten, damit Ihr benutzerdefiniertes Formular funktioniert: Ondata-Aktion: Namen und Werte werden mit dieser Aktion als Variablen an das Skript zurückgegeben. WaitForSubmit -Eigenschaft: Wenn diese Eigenschaft enthalten und auf True eingestellt ist, werden Feldnamen im Skript zu Variablen. Die Feldwerte werden zum Inhalt der Variablen. Formularfelder, die mehrere Werte unterstützen, z. B. Kontrollkästchen und Auswahl, enthalten ein durch Komma getrenntes Feld. Es können mehrere Senden-Schaltflächen mit dem gleichen oder anderen Namen verwendet werden, aber jede Senden-Schaltfläche sendet die Daten und schließt das Fenster. Möchten Sie eine Schaltfläche, die nicht sendet, verwenden Sie eine Schaltfläche und kein Senden. Verknüpfte Stylesheets werden nicht unterstützt, Sie können Inline-Stile verwenden. Zum Beispiel <div style="position: absolute: left: 10px: top: 100px:">. Javascript funktioniert, wenn zu einem externen Javascript verlinkt wird, wobei der Inhalt aber HTTPS sein muss, um Fehler zu vermeiden. Zum Beispiel: <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)"> Sie können den RunApp Property Editor verwenden, um diese Eigenschaft zu konfigurieren, indem Sie auf die Aktion doppelklicken.
WaitForSubmit	True oder False. Beim Wert True wird gewartet, dass der Agent eine Aktion zum Übermitteln ausführt. Außerdem werden die Feldnamen zu Variablen im Skript, wobei die Feldwerte den Inhalt der Variablen bilden. WaitForSubmit ist nur anwendbar, wenn Action Type auf ShowCustomForm eingestellt ist. Diese Einstellung wird zusammen mit WaitTimeout angewendet. Wenn WaitForSubmit auf False gesetzt ist, müssen Sie die Ondata-Aktion in das Skript aufnehmen, mit der die Namen und Werte der Felder als Variablen an das Skript zurückgegeben werden. Bestimmt, ob das System auf eine Übermitteln-Aktion des Agenten wartet. Wenn die Einstellung aktiviert ist, wartet das System auf die Übermitteln-Aktion des Agenten. Feldnamen werden im Skript zu Variablen, wobei die Feldwerte den Wert der Variablen bilden. Wenn die Einstellung deaktiviert ist, müssen Sie die Ondata-Aktion in das Skript aufnehmen, mit der die Namen und Werte der Felder als Variablen an das Skript zurückgegeben werden. Setzen Sie die Einstellung auf True, um sie zu aktivieren, oder auf False, um sie zu deaktivieren. Diese Option ist nur relevant, wenn Action Type auf ShowCustomForm eingestellt ist. Diese Einstellung wird zusammen mit WaitTimeout angewendet.
WaitTimeout	Die Dauer (Anzahl der Sekunden), nach der die Verzweigung OnTimeout ausgelöst wird, wenn Action Type auf ShowCustomForm eingestellt ist.

Bedingungen für Ergebnisverzweigungen

Mit Bedingungen für Ergebnisverzweigungen können Sie in Ihrem Skript Verzweigungen erstellen, die für unterschiedliche Ergebnisse bei der Ausführung einer Aktion vorgesehen sind.

Bedingung	Beschreibung
Default	Genommener Pfad, außer das Skript erfüllt eine Bedingung, die es erfordert, einer der anderen Verzweigungen zu folgen. Dieser Pfad wird auch genommen, wenn die anderen Verzweigungen der Aktion nicht definiert sind.
Submit	Genommener Pfad, wenn WaitForSubmit auf True gesetzt ist.
Timeout	Genommener Pfad, wenn keine Antwort für die Anzahl angegebener Sekunden vorhanden ist.
OnError	Genommener Pfad, wenn die Aktion nicht ordnungsgemäß ausgeführt werden kann. Beispiel: Wenn ein unerwartetes Problem auftritt, wie eine schlechte Verbindung oder Syntaxfehler. Die Variable _ERR, mit einem einzelnen Unterstrich, sollte mit einer kurzen Erläuterung des Problems ausgefüllt werden.

Runapp-Assistent

Sie können die Aktion auch direkt in den Eigenschaften der Aktion konfigurieren.

Doppelklicken Sie auf die Runapp-Aktion, um den Assistenten RunApp Property Editor zu öffnen.
Bild anzeigen
Geben Sie die Agent-ID des Agenten ein, der die Runapp-Aktion empfangen soll. Verwenden Sie für ausgehende Skripte {__agentID} als Variablennamen, für alle anderen Skripte verwenden Sie {AGENTID}.

Wählen Sie den Aktionstyp aus.

Feld	Beschreibung
Run an executable program	Führt eine lokale ausführbare Datei aus. Diese Option verwendet ein Java-Plugin, das nur mit dem Internet Explorer funktioniert, der von CXone nicht unterstützt wird. Dies erfordert eine lokale ausführbare Datei, die im Windows-Pfad gespeichert ist oder deren vollständiger Pfad im Feld ActionValue angegeben ist. Der Dateipfad muss zwei umgekehrte Schrägstriche (\\) im Pfad enthalten. Beispiel: C:\\Programme\\CXone\\studio.exe. Die meisten modernen Browser unterstützen die Ausführung ausführbarer Programme nicht. Wenn Sie diesen Typ verwenden möchten, stellen Sie sicher, dass Ihre Agenten einen kompatiblen Browser verwenden.
Pop open a web page	Geben Sie die vollständige URL der Webseite in das Feld Action Command ein. Die Seite wird auf dem Computer des Agenten mit dem Standard-Browser geöffnet.
Prompt the user with a web page like form	Geben Sie den HTML-Code zum Generieren eines Formulars in das Feld Action Command ein. Öffnende und schließende <form> Tags müssen nicht enthalten sein. Klicken Sie auf Preview, um das Formular anzuzeigen.

Klicken Sie auf OK.