概述

桌面布局功能允许您根据业务需求配置 Webex Contact Center 桌面。 您可以自定义徽标、标题和 Widget 等元素。 您可以创建桌面布局并将其分配给团队。 此布局可为作为该团队成员登录的所有代理生成桌面上的代理体验。

有两种类型的布局:

  • 全局布局:此布局是系统生成的布局,默认情况下会在创建团队时分配。 有关详细信息,请参阅 管理团队。 创建团队时,“全局布局”会自动设置为团队的桌面布局。 您无法删除该布局。

  • 自定义布局:提供自定义桌面体验的布局。 您可以为一个或多个团队创建自定义布局。

如果您在代理登录时分配了新的桌面布局,则代理必须重新加载页面才能看到新布局。

Webex Contact Center 桌面支持三种角色:

  • 座席

  • 主管

  • 主管和代理

JSON 布局文件为每个角色提供了单独的部分。 管理员应在 JSON 布局文件的相应部分中配置每个角色的设置。 有关示例 JSON 布局文件的详细信息,请参阅 JSON 布局顶级属性

当 Cisco 向桌面布局添加新功能时,未修改的布局会自动更新为新功能。 更新后的桌面布局将自动有空给使用未修改桌面布局的现有团队。 使用未修改桌面布局的桌面用户在登录或重新加载浏览器时会收到新的基于布局的功能。

如果您使用的是未作任何修改的默认 桌面 Layout.json 文件,则将其视为未修改的布局。 但是,如果您下载 缺省桌面 Layout.json 文件并再次上传,即使文件内容或文件名未被修改,该文件也被视为已修改的布局。

对于使用自定义桌面布局的团队,管理员必须定期更新布局定义以合并新功能。 当管理员查看未修改的布局或使用未修改布局的团队时,将显示一条消息,指示将自动应用新的桌面功能。

在桌面中,有两种类型的 widget - 基于 iframe 的和基于 Web 组件的。 页眉、导航(自定义页面)、持久区域、无头区域和辅助面板是桌面中的可自定义区域。 这些不是小部件。

以下列表详细说明了您可以配置的空间。 下图说明了桌面的布局:

  1. 标题和徽标区域:此空间在屏幕的左上角显示 Webex Contact Center 徽标和名称(默认)。

  2. 水平标题 区域:此空间有一个可配置的区域,其中填充了自定义小部件。 例如,这些 Widget 可以显示内联信息和下拉菜单。 由于此标题的高度仅为 64 像素,因此构件的高度不能超过标题高度。

  3. 工作区 :此空间会根据导航栏上的选择或代理与客户交互时而变化。 当代理在呼叫时,此区域显示交互控制和辅助信息窗格(包括自定义小组件和持久小组件)。 当代理通过电子邮件、聊天或社交渠道进行交互时,该区域将显示工作区和辅助信息窗格(包括永久性小组件区域)。

    自定义页面 显示在工作区窗格的桌面界面上。 您可以通过导航栏上的图标访问自定义页面。 每个自定义页面可以包含一个或多个自定义小组件。

    自定义小组件 是在 JSON 布局中配置的第三方应用程序。 您可以将自定义 Widget 放置在自定义页面、自定义 Tab(辅助信息窗格)或桌面的水平标题上。

  4. 导航栏 区域:使用此空间添加导航项以访问自定义页面。

Sample Webex Contact Center Desktop user interface for voice, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
语音桌面 UI 示例
Sample Webex Contact Center Desktop user interface for new digital channels, showing the areas that are customizable including page icons, page labels, page level widgets, tab icons, tab labels, table level widgets, logo, title, drag and drop/resize/maximize/minimize ability, header customization, and other header widgets.
新数字渠道的示例桌面 UI

JSON 布局顶级属性

角色

默认 JSON 布局具有以下三个角色。

  • 代理 - 设置当代理登录到 Webex Contact Center 桌面以处理代理活动时显示的桌面布局。

  • 主管 - 设置主管登录 Webex Contact Center 桌面时显示的桌面布局,以仅处理主管功能。

    当主管登录到桌面时,将应用为主团队指定的桌面布局。 如果未提供主团队,则应用全局布局。 默认情况下,APS 报告处于禁用状态。

  • supervisorAgent - 设置主管登录 Webex Contact Center 桌面以处理主管功能和代理活动时显示的桌面布局。

您可以在相关 JSON 布局文件的相应角色中添加或修改每个角色的小组件。

以下是基于角色的 JSON 布局的顶级属性:

