Putvalue

本帮助页面适用于 CXone Studio。此信息也可用于Desktop Studio。

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

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

依赖关系

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

支持的脚本类型

其中一条分支线通向其他三个正方形的正方形。

通用

 Email 聊天 电话 语音信箱 工作项目 短信 数字

相关操作

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

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

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

注意：

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

输入属性

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

属性

说明

添加 说明文字

输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。
Scope

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

选择的Scope必须与脚本中包含的所有其他列表操作中设置的Scope相匹配。列表操作为 Putvalue、Getvalue、Remvalue、Getlist 和 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 小时。如果设置的值超过允许限值，操作将使用最接近的允许值。

结果分支条件

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

条件

说明

Default

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