Scripts en API's
De informatie op deze helppagina is zowel van toepassing op CXone Studio als op Desktop Studio.
U kunt verbinden met webservices met Studio-scripts die SOAP- of RESTful API-normen gebruiken. U kunt verbinden met de volgende methoden:
- REST APIStudio-actie
- Integration Hub
- APIStudio-acties
- CRM-workflowintegraties
RESTful web-services
U kunt Studio-scripts gebruiken voor het verbinden met RESTful API met de REST-proxy in een
De REST-proxy vereist het gebruik van dynamische gegevensobjecten. Met het dynamische gegevenstype kunnen uw scripts werken met reacties die zijn opgemaakt in XML en JSON. Dynamische gegevensobjecten kunnen gegevens ontvangen in deze indelingen zodat ze kunnen worden gelezen. U kunt ook dynamisch objecten maken die kunnen worden omgezet in XML of JSON. Deze mogelijkheden zijn nodig voor het gebruik van RESTful API's.
Om de REST-proxy te gebruiken, voegt u een Snippet-actie toe aan uw script en opent u het
ASSIGN proxy = GetRESTProxy()
proxy.<property | function>([parameters])
Voor <property | function> kiest u uit de eigenschappen en functies die zijn beschreven in de volgende secties.
Eigenschappen
Vertakking | Details |
---|---|
|
Bevat de HTTP-statuscode na een aanroep naar |
|
Bevat de HTTP-statusbeschrijving na een aanroep naar |
|
Hiermee kunt u de standaard content-type header overschrijven. De standaardwaarde is application/x-www-form-urlencoded. Afhankelijk van de aanroep die u maakt, kunt u de koptekst wijzigen. Als u bijvoorbeeld JSON verzendt, wijzigt dit naar application/json. U moet deze eigenschap wijzigen. |
|
Hiermee kunt u de time-out voor de aanvraag wijzigen. De standaardwaarde is 10 seconden. u moet deze eigenschap wijzigen. |
Functies
De volgende tabel biedt informatie oer de functies die beschikbaar zijn voor gebruik wanneer u verbindt met RESTful API's. Er zijn extra REST-proxyfuncties waarmee u strings kunt coderen en hashen.
Functie | Details |
---|---|
|
Voert een HTTP-verzoek uit naar de aangewezen URL. |
|
Voegt een aangepaste header toe aan het HTTP-verzoek. |
|
Wist alle aangepaste headers die zijn toegevoegd met |
Voorbeelden
ASSIGN proxy = GetRESTProxy()
ASSIGN proxy.ContentType = "application/json"
ASSIGN url = "https://catfact.ninja/fact"
ASSIGN verb = "GET"
ASSIGN result = proxy.MakeRestRequest(url,payload,'JSON',verb)
ASSIGN restProxy=GetRESTProxy()
restProxy.AddHeader("x-api-key", "qwer") //Assigning incorrect header for demonstration purposes
restProxy.ClearHeaders()
restProxy.AddHeader("x-api-key", "asdf")
ASSIGN restProxy.ProxyTimeoutSeconds = "2"
ASSIGN restProxy.ContentType = "application/json"
ASSIGN uri = "http://postman-echo.com/post"
DYNAMIC beowulfCharacteristics
ASSIGN beowulfCharacteristics.name = "Beowulf"
ASSIGN beowulfCharacteristics.occupation= "Hero"
ASSIGN beowulfCharacteristics.foe = "Grendel"
ASSIGN payloadJSON = "{beowulfCharacteristics.asJSON()}
SOAP-webservices
U kunt op SOAP gebaseerde webservices gebruiken in uw Studio-scripts. Dit vereist dat u een a WSDL of Proxy DLL importeert in Studio. De geïmporteerde DLL moet worden geautoriseerd door NICE CXone. Na het autoriseren van de DLL's, wordt dit opgeslagen in de hoofdmap van de bestandopslag van tenant Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone-omgeving te beheren.
Het gebruik van SOAP-webservices vereist hulp van NICE CXone. Neem voor meer informatie contact op met uw CXone-accountmanager.
SOAP gebruiken in een snippet
Wanneer u een op SOAP gebaseerde webservice wilt gebruiken in een Studio-script, moet u een fragment maken. Voeg een Snippet-actie toe aan uw script. Voeg in het venster Fragment-editor een
Het volgende fragment is een voorbeeld van het gebruik van een op SOAP gebaseerde webservice met een Studio-scripts.
USES "sf.dll"
cStart="{now}"
sforce=new SforceService()
session=new SessionHeader()
loginResult=sforce.login("demo@nice.com",password6")
sforce.sessionheadervalue=session
session.sessionid=loginResult.sessionid
sforce.url=loginresult.serverUrl
t=new Task()
t.ActivityDate=#"8/20/2050"
t.Description="Call placed by {first }{Last}."
t.Subject="Call @{cStart}"
t.Status="Completed"
t.CallType="Outbound"
t.OwnerId=SF_Agent_ID
t.ReminderDateTime="{cStart}"
SWITCH Type
{
CASE "CON" { t.WhoId=SF_Obj_ID }
CASE "LEA" { t.WhoId=SF_Obj_ID }
CASE "ACC" { t.WhatId=SF_Obj_ID }
CASE "OPP" { t.WhatId=SF_Obj_ID }
CASE "CAS" { t.WhatId=SF_Obj_ID }
}
SaveResult=sforce.create(t)