通过

管理应用程序选项卡模板

  • 项目

备注

功能可用性信息如下。

Dynamics 365 Contact Center—嵌入 Dynamics 365 Contact Center—独立 Dynamics 365 Customer Service
否​ 是 是

利用 Customer Service 中的应用程序选项卡模板，您可以指定当代理在 Customer Service workspace 中启动会话时可以打开的应用程序的类型。

左侧面板中的垂直条将显示会话列表。 此面板会始终显示无法关闭或自定义的主页会话。

在 Customer Service workspace 中，每个会话至少有一个不能关闭或自定义的应用程序选项卡，此选项卡称为“定位点选项卡”。 当您启动会话时，会根据您的配置设置打开相应的应用程序页面和任何其他附加页面。

使用应用程序选项卡模板，可以定义可用于会话的应用程序，然后将这些应用程序与会话关联。 例如，您可以创建可用对话页面选项卡并将其与聊天或短信会话相关联。 现在，当代理接受来自聊天或短信渠道的通知后，会话将开始，并打开可用对话页面。

作为管理员，您可以创建多个应用程序选项卡模板。

备注

无法自定义现成模板，但可以创建您自己的自定义模板。

先决条件

您需要系统管理员角色来执行本文提到的任务。

创建应用程序选项卡模板

  1. 选择 Customer Service 管理中心，执行相应步骤。

    1. 在站点地图中，选择代理体验中的工作区。
    2. 在工作区页面上，为应用程序选项卡模板选择管理。

  2. 在可用应用程序选项卡模板页上选择新建。

  3. 在新建应用程序选项卡模板页上指定以下各项。

    制表符 Name 步骤 示例
    一般 客户 指定应用程序选项卡的名称。代理在运行时看不到此名称。 知识文章搜索
    一般 唯一名称 以 <前缀>_<名称> 格式提供一个唯一标识符。
    重要提示
    指定唯一名称时需考虑下列因素：
    • 前缀只能是字母数字，长度必须在 3 到 8 个字符之间。
    • 必须在前缀和名称之间添加下划线。

    您可以选择灯泡图标，然后选择应用验证您输入的名称是否满足要求。    		 contoso_application_tab
    常规 职位 提供您希望代理在运行时查看的应用程序的标题。 知识文章搜索
    一般 页面类型 从列表中选择页面类型。 Web 资源
    一般 说明 提供说明以供参考。 页面类型用于显示知识库搜索页。

  4. 选择保存。 参数部分显示所选页面类型的参数。

    备注

    只要编辑应用程序选项卡模板，请保存更改，以便在参数部分中查看相应字段。

  5. 选择要编辑的参数的值字段并提供值。

  6. 选择保存。

页面类型

提供以下页面类型：

  • 仪表板​​
  • 实体列表
  • 实体记录
  • 搜索
  • 第三方网站
  • Web 资源
  • 控件（仅供内部使用）
  • 自定义

仪表板​​

此页面类型用于将仪表板显示为应用程序。 以下参数可用于仪表板页面类型。

参数 说明 必需 支持值 示例
dashboardId 仪表板的 GUID 是 String d201a642-6283-4f1d-81b7-da4b1685e698

备注

  • 如果 dashboardId 参数为以下参数，将显示默认仪表板：
    > - 空白
    > - 不正确
    > - 应用模块定义中未包括的仪表板
  • 不支持个人默认仪表板。

实体列表

此页面类型用于显示定义如何显示特定实体的记录列表的实体视图。 以下参数可用于实体视图页面类型。

参数 说明 必需 支持值 示例
entityName 实体的逻辑名称 是 字符串

数据域
 帐户

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}
viewId 视图的 GUID 否 字符串 00000000-0000-0000-00aa-000010001031

备注

如果目标视图不存在或未包含在应用模块定义中，则会显示默认实体视图。

实体记录

此页面类型用于显示现有记录或打开窗体以创建新记录。

现有记录打开时，以下参数可用于实体记录页面类型。

参数 说明 需要 支持值 示例
entityName 实体的逻辑名称 是 字符串

数据域

 帐户

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}
entityId 实体记录的 GUID 否 字符串

数据域

 d49e62a8-90df-e311-9565-a45d36fc5fe8

{anchor._customerid_value}

formId 窗体实例的 GUID 否 字符串 915f6055-2e07-4276-ae08-2b96c8d02c57
validateRecord 检查组织数据库中是否存在记录 否 布尔型 TRUE

备注

如果系统没有将 entityId 值与 Dataverse 中的现有记录匹配，窗体将在创建模式下打开，以创建记录。 如果您希望系统仅在记录在 Dataverse 中存在时加载窗体，将 validateRecord 参数设置为 true。

如果 validateRecord 参数不存在，按如下方式创建此参数：

  1. 在应用程序选项卡模板窗体中，选择新建模板参数，输入以下值：
    • 名称：validateRecord
    • 唯一名称：new_tabtemplateparam_validateRecord
    • 值：True
  2. 保存并关闭。

