Runapp

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

Start aangepaste functionaliteit vanuit het script, bijvoorbeeld het starten van een formulier, webpagina of applicatie. Alle URL's die gericht zijn op een contactpaneel moeten zo geconfigureerd zijn dat ze in een iframe kunnen worden weergegeven. De Panels -instelling van agents in MAX moet de waarde On hebben. Salesforce Agent en Salesforce Agent Lightning ondersteunen deze actie.

Deze actie verzendt informatie via de Ondata-vertakking.

Een algemene toepassing van Runapp is om een standaardformulier of een aangepaste URL te openen voor agents met behulp van de ONANSWER-gebeurtenis (beheerd met de Onanswer-actie).

U kunt PAGE action gebruiken om eenvoudige HTML-pagina's voor een agent te openen in een pop-up. Page is handig voor het maken van een reeks items die verschillende vertakkingen volgen, terwijl elke keer dat u informatie verzendt met Runapp de informatie verloopt via de Ondata-vertakking.

In CXone Mpower Agent geeft deze actie alleen de URL-link weer. De pagina wordt niet via een iframe weergegeven. Er wordt ook een aangepast formulier als link weergegeven. Het wordt voorgesteld om in plaats daarvan de POPURL action te gebruiken.

Ondersteunde scripttypen


Generiek	E-mail	Chat	Telefoon	Werkitem	SMS

Soortgelijke acties vergelijken

De volgende acties hebben vergelijkbare functies, maar met enkele belangrijke verschillen:

Runapp: start aangepaste functionaliteit vanuit het script, bijvoorbeeld het starten van een formulier, webpagina of applicatie.
PopURL: opent webpagina-URL's en biedt opties voor de locatie en opmaak van de pop-ups waarin de webpagina wordt geopend.
Indicate : breidt de agentinterface uit met aangepaste functionaliteit, met name een pictogram waarop de agent kan klikken om de aangepaste functie te starten. Dit is vergelijkbaar met Runapp, behalve dat bij Indicate de ActionType wordt geïnitieerd door het script in plaats van door de agent.

Invoereigenschappen

Deze eigenschappen definiëren gegevens die de actie gebruikt bij het uitvoeren.

Vertakking	Beschrijving
Caption	Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram. The default is the action name.
AgentID	De agent-ID. U kunt een variabele gebruiken voor dit veld, zoals {agentId}. Aan outbound skills wordt een aangepast script toegewezen, dus wanneer de Runapp wordt getriggerd in het aangepaste outbound script, wordt de Begin-actie gebruikt omdat het script al "weet" wie de agent is (degene die de outbound oproep start). Daarom werkt een schermpopup alleen indien {__agentID} wordt gebruikt als de naam van de variabele. Voor Inbound scripts "weet" het script niet wie de agent is totdat Onanswer wordt getriggerd, waarbij de Agent ID-variabele wordt ingesteld op AGENTID. U kunt de RunApp eigenschappen-editor gebruiken om deze eigenschap te configureren door te dubbelklikken op de actie.
ActionType	RunExe: CXone Mpower wordt niet ondersteund. Dit vereist een lokaal uitvoerbaar bestand dat zich in het Windows-pad bevindt of waarvan het volledige pad is ingevoerd in het veld ActionValue. Het bestandspad moet dubbele backslashes (\\) bevatten. Bijvoorbeeld, C:\\Program Files\\CXone Mpower\\studio.exe. De meeste moderne browsers ondersteunen het uitvoeren van uitvoerbare programma's niet. Als u dit type wilt gebruiken, moet u ervoor zorgen dat uw agents een compatibele browser gebruiken. OpenURL: opent een standaard webbrowser voor de URL die is opgegeven in het veld ActionValue . ShowCustomForm: hiermee start u een aangepast HTML-formulier dat is gemaakt in Studio. De gegevens van het aangepaste formulier triggeren de ONDATA -gebeurtenis in het script. U kunt de RunApp Property-editor gebruiken voor het configureren van deze eigenschap door te dubbelklikken op de actie.
ActionValue	De waarde die nodig is voor het opgegeven ActionType. Variabelen worden in deze eigenschap gespecificeerd door de variabele tussen {accolades} te zetten. RunExe: de naam of het pad van een uitvoerbaar bestand in Windows. Het bestandspad moet dubbele backslashes (\\) bevatten. Bijvoorbeeld: C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}. OpenURL: dit moet een volledig gekwalificeerde domeinnaam en URL zijn. Querystring-parameters worden ondersteund. Bijvoorbeeld: http://www.voorbeeld.com/file.asp?ANI={ANI}. De titel van het tabblad dat in de MAX-interface wordt weergegeven, kan ook worden aangepast door de parameter icAgentPanelTitle= toe te voegen aan de URL. Deze parameter wordt niet ondersteund in CXone Mpower Agent. ShowCustomForm: dit veld biedt de mogelijkheid om een aangepast HTML-formulier te maken. Alle standaard invoervelden voor formulieren kunnen worden gebruikt, zoals Input, Textarea, Password, Checkbox, Radio, Select, Button en Submit. Voeg geen <form>-tags toe. Elk invoerveld moet een naam hebben. Velden zonder naam worden genegeerd. Voorbeeld: <input type="text" name="phone">. Het script moet een van de onderstaande elementen bevatten om het aangepaste formulier te laten werken: Ondata -actie: namen en waarden worden door middel van deze actie als variabelen naar het script geretourneerd. WaitForSubmit eigenschap: als deze eigenschap is opgenomen en ingesteld op True, worden de veldnamen variabelen in het script. De veldwaarden worden de inhoud van de variabelen. Formuliervelden die meerdere waarden ondersteunen, zoals Checkbox en Select, zullen een door komma's gescheiden array bevatten. U kunt meerdere Submit-knoppen toevoegen met dezelfde of verschillende namen, maar elke knop zorgt ervoor dat de gegevens worden verzonden en het venster wordt gesloten. Als u een knop wilt die de gegevens niet verzendt en het venster niet afsluit, gebruikt u een Button- in plaats van een Submit-element. Gekoppelde stylesheets worden niet ondersteund, maar u kunt wel inline styles gebruiken. Bijvoorbeeld, <div style="position: absolute: left: 10px: top: 100px:">. Javascript werkt indien er een koppeling is met een extern Javascript, maar de inhoud moet HTTPS zijn om fouten te voorkomen. Voorbeeld: <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)"> U kunt de RunApp Property Editor gebruiken voor het configureren van deze eigenschap door te dubbelklikken op de actie.
WaitForSubmit	Bepaalt of het systeem wacht op een verzendactie van de agent. Wanneer ingesteld op True, wacht het systeem op de indieningsactie van de agent. Veldnamen worden variabelen in het script met de veldwaarde als de waarde van de variabele. Wanneer dit is ingesteld op False, moet u de actie Ondata in het script opnemen, die de veldnamen en waarden als variabelen naar het script retourneert. WaitForSubmit is alleen van toepassing als het Action Type is ingesteld op ShowCustomForm. Dit werkt in combinatie met WaitTimeout. Schakel deze eigenschap uit wanneer u deze actie gebruikt in een script dat een CRM Klantrelatiebeheer: externe systemen voor het beheren van contacten, verkoopkansen, supportdetails en cases. integreert met een CXone Mpower Agent applicatie. Wanneer deze eigenschap is ingeschakeld, is het formulier leeg wanneer het wordt verzonden als de time-out van het formulier is opgetreden.
WaitTimeout	Het aantal seconden waarna de OnTimeout-vertakking wordt getriggerd als Action Type is ingesteld op ShowCustomForm.

