设置参与者数据操作

此操作在数据类别中可用的任务编辑器的工具箱。建筑师可以将属性或参与者数据分配给 v办公室或数字参与者。属性是有关在整个互动过程中与之一起旅行的参与者的信息。在 Architect 中，参与者是入站语音或数字流的呼叫者，或出站流的接收者。

关于属性

与流变量相反，参与者数据属性在从一个流到另一个流的转移之间仍然存在。例如，如果交互转移到另一个流程，参与者的电话号码（Call.Ani）将不会保留。但是如果将信息存储到参与者数据中，其他流程就可以访问该数据。

每个参与者属性都是流程作者配置的名称和值字符串。要设置属性，请指定其名称和要分配给该属性的字符串值。参与者数据属性对于存储您想要在当前流程之外保留的信息最有用。例如，您想要从不同的流访问的信息或完全离开当前流的信息。通过参与者数据，第三方集成（例如 Genesys Cloud for Salesforce）可以接收您通过参与者数据设置的屏幕弹出 URL 信息。

注释：
  • 属性区分大小写。 如果您在流程的另一部分中使用现有属性，请确保与原始属性的大小写匹配。
  • For bot flows, these limitations apply. If you reach the limit, the session closes and the flow follows the configured error handling path.
    • 每个机器人会话的设置参与者数据操作执行次数为 50。
    • 流程在机器人会话期间设置的属性数量为 50。
    • 属性值的最大长度为 256 个字符。
  • 由于设置参与者数据需要具有对话 ID 的实际对话，因此该操作不适用于架构师测试选项。
  • 对话完成后，Genesys Cloud 不会保存属性分析。如果对话和片段已经完成，分析就无法重新打开对话来保存更改。例如： 
    1. 传入交互和入站流处于活动状态，并且一些参与者数据已写入流中，并在对话服务和分析服务中同步。
    2. 系统将交互转移到队列并等待。队列内流程处于活动状态，一些参与者的数据已写入流程中，并在对话服务和分析服务中同步。
    3. 交互路由到队列并且代理接受它。代理脚本包含一些参与者数据，在对话服务和分析服务中同步。
    4. 客户断开连接，代理进入结束状态。由脚本中的输出变量触发的代理脚本包含更多参与者数据，在对话服务中同步，但不在分析服务中同步。
    5. 代理完成总结并关闭该代理的交互视图。通过 API，该交互的另一个参与者数据和该代理参与者在对话服务中设置和同步，但在分析服务中未设置和同步。

    任务中的“设置参与者数据”操作为交互参与者分配属性值。例如，如果您有一个查找参与者信息的“呼叫数据”操作，请使用“设置参与者数据”操作来保存“呼叫数据”操作找到的结果。如果 Architect 将交互转移到另一个流程，则第二个流程可以通过获取参与者数据操作来调用信息，这样数据操作就不需要重复。

    笔记：当“获取参与者数据”操作调用某个属性时，请确保该属性名称与前一个流程中的“设置参与者数据”名称完全匹配。Architect 不会自动完成跨流程的参与者数据名称。为了确保精确匹配，请复制并粘贴区分大小写的名称。

    在语音流中，如果“设置参与者数据操作”在交互期间设置了参与者属性值，则会在后续的“获取参与者数据”操作交互中读取该设置值，即使该设置值直到流终止时才在云端更新。例如：

    1. 如果流程发出以“Foo”作为属性名称的获取参与者数据操作，则云将返回“Hello”，以便获取参与者数据操作中绑定到“Foo”的变量设置为“Hello”。
    2. 然后，流程会发出 “设置参与者数据” 操作，其中 “Foo” 作为属性名称，值为 “再见”。
    3. 然后流程重复并发出以“Foo”作为属性名称的获取参与者数据操作。云端像以前一样返回“Hello”，因为通过设置参与者数据所做的更新是排队的，并且只在终止之前发送到云端。然而在这种情况下，绑定到“Foo”的变量被设置为“Goodbye”，因为获取参与者数据在使用云返回的值之前使用了任何排队更新的值。
    笔记：与语音流不同，机器人流不维护更新列表的队列。相反，Architect 直接将参与者数据更新到云端。

    操作 描述和使用

    姓名

    		 为操作键入一个独特的名称。 您在此处输入的标签将成为任务序列中显示的操作名称。

    添加要设置的属性

    		 点击旁边属性并为属性添加名称/值对配置。可以在单个“设置参与者数据”操作中创建并保存多个属性（“参与者数据”）。

    属性名称

    为属性指定一个名称。属性名称是字符串文字，不能为空白（空）。此名称必须与“获取参与者数据”操作完全匹配才能检索值。

    要分配的值

    		 属性（参与者数据）值是字符串文字或表达式，例如内置变量、流变量或您创建的任务变量。使用文字编辑器或表达式编辑器为属性分配字符串、变量或表达式值。 

    注释：
    • 在语音流中，有时参与者的属性值会发生变化，而当参与者按照流程前进时，属性值也会发生变化。通过 “设置参与者数据” 操作进行的更新将在内存中排队，直到流程终止之前。但是，机器人流程会立即发送属性。
    • 更新将一次性发送到云端。如果流程针对同一属性发生多个“设置参与者数据”操作交互，则最后一次交互中设置的值将生效。