Indicate

Deze Help-pagina is bedoeld voor CXone Studio. Deze informatie is ook beschikbaar voor Desktop Studio.

Breidt de agentinterface uit met aangepaste functionaliteit, met name een pictogram waarop de agent kan klikken om de aangepaste functie te starten. Deze pictogrammen in de agentinterface kunnen worden gebruikt om een script uit te voeren of te signaleren, een URL te openen of eenvoudige webformulieren te bouwen en de data ervan te verwerken.

Afhankelijkheden

Een indicator moet in het script worden uitgeschakeld, omdat de indicator anders in de agentinterface aanwezig blijft nadat het contact is beëindigd. Doorgaans worden er twee Indicate-acties gebruikt: één om de knop in te schakelen en één om de knop uit te schakelen.
Omdat de Indicate-actie zo flexibel is, moet u het script zorgvuldig programmeren en uitgebreid testen.
Controleer of de koppeling die met de eigenschap ImageFile wordt gebruikt, geldig is. Een niet-werkende link kan ernstige prestatieproblemen veroorzaken voor uw CXone-servers.
MAX gebruikt een ingebouwde set afbeeldingen voor alle indicatoren, gebaseerd op ActionType. Als u een afbeelding opgeeft met de ImageFile-eigenschap met MAX, verandert er niets aan de afbeeldingen die agents te zien krijgen.

Ondersteunde scripttypen


Generiek	E-mail	Chat	Telefoon	Voicemail	Werkitem	SMS	Digitaal

Vergelijkbare functies 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, maar met Indicate wordt het ActionType geïnitieerd door het script in plaats van de agent.

Invoereigenschappen

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

De eigenschappen van deze actie wijzigen dynamisch wanneer u deze configureert. Als u bijvoorbeeld Agent selecteert als Target, wijzigt het volgende veld van Contact ID in Agent ID.

