SNIPPET

Diese Hilfeseite bezieht sich auf CXone Studio. Diese Informationen sind auch für Desktop Studio verfügbar.

Ermöglicht Ihnen das Hinzufügen von eigenem Code zu Ihrem Skript.

ABHÄNGIGKEITEN

  • Code, der in dieser Aktion verwendet wird, muss in Snippet, einer hausinternen Skriptingsprache, die von NICE CXone entwickelt wurde, geschrieben sein. Das technische Referenzhandbuch für Studio enthält ausführliche Informationen über die Skripterstellung in Snippets.
  • Attribute von dynamischen Datenobjekten können nicht __type (mit zwei Unterstrichen) genannt werden. Dieses Wort ist für das Parsen von JSON in dynamischen Objekten reserviert.
  • Sie können API-Aufrufe mithilfe der Snippet-Aktion durchführen. Die maximale Antwortgröße beträgt 32 kB. Dies entspricht dem Antwortgrößenlimit in der REST API-Aktion.  Das Limit wird streng erzwungen, um Cluster-Instabilität und Ausfälle zu verhindern. Verwenden Sie nach Möglichkeit stattdessen die REST API-Aktion. Sie hat dasselbe Limit, kann aber eine höhere Auslastung handhaben. Wenn Sie die SNIPPET-Aktion verwenden müssen, beachten Sie die folgenden Tipps, um die Größe der zurückgegebenen Daten zu verringern: 
    • Filtern Sie die Daten in der API-Antwort. Wenn Sie zum Beispiel die NICE-API für Berichte verwenden, um Kontakte abzurufen, können Sie die Ergebnisse nach startDate und endDate des Kontakts filtern. Mit diesem API-Aufruf können Sie auch eine Obergrenze für die Anzahl der zurückgegebenen Elemente festlegen. In der API-Dokumentation, die mit Ihrer Skriptintegration geliefert wurde, wird beschrieben, welche Filter Sie verwenden können.

    • Ändern Sie die API-Anfrage so, dass nur die benötigten Daten zurückgegeben werden. Wenn Sie zum Beispiel die NICE-API für Berichte verwenden, um Kontakte abzurufen, können Sie die Felder contactId oder agentId so festlegen, dass nur relevante Daten zurückgegeben werden. In der API-Dokumentation, die mit Ihrer Skriptintegration geliefert wurde, wird beschrieben, welche Datenlimits Sie verwenden können.

    • Wenn Sie keine der genannten Optionen verwenden können, erstellen Sie eine Middleware.

Unterstützte Skripttypen

Ein Quadrat, von dem eine Linie abzweigt, die zu drei anderen Quadraten verläuft.

Allgemein

E-Mail Chat Telefon Voicemail Arbeitselement SMS Digital

Eingabeeigenschaften

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

Eigenschaft

Beschreibung

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

Data

Enthält den benutzerdefinierten Code, der im Snippet editor-Fenster hinzugefügt wurde. Dies kann die folgenden Elemente umfassen: mehrere ASSIGN- und DYNAMIC-Befehle, verschiedene Anweisungen zur Ablaufkontrolle sowie integrierte und benutzerdefinierte Funktionen.

Max String Size

Legt die maximale String-Größe für alle Befehle in der Data-Eigenschaft fest. Die folgenden Optionen sind verfügbar: Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Dieses Limit gilt auch für Integrationsantworten mit Rest-APIs und SOAP.

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.

Fehler

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.

Tipps & Tricks

Snippet Editor -Fenster

Das Snippet editor-Fenster wird geöffnet, wenn Sie eine Snippet-Aktion auswählen und dann in den Aktionseigenschaften auf Editor öffnen klicken.

Skriptbeispiel

Dies ist ein Beispiel, das zeigt, wie diese Aktion in Skripten verwendet werden kann. Es handelt sich nicht um ein vollständiges Skript. Möglicherweise müssen weitere Skriptteile erstellt werden.

In diesem einfachen Beispiel wird der Code im Snippet verwendet, um zu testen, ob ein Interessent mithilfe von Informationen aus einem Drittanbieter-System erstellt werden kann.

Ein Skript mit zwei SNIPPET-Aktionen.

Laden Sie dieses Skript herunter.