知识库
安装指南
上次修改时间: 2025年2月10日
客户要求
该扩展需要为 FSM 账户设置 OAuth2 客户端，并为每个公司设置适当的访问权限。 需要执行此作才能启用扩展的安装。
账户信息
您需要提供 FSM 中账户和公司的技术名称，以及安装其实例的集群。此信息可以在管理面板中找到，如下图所示：
公司信息
在上面的示例图像中，所需的信息是：
- 帐户名称： Teamviewer-demo
- 公司： DemoCompany1，
- 集群： DE
注意： 该扩展可以支持多个公司，请指定将使用它的所有公司。
用户组
该扩展只需要一些权限即可运行。它充当“Dispatcher”，因为它读取“ServiceCall”和“Activity”对象。然后，它为匹配的 'ServiceCall' 创建一个 'Attachment' 对象。它还会在更新时删除创建的资产。
您可以决定在 FSM 中使用现有的“Dispatcher”角色，也可以创建一个新角色以供客户端使用。创建合适组的一种方法是复制现有的“Dispatcher”组。
然后，您可以在需要时使用此副本进一步限制访问权限，例如，您可以删除所有对象（“附件”对象除外）的 Create 和 Delete 权限。
客户
要从技术上访问 FSM，该扩展需要 OAuth2 客户端设置。
在 FSM 客户端 配置中，您需要创建一个新客户端。
注意： 保存时，请务必记下生成的客户端密钥。TeamViewer 解决方案交付团队需要此插件才能提供扩展实例。
通过设置访问权限以及客户端 ID 和客户端密钥对，TeamViewer 可以为 FSM 账户配置扩展。 通过安全通信通道向 TeamViewer 联系人提供客户端 ID 和 客户端密钥 。
FSM 中的扩展安装
扩展链接
配置扩展实例后，TeamViewer 将提供用于安装扩展的扩展访问 URL。
安装
该扩展是通过左侧 Installed overview 中的 Foundational Services 配置安装的。
⇒FSM 目录中将有一个用于集成的扩展磁贴，但仅根据请求通过自定义 URL 配置来支持安装。
1. 选择 添加扩展 ，提示您输入 TeamViewer 提供的 URL。
注意： 请完全按照提供的 URL 输入 URL（它可能以必需的“/”结尾）。
4. 单击安装。
⇒扩展可用。
侧 栏
如果您一开始选择不将扩展安装到侧边栏中，则可以手动执行此作。
1. 打开侧边栏的 Extension Configuration（扩展配置）。
2. 单击 添加扩展。
3. 选择 Frontline Assist。
4. 单击 “添加”。 关闭 扩展配置。
扩展现已安装！
卸载/从侧边栏中删除
您可以随时安全地卸载或删除扩展程序。当您的实例仍然有效时，您可以稍后使用相同的扩展访问 URL 重新安装或重新启用扩展。
在 Assist Call Management 中添加用户
在 Frontline Command Center 上，创建角色和用户以对用户目标进行分类和管理。在这里，我们将为 FSM 专家创建一个角色，并将此角色分配给用户或团队。
要在 Frontline Command Center 中创建角色：
1. 使用 Frontline Command Center 凭据登录。
2. 转到左侧导航窗格中的 Configuration 。
3. 选择 Permissions 下的 Roles 。
4. 单击 Create Role（创建角色 ）按钮。
5. 输入角色的名称， 例如 FSM Expert。
6. 点击页面底部的 Add 。
⇒角色已创建。有关角色的更多信息，请参阅我们的 角色和权限 品。
现在，我们将与 FSM 专家一起创建团队。
要创建 Teams：
1. 转到 Configuration 下的 Teams 。
2. 单击 Create Team（创建团队 ）按钮。
3. 输入团队名称。
4. 在 Roles（角色）栏中键入您刚刚创建的 FSM Expert 角色，然后选择它。
5. 按 Enter 键。
6. 添加用户。
7. 点击保存。
⇒团队已创建。有关 Teams 的更多信息，请参阅我们的 用户管理 – 团队 品。
现在，我们将指派 FSM 专家团队来协助呼叫管理。这将允许这些用户进行群组呼叫或相互呼叫。
要管理呼叫组：
1. 转到 Assist。
2. 选择 呼叫管理。
3. 单击顶部节点下的 加号 图标。
⇒ 与 Roles 和 Teams 创建一样，也有一个模式打开。
4. 从顶部的模态栏中选择 Teams。
5. 切换 Include team members to group（将团队成员纳入组 ）按钮。这将允许 FSM 专家自动添加为此呼叫组的用户。
6. 点击 保存。
⇒ 这会在 Top Node Call Group （顶级节点调用组） 下创建一个分支。FSM 专家呼叫组已添加到其下。通常，在您选择的加号图标所属的呼叫组下会添加新的呼叫组。有关呼叫组的更多信息，请参阅我们的 组信息 文章。
支持 SAP Field Service Manager Mobile 应用程序
从分机 3.0.0 版开始，移动应用程序可以自行进行 Assist 调用。此集成基于 启动外部应用程序 功能，适用于 Android 和 iOS。
从扩展版本 3.2.0 开始，设置现在需要 Frontline 和 FSM 服务工作流程已知的共享密钥。
共享密钥设置（自 3.2.0 起）
1. 登录到 Frontline Command Center（需要管理员角色）。
2. 转到配置下的 首选项 。
3. 找到 FSM 首选项（在右上角的搜索栏中键入 FSM ）。
4. 在 fc.fsm.mobile-call.keys 字段中输入至少一个值（例如随机 UUID）作为共享密钥。
5. 可选：用逗号分隔多个值。
6. 确保将 fc.fsm.mobile-call.key-required 设置为 true ，以确保进行键检查。
7. 确保将 fc.fsm.mobile-call.enabled 设置为 true 以启用呼叫功能。
所选首选项应如下所示：
服务工作流设置
您需要为 Assist 创建一个步骤，该步骤可以在 技术人员的工作步骤 之后运行。从技术上讲，要进行 Assist 呼叫，技术人员需要分配一个 Activity。
下面是一个配置的示例：
此处的 Assist 步骤已插入到 work 步骤之后。 下一步，工作 步骤可以转到 Assist 或 checkout 。这允许一个工作流，技术人员可以在工作时多次开始呼叫，然后在工作完成后执行 签出 。
Assist 步骤 是一个 External application 屏幕。应将其配置为 go back to work step next，以便配置允许在下班后返回。根据您的需要，您还可以继续执行不同的步骤。
在给定的示例中，使用了以下设置：
Android 和 iOS 的配置具有相同的 URL。这基于为扩展安装提供的扩展链接，其中包含其他参数。
如果您的扩展链接 https://frontline/connector/ 则外部应用程序的 URL 将变为 https:////frontline/connector/fsm.html?activityId=${activity.id}&key=[keydata]&qr'。
${activity.id} 参数由 FSM 动态提供，用于标识当前 Activity。
key 参数必须包含共享密钥设置中的值之一（请参阅上文）。
qr 参数将在移动设备上显示一个二维码，其他设备可以扫描该二维码以发起通话。呼叫仍可在移动设备本身上启动。
当技术人员进入 Assist 步骤时，移动设备将打开一个浏览器，该浏览器将指导用户开始 Assist 呼叫。
此示例使用标准 摄像头正面 图标为技术人员提供视觉线索。
受保护的字段/用户名
该扩展将使用 FSM API 检索有关 Activity、 ServiceCall 和关联 Person 的信息。
注意： 根据您的安全配置，某些字段可能不可用。
该扩展将尝试通过 firstName 和 lastName 字段确定用户名。如果这些字段不可用，它将尝试使用 userName 字段。如果此字段也不可用，则将使用 emailAddress 。作为后备，将使用 FSM User 来命名用户。
可以通过 公司>自定义对象 > 标准字段定义 来检查字段可访问性，并根据需要相应地调整客户端访问级别。
以下是 firstName 配置的示例：
