Putvalue

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

Speichert und ruft Daten in einer NICE CXone Datenbank-Tabelle ab, um sie anderen Skripts und Kontakten zugänglich zu machen. Diese Daten können mit der GETvalueaction- abgerufen werden.

Wenn mehrere Variablen von anderen Skripten oder Kontakten abgerufen werden müssen, ist eine Datenbank meist die beste Lösung.

ABHÄNGIGKEITEN

  • Putvalue verwendet einen besonderen Datentyp, der mithilfe der entsprechenden Studio-Aktionen abgerufen werden muss: Getvalue, Remvalue, Getlist, and Clearlist.
  • Wenn die Eigenschaft Persistent auf False eingestellt ist, werden alle öffentlichen Werte, die von einem bestimmten Kontakt hinzugefügt wurden, automatisch entfernt, wenn der Kontakt freigegeben wird. Diese Funktion wird üblicherweise verwendet, wenn ein Parent-Skript die hervorgebrachten Child-Skripte verfolgen muss. Jedes untergeordnete Skript verwendet Putvalue mit der Eigenschaft Name, wie "{MasterID}List", und dem Wert von {ContactID}. Weil die "{MasterID}List" öffentlich ist, kann das übergeordnete Skript regelmäßig Getlist ausführen, um zu verfolgen, wie viele untergeordnete Skripte derzeit ausgeführt werden. Wegen der Eigenschaft Persistent=false wird der öffentliche Wert des untergeordneten Skripts bei der Freigabe automatisch entfernt. Es ist keine zusätzliche Arbeit erforderlich, um eine genaue Anzahl der Child-Skripte zu erhalten.
  • Nicht-dauerhafte öffentliche Variablen können während der Lebenszeit des Skripts, das diese Variablen setzt, auch von anderen Skripten / Kontakten verwendet werden. Diese Variablen werden automatisch bereinigt, wenn sie freigegeben werden.
  • Persistent-Variablen müssen manuell entfernt werden, und zwar durch Ausführen von Getvalue (mit der Remove-Eigenschaft auf true), Remvalue oder Clearlist. Es ist nicht empfehlenswert, Putvalue für große Datenmengen oder Daten zu verwenden, die Sie über längere Zeiträume benötigen. Wenn Sie Daten speichern müssen, sollten Sie einen DB -Konnektor verwenden und eine Verbindung mit einer Datenbank herstellen, die Sie steuern.

Unterstützte Skripttypen

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Allgemein

E-Mail-Adresse Chat Telefon Voicemail Arbeitselement SMS Digital

Verwandte Aktionen

Diese Aktion ist eine von mehreren Aktionen, die Daten aus einer Datenbanktabelle speichern und abrufen, um sie anderen Skripten zugänglich zu machen; sie verhält sich wie eine Liste von Feldern oder Werten. Verwenden Sie sie zum Speichern mehrerer Werte oder von Werten, die in anderen Skripten weiter benötigt werden. Die vollständige Liste der Aktionen, einschließlich dieser Aktion, ist: Putvalue, Getvalue, Remvalue, Getlist, and Clearlist.

Diese Aktionen verwenden einen eindeutigen Datentyp, auf den nur über diesen Satz von Studio Aktionen zugegriffen werden kann. Die Daten sind auf keine andere Weise zugänglich. Benutzer können nicht auf diese Datenbank zugreifen und sie verwenden, unabhängig von ihren Berechtigungen.

Die Werte werden für eine begrenzte Zeit in einer Datenbanktabelle aufgelistet, wie in der Eigenschaft TTL hrs der Putvalue -Aktion konfiguriert. Der Standardwert ist 24 Stunden, er kann jedoch von einer Stunde bis 168 Stunden (sieben Tage) reichen. Sie können die Remvalue-Aktion verwenden, um Daten vor der TTL-Zeit zu löschen. So haben Sie die vollständige Kontrolle über die Daten in Ihren Skripten.

Hinweise:

  • Wenn mehrere Variablen von anderen Skripten oder Kontakten abgerufen werden müssen, ist eine Datenbank meist die beste Lösung.
  • Nicht dauerhafte öffentliche Variablen können während der Lebenszeit des Skripts, das diese Variablen setzt, auch von anderen Skripten oder Kontakten verwendet werden. Diese Variablen werden automatisch bereinigt, wenn sie freigegeben werden.

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.

Scope

Wählen Sie die Ebene, auf der die Werte, die diese Aktion verarbeitet, für andere Kontakte sichtbar sind. Nur Kontakte mit dem gleichen Scope können auf die selben Daten zugreifen. Optionen sind:

Der ausgewählte Scope muss mit dem Scope übereinstimmen, der in allen anderen Listenaktionen festgelegt ist, die Sie in Ihr Skript aufnehmen. Die Listenaktionen sind Putvalue, Getvalue, Remvalue, Getlist, and Clearlist. Auch wenn der Name der Liste gleich ist, werden sie nicht erkannt, wenn die Einstellungen für Scope nicht übereinstimmen.

Name

Hiermit wird der Wert identifiziert. Es kann sich um einen beliebigen Namen oder Nummer handeln. Bei den Namen muss die Groß-/Kleinschreibung nicht beachtet werden. Wenn der Wert mithilfe von Getvalue abgerufen wird, muss Name identisch sein. Wenn die Eigenschaft Name nicht übereinstimmt, erkennen sie einander nicht, auch wenn die Einstellung für Scope dieselbe ist.

Value

Der zu speichernde Wert oder die zu speichernden Daten.

Method

Wenn mehrere Werte mit demselben gespeichert werden, werden sie in eine Liste gestellt. Wählen Sie eine der folgenden Methoden:

  • ReplaceAll: Dies ist der Standardwert, der automatisch ausgewählt wird.
  • Append: setzt den neuen Wert an das Ende der Liste. Wenn Sie mehr als 1000 Werte in weniger als 24 Stunden anfügen, werden keine Werte mehr hinzugefügt, bevor einige davon gelöscht werden (nach 24 Std.).
  • Insert: setzt den Wert an den Anfang der Liste. Folgende Aufrufe an Getvalue rufen Daten vom Anfang der Liste ab.
Persistent

Wählen Sie True aus, wenn die von einem bestimmten Kontakt gespeicherten Daten beibehalten werden sollen, nachdem der Kontakt freigegeben wurde. Standardmäßig werden die Daten gelöscht, wenn der Kontakt freigegeben wird (False).

TTL (hrs)

Setzen Sie diese Eigenschaft auf die Zeitspanne in Stunden, in der die Daten verfügbar sein sollen. Wenn die TTL (Time to Live) erreicht ist, werden die Daten gelöscht. Der tatsächliche Zeitpunkt der Datenlöschung kann bis zu einer Stunde nach Ablauf der TTL liegen. Der Grund dafür ist, dass der Prozess, der die TTL überprüft, einmal pro Stunde, zu Beginn der Stunde, abläuft. Wenn die TTL beispielsweise um 10:03 Uhr abläuft, wird der Prozess, der den Ablauf der TTL prüft, erst um 11:00 Uhr ausgeführt, was bedeutet, dass die Daten bis 11:00 Uhr weiter existieren.

Der Mindestwert für diese Eigenschaft ist eine Stunde und der Höchstwert 168 Stunden (sieben Tage). Die Standardeinstellung ist 24 Stunden. Wenn Sie Werte außerhalb der zulässigen Grenzen einstellen, wird der nächstmögliche Wert verwendet.

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.