Putvalue

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

NICE CXone 数据库表中存储和检索数据,以便其他脚本和联系人可以访问数据。此数据可以使用 GETvalue action检索。

如果其他脚本或联系人需要访问多个变量,数据库通常是最佳解决方案。

Dependencies

  • Putvalue 使用唯一数据类型,此类型必须使用适当的 Studio 操作加以访问: Getvalue, Remvalue, Getlist, and Clearlist.
  • Persistent 属性设置为 False 时,特定联系人添加的所有公共值都会自动删除当联系人被释放时。当父脚本需要跟踪生成的子脚本时,通常会使用这个特性。每个子脚本都将包含Putvalue "{MasterID}List” Name 属性和 {ContactID} 值。由于 “{MasterID}List” 是公共值,父脚本会定期执行 Getlist 来发现当前有多少个子脚本在运行。凭借 Persistent=false 属性,子脚本的公共值将在发布时自动被删除。不需要额外的工作来让子脚本保持准确数量。
  • 在设置这些变量的脚本的整个生命周期中,非永久公共变量可以由其他脚本/联系共享。变量会在释放后自动清除。
  • 必须通过执行Getvalue(将 Remove 属性设置为 true)、RemvalueClearlist 来手动删除变量 Persistent。对于大量数据或长时间需要使用的数据,不建议使用 Putvalue。如需保存数据,建议使用数据库连接器,并连接到自己控制的数据库。

Supported Script Types

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.

通用

电子邮件 聊天 电话 语音信箱 工作项目 短信 数字

Related Actions

此操作属于在数据库表中存储和检索数据的若干操作之一,目的是使其他脚本可以访问这些数据;其运行方式如同字段或值的列表一样。使用它们来存储多个值或在其他脚本中进一步需要的值。包括此操作在内的完整操作列表为:Putvalue, Getvalue, Remvalue, Getlist, and Clearlist.

这些操作使用唯一的数据类型,而这种数据仅能通过此组 Studio 操作来访问。无法以任何其他方式来访问数据。无论用户拥有何种权限,他们都无法访问并使用此数据库。

如同在 Putvalue 操作的 TTL hrs 属性中所配置的,这些值在限制了时间的数据集表格中列出。默认值为 24 小时,但可以设为 1 小时到 168 小时(7 天)。您可以使用 Remvalue 操作删除 TTL 时间之前的数据。这样您就可以完全控制脚本中的数据。

注意:

  • 如果其他脚本或联系人需要访问多个变量,数据库通常是最好的解决方案。
  • 在设置这些变量的脚本的整个生命周期中,其他脚本或联系人可以共享非持久性公共变量。变量会在释放后自动清除。

Input Properties

这些属性定义操作在执行时使用的数据。

属性

说明

说明文字

输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.

Scope

选择此操作处理的值对其他联系人可见的级别。只有共享相同可见性范围的联系人才能够访问相同的数据。选项包括:

选择的Scope必须与脚本中包含的所有其他列表操作中设置的Scope相匹配。列表操作为 Putvalue, Getvalue, Remvalue, Getlist, and Clearlist. 如果 Scope 设置不匹配,即使列表的 Name 相同,也无法识别。

Name

用于标识值。可以是任何名称或数字。名称不区分大小写。使用 Getvalue检索值时,Name 必须相同。如果 Name 属性不匹配,即使 Scope 设置相同,它们也无法相互识别。

Value

要存储的值或数据。

Method

当存储多个具有相同名称的值时,会将其放在一个列表中。选择以下方法之一:

  • ReplaceAll:这是默认值,将被自动选中。
  • Append:将新值放在列表的末尾。当追加值时,如果在 24 小时内值的数量超过 1000,将不再进行追加,直到清除了一些追加值(24 小时后)。
  • Insert:将值放在列表的开头。后续调用 Getvalue 时,将从列表的开头检索数据。
Persistent

如果您希望指定联系人存储的数据在该联系被释放后保持不变,请选择True。默认值为释放联系时移除数据(False)。

TTL (hrs)

将此属性设置为您希望数据处于可用状态的时间(以小时为单位)。达到 TTL(存留时间)后,数据将被清除。数据可能在 TTL 过期后一小时内才予以实际清除。原因在于,检查 TTL 的进程在每小时开始时每小时运行一次。例如,如果 TTL 于 10:03 过期,而检查 TTL 过期的进程直到 11:00 才会运行,这意味着数据在 11:00 之前仍将继续存在。

此属性的最小值为 1 小时,最大值为 168 小时(7 天)。默认值为 24 小时。如果设置的值超过允许限值,操作将使用最接近的允许值。

Result Branch Conditions

结果分支条件允许您在脚本中创建分支,以在执行操作时处理不同的结果。

条件

说明

Default

除了脚本满足条件要求其接受其他分支的情况之外,所要采用的路径。如果未定义操作的其他分支,也会执行此操作。