管理应用程序选项卡模板
利用 Customer Service 中的应用程序选项卡模板，您可以指定当代理在 Customer Service workspace 中启动会话时可以打开的应用程序的类型。
左侧面板中的垂直条将显示会话列表。 此面板会始终显示无法关闭或自定义的主页会话。
在 Customer Service workspace 中，每个会话至少有一个不能关闭或自定义的应用程序选项卡，此选项卡称为“定位点选项卡”。 当您启动会话时，会根据您的配置设置打开相应的应用程序页面和任何其他附加页面。
使用应用程序选项卡模板，可以定义可用于会话的应用程序，然后将这些应用程序与会话关联。 例如，您可以创建可用对话页面选项卡并将其与聊天或短信会话相关联。 现在，当代理接受来自聊天或短信渠道的通知后，会话将开始，并打开可用对话页面。
作为管理员，您可以创建多个应用程序选项卡模板。
备注
无法自定义现成模板，但可以创建您自己的自定义模板。
先决条件
您需要系统管理员角色来执行本文提到的任务。
创建应用程序选项卡模板
选择 Customer Service 管理中心，执行相应步骤。
- 在站点地图中，选择代理体验中的工作区。
- 在工作区页面上，为应用程序选项卡模板选择管理。
在可用应用程序选项卡模板页上选择新建。
在新建应用程序选项卡模板页上指定以下各项。
制表符 Name 步骤 示例 一般 客户 指定应用程序选项卡的名称。代理在运行时看不到此名称。 知识文章搜索 一般 唯一名称 以 <前缀>_<名称> 格式提供一个唯一标识符。
重要提示
指定唯一名称时需考虑下列因素：- 前缀只能是字母数字，长度必须在 3 到 8 个字符之间。
- 必须在前缀和名称之间添加下划线。
您可以选择灯泡图标，然后选择应用验证您输入的名称是否满足要求。contoso_application_tab 常规 职位 提供您希望代理在运行时查看的应用程序的标题。 知识文章搜索 一般 页面类型 从列表中选择页面类型。 Web 资源 一般 说明 提供说明以供参考。 页面类型用于显示知识库搜索页。 选择保存。 参数部分显示所选页面类型的参数。
备注
只要编辑应用程序选项卡模板，请保存更改，以便在参数部分中查看相应字段。
选择要编辑的参数的值字段并提供值。
选择保存。
页面类型
提供以下页面类型：
- 仪表板
- 实体列表
- 实体记录
- 搜索
- 第三方网站
- Web 资源
- 控件（仅供内部使用）
- 自定义
仪表板
此页面类型用于将仪表板显示为应用程序。 以下参数可用于仪表板页面类型。
| 参数 | 说明 | 必需 | 支持值 | 示例 |
|---|---|---|---|---|
dashboardId |
仪表板的 GUID | 是 | String | d201a642-6283-4f1d-81b7-da4b1685e698 |
备注
- 如果 dashboardId 参数如下所示，将显示默认仪表板：> - blank > - incorrect > - is a dashboard that isn't included in the app module definition
- 不支持个人默认仪表板。
实体列表
此页面类型用于显示定义如何显示特定实体的记录列表的实体视图。 以下参数可用于实体视图页面类型。
| 参数 | 说明 | 必需 | 支持值 | 示例 |
|---|---|---|---|---|
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 参数不存在，按如下方式创建此参数：
- 在应用程序选项卡模板窗体中，选择新建模板参数，输入以下值：
- 名称：validateRecord
- 唯一名称：new_tabtemplateparam_validateRecord
- 值：True
- 保存并关闭。
当打开实体窗体以创建记录时，以下参数可用于实体记录页面类型。
| 参数 | 说明 | 必需 | 支持值 | 示例 |
|---|---|---|---|---|
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 |
定义要使用相关性搜索还是分类搜索。 值可以为：
|
否 | 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 报表。 | 控件 |
| 快速回复预览 | 在选项卡中显示快速回复。 | 控件 |
| 丰富消息预览 | 在选项卡中显示丰富消息。 | 控件 |
| 搜索 | 在选项卡中显示全渠道搜索页。 | 控件 |
另请参见
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