Resultaatvertakkingsvoorwaarden

Met Resultaatvertakkingsvoorwaarden kunt u vertakkingen maken in uw script om verschillende resultaten te behandelen wanneer de actie wordt uitgevoerd.

Voorwaarde	Beschrijving
Default	Het pad dat altijd wordt gevolgd, behalve als het script voldoet aan een voorwaarde die vereist dat het een van de andere vertakkingen volgt. Dit pad wordt ook gevolgd als de andere vertakkingen van de actie niet zijn gedefinieerd.
Submit	Pad dat wordt genomen als WaitForSubmit is ingesteld op True.
Timeout	Het pad dat wordt gevolgd als er gedurende het opgegeven aantal seconden geen reactie is.
OnError	Het pad dat wordt gevolgd als de actie niet correct is uitgevoerd. Als er bijvoorbeeld een onverwacht probleem is, zoals een slechte verbinding, syntaxfouten enz. De _ERR-variabele, met één onderstrepingsteken, moet een beknopte beschrijving van het probleem bevatten.

Wizard voor Runapp

U kunt de actie ook rechtstreeks configureren met behulp van de eigenschappen van de actie.

Dubbelklik op de actie Runapp om de wizard RunApp Property Editor te openen.
Afbeelding weergeven
Voer de agent-ID in voor de agent die de Runapp-actie moet ontvangen. Voor outbound scripts gebruikt u {__agentID} als naam van de variabele, voor alle andere scripts gebruikt u {AGENTID}.

Selecteer het Actietype.

Veld	Beschrijving
Run an executable program	voert een lokaal uitvoerbaar bestand uit. Deze optie maakt gebruik van een Java-plugin die alleen werkt met Internet Explorer, een webbrowser die niet wordt ondersteund door CXone Mpower. Dit vereist een lokaal uitvoerbaar bestand dat zich in het Windows-pad bevindt of waarvan het volledige pad is ingevoerd in het veld ActionValue. Het bestandspad moet dubbele backslashes (\\) bevatten. Bijvoorbeeld, C:\\Program Files\\CXone Mpower\\studio.exe. De meeste moderne browsers ondersteunen het uitvoeren van uitvoerbare programma's niet. Als u dit type wilt gebruiken, moet u ervoor zorgen dat uw agents een compatibele browser gebruiken.
Pop open a web page	Typ de volledige URL van de webpagina in het veld Action Command. De pagina wordt geopend met de standaardbrowser op de lokale computer van de agent.
Prompt the user with a web page like form	Typ de HTML-code om een formulier te genereren in het veld Action Command. U hoeft de <form>-tags voor openen en sluiten niet op te nemen. Klik op Preview om het formulier te bekijken.

Klik op OK.