Vertakking	Beschrijving
Add Caption	Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.
Target	Selecteer het ontvangerstype in de vervolgkeuzelijst:Agents, Team, Skill, Everyone of Contact. De optie Everyone is afgeschaft. Selecteer dit niet.
Target Id Contact-ID, Agent-ID, Team	De ID van het doel, zoals een agent-ID. De naam van deze eigenschap varieert, afhankelijk van de Target die u kiest. Voor deze eigenschap wordt vaak een vervangende variabele gebruikt.
Name	Deze eigenschap is de naam of sleutel die wordt gebruikt om de waarde te identificeren. Dit kan een willekeurige naam of een willekeurig nummer zijn. Namen zijn niet hoofdlettergevoelig. Wanneer u meerdere Indicate-acties gebruikt, wordt deze naam gebruikt om bij te houden welke Indicate-actie is ingeschakeld of uitgeschakeld.
Image File	De URL van een afbeeldingsbestand in de directory van de tenant Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone-omgeving te beheren op de CXone-bestandsserver. Dit is de afbeelding waarop de agents moeten klikken. Het bestand moet een GIF, JPG of PNG zijn en de afbeelding moet 16x16 pixels groot zijn.Deze eigenschap is vereist bij het gebruik van de actie Indicate in Salesforce Agent of Salesforce Agent Lightning. Waarschuwing Een niet-werkende link voor ImageFile kan ernstige prestatieproblemen veroorzaken voor de gekoppelde tenant. Als u aangepaste pictogrammen gebruikt, is het belangrijk om goed te controleren of de link klopt.
Tooltip	De tekst die wordt weergegeven wanneer de muisaanwijzer over het indicatorpictogram of de tekst beweegt.
State	Een vervolgkeuzelijst met de opties On en Off om te bepalen of de indicator wordt weergegeven. U hebt meestal twee indicate acties met dezelfde naam nodig: een om de knop in te schakelen en een om de knop uit te schakelen.
Action Type	Run Exe: start een lokaal uitvoerbaar bestand. Deze optie maakt gebruik van een Java-plug-in die alleen werkt met Internet Explorer, een webbrowser die niet wordt ondersteund door CXone. Selecteer deze optie niet. Open URL: opent een standaard webbrowser voor de URL die is opgegeven in het veld URL . Spawn script: spawnt een script dat is opgegeven in het veld Script Name en geeft parameters door. Signal script: signaleert een script dat is opgegeven in het veld ActionValue en geeft parameters door. Show Custom Form: er wordt een aangepast HTML-formulier geopend. Plak de HTML-code voor het formulier in de Html-eigenschap. De vastgelegde gegevens van het aangepaste formulier triggeren de ONDATA-gebeurtenisactie in het script.
URL	Geef de URL op die u wilt openen. Deze eigenschap wordt alleen weergegeven als u Open URL of Run Exe selecteert als Action Type. Voor URL openen, moet u een volledig gekwalificeerde domeinnaam en een URL gebruiken. Querystring-parameters worden ondersteund. Bijvoorbeeld, http://www.example.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. Voor Exe uitvoeren moet u een lokaal uitvoerbaar bestand gebruiken dat zich bevindt in het Windows-pad of met het volledige pad ingevoerd in het veld URL. Het bestandspad moet dubbele backslashes (\\) bevatten. Bijvoorbeeld, C:\\Program Files\\CXone\\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.
Script Name	Voer het volledige pad en de naam in van het script dat u wilt spawnen. Het pad moet een relatief pad zijn dat begint in de map waar het huidige script zich bevindt. U moet ook de Skill# opgeven. Deze wordt ook doorgegeven in het gespawnde script. U kunt een aanvullende Parameters opgeven die u wilt doorgeven in het script Deze eigenschap wordt alleen weergegeven als u Spawn script selecteer als Action Type.
Skill#	Voer het nummer in van de ACD-skill die moet worden doorgegeven in het gespawnde script. U moet ook de Script Name opgeven die u wilt spawnen. U kunt een aanvullende Parameters opgeven die u wilt doorgeven in het script Deze eigenschap wordt alleen weergegeven als u Spawn script selecteer als Action Type.
Contact ID	Voer de ID van het script dat u wilt signaleren. Dit is meestal de contact-ID. Deze eigenschap gebruikt standaard de variabele {contactId}. U kunt ook {masterID} gebruiken om het bovenliggende script te signaleren, of bijvoorbeeld {spawnID} om een onderliggend script te signaleren. Deze eigenschap wordt alleen weergegeven als u Signal script selecteer als Action Type.
Parameters	Geef eventuele aanvullende parameters op om door te geven aan het gespawnde script of het script dat wordt gesignaleerd. Parameters toevoegen is optioneel. Deze eigenschap wordt alleen weergegeven als u Spawn script of Signal script selecteert als Action Type.
Html	Voer de HTML in voor het aangepaste formulier dat u wilt starten. U kunt invulvelden van standaardformulieren gebruiken, waaronder Input, Textarea, Password, Checkbox, Radio, Select, Button en Submit. Gebruik echter de <form>-tags niet. Wanneer u velden toevoegt: Elk invoerveld moet een naam bevatten. Velden zonder naam worden genegeerd. Bijvoorbeeld, <input type="text" name="phone">. Namen en waarden worden als variabelen naar het script geretourneerd met behulp van de Ondata-actie. Als de Ondata-actie in het script ontbreekt, is het formulier zinloos. Formuliervelden die meerdere waarden ondersteunen, bijvoorbeeld Checkbox en Select, bevatten een door komma's gescheiden array. U kunt meerdere verzendknoppen toevoegen met dezelfde of verschillende namen, maar elke verzendknop 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 script, maar de inhoud moet HTTPS zijn om fouten te voorkomen. Bijvoorbeeld: `<script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">` Deze eigenschap wordt alleen weergegeven als u Signal script selecteer als Action Type.

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.
Fout	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.

Tips en trucs

Fieldset en Legend worden ondersteund om de formulieren leesbaarder te maken. Er kunnen inline-stijlen worden toegepast op HTML-elementen. Bijvoorbeeld:

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

Voorbeeld van een script

Dit is een voorbeeld dat toont hoe deze actie kan worden gebruikt in scripts. Het is niet bedoeld als een compleet script. Het kan nodig zijn het script verder te bewerken.

Dit voorbeeld toont hoe u de Indicate-actie moet integreren in een script. Dit omvat voorbeelden van de manier waarop verschillende types data worden doorgegeven aan het gespawnde script. Een voorbeeld van een gespawnd script is opgenomen in het downloadbare ZIP-bestand. Dit is een voorbeeld dat toont hoe deze actie kan worden gebruikt in scripts. Het is niet bedoeld als een compleet script. Het kan nodig zijn het script verder te bewerken.

Download dit script.