集成 Cherwell
部署 Cherwell 集成模板以管理事件和服务请求的更改并收到有关更改的通知。
衷心期盼您的反馈信息！请在使 用此集成模板时提供反馈 。对于任何问题，我们的团队还将每天监控我们的 专门论坛 。
有关适用于 Cherwell 的开箱即用微应用的全面详细信息，请参阅 使用 Cherwell 微应用。
查看必备项
与 Cherwell 设置此集成后，您需要以下工件才能在 Citrix Workspace 微应用中添加集成：
-
基本 URL：
https:/{Cherwell_Instance_URL}/CherwellAPI/api/。{Cherwell_Instance_URL}是从 Cherwell 购买时获得的。 -
令牌 URL：
https:/{Cherwell_Instance_URL}/CherwellAPI/token。{Cherwell_Instance_URL}是从 Cherwell 购买时获得的。 - 用户名：这和密码是有权访问 Cherwell 的服务帐户的凭据。
- 密码：这和用户名是有权访问 Cherwell 的服务帐户的凭据。
- 客户端 ID：客户端 ID 是表示授权服务器唯一的客户端注册信息的字符串。
- 客户端密钥：客户端密钥是设置目标应用程序集成时发出的唯一字符串。
建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
集成需要定期访问您的 Cherwell 实例，因此我们建议您创建一个专用用户帐户。此账户必须具有以下权限：
- 管理员安全组
创建客户端 ID 和客户端密钥
在执行此过程之前，请导航到 https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/ 并下载 Cherwell 服务管理并进行安装。
- 使用您的用户名和密码登录。
- 在 Cherwell 服务管理应用程序屏幕上，选择 安全性。
- 转到 编辑 REST API 客户端设置。
- 选择 创建新客户端。
-
为以下项输入一个值：
- 名称
- 说明
- 输入 360 以获得 代币寿命
- 输入 1440 以获得 **刷新令牌寿命
- 选中 已启用 API 访问 复选框。
- 选择 保存当前客户端。
- 复制并保存 客户端密钥。这是配置集成时用于服务身份验证的 客户端 ID和客户端密钥 的值。
创建用户名和密码
同样，在执行此过程之前，请导航到 https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/ 并下载 Cherwell 服务管理并进行安装。
- 使用您的用户名和密码登录。
- 在 Cherwell 服务管理应用程序屏幕上，选择 安全性。
- 选择 编辑用户。
- 选择 创建新用户。
-
为以下项输入一个值：
- 登录 ID
- 密码
- 确认密码
- 选择安全组：管理员，然后输入 全名 和 电子邮件。
- 选中 “ 密码永不过期 ” 复选框。
- 选择 保存当前用户。
注意：
将集成添加到 Citrix Workspace 微应用
将 Cherwell 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用
请按照以下步骤进行操作：
- 在 微应用集成 页面中，选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
- 选择 Cherwell 瓷砖。
- 输入集成的名称。
- 输入 连接器参数。
- 输入实例 基本 URL：
https:/{Cherwell_Instance_URL}/CherwellAPI/api/。{Cherwell_Instance_URL}是从 Cherwell 购买时获得的。 - 从 图标 库中选择用于集成的图标，或将其保留为默认图标。
- 输入实例 基本 URL：
- 在 服务身份验证下，从身份验证 方法 菜单中选择 OAuth 2.0 ，然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从 授权类型 菜单中选择 资源所有者密码 。
- 输入 授权类型值 的 密码。
- 选择 请求正 文作为 令牌授权。
- 选择 URL 编码表单 作为 令牌内容类型。
- 输入您的 令牌 URL：
https:/{Cherwell_Instance_URL}/CherwellAPI/token。{Cherwell_Instance_URL}是从 Cherwell 购买时获得的。 - 输入您的用户名。这和密码是有权访问 Cherwell 的服务帐户的凭据。
- 输入你的 密码。此和用户名是有权访问 Cherwell 的服务帐户的凭据。
- 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。
- 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。
- 从 “ 标题前缀 ” 菜单中选择 “ 持票人 ”。
- 在 访问令牌参数 下，输入 auth_mode 作为 名称 ，在 内部 输入 值。
- 将服务操作身份验证开关保留为禁用状态
- 将 启用请求速率限制 开关保留为禁用状态。
- （可选）启用 日志记录 开关以保留 24 小时的日志记录以便获得支持。
- 选择 保存 以继续。
现在，您已准备好设置和运行第一次数据同步。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。
有关 API 端点和表实体的更多详细信息，请参阅 Cherwell 连接器规范。
使用 Cherwell 微应用
现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始，然后根据您的需求自定义它们。
创建事件： 允许用户创建事件。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建事件” 页 | 提供用于创建事件的表单。 |
创建服务请求： 从目录中创建新的服务请求或选择预定义的服务请求模板。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建服务请求” 页 | 提供用于选择预定义模板或从服务目录创建请求的表单。 |
我的开放事件： 查看和管理工作区用户拥有的开放事件。
| 通知或页面 | 用例工作流 |
|---|---|
| 事件创建通知 | 创建新事件时，事件的所有者会收到通知。 |
| 事件解决 SLA 阈值命中通知 | 如果错过了事件的解决方案 SLA，事件的所有者会收到通知。 |
| 事件响应 SLA 阈值命中通知 | 当事件的响应 SLA 丢失时，事件的所有者会收到通知。 |
| 事件状态已更改通知 | 当事件的状态发生更改时，事件的所有者会收到通知。 |
| 我的开放事件页面 | 提供工作区用户拥有的开放事件的列表。 |
| 事件详情页面 | 提供事件详细信息，包括评论以及添加评论和撤回事件的选项。 |
我的打开服务请求： 查看和管理工作区用户拥有的打开的服务请求。
| 通知或页面 | 用例工作流 |
|---|---|
| 服务请求已创建通知 | 创建新的服务请求后，事件的所有者会收到通知。 |
| 服务请求解决方案 SLA 阈值命中通知 | 当新服务请求的解决方案 SLA 丢失时，事件的所有者会收到通知。 |
| 服务请求响应 SLA 阈值命中通知 | 当新服务请求的响应 SLA 丢失时，事件的所有者会收到通知。 |
| 服务请求状态已更改通知 | 当新服务请求的状态发生更改时，事件的所有者会收到通知。 |
| 我的开放式服务请求 | 提供工作区用户拥有的打开的服务请求的列表。 |
| 服务请求详情 | 提供服务请求详细信息，包括注释以及添加评论和撤回服务请求的选项。 |