当打开实体窗体以创建记录时，以下参数可用于实体记录页面类型。

参数 说明 必需 支持值 示例
entityName 实体的逻辑名称 是 字符串

数据域

 联系人

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}

data 在窗体中预填充的数据 否 JSON {"subject":"Task created from {anchor.ticketnumber}","description":"Follow-up needed with customer","prioritycode":"2","scheduledend":"06/12/2023", "regardingobjectid": [{"id": "{anchor.incidentid}", "name": "{anchor.title}", "entityType":"{anchor.entityName}"}]}
formId 窗体实例的 GUID 否 字符串 915f6055-2e07-4276-ae08-2b96c8d02c57

以下参数可用于实体搜索页面类型。

参数 说明 必需 支持值 示例
searchType 定义要使用相关性搜索还是分类搜索。 值可以为：
  • 0 代表相关性搜索
  • 1 代表分类搜索
 否 Number 0
searchText 定义要搜索的字符串。 是 字符串

数据域

OData


 contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

第三方网站

此页面类型用于将第三方网站显示为应用程序。 可以使用该类型仅托管那些与 iframe 托管兼容的网站。 如果您的网站与 iframe 托管不兼容，将显示一条错误消息，说明网站拒绝连接。 应用程序选项卡模板解析 URL 和数据参数以为要显示的 URL 地址提供格式。

参数 步骤 需要 支持值 示例
url 显示在应用选项卡中的网站 URL
 是 字符串
 https://www.bing.com/search?q=
data 要使用 url 参数分析的其他数据参数
 否 字符串

数据域

OData


 contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

备注

当代理从第三方网站类型的选项卡模板切换到另一个选项卡，然后切换回第三方网站选项卡模板时，页面会刷新到初始状态。 有关详细信息，请参阅已知问题文档中的“第三方应用程序选项卡在焦点更改时刷新”一节。

解析的工作原理

这些示例基于此场景：案例在票证编号为 CAS-01003-P3B7G1 的新会话中作为定位点选项卡打开。

url 参数：https://www.bing.com/search?q=
使用数据域的 data 参数：{anchor.ticketnumber}
预期 URL：https://www.bing.com/search?q=CAS-01003-P3B7G1

url 参数：https://www.bing.com/search?q=
使用 OData 的 data 参数：{$odata.incident.ticketnumber.?$filter=incidentid eq'{anchor.incidentid}'&$select=ticketnumber}
预期 URL：https://www.bing.com/search?q=CAS-01003-P3B7G1

备注

url 参数需要使用“https://”的正确 URL 格式。

Web 资源

此页面类型用于显示表示文件的 Web 资源，这些资源用于扩展 Web 应用程序，例如 HTML 文件、JavaScript CSS 和多种图像格式。 以下参数可用于 Web 资源页面类型。

参数 说明 必需 支持值 示例
webresourceName 要打开的 Web 资源的名称 是 字符串 new_myresource.html
data 根据 Web 资源的要求提供字符串或键值对。 否 字符串

数据域

OData


 contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

备注

当代理从 web 资源类型的选项卡模板切换到另一个选项卡，然后切换回 web 资源类型选项卡模板时，页面会刷新到初始状态。 有关详细信息，请参阅已知问题文档中的“第三方应用程序选项卡在焦点更改时刷新”一节。

自定义

此页面类型用于在应用程序选项卡上显示自定义页。可以使用此选项卡模板类型托管在相应应用中提供的自定义页面。 有关自定义页面的更多信息，请参阅模型驱动应用的自定义页面概述。

以下参数可用于自定义页面。

参数 步骤 需要 支持值 示例
entityName 实体的逻辑名称 否 字符串

数据域
 事件

{anchor.entityName}
name 自定义页面的唯一名称 是 字符串
 new_mycustompage
recordId 实体记录的 GUID 否 字符串

数据域



OData



 d49e62a8-90df-e311-9565-a45d36fc5fe8

{caseId}

{anchor.incidentid}

{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

现成应用程序选项卡模板

以下现成的应用程序选项卡模板可用。

模板名称 说明 应用程序类型
活动对话 在选项卡中显示可用对话页面。 实体记录
实体记录 在选项卡中显示实体记录。 实体记录
知识搜索 在选项卡中显示知识文章搜索页。 Web 资源​​
全渠道对话仪表板 在选项卡中显示全渠道对话仪表板。 仪表板​​
全渠道日内见解 在选项卡中显示 Power BI 报表。 控件
快速回复预览 在选项卡中显示快速回复。 控件
丰富消息预览 在选项卡中显示丰富消息。 控件
搜索 在选项卡中显示全渠道搜索页。 控件

另请参见

开始使用 Customer Service 管理中心
管理会话模板
管理通知模板
将模板与工作流关联