{“agent”:{“version”:“0.1.0”,“appTitle”:“Webex Contact Center”,“logo”:“”,“taskPageIllustration”:“https://www.abc.com/image/logo.jpg”,“stopNavigateOnAcceptTask”:false,“dragDropEnabled”:false,“notificationTimer”:8,“maxumNotificationCount”:3,“browserNotificationTimer”:8,“wxmConfigured”:false,“desktopChatApp”:{“webexConfigured”:false,}“headerActions”:[“outdial”,“notification”],“area”:{“advancedHeader”:{ ... },“面板”:{ ... },“导航”:{ ... },“持久”:{ ... },“无头”:{ ... } },},“主管”:{“版本”:“0.1.0”,“appTitle”:“Webex Contact Center”,“徽标”:“”,“taskPageIllustration”:“https://www.abc.com/image/logo.jpg”,“stopNavigateOnAcceptTask”:false,“dragDropEnabled”:false,“notificationTimer”:8,“maximumNotificationCount”:3,“browserNotificationTimer”:8,“wxmConfigured”:false,“desktopChatApp”:{“webexConfigured”:false,}“headerActions”:[“outdial”,“notification”],“area”:{“advancedHeader”:{ ... },“面板”:{ ... },“导航”:{ ... },“持久”:{ ... },“无头”:{ ... },“主页”:{ ... } },}“supervisorAgent”:{“version”:“0.1.0”,“appTitle”:“Webex Contact Center”,“logo”:“”,“taskPageIllustration”:“https://www.abc.com/image/logo.jpg”,“stopNavigateOnAcceptTask”:false,“dragDropEnabled”:false,“notificationTimer”:8,“maximumNotificationCount”:3,“browserNotificationTimer”:8,“wxmConfigured”:false,“desktopChatApp”:{“webexConfigured”:false,}“headerActions”:[“outdial”,“notification”],“area”:{“advancedHeader”:{ ... },“面板”:{ ... },“导航”:{ ... },“持久”:{ ... },“无头”:{ ... } }, } },
  • 对 JSON 布局属性所做的更改将在刷新桌面浏览器时生效。
  • 如果在 JSON 布局上启用的功能在桌面上未有空,请联系 Cisco 支持以启用该功能。
  • JSON 布局中的所有属性都区分大小写。

应用标题

在桌面的水平标题上指定标题。 缺省标题为 Webex Contact Center

示例

“appTitle”:“Webex Contact Center”

默认应用标题从联系人中心桌面 更改为 Webex Contact Center。 使用旧的默认 appTitle(联系人中心桌面的现有自定义布局没有影响。 要使用新的 appTitle,必须修改自定义布局。 但是,新的全局布局使用默认的 appTitle 作为 Webex Contact Center

标题可以是文本、图像或空字符串。 标题文本分两行显示。 如果文本超出第二行,则会显示省略号图标,并且工具提示将显示完整的标题。 样式不能应用于字幕。

您可以使用数据 URI(统一资源标识符)或在内容分发网络(CDN)、Amazon Web Services(AWS)简单存储服务(S3)存储桶或类似的托管服务上托管自定义标题图像,然后指定托管映像的 URL。 支持的标题图像格式为 PNG、JPG、JPEG、GIF、SVG 和 WebP。 支持的标题图像大小为 184 x 32 像素(宽 x 高)。

logo

指定公司徽标的 URL。 如果不提供 URL,则缺省情况下将显示 Webex Contact Center 徽标。

示例

“徽标”:“https://my-cdn.com/logo.png”

您可以在 CDN、Amazon Web Services(AWS)Simple Storage Service(S3)存储桶或类似的托管服务上托管自定义徽标图像,然后指定托管图像的 URL。 支持的徽标图像格式为 PNG、JPG、JPEG、GIF、SVG 和 WebP。 支持的徽标图像大小为 96 x 32 像素(宽 x 高)。

表 1. 基于桌面布局配置的应用标题和徽标的显示矩阵
条件 示例 应用标题 logo
如果未配置 appTitle 和徽标
“appTitle”:“”,“徽标”:“”, 
无标题 缺省徽标
如果配置了应用标题和徽标
“appTitle”:“ABC Company”,“logo”:“https://my-cdn.com/abclogo.png”, 
配置的文本 配置的徽标
如果配置了 appTitle 但未配置徽标
“appTitle”:“ABC Company”,“logo”:“”, 
配置的文本 缺省徽标

如果未配置 appTitle 并且配置了徽标

“appTitle”:“”,“徽标”:“https://my-cdn.com/abclogo.png”, 
无标题 配置的徽标
如果配置了 appTitle 并且徽标不是首选
“appTitle”:“ABC Company”,“logo”:“no-logo”, 
配置的文本 无徽标

如果未配置 appTitle 且徽标不是首选

“appTitle”:“”,“logo”:“no-logo”, 
无标题 无徽标
如果将 appTitle 添加为图像并配置了徽标
“appTitle”:“https://my-cdn.com/abccompanylogo.png”,“徽标”:“https://my-cdn.com/abclogo.png”, 
配置的映像 配置的徽标

如果将 appTitle 添加为图像并且未配置徽标

“appTitle”:“https://my-cdn.com/abccompanylogo.png”,“徽标”:“”, 
配置的映像 缺省徽标

如果将 appTitle 添加为图像,并且徽标不是首选

“appTitle”:“https://my-cdn.com/abccompanylogo.png”,“徽标”:“no-logo”, 
配置的映像 无徽标
  • 自定义图像大小根据纵横比进行调整。 之前配置的自定义标题文本现在可能在桌面上分两行显示。 为避免这种情况,您可以修改自定义标题文本。
  • 如果未在桌面的水平标题中配置标题和徽标,则标题 Widget 会使用该空间。 必须正确配置页眉构件才能使用标题和徽标空间。
  • 标题和徽标之和不能超过 304 像素(包括填充)的最大宽度。 如果徽标宽度小于 96 像素,则可将剩余宽度用于标题。
  • 如果自定义图片大小高于支持的大小,则会根据水平标题中的纵横比调整图像大小。 如果自定义图像大小小于支持的大小,则实际图像大小将保留在水平标题中。

任务页面插图

根据组织首选项和品牌一致性为任务页面指定自定义插图。 当代理登录时,任务页面将配置的插图显示为背景。 缺省情况下,任务页面不显示插图。

示例

“taskPageIllustration”:“https://www.abc.com/image/logo.jpg”,

您可以使用数据 URI 或在内容分发网络(CDN)、Amazon Web Services(AWS)简单存储服务(S3)存储桶或类似的托管服务上托管自定义插图,然后指定托管插图的 URL。 可以根据布局定义在全局或团队级别配置插图。 确保配置正确的 URL 以防止损坏的图像显示在桌面上。

支持的任务页面插图格式为 PNG、JPG、JPEG、GIF、SVG 和 WebP。 建议的插图大小为 400 x 400 像素(宽 x 高)。 如果自定义插图大小大于建议大小,则会根据任务页面中的纵横比调整插图大小。 如果自定义插图大小小于建议大小,则实际插图大小将保留在任务页面中。

Webex Contact Center interface example of a custom illustration retraining the actual size.
保留实际大小的自定义插图的示例示例
Webex Contact Center interface example of a custom illustration adjusted based on the aspect ratio.
根据纵横比调整的自定义插图的示例

stopNavigateOnAcceptTask

要确定当代理在处理上一个任务时接受新任务时是否将焦点转移到新接受的任务上。 缺省值为 false

示例

“stopNavigateOnAcceptTask”:假

如果将该值设置为 true,当用户在桌面上接受新任务时,焦点将保留在前一个任务上,而不会转移到新接受的任务上。 此设置可防止用户在接受新请求时丢失任何数据。

例如,假设代理 1 正在与客户 1 聊天,同时与客户 2 进行语音呼叫。在语音呼叫期间,代理 1 正在“交互控制”窗格中更新客户 2 的详细信息。 目前,代理 1 在“任务列表”窗格中有两个活动任务,焦点位于“交互控制”窗格上。 当代理 1 接受来自客户 3 的新聊天请求时,焦点将停留在与客户 2 的“交互控制”窗格上,而不会转移到新接受的聊天请求上。

要将焦点保留在前一个任务上而不转移到新接受的任务上,请选择 stopNavigateOnAcceptTask 属性值设置为 true 的 自定义布局

如果未在 JSON 布局中输入 stopNavigateOnAcceptTask 属性值,桌面会将焦点转移到新接受的任务上。 该行为类似于 stopNavigateOnAcceptTask 属性值设置为 false 的行为。

  • 该设置适用于在桌面上执行的所有任务(如接受任务、会议、咨询或转接),以及外拨呼叫、出站营销活动呼叫、自动话后总结等。
  • 如果桌面用户位于 Home 页面上,且“任务列表”窗格中没有活动任务,则该设置不适用。 在这种情况下,当接受新任务时,焦点将从 Home 页面转移到新接受的任务。

拖放启用

要启用自定义页面上小组件的拖放和大小调整,请将值设置为 true。 缺省值为 false

示例

“dragDropEnabled”:假

有关为“辅助信息”窗格中的选项卡启用拖放功能的更多信息,请参阅 “辅助信息”窗格

通知计时器

设置桌面上的桌面通知自动关闭的持续时间(秒)。 通知显示在桌面的右上角。 默认超时值为 8 秒。 超时值的有效范围是 1-10 秒。 要使超时更改生效,必须在进行更改后刷新浏览器。

示例

“通知计时器”:8

最大通知计数

设置一次在桌面上显示的桌面通知数量。 默认值为 3。桌面通知的范围是 1 到 10。 桌面通知堆叠在一起。 如果通知很多,它们会稍有延迟,具体取决于 notificationTimer 设置。

示例

“maxumNotificationCount”:3

浏览器通知计时器

设置桌面上的浏览器烤面包机通知自动关闭的持续时间(秒)。 Toaster 是一种本机浏览器通知,仅当桌面不是活动浏览器窗口或 Tab 时才会出现。 桌面浏览器窗口或 Tab 在以下情况下处于非活动状态

  • 您正在使用其他浏览器窗口或选项卡。

  • 您正在处理其他应用程序。

  • 您已最小化桌面浏览器窗口。

通知显示在桌面的右上角。 默认超时值为 8 秒。 超时值的建议范围是 5-15 秒。 要使超时更改生效,必须在进行更改后刷新浏览器。

示例

“browserNotificationTimer”:8

配置的浏览器通知超时时间取决于作系统和浏览器设置。 在 Windows OS、Chrome OS 和 macOS 版 Chrome 浏览器中,都会遵循超时值。 不过,其他支持的浏览器未必总是遵循配置的通知超时值。

wxm 已配置

(可选)要配置 Webex Experience Management,请将值设置为 true。 缺省值为 false

示例

“wxm 已配置”:true

桌面聊天应用程序

配置多个 Cisco 提供的聊天应用程序,例如 Webex 应用程序。

webex 已配置

Webex 应用程序及其消息传递和会议功能可以在桌面中配置。 此配置允许代理与其组织中的其他代理、主管和主题专家(SME)协作,而无需离开桌面。

  • 站点管理员管理 Webex 会议用户,并且只有在用户拥有 Webex 企业版时才分配权限。 有关详细信息,请参阅 在 Cisco Webex Control Hub 中管理 Webex Meetings 用户。
  • 主管和 SME 必须在其系统(个人设备)上下载 Webex 客户端或使用 Webex Web 版应用程序( https://web.webex.com/)访问 Webex 应用程序。 有关详细信息,请参阅 下载应用程序
  • 您可以在 Agent Desktop 中访问 Webex 应用程序,与组织中的其他代理、主管和主题专家(SME)协作,而无需离开 Agent Desktop。 呼叫控制功能未有空。 要接听和拨打电话,您需要外部的非嵌入式 Webex 应用程序。 有关详细信息,请参阅呼叫应用

要在桌面中配置 Webex 应用程序:

  • 在 Cisco Webex Control Hub 中,为用户添加服务时,选中 “高级消息传递 ”复选框(用户 > 管理用户 > 服务 > 消息传递)。 有关更多信息,请参阅 在 Cisco Webex 站点管理中管理用户帐户。

  • 在自定义桌面布局中,将 webexConfigured 属性 值设置为 true

    示例

    “desktopChatApp”:{“webexConfigured”:true },

    webexConfigured 属性 的缺省值为 false

    Webex 仅当您为代理、主管和主管代理角色设置 WebexConfigured 属性值 为 true ,才会为这些角色有空应用程序。 代理、主管或主管代理无法注销 Webex 应用程序。

    要显示 Webex 图标Webex)图标,在 headerActions 属性中 输入值 Webex 。 有关更多信息,请参阅 标头作

    要为特定团队启用 Webex 应用程序,请选择 webexConfigured 属性 值设置为 true 的自定义布局。 有关详细信息,请参阅 创建团队

您还可以在辅助信息窗格、自定义页面和自定义小组件中配置 Webex 应用程序。 有关详细信息,请参阅 辅助信息窗格

Webex 应用通知

使用通知计时器的通知 计时器和 浏览器通知计时器 属性指定的 值适用于 Webex 应用程序。 这些属性的默认超时值为 8 秒。 有关更多信息,请参阅 notificationTimerbrowserNotificationTimer

标头作

更改桌面水平标题上的图标顺序。 默认顺序如下:

  1. Webex 图标 (Webex)

  2. 使用电话音频指示器 (外拨呼叫)

  3. 通知图标。 (通知中心)

按如下所示设置 headerActions 属性的值

图标名称

headerActions 属性值

Webex 应用

webex

外拨呼叫

外拨

通知中心

通知

示例

“headerActions”:[“Webex”,“outdial”,“notification”],

属性 值区分 大小写。

要更改图标的默认顺序,请在自定义布局中输入 headerActions 属性和相应的值。

示例:

“headerActions”:[“notification”,“outdial”,“Webex”],
  • 如果未在自定义布局中输入 headerActions 属性和值,图标将按缺省顺序显示。
  • 要从桌面删除标题图标和相关功能,请为 headerActions 属性(“headerActions”:[]设置一个空值。 但是,如果您已将 Webex 应用程序添加到“辅助信息”窗格或自定义页面,或作为自定义 Widget 添加,即使桌面的水平标题中未有空 Webex 应用程序,代理仍可以访问 Webex 应用程序。
  • 如果 webexConfigured 属性值设置为 false则 Webex 应用程序 图标不会显示在桌面 的水平标题上,即使 Webex 值已添加到 headerActions 属性中 也是如此。 有关更多信息,请参阅 webex 已配置

面积

区域 属性是桌面布局的核心部分。 您可以根据区域定义布局。

“区域”:{“标题”:{ ... },“advancedHeader:{ {”comp“:”widget-1“,”attributes“:{ ... },“脚本”:.... } },“面板”:{ ... },“导航”:{ ... },“持久”:{ ... },“无头”:{ ... } },

您可以配置以下 区域 对象:

  • 面板:代表“辅助信息”窗格中的第二个面板或最右侧的面板。

  • 导航:表示自定义页面及其与页面相关的导航元素。

  • 持久:表示持久且显示在桌面的所有页面上的页面级小组件。

  • 无头:表示没有可视界面但在后台执行逻辑的小组件。

如果配置了 advancedHeader 属性,则必须删除标头和标头作属性。

高级标题

自定义桌面水平标题上的可见性并更改图标的顺序。 默认顺序如下:

  1. Webex 图标 (Webex)

  2. 使用电话音频指示器 (外拨呼叫)

  3. 通知图标。 (通知中心)

  4. Webex Contact Center 代理状态选择器。 (代理状态选择器)

按如下所示设置 advancedHeader 属性的值

图标名称

headerActions 属性值

Webex 应用

agentx-webex

外拨呼叫

Agentx 外拨

通知中心

代理 X 通知

代理状态选择器

agentx-state-selector

示例

“advancedHeader”:[ {“comp”:“agentx-webex”},{“comp”:“agentx-outdial”},{“comp”:“agentx-notification”},{“comp”:“agentx-state-selector”} {“comp”:“widget-1”,“attributes”:{ ... },“脚本”:.... } ]

属性 值区分 大小写。

要更改图标的默认顺序,请在自定义布局中输入 advancedHeader 属性和相应的值。

小组件从左到右流入下拉菜单。

  • 如果未在自定义布局中输入 advancedHeader 属性,则会显示缺省标题。

  • 启用高级标题后,应按照示例将小部件从现有标题移动到高级标题。

  • 启用高级标头后,将不会显示旧标头。

  • 每个小部件图标都有一个默认的填充和边距,该填充和边距是通过 CSS 定义的,无法通过桌面进行自定义。

  • 徽标、标题和档案图标的位置是固定的,无法自定义。

  • 要从桌面删除标题图标和相关功能,请在 advancedHeader 属性( “advancedHeader”:[])中为关联的组件设置一个空值。

    如果您已将 Webex 应用程序添加到“辅助信息”窗格或自定义页面,或作为自定义 Widget,即使桌面的水平标题中未有空 Webex 应用程序,代理仍可以访问 Webex 应用程序。

  • 如果添加带有长标签的 Widget,则根据有空空格显示截断的标签名称。

    您可以使用属性 textContent 向微件添加标签。

    示例

    {“comp”:“timer-widget”,“attributes”:{“duration”:“08:00:00”},“textContent”:“Current Shift 的倒计时计时器”,“script”:“https://wxcc-demo.s3.amazonaws.com/widgets/timer-widget.js”}

    标签“当前班次倒数计时器”将根据空格有空进行截断和显示。

    • 避免添加带有长标签的小部件。

    • 当小组件流向下拉列表时,只有小组件图标是可点击的。

  • 如果 webexConfigured 属性值设置为 false则 Webex 应用程序 图标不会显示在桌面 的水平标题上,即使 advancedHeader 属性中添加 了 Webex 值也是如此。 有关更多信息,请参阅 webex 已配置

Home 页面

当您登录到桌面时,您将登录到 Home 页面。

Home 页面仅适用于主管和主管代理角色。

您可以在 Home 页面上查看以下 Widget。 缺省情况下会提供分析器小组件,但管理员也可以配置持久小组件和自定义小组件。 有关更多信息,请参阅 JSON 布局顶级属性

分析器小组件

缺省情况下,分析器小组件显示在桌面 Home 页面上。

Home 页面布局配置

您可以将桌面的 Home 页面配置为显示基于组织首选项和品牌一致性的布局。 编辑主页 字段以配置 Home 页面。 您可以将以下组件配置为在用户登录桌面时显示在 Home 页面中:

  • 欢迎消息

  • 导航栏上的“ 任务 ”图标,用于导航至“任务”窗格。 在启用呼叫监控功能的情况下,将显示主管和主管和代理角色的任务图标。 任务窗格显示传入的客户请求、活动和过去的客户交互以及活动的监视请求。

  • 筛选“队列名称”、“ 频道类型 ”和“托管团队” 等部分

下表描述了 配置 Home 页面所需的页面 属性:

表 2. 动态 Home 页面布局 - 页面属性

财产

描述和代码

页面>使用 FlexLayout

Flex 布局是一个新的 Web 组件。 它不会更改现有的小部件。 新的 flex 布局以简化的方式使用相同的布局配置格式。 它向后兼容,不会影响现有的小部件。 您需要配置 JSON 布局。 要配置 JSON 布局,请提供微件的高度和宽度。 小组件的呈现顺序与其在 JSON 布局中配置的顺序相同。 小部件的默认边距为 8 px。

JSON 布局基于微件的尺寸(宽 x 高)和坐标(X、Y 和 Z)。

灵活的布局支持单个小组件大小调整大小、最大化小组件等功能。

各个微件的高度以像素为单位。 1 个高度单位 = 40 像素。 构件的宽度取决于容器中的列数以及根据容器宽度而变化的列数。

Widget 从左到右显示。 高级布局引擎使用自定义逻辑来应用微件的水平和垂直空间调整。 最初,布局水平加载。 水平加载后,小部件垂直加载并确保空间利用率最佳。

根据屏幕尺寸配置微件。 您可以根据屏幕大小增加或减少 Widget 的宽度。 这使小部件更具可读性和可用性。

Flex 布局提供标准断点,例如大、中、小和超小。

  • 大型微件的分辨率为 1360 像素或更高。 对于大型小组件,将列值指定为 12。

  • 中型微件的分辨率为 1070 像素到 1360 像素。 对于中型小组件,将列值指定为 10。

  • 小部件的分辨率为 850 像素到 1070 像素。 对于小型小组件,将列值指定为 6。

  • 超小部件的分辨率为 500 像素。 对于非常小的小组件,请将列值指定为 4。

这些像素可能因作系统和浏览器而异。

“页面”:{“id”:“landing”,“useFlexLayout”:true,“widgets”:{“comp1”:{“comp”:“div”,“width”:4,“height”:4,“textContent”:“Widget 1”,“attributes”:{“style”:“width:max-content;边距:80px 240px;颜色:白色;“}},“comp2”:{“comp”:“div”,“width”:4,“height”:4,“textContent”:“Widget 2”,“attributes”:{“style”:“width:max-content;边距:80px 240px;颜色:白色;“}} } 

页面>比较

确保提供唯一的自定义组件。

“comp”:“页面标题”,

页面标题 组件表示自定义 HTML 元素的二级标题 <h2>

页>页眉

确保指定可以是静态、动态或两者的标题字符串。

页面标题 组件表示自定义 HTML 元素中的第 2 级标题 <h2>

  • 静态字符串:例如,嘿,欢迎!

    “comp”:“page-title”,“attributes”:{“pageTitle”:“Hey,Welcome!” }
  • 动态字符串:从 存储中获取值。 例如,简·

    “comp”:“page-title”,“attributes”:{“pageTitle”:“$STORE.agent.agentName”}

  • 两者:静态和动态字符串的组合。 例如,嘿,Jane Doe,欢迎!

    “comp”:“page-title”,“attributes”:{“pageTitle”:“Hey {$STORE.agent.agentName},欢迎!” }

    必须将字符串的动态部分括在闭大括号 {} 内,并使用结构 $ 作为前缀。

页面 > 页面副标题

确保添加显示在桌面上的子标题。 用户可以 在子标题中添加“转到分析器 ”。

  • 子标题的代码块

    “useFlexLayout”:true,“pageSubHeader”:{“comp”:“div”,“attributes”:{“style”:“display:flex;浮点:右;margin:16px 0px 16px 16px“},”children“:[ {”comp“:”div“,”children“:[ {”comp“:”md-label“,”textContent“:”$I 18N.pageSubHeader.queueName“,”attributes“:{”style“:”margin-bottom:8px;“}
  • 子标题中的“转到分析器”的代码块

    {“comp”:“div”,“children”:[ {“comp”:“agentx-more-actions-wrapper”,“properties”:{“actionList”:[ {“comp”:“agentx-wc-goto-analyzer”} ] } }

导航(自定义页面)

在此部分中,您可以添加显示在左侧导航栏上的页面。 您可以指定要在导航栏上显示的小组件的导航图标和唯一 URL。 我们建议为 URL 使用特定的前缀以避免冲突。 有关更多详细信息,请参阅 nav 属性 部分。

您还可以拥有可在此页面上显示的 Widget 集合。 页面可以具有显示在屏幕上的单个小组件,也可以是网格中的小组件集合。 有关网格排列的更多详细信息,请参阅 布局属性 部分。

您不需要向小部件树添加动态区域包装器。 这意味着当您启用此选项时,您可以在自定义页面上拖放小部件并调整其大小。

示例:

{“nav”:{“label”:“Custom Page”,“icon”:“stored-info”,“iconType”:“momentum”,“navigateTo”:“dynamic-tabs”,“align”:“top”,“isDefaultLandingPage”:true },“page”:{“id”:“my - custom - page”,“useFlexLayout”:true,“widgets”:{“comp1”:{“comp”:“md-tabs”,“children”:[{“comp”:“md-tab”,“textContent”:“Shift Timer”,“attributes”:{“slot”:“Tab”} },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”},“children”:[{“comp”:“my - custom - timer”,“source”:http:my-cdn.com/my-custom-timer.js“wrapper”:{“title”:“Shift Timer”,“maximizeAreaName”:“app-maximize-area”} }] },{“comp”:“md-tab”,“textContent”:“Stock Market”,“响应式”:“false”“attributes”:{“slot”:“Tab”},},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”},“children”:[{“comp”:“agentx-wc-iframe”,“response”:“false”“attributes”:{“src”:“https://widget-kad.s3.amazonaws.com/Trading.htm”},“wrapper”:{“title”:“Stock Market”,“maximizeAreaName”:“app-maximize-area”} }],},{“comp”:“md-tab”,“textContent”:“Widget3”,“attributes”:{“slot”:“Tab”} },{“comp”:“md-tab-panel”,“textContent”:“Three Content”,“attributes”:{“slot”:“panel”} } ] },“comp2”:{“comp”:“my - google - maps - component”,“source”:“https://my-cdn.com/my-google.maps.js”wrapper“:{”title“:”Google Map“,”maximizeAreaName“:”app-maximize-area“} },”layout“:{”areas“:[ [”left“,”right“] ],”size“:{”cols“:[1,1],”rows“:[1] } } },

下表描述了 导航页面 属性及其子属性:

表 3. 导航属性详细信息

财产

描述和代码

导航 > 标签

此属性指示页面导航标识符。 屏幕阅读器会读取此属性,它将显示在工具提示中。

这些参数是在导航栏上显示自定义页面所必需的。

类型导航。项目 = { 标签:字符串;图标类型:“动量”|“其他”;图标:字符串;对齐:“顶部”|“底部”;导航至:字符串;图标大小? :数;是响应式的? :布尔;};

label 属性是自定义页面的标题。

导航 > 图标类型

此属性表示在自定义页面的导航栏中显示的图标的类型。

有空以下类型的图标:

  • 动量:您可以选择集合中的任何有空图标: https://momentum.design/icons。 使用 Momentum 的优点是它提供了一些带有“活动”版本的图标。

    活动版本的用例:

    例如,如果您选择“动量”图标类型 公告,您可以在导航栏上看到缺省图标。 当您导航到自定义页面(链接到图标)时,图标将变为 公告 - 活动 自动版本。 确保验证它是否具有 积极 图标库中同一图标的版本。

  • 其他:可以提供显示在导航栏上的自定义图像 URL(托管在 CDN 上)。 如果您使用黑色或白色自定义图标,当您在浅色和深色模式之间切换时,该图标将不可见。

导航 > 图标

此属性表示动量库或 CDN URL 中的图标名称。

类型导航。项目 ={ 图标:“公告”; };OR // 键入 Navigation.Item ={ icon:“https://my-cdn.com /my-navigation-icon.png”; };

导航 > 对齐

此属性可帮助您将图标与导航栏的顶部或底部对齐。

目前,该属性仅允许顶部对齐。

nav > isDefaultLandingPage

此属性指定 Agent Desktop 中代理的默认目标页面。 将此属性设置为 true 可使导航栏页面成为代理在登录到 Agent Desktop 后向代理显示的缺省登录页面。 如果多个导航栏页面将此属性设置为 true,则系统会将第一个导航栏页面视为默认的 Landing 页面。

如果没有导航栏页面将此属性设置为 true,则 Home 页面将充当默认的 Landing 页面。

您不能将“代理绩效统计信息”报告设置为默认登录页面。

nav > navigateTo

此属性指定自定义页面的名称。 代理导航时,此名称将显示在地址栏中。

navigateTo 不能包含以下值:图像、字体、css、build_info、帮助、应用程序、i18n、图标、图像 -mfe-wc 和声音。

类型导航.项目 = { navigateTo:“我的 - 自定义 - 页面”; };
表 4. 页面属性详细信息

财产

描述和代码

页面 > 标识

属性,指定自定义页面(动态小部件)对象。

id 属性表示唯一的页面标识符。 例如,my-custom-page-1。 代理在桌面上看不到此标识符。

type DynamicWidgets.Page = { id:string; widgets:Record < string,DynamicWidget.Options > ; layout:Layout; };

页面 > useFlexLayout

Flex 布局是一个新的 Web 组件。 它不会更改现有的小部件。 新的 flex 布局以简化的方式使用相同的布局配置格式。 它向后兼容,不会影响现有的小部件。 您需要配置 JSON 布局。 要配置 JSON 布局,请提供微件的高度和宽度。 小组件的呈现顺序与其在 JSON 布局中配置的顺序相同。 小部件的默认边距为 8 px。

JSON 布局基于微件的尺寸(宽 x 高)和坐标(X、Y 和 Z)。

灵活的布局支持单个小组件大小调整大小、最大化小组件等功能。

各个微件的高度以像素为单位。 1 个高度单位 = 40 像素。 构件的宽度取决于容器中的列数以及根据容器宽度而变化的列数。

Widget 从左到右显示。 高级布局引擎使用自定义逻辑来应用微件的水平和垂直空间调整。 最初,布局水平加载。 水平加载后,小部件垂直加载并确保空间利用率最佳。

根据屏幕尺寸配置微件。 您可以根据屏幕大小增加或减少 Widget 的宽度。 这使小部件更具可读性和可用性。

Flex 布局提供标准断点,例如大、中、小和超小。

  • 大型微件的分辨率为 1360 像素或更高。 对于大型小组件,将列值指定为 12。

  • 中型微件的分辨率为 1070 像素到 1360 像素。 对于中型小组件,将列值指定为 10。

  • 小部件的分辨率为 850 像素到 1070 像素。 对于小型小组件,将列值指定为 6。

  • 超小部件的分辨率为 500 像素。 对于非常小的小组件,请将列值指定为 4。

这些像素可能因作系统和浏览器而异。

“页面”:{“id”:“landing”,“useFlexLayout”:true,“widgets”:{“comp1”:{“comp”:“div”,“width”:4,“height”:4,“textContent”:“Widget 1”,“attributes”:{“style”:“width:max-content;边距:80px 240px;颜色:白色;“}},“comp2”:{“comp”:“div”,“width”:4,“height”:4,“textContent”:“Widget 2”,“attributes”:{“style”:“width:max-content;边距:80px 240px;颜色:白色;“}} } 

页面 > widget

页面 > 比较

帮助您定义自定义小组件。 要放置多个 Widget,请按顺序指定 Widget 选项。 确保为每个 Widget 指定唯一的区域名称。稍后在布局部分中使用它。

“widgets”:{“comp1”:{ ... }“comp2”:{ ... } }

此属性表示自定义 HTML 元素(如果要将其用作包装器,则称为 Web 组件或任何其他元素)的名称。 有关更多信息,请参阅 示例用例示例。 在此处输入不带尖括号的自定义元素名称(“<”或“>”)。 例如,“my-custom-element”。

Widgets 部分下的每个条目都支持以下格式:

类型选项 = { comp:字符串;脚本? :字符串;性能? :记录<字符串,任意>;属性? :记录<字符串,字符串>;孩子? :选项[];文本内容? :字符串;风格? :部分<CSSStyle 宣言>;包装纸? :{ title:string; maximizeAreaName:string; };};

页面 > 脚本

(可选)仅当从远程位置(如 CDN)加载小组件或组件时,才需要此属性。

“comp1”:{“comp”:“widget-one”,“script”:“http:/my-cdn.com / dynamic - widgets / widget - one.js”,}

不要更改同一组件的脚本 URL。 如果需要更改同一组件的脚本 URL,请执行以下作之一:

  • 通知代理清除浏览器缓存并重新加载 Agent Desktop。

  • 保留现有 URL。 使用托管在现有 URL 中的 javascript 动态导入新的捆绑 URL。

    示例:

    (function(){ var script = document.createElement(“script”); script.src = <Your JS Script URL> script.type =“text/javascript”; script.async = true; document.getElementsByTagName(“head”).item(0).appendchild(script); })()

页面 > 属性

您可以指定必须为 Web 组件传递的属性。

“properties”:{“user”:“admin”,},

页面 响应>

确定在页面 级别或 复合 级别添加到 自定义布局中的 Web 组件或基于 iFrame 的小部件是否响应。 响应式 Web 组件使您的网页在所有设备上都具有视觉吸引力,并且易于使用。 您必须使用响应式 iFrame Widget。

使用以下值之一配置此属性:

  • True:启用小组件的响应。 默认情况下,所有微件都会根据所用设备的渐进式屏幕大小、方向和查看区域进行响应。

  • False:禁用小组件的响应。 如果 Widget 不支持在其他设备上查看,请将其标记为无响应。

{“comp”:“md-tab”,“responsive”:true,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“SCREEN_POP_TAB”} }],“visibility”:“SCREEN_POP”},{“comp”:“md-tab-panel”,“responsive”:false,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CALL_GUIDE”} }],“visibility”:“CALL_GUIDE”},

无响应的 Widget 无法确保最佳用户体验,并且不会显示在较小的视图中。 代理必须增加浏览器窗口的大小,才能查看任何配置为无响应的小组件。

页面 > 属性

您可以在此部分中指定 Web 组件属性。

“属性”:{“禁用”:“假”,},

页面 > 可见性

指定在自定义布局 中添加的页面 级别或 补偿 级别的 Cisco 提供的 Widget 是否可见。

Cisco 提供的小组件包括“联系人历史记录”、“Cisco Webex Experience Management, IVR 副本”、“预览活动呼叫指南”和“屏幕弹出”。

  • 可见性 属性值内置在桌面布局的默认 JSON 文件中并定义。 管理员无法修改 Cisco 提供的 Widget 的可见性 属性值。

  • 可见性 属性值 NOT_RESPONSIVE 已弃用。 您只能继续使用它以实现向后兼容性。 以前设置为 NOT_RESPONSIVE 的任何值都不需要修改,因为功能保持不变。

    若要将新创建的小组件设置为响应或无响应,必须使用 responsive 属性。 有关详细信息,请参阅 响应属性

页面 > 儿童

此属性是布局的核心部分。 在 孩子 部分,如果基于 Web 组件的小部件允许您传递子项,则可以根据需要嵌套任意数量的级别。 为此,开发人员必须以编程方式处理 开槽 内容。 更多信息,请参见 Cisco Webex Contact Center 桌面版开发者指南

要了解如何将数据作为属性传递,请参阅 将数据从桌面共享到小组件

“children”:[{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“children”:[{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“textContent”:“Test”},{“comp”:“div”,“textContent”:“Test”} ] } ],

“子”数组部分的优点是您可以在布局规范中使用现有的 Web 组件,这已经是桌面捆绑包的一部分。 一些桌面捆绑包 Web 组件包括:

  • agentx-wc-iframe:一个小部件,允许您将任何网页作为小部件放入 iFrame 中。

  • dynamic-area:允许您在自定义页面以外的位置为代理启用拖放功能的组件。 如果您缺省启用拖放,则自定义页面也可以具有此功能。

  • 动量 -ui-web- 组件库中的任何组件。 有关更多信息,请参阅 GitHub。 例如:

    • md-tabs:选项卡容器包装器

    • md-tab:单个 Tab 标头

    • md-tab-panel:单个 Tab 内容

有关持久 Tab 的属性的更多信息,请参阅 持久选项卡的属性。

页面 > 文本内容

帮助您添加文本内容。

“文本内容”:“我的文本内容”,

页面 > 样式

帮助您为组件分配特定的 CSS 样式。

“style”:{“backgroundColor”:“#CBD”,“overflow”:“scroll”},

页面 > 封装包

Widget 包装器允许您在 Widget 顶部添加工具栏。 工具栏可以包含标题和 最大化图标最大化)图标。 当 Widget 在页面上占用了很小的空间时,最大化图标允许代理在完整的工作区中查看 Widget。

确保将默认值用作“应用最大化区域”。 目前只有默认值为有空。

“wrapper”:{“title”:My Widget Title“,”maximizeAreaName“:”app-maximize-area“}

页面 > 包装器>标识

(可选)Web 组件 widget 封装器允许您使用唯一标识符更新动态 widget 标题。 输入小组件包装器 id 属性值作为 更新标题的唯一标识。

“wrapper”:{“title”:My Widget Title“,”id“:”unique-id-to-update-title“,”maximizeAreaName“:”app-maximize-area“} 

确保对 JavaScript CustomEvent 使用相同的唯一标识符。 有关详细信息,请参阅 Cisco Webex Contact Center 桌面开发人员 的“代理联系人模块” 一章 中的 异步事件部分。

要更新基于 iFrame 的 Widget 标题,请使用来自同一域的 iFrame 内容。 下面是一个示例示例:

< 脚本类型 =“文本/javascript”> var title =“”;window.addEventListener(“update-title-event”,function(e){ title = e.detail.title; });document.querySelector('#customEvent').onclick = function(){ const e = new CustomEvent(“update-title-event”,{ bubbles:true,detail:{ title:“new title”} }); window.parent.dispatchEvent(e); };< /script> < button id =“customEvent”> New Title < /button> < iframe src =“https://blog.logrocket.com/the-ultimate-guide-to-iframes/”> < /iframe>

page > agentx-wc-iframe

允许您在 iFrame 中嵌入在桌面上显示为小组件的网页。 您可以使用名为“agentx-wc-iframe”的 iFrame widget。

“comp1”:{“comp”:“agentx-wc-iframe”,“attributes”:{“src”:“https://blog.logrocket.com / the - ultimate - guide - to - iframes /”},“wrapper”:{“title”:“AgentX iFrame”,“maximizeAreaName”:“app-maximize-area”},

页面 > 布局

允许您在页面上排列小组件。

以下格式表示网格布局:

类型布局 = { 区域:字符串[][]; 大小:{ 行:数字[]; 列:数字[]; }; };

您可以在此处使用您在微件 部分中定义的 区域名称定义网格。

下面的示例演示如何指定三行三列的布局:

“布局”:{“areas”:[ [“comp1”,“comp1”,“comp3”],[“comp2”,“comp2”,“comp3”],[“comp4”,“comp4”,“comp4”] ],“size”:{“cols”:[1,1,1],“rows”:[1,1,1] } }
3x3 布局的均等分布
Equal distribution of a 3x3 layout for Webex contact Center Desktop layout configuration.

在大小部分中,数字表示 Widget 相对于其他 Widget 可以占用的空间比例。 所有三列占用的空间等于 1 的分数。 以 100%作为有空宽度,每个小部件占据 33.33%的水平空间。

列宽相等
Equal column width layout for Webex Contact Center Desktop layout configuration.

另一个用例示例,如果您设置为“cols”:[1,2,2],则表示总空间除以 5(1+2+2),第一个小部件占据水平空间的 20%。 第二个和第三个小部件各占 40%。 有关详细信息,请参阅 网格布局的基本概念。

Unequal column width layout for Webex Contact Center Desktop layout configuration.
更改列宽之后

>

布局嵌套称为子布局。 如果布局配置中有嵌套布局,则必须将单个“ROOT”对象作为子布局的父对象。 否则,如果不需要嵌套,则布局配置可以是扁平的。

此子布局提供了对布局大小调整行为的更多控制。 页面 布局 属性的类型必须是记录<字符串、布局>。 布局属性允许您在页面上排列小组件。

{“id”:“some-id”,“widgets”:{“c1”:{“comp”:“div”,“textContent”:“c1”},“c2”:{“comp”:“div”,“textContent”:“c2”},“c3”:{“comp”:“div”,“textContent”:“c3”},“c4”:{“comp”:“div”,“textContent”:“c4”},“c5”:{“comp”:“div”,“textContent”:“c5”} },“布局”:{“ROOT”:{“areas”:[ [“c1”,“sub1”],[“c2”,“sub2”],],“size”:{“cols”:[1,1],“rows”:[1,1] } },“sub1”:{“areas”:[ [“c3”,“c4”],“size”:{“cols”:[1,1],“rows”:[1] } },“sub2”:{“areas”:[ [“c1”],[“c5”]],“size”:{“cols”:[1],“rows”:[1,1] } } } }

此设置会在 ROOT 布局中创建一个网格,其中包含两个可以独立调整大小的子网格。

Sub-layout appearance for Webex Contact Center Desktop layout configuration.
子布局外观

调整组件大小会影响该子布局中的组件。

Sub-layout appearance, after resizing both sub-layouts, for Webex Contact Center Desktop layout configuration.
调整两个子布局的大小后

请注意以下情况:

无限循环:如果将 ROOT 布局包含为 ROOT 的子布局,则会导致“超出调用堆栈”错误并运行无限循环。

{“布局”:{“根”:{“areas”:[ [“c1”,“c2”],[“c3”,“ROOT”],],“size”:{“cols”:[1,1],“rows”:[1,1] } } }
Sub-layout appearance with infinite loop for Webex Contact Center Desktop layout configuration.
具有无限循环的子布局

相同的子布局(N)次:如果您多次使用相同的名称将子布局包含在网格中,并且如果您调整其中一个子布局的大小,则所有子布局都会自动调整大小。

如果这不是所需的行为,请使用唯一的名称重命名每个子布局。

{“布局”:{“根”:{“areas”:[ [“c1”,“sub1”],[“c2”,“sub1”],],“size”:{“cols”:[1,1],“rows”:[1,1] } },“sub1”:{“areas”:[ [“c3”,“c4”] ],“size”:{“cols”:[1,1],“rows”:[1] } } } }
Sub-layout appearance with N times for Webex Contact Center Desktop layout configuration.
具有 N 次的子布局

永久选项卡的属性

要将自定义页面和自定义小部件中的标签页设置为永久性标签页,请在自定义布局中输入 md 标签 页的属性

示例:将制表符设置为永久性

{“comp”:“md-tabs”,“attributes”:{“persist-selection”:true,“tabs-id”:“容器中所有选项卡的唯一 id”},}

财产

说明

保留选择

将 md 选项卡 设置为 持久。 缺省值为 true

标签页标识

容器中所有选项卡的唯一标识。

当您将 md-tabs 设置为 持久(persist-selection:true)时,Agent Desktop 会保留 Tab 选择,即使代理在桌面的页面或 widget 之间切换也是如此。

  • 持久选择 属性不适用于“辅助信息”窗格和“代理性能统计”报告页面中的选项卡,因为已在桌面中设置了持久 Tab 行为。
  • 当您从桌面注销、重新加载/刷新浏览器或清除浏览器缓存时,Tab 选择将重置为缺省 Tab。

持久小组件配置

您可以将任何自定义小组件配置为持久性。 永久性 Widget 显示在桌面的所有页面上。 仅当您有活动的联系人请求或对话时,永久性小组件才会在“辅助信息”窗格中显示为新的 Tab。 例如, 示例持久 小部件。

持久性小部件在 Home 页面上的显示方式与其他页面上的显示方式不同。 但是,如果您有活动的交互,则永久性小组件将作为“辅助信息”窗格的一部分显示在 Home 页面中。 例如,当您应答呼叫时,将显示“交互控制”窗格, 而“示例持久 小组件”将显示为“辅助信息”窗格的一部分。

示例:

“area”:{“persistent”:[{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”},“children”:[{“comp”:“md-icon”,“attributes”:{“name”:“emoticons_16”} },{“comp”:“span”,“textContent”:“Custom Page Widget”} ] },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”},“children”:[{“comp”:“dynamic-area”,“properties”:{“area”:{“id”:“dw-panel-two”,“widgets”:{“comp1”:{“comp”:“agentx-wc-iframe”,“attributes”:{“src”:“https://blog.logrocket.com/the-ultimate-guide-to-iframes/”},“wrapper”:{“title”:“AgentX iFrame”,“maximizeAreaName”:“app-maximize-area”} },“comp2”:{“comp”:“uuip-widget-two”,“script”:“./dynamic-widgets/widget-two.js”,“attributes”:{“title”:“WIDGET 2 content”},“wrapper”:{“title”:“Widget 2 title”,“maximizeAreaName”:“app-maximize-area”} },“layout”:{“areas”:[ [“comp1”,“comp2”] ],“size”:{“cols”:[1,1],“rows”:[1] } } } } }] } ] }

自定义 Widget 时,您可以选择以下任一选项:

  • 在可嵌入 iframe 中的网页上托管应用程序。

  • 构建自定义小组件。

技术小部件要求在桌面小部件开发文档中 描述。 作为布局编辑器,请确保您具有以下详细信息:

  • 自定义 HTML 元素(称为 Web 组件)的名称是什么?

  • 托管 JavaScript 捆绑包的内容分发网络(CDN)源的 URL 是什么?

页眉 Widget

标题用于显示内联信息、添加下拉菜单等。 由于标题容器的垂直空间有限,因此整体标题高度仅为 64 像素。 有关布局对齐的详细信息,请参阅 布局属性 部分。

示例:

“header”:{“id”:“header”,“widgets”:{“head1”:{“comp”:“header-widget-one”,“script”:“https://my-cdn.com/dynamic-widgets/header-widget-one.js”,},“head2”:{“comp”:“header-widget-two”,“script”:“https://my-cdn.com/dynamic-widgets/header-widget-two.js”,} },“layout”:{“areas”:[[“head1”,“head2”]],“size”:{“cols”:[1,1],“rows”:[1] } } }

要为标题小部件添加工具提示,请使用 md 工具提示包装 组件。 在消息 属性中 输入工具提示信息。

示例:

“header”:{“id”:“dw-header”,“widgets”:{“head1”:{“comp”:“md-tooltip”,“attributes”:{“message”:“Netlify”},“children”:[{“comp”:“agentx-wc-iframe”,“attributes”:{“src”:“https://keen-jackson-8d352f.netlify.app”} }] },},}

必须添加样式属性 、显示高度 ,才能通过页眉中可自定义微件区域中的 iFrame 配置任何微件。 高度 属性的最佳 拟合值为 64 像素。

确保将样式属性添加到现有页眉小组件,以便它们在 iFrame 中按预期加载。

示例:

“head1”:{“comp”:“agentx-wc-iframe”,“attributes”:{“src”:“https://widget-kad.s3.amazonaws.com/Headers/Timer/Timer.htm”,“style”:“height:64px;display:flex;“}},

我们建议您仅对标题使用包含多列的单行,因为标题高度仅为 64 像素。 有关对齐方式的详细信息,请参阅 布局属性 部分。

辅助信息窗格

桌面的“辅助信息”窗格显示包含 Cisco 提供的(缺省)小组件和自定义小组件的标签页。 以下 Cisco 提供的小组件显示在预定义的标签页中:

  • 联系人历史记录

  • IVR 脚本

  • 客户体验之旅

  • 屏幕提示

您可以使用“辅助信息”窗格执行以下作:

  • 添加标签页

  • 更改 Tab 顺序

  • 删除预定义选项卡

  • 将自定义选项卡标记为可拖动

  • 向自定义标签页添加工具提示

  • 添加“ 重置 Tab 顺序 ”选项

示例:

“panel”:{“comp”:“md-tabs”,“attributes”:{“class”:“widget-tabs”},“children”:[{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY_TAB”}] },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY”}] },{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“md-icon”,“attributes”:{“name”:“pop-out_16”} },{“comp”:“span”,“textContent”:“Screen Pop”} ],“visibility”:“SCREEN_POP”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“#SCREEN_POP”}],},{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”},“children”:[{“comp”:“md-icon”,“attributes”:{“name”:“emoticons_16”} },{“comp”:“span”,“textContent”:“Custom widget”} ] },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”},“children”:[{“comp”:“dynamic-area”,“properties”:{“area”:{“id”:“dw-panel-two”,“widgets”:{“comp1”:{“comp”:“agentx-wc-iframe”,“attributes”:{“src”:“https://blog.logrocket.com/the-ultimate-guide-to-iframes/”},“wrapper”:{“title”:“AgentX iFrame”,“maximizeAreaName”:“app-maximize-area”} },“comp2”:{“comp”:“widget-one”,“script”:“https://my-cdn.com/dynamic-widgets/widget-one.js”,“wrapper”:{“title”:“Widget title”,“maximizeAreaName”:“app-maximize-area”} },“layout”:{“areas”:[ [“comp1”],[“comp2”] ],“size”:{“cols”:[1],“rows”:[1,1] } } } } }] } ] },

在管理门户上启用客户体验管理指标后,您可以配置客户体验之旅 Widget。

在“辅助信息”窗格中,添加新标签页以放置自定义微件。 此处没有特殊规则,组件嵌套符合子部分 预期和描述。 有关详细信息,请参阅 页的 Children 属性。

以下是自定义 Tab 标头的特定示例:

在 child 属性中放置图标和标签的示例

{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“md-icon”,“attributes”:{“name”:“transcript_16”} },{“comp”:“span”,“textContent”:“My Widget Tab”} ],},

在子属性中放置图像(使用 CSS)和标签的示例

{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”},“children”:[{“comp”:“span”,“attributes”:{“style”:“align-items:center;display:flex;“},”children“:[{”comp“:”img“,”attributes“:{”src“:”http://my-cdn.com/icon.svg“,”width“:16,”height“:16,”style“:”margin-right:0.5rem;“} },{”comp“:”span“,”textContent“:”My Widget Tab“} ] }],},

当“辅助信息”窗格包含多个选项卡时,将自动显示更多选项卡 下拉列表。

您必须添加自定义 Tab 工具提示以提高可读性和可访问性。 要为自定义 Tab 添加工具提示,请使用 md 工具提示 包装组件。 在消息属性中 输入工具提示信息,并应用 样式 属性值,如以下示例 所示。

“comp”:“md-tooltip”,“attributes”:{“class”:“widget-tabs”,“message”:“Sample Tab 1”,“style”:“最大宽度:252px;最小宽度:110px;溢出:隐藏;文本溢出:省略号;空格:无换行;显示:内联块;底部边距:-10px;“},

对于自定义 Tab,我们建议最大宽度为 252 像素,最小宽度为 110 像素。

要在自定义 Tab 中启用拖放功能,请在属性 中添加以下属性:

“comp”:“md-tabs”,“attributes”:{“class”:“widget-tabs”,“draggable”:true,“comp-unique-id”:“sample-dynamic-custom-tabs”},
  • 拖动:将 拖动属性值设置为 true

  • comp-unique-id:输入唯一值以标识组件。

    示例:

    “comp-unique-id”:“sample-dynamic-custom-tabs” 

如果为自定义 Tab 启用拖放,代理可以将 Tab 拖放到“辅助信息”窗格中的所需位置。 若要将选项卡重置为默认的 Tab 顺序,请添加以下属性:

“comp”:“agentx-wc-more-actions-widget”,“attributes”:{“slot”:“settings”,“class”:“widget-pane”,“tabs-unique-id”:“sample-dynamic-custom-tabs”},
  • agentx-wc-more-actions-widget:输入显示为“ 更多作 ”(“更多作”图标)图标。

  • slot=“settings”:输入组件内在“更多作 下拉列表中显示为“重置 Tab 顺序 ”选项的属性 。 代理可以将“辅助信息”窗格中的标签页重置为缺省顺序,方法是单击 “更多作”图标 > 重置 Tab 订单

  • tabs-unique-id:输入为 comp-unique-id 属性定义的相同唯一值,以映射和重置 md-tabs 组件。

下面的示例代码使用 “更多作 ”和 “重置 Tab 顺序 ”函数。

“comp”:“agentx-wc-more-actions-widget”,“attributes”:{“slot”:“settings”,“class”:“widget-pane”,“tabs-unique-id”:“sample-dynamic-custom-tabs”},“children”:[{“comp”:“div”,“attributes”:{“textContent”:“custom action”,“slot”:“custom-action”},“children”:[{“comp”:“agentx-wc-notes-header-widget”},{“comp”:“agentx-wc-menu-notification”} ] }],}
Webex Contact Center more actions menu example, showing the 'Reset Tab Order' option.

默认情况下,将定义预定义选项卡的工具提示、省略号图标和 Tab 顺序重置。

可以 扩展更多作 下拉列表,以在重置 Tab 顺序 选项后 添加其他自定义组件或小部件。 下面是可应用于其他组件的样式 属性值示例 集。

“comp”:“md-tooltip”,“attributes”:{“class”:“widget-tabs”,“message”:“Sample Element”,“style”:“max-width:252px;最小宽度:110px;溢出:隐藏;文本溢出:省略号;空格:无换行;显示:内联块;底部边距:-10px;“},
Webex Contact Center more actions menu example, showing additional, custom options that can be added after the 'Reset Tab Order' option.

添加到“更多作 下拉列表中的其他自定义组件或小部件不支持拖放功能。

无头小部件

在无头部分中,您可以添加隐藏且不会出现在 Agent Desktop 上的小部件。 这些小组件用于在后台执行逻辑。 此部分可用于触发桌面上发生的事件并执行特定于小组件的逻辑。 例如,在 SMS 到达时打开自定义 CRM 屏幕弹出。

示例:

“headless”:{“id”:“headless”,“widgets”:{“comp1”:{“comp”:“headless-widget-one”,“script”:“https://my-cdn.com/dynamic-widgets/headless-widget-one.js”,},“comp2”:{“comp”:“headless-widget-two”,“script”:“https://my-cdn.com/dynamic-widgets/headless-widget-two.js”,} },“layout”:{“areas”:[[“comp1”,comp2“]],”size“:{”cols“:[1,1],”rows“:[1] } }

将数据从桌面共享到 Widget

要通过自定义小组件中的属性或属性接收实时数据,请在布局 JSON 配置中分配适当的 STORE 值。

此外,要通过 JavaScript SDK 订阅者访问数据,您还可以通过属性或属性传递数据。 如果组件是为响应属性或属性更改而构建的,则可以从 Agent Desktop(称为数据提供程序)获取实时数据更新。

目前,我们在密钥存储下有一个数据提供程序。 有关详细信息,请参阅 Cisco Webex Contact Center 桌面开发人员指南 中的数据 提供程序 - Widget 属性和属性部分。

预览活动电话

管理员创建市场活动,配置拨号模式(预览版),并将市场活动分配给团队。 如果代理是分配到活动的团队的一部分,则该代理可以进行出站预览市场活动调用。 有关详细信息,请参阅 在 Webex Contact Center 中配置语音出站活动模式。

管理员在自定义布局中配置以下内容,以启用代理的预览活动联系人。

活动联系人

管理员将“市场活动联系人”Widget 添加到自定义布局的页眉容器中。 市场活动联系人基于定义的属性显示客户的联系信息。 有关布局对齐的详细信息,请参阅 页面属性详细信息 表的 布局属性 行。

示例:

 “advancedHeader”:[ {“comp”:“agentx-preview-campaign”,“properties”:{“isCampaignManagementEnabled”:“$STORE.agent.isCampaignManagementEnabled”,“agentDbId”:“$STORE.agent.acqueonAgentId”,“lcmUrl”:“$STORE.agent.lcmUrl”,“isCallInProgress”:“$STORE.agentContact.isActiveCall”,“outdialEntryPointId”:“$STORE.agent.outDialEp”,“teamId”:“$STORE.agent.getAcqueonTeamId”,“campaignManagerAdditionalInfo”:“$STORE.agent.campaignManagerAdditionalInfo”,“orgId”:“$STORE.agent.orgId“,”dialerProxyHost“:”$STORE.envVaribles.serviceUrls.dialerProxyHost“,”isProgressiveCampaignEnabled“:”$STORE.app.featuresFlags.isProgressiveCampaignEnabled“} },{”comp“:”agentx-webex“},{”comp“:”agentx-outdial“},{”comp“:”agentx-notification“},{”comp“:”agentx-state-selector“} ] 

呼叫指南

呼叫指南 ”小组件显示在桌面上的“辅助信息”窗格中。 呼叫指南在广告系列一级显示问题和答案。 系统提示代理通读呼叫指南中的一组问题并提交答复。

示例:

“panel”:{“comp”:“md-tabs”,“attributes”:{“class”:“widget-tabs”},“children”:[ {“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[ {“comp”:“md-icon”,“attributes”:{“name”:“icon-note_16”} },{“comp”:“span”,“textContent”:“Call Guide”} ],“visibility”:“CALL_GUIDE”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[ {“comp”:“acqueon-call-guide”,“script”:“http://localhost:5555//index.js”,// 包含 CDN 此处链接“wrapper”:{“title”:“Call Guide”,“maximizeAreaName”:“app-maximize-area”},“properties”:{“lcmKey”:“$STORE.agentContact.getCallGuideProps.LCMKey”,“agentDbId”:“$STORE.agent.acqueonAgentId”,“lcmUrl”:“$STORE.agent.lcmUrl”,“campaignManagerAdditionalInfo”:“$STORE.agent.campaignManagerAdditionalInfo”“orgId”:“$STORE.agent.orgId”,“dialerProxyHost”:“$STORE.envVaribles.serviceUrls.dialerProxyHost”,“isProgressiveCampaignEnabled”:“$STORE.app.featureFlags.isProgressiveCampaignEnabled“} } ],”visibility“:”CALL_GUIDE“} ] }
  • 以下 合成 属性引用已更改。 属性值中的 agentx 将替换为 acqueon
    • agentx-preview-campaign 更名为 acqueon-preview-campaign
    • agentx-call-guide 更名为 acqueon-call-guide
  • 您必须在 CDN 上托管列表和市场活动管理器(LCM),然后在脚本 属性中 指定 URL。

屏幕提示

在桌面布局中,您可以通过以下方式之一配置屏幕弹出:

  • 作为自定义页面

  • 作为自定义页面中的小组件之一

  • 作为“辅助信息”窗格中的 Tab

屏幕弹出在桌面上显示基于以下因素:

对于语音频道:

  • 在桌面布局中定义的配置

  • 流设计器中定义的屏幕弹出活动

对于新的数字渠道:

  • 在桌面布局中定义的配置

  • 在 Connect Flow Builder 中定义的 Screen Pop 节点

有关配置屏幕弹出的详细信息,请参阅 屏幕弹出

在导航栏中配置屏幕弹出

您可以将 Screen Pop 配置为自定义页面或自定义页面中的某个小组件。 要访问“屏幕弹出”自定义页面,请单击导航栏上的“屏幕弹出 图标。 要访问自定义页面中的 Screen Pop Widget,请单击导航栏上的自定义图标。 有关 导航 属性的详细信息,请参阅 导航(自定义页面)。

示例:作为自定义页面弹出屏幕

{“nav”:{“label”:“Screen Pop”,“icon”:“pop-out”,“iconType”:“momentum”,“navigateTo”:“/screenpop”,“align”:“top”},“page”:{“id”:“agentx-wc-screen-pop”,“widgets”:{“comp1”:{“comp”:“agentx-wc-screen-pop”,“properties”:{“screenPopUrl”:“$STORE.session.screenpop.screenPopSelector”} },“layout”:{“areas”:[ [“comp1”] ],“size”:{“cols”:[1],“rows”:[1] } },“visibility”:“SCREEN_POP”}

示例:在自定义页面中作为小组件弹出屏幕

“comp1”:{“comp”:“agentx-wc-screen-pop”,“properties”:{“screenPopUrl”:“$STORE.session.screenpop.screenPopSelector”}

如果未在流设计器中配置屏幕弹出,则自定义页面将显示空白。 有关在流设计器中配置屏幕弹出的详细信息,请参阅 屏幕弹出

在辅助信息窗格中配置屏幕弹出

您可以将“屏幕弹出”配置为在“辅助信息”窗格中显示为 Tab。

默认情况下,如果将屏幕弹出配置为在流设计器中显示为 桌面内部 ,则屏幕弹出在辅助信息窗格的屏幕 弹出 Tab 中显示为新的子 Tab。

面板 部分添加以下属性,以将屏幕弹出作为 Tab 包含在“辅助信息”窗格中。 有关面板 详细信息的详细信息,请参阅 辅助信息窗格

示例:在辅助信息窗格中以 Tab 形式弹出屏幕

 {“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[ {“comp”:“md-icon”,“attributes”:{“name”:“pop-out_16”}},{“comp”:“span”,“textContent”:“Screen Pop”}],“visibility”:“SCREEN_POP”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“#SCREEN_POP”} ],}

流设计器中定义的“屏幕弹出”显示选项优先于桌面布局中定义的配置。

例如,假设您已配置以下屏幕弹出设置:

  • 流设计器 - 在新的浏览器中将设置显示为 Tab
  • 桌面布局 - 作为“辅助信息”窗格中的 Tab

当配置屏幕弹出的事件发生时,屏幕弹出将显示在桌面外部 - 即在新的浏览器 Tab 中。

示例用例示例

以下各节提供了一些示例供您参考:

从导航栏配置和访问“客户体验管理指标”小组件

示例:

{“nav”:{“label”:“Customer Experience Management Metrics”,“icon”:“/app/images/wxm.bcd45cc3.svg”,“iconType”:“other”,“navigateTo”:“wxm-metrics”,“align”:“top”},“page”:{“id”:“wxm-metrics”,“widgets”:{“comp1”:{“comp”:“agentx-wc-cloudcherry-widget”,“attributes”:{“metrics”:true },“properties”:{“userModel”:“$STORE.app.userModel”,“spaceId”:“”,“metricsId”:“”,teamId“:”$STORE.agent.teamName“,”ani“:”$STORE.agentContact.taskSelected.ani“,”isDarkMode“:”$STORE.app.darkMode“},”wrapper“:{”title“:”Customer Experience Journey“,”maximizeAreaName“:”app-maximize-area“} } },”layout“:{”areas“:[ [”comp1“] ],”size“:{”cols“:[1],”rows“:[1] } } },

要获取 spaceId 和 metricsId,请参阅 Webex Experience Management 文档。

使用自定义页面上的标签页

示例:

{“nav”:{“label”:“Dynamic Tabs”,“icon”:“stored-info”,“iconType”:“momentum”,“navigateTo”:“dynamic-tabs”,“align”:“top”},“page”:{“id”:“page-id-tabs”,“widgets”:{“comp1”:{“comp”:“md-tabs”,“children”:[{“comp”:“md-tab”,“textContent”:“One”,“attributes”:{“slot”:“Tab”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”},“children”:[{“comp”:“widget-two”,“script”:“http:/my-cdn.com/dynamic-widgets/widget-two.js”}] },{“comp”:“md-tab”,“textContent”:“Two”,“attributes”:{“slot”:“Tab”} },{“comp”:“md-tab-panel”,“textContent”:“Two Content”,“attributes”:{“slot”:“panel”} } ] },“comp2”:{“comp”:“widget-two”,“script”:“http:/my-cdn.com/dynamic-widgets/widget-two.js”} },“layout”:{“areas”:[ [“comp1”,“comp2”] ],“size”:{“cols”:[1,1],“rows”:[1] } } } }

包含联系人历史记录和弹出屏幕的缺省辅助信息窗格

示例:

“panel”:{“comp”:“md-tabs”,“attributes”:{“class”:“widget-tabs”},“children”:[{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY_TAB”}] },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY”} }] },] },{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“SCREEN_POP_TAB”} }],“visibility”:“SCREEN_POP”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“SCREEN_POP”} }],“visibility”:“SCREEN_POP”} },

带有客户体验旅程小组件的辅助信息窗格

示例:

“panel”:{“comp”:“md-tabs”,“attributes”:{“class”:“widget-tabs”},“children”:[{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“WXM_JOURNEY_TAB”}],“visibility”:“WXM_JOURNEY”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“agentx-wc-cloudcherry-widget”,“properties”:{“userModel”:“$STORE.app.userModel”,“spaceId”:“”,“metricsId”:“”,“teamId”:“$STORE.agent.teamName”,“ani”:“$STORE.agentContact.taskSelected.ani”,“isDarkMode”:“$STORE.app.darkMode”},“wrapper”:{“title”:“Customer Experience Journey”,“maximizeAreaName”:“app-maximize-area”} }],{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY_TAB”} }] },{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“CONTACT_HISTORY”} }] },{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”,“class”:“widget-pane-tab”},“children”:[{“comp”:“slot”,“attributes”:{“name”:“SCREEN_POP_TAB”} }],“visibility”:“SCREEN_POP”},{“comp”:“md-tab-panel”,“attributes”:{“slot”:“panel”,“class”:“widget-pane”},“children”:[{“comp”:“slot”,“attributes”:{“名称”:“SCREEN_POP”} }],“可见性”:“SCREEN_POP”}“可见性”:“SCREEN_POP”},},

本地化

桌面 UI 支持 29 种语言的本地化。

支持的语言如下:

保加利亚语、加泰罗尼亚语、中文(中国大陆)、中文(中国台湾)、克罗地亚语、捷克语、丹麦语、荷兰语、英语(英国)、英语(美国)、芬兰语、法语、德语、匈牙利语、意大利语、日语、韩语、挪威语、波兰语、葡萄牙语(巴西)、葡萄牙语(葡萄牙)、罗马尼亚语、俄语、塞尔维亚语、斯洛伐克语、斯洛文尼亚语、西班牙语、瑞典语和土耳其语。

桌面 UI 语言基于浏览器上的语言首选项设置。 例如,假设您在 Firefox 浏览器中选择的首选语言为法语。 在 Firefox 浏览器中启动桌面时,桌面用户界面以法语显示。 但是,桌面布局中添加的水平标题、导航栏和其他组件不会根据浏览器上的语言首选项设置进行本地化。

本地化桌面组件

要本地化桌面组件,

  • 使用 app.json 文件中设置 的现有本地化密钥。 如果未设置本地化密钥,将使用缺省语言英语(美国)。 您可以向 Cisco Support 提交服务请求,以向 app.json 文件添加本地化密钥

    示例:本地化键

    {“common”:{“buttonTitle”:“Stop Timer”} }
  • 在桌面布局 JSON 文件中输入以下区分大小写的属性以本地化组件:

    “文本内容”:“$I 18N.<key>“, 

    其中 <key> 是指 app.json 文件中对应的本地化密钥

示例:本地化标题组件

“header”:{“id”:“header”,“widgets”:{“head1”:{“comp”:“md-button”,“attributes”:{“slot”:“menu-trigger”,“style”:“height:64px”},“children”:[{“comp”:“span”,“textContent”:“$I 18N.common.buttonTitle”,} },},}

示例:本地化“辅助信息”窗格中的 Tab 组件

“panel”:{“comp”:“md-tab”,“attributes”:{“slot”:“Tab”},“children”:[{“comp”:“span”,“textContent”:“$I 18N.panelTwo.screenPopTitle”}] }