介绍
HP Workforce Experience Platform （WXP） 设备管理应用程序允许 HP Workforce Experience 和 ServiceNow 配置管理数据库 （CMDB） 之间的端到端集成。本技术设计文档详细描述了应用程序的架构、数据流、用户界面和配置要求。它旨在供系统管理员、IT 运营专业人员和资产经理使用，他们将部署、作和维护集成，以提高设备的可见性、丰富 CI 数据并使用遥测和更新功能实时自动执行事件管理。
本 TDD 涵盖以下主题：
文件的目的和范围
本文档介绍了将 HP Workforce Experience 与 ServiceNow 的配置管理应用程序集成的技术设计。它详细介绍了集成的功能、架构、数据流、用户界面和关键组件，确保与 ServiceNow 最佳实践的一致性。
有关安装说明，支持用户指南文档提供了有关如何安装和配置 HP WXP 设备管理应用程序的全面信息。
应用概述
HP Workforce Experience 与 ServiceNow 的配置管理的集成提供了根据特定租户的 HP Workforce Experience Platform 数据导入 ServiceNow CMDB CI （cmdb_ci_computer） 的功能。该集成通过预定义的字段映射实现持续的 CI 数据丰富，以及按需访问遥测数据，例如电池状态、硬件运行状况、蓝屏错误、保修信息等，从而改善整体事件处理。
目标受众
本技术设计文档面向负责实施和管理 HP Workforce Experience 与 ServiceNow 配置管理应用程序集成的系统和应用程序管理员。它还适用于 IT 运营团队、支持工程师以及 CMDB 和资产经理。
注意： ServiceNow 集成适用于 HP WXP 合作伙伴 （他们可以在其托管客户租户中启用它）和 直接 HP WXP 客户。合作伙伴帐户下的托管客户 无法 直接访问 ServiceNow 集成。有关更多信息，请联系 HP WXP 支持。
2. 主要功能和用例
此集成具有 ServiceNow 配置向导，旨在简化设置和部署。通过其引导式分步界面，该向导有助于配置 HP Workforce Experience 和 ServiceNow 的配置管理应用程序之间的连接。该向导的显着功能包括：
使用 Fastn.AI 进行身份验证
租户选择
导入 CI 记录（计算机）
HP Workforce Experience 和 ServiceNow cmdb_ci_computer 表之间的预定义字段映射
持续更新惠普员工体验数据到 CI 记录
按需遥测数据（硬件运行状况、蓝屏错误、电池状态、保修信息等）
下面的用例图从不同角色（例如 HP 和 ServiceNow）的角度提供了集成的可视化表示。
3. 应用架构
“应用程序体系结构”部分包含高级体系结构图、应用程序范围信息、数据流图以及与其他系统/应用程序的任何集成。这些设计反映了应用程序组件的交互方式以及数据流动的方式。
4. 数据模型
数据模型部分包含实体关系图 （ERD）、带有字段名称、类型和关系的表定义，以及访问控制要求。
4.1 数据模型叙述
4.2 表名称 - HP Workforce Experience 设备导入集
集（x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set）
列名称 | 列标签 | 命令的 | 主要 | 类型 | 最大长度 |
组织ID | 组织 ID | 假 | 假 | 字符串 | 40 |
sys_id | 系统 ID | 假 | 真 | 系统 ID （GUID） | 32 |
作系统 | 操作系统 | 假 | 假 | 字符串 | 50 |
最后看到 | 上次查看 | 假 | 假 | 字符串 | 40 |
奥斯释放 | 发布 | 假 | 假 | 字符串 | 50 |
序列号 | 序号 | 假 | 假 | 字符串 | 40 |
制造者 | 制造者 | 假 | 假 | 字符串 | 50 |
创建 | 创建的 Ts | 假 | 假 | 字符串 | 40 |
设备类型 | 设备类型 | 假 | 假 | 字符串 | 50 |
图形 | 图形 | 假 | 假 | 字符串 | 50 |
固件版本 | 固件版本 | 假 | 假 | 字符串 | 40 |
记忆 | 记忆 | 假 | 假 | 字符串 | 50 |
别名 | 别名 | 假 | 假 | 字符串 | 50 |
生物流转 | Bios版本 | 假 | 假 | 字符串 | 70 |
制造日期 | 制造日期 | 假 | 假 | 字符串 | 40 |
名字 | 名字 | 假 | 假 | 字符串 | 50 |
位置 | 位置 | 假 | 假 | 字符串 | 40 |
设备型号 | 设备型号 | 假 | 假 | 字符串 | 70 |
资产标签 | 资产标签 | 假 | 假 | 字符串 | 50 |
作系统 | 作系统版本 | 假 | 假 | 字符串 | 50 |
泰卢固语 | 产品 SKU | 假 | 假 | 字符串 | 50 |
dataasofdate | 截至日期的数据 | 假 | 假 | 字符串 | 50 |
生命周期状态 | 生命周期状态 | 假 | 假 | 字符串 | 40 |
处理器 | 处理器 | 假 | 假 | 字符串 | 50 |
访问控制要求
供参考的 ACL 列表：
名字 | 操作 | 类型 | 角色 |
x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set | 删除 | 记录 | x_hpws_wrkfrcexpdm.hp_workforce_experience_device_import_set_user |
x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set | 写 | 记录 | x_hpws_wrkfrcexpdm.hp_workforce_experience_device_import_set_user |
x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set | 读 | 记录 | x_hpws_wrkfrcexpdm.hp_workforce_experience_device_import_set_user |
x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set | 创造 | 记录 | x_hpws_wrkfrcexpdm.hp_workforce_experience_device_import_set_user |
5. 用户界面和安装指南
用户界面设计部分引用应用程序 UI 元素的线框/屏幕截图和导航路径，显示常见的用户路径和设计。
请参阅用户安装指南
6. 业务逻辑和工作流程
业务逻辑和工作流部分包含流程流、转换映射、脚本包含、记录生成者、目录客户端脚本、目录 UI 策略、UI 页面、通知、系统属性、图像、UI作和其他部分。
6.1 HP Workforce → Import 设置表→计算机记录
导入集表：来自 HP Workforce Experience 的数据将插入导入集暂存表中。
6.2 工艺流程
HP WXP 设备管理
电脑记录
导入集暂存表
计划作业
6.3 导入集 Web 服务
导入集 Web 服务列表以供参考：
名字 | 应用 |
HP WXP 设备导入套装 | HP Workforce Experience Platform 设备管理 |
6.4 变换贴图
下表显示了为将暂存表映射到目标表而创建的转换映射列表：
名字 | 源表 | 目标表 |
HP WrkfrcExpDM 变换图 | HP WXP 设备导入套装 [x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set] | 电脑 [cmdb_ci_computer] |
HP WrkfrcExpDM 外围设备 | HP WXP 设备计算机外围设备导入套装 [x_hpws_wrkfrcexpdm_hp_wxp_device_computer_peripheral_import_set] | 目标台式计算机外围设备 [cmdb_ci_peripheral] |
注意： 确保 ServiceNow 中的基础数据（公司和位置记录）与 HP Workforce Experience Platform 中的公司、制造商和位置值保持一致，以避免不匹配。
如果未找到匹配项或公司名称和位置名称不匹配，则计算机表 （cmdb_ci_computer） 上的字段：公司、制造和位置在同步后将保持为空，因为这些字段的选择作设置为“忽略”。
6.5 脚本包括
脚本包含列表以供参考：
名字 | 描述 | 应用 |
WrkfrcExpFleetDeviceMgmtUtil | 包括用于调用 API 和处理响应的函数。 | HP Workforce Experience Platform 设备管理 |
WrkfrcExpDMUtil | 包括通用实用程序的功能 | HP Workforce Experience Platform 设备管理 |
WrkfrcExpIREANDPHYSICALDATA | 包括 IRE 应用程序日志和发送 IRE 电子邮件的功能。 | HP Workforce Experience Platform 设备管理 |
6.6 计划脚本执行
预定脚本列表供参考：
名字 | 描述 | 类型 | 默认执行间隔 | 应用 |
按需：校准 URL 引用 | 将 sysID 值填充到相应的系统属性。 | 按需 | ----- | HP Workforce Experience Platform 设备管理 |
定期：获取所有资产 | 获取所有资产 | 周期的 | 每周（周日） | HP Workforce Experience Platform 设备管理 |
定期：获取所有实物资产 | 获取所有实物资产 | 周期的 | 每周（周日） | HP Workforce Experience Platform 设备管理 |
6.7 唱片制作人
唱片制作人名单供参考：
唱片制作人名称 | 描述 |
HP WXP 设备管理组/电子邮件以获取故障通知 | 此表单用于提供必须发送失败通知的组/电子邮件地址。 |
6.8 目录客户端脚本
目录客户端脚本列表以供参考：
名字 | 目录项 | 描述 | 类型 |
群组电子邮件验证 | HP Workforce Experience 设备管理组/电子邮件以获取故障通知 | 确保输入的时间不是未来日期 | 更改 |
将电子邮件地址设置为系统属性 | HP Workforce Experience 设备管理组/电子邮件以获取故障通知 | 使用所选组的电子邮件地址设置系统属性值 | 提交时 |
6.9 目录 UI 策略
目录UI策略列表以供参考：
名字 | 目录项 | 描述 | 适用于目录项视图 [目录 UI 策略] | 适用于目标记录 [目录 UI 策略] |
6.10 UI 页面
UI 页面列表供参考：
UI页面名称 | 描述 |
WrkfrcExpfmdm重定向联系 | 重定向到唱片制作人 |
WrkfrcExpfmdm重定向电子邮件 | 重定向到唱片制作人 |
WrkfrcExpfmdm重定向公司 | 重定向到唱片制作人 |
WrkfrcExpfmdmRP成功 | 在提交记录制作者时显示成功消息 |
extra_fields | 显示 API 的属性 |
发现源 | 显示配置发现源的步骤 |
battery_risk_factors | 在计算机记录中显示 API 的属性 |
bluescreen_errors | 在计算机记录中显示 API 的属性 |
|
|
WrkfrcExpDMApp隐私政策 | 显示应用隐私策略模块 |
WrkfrcExpDMGuidedSetUp | 传递引导式设置的 sys id |
hw_warranty | 在计算机记录中显示 API 的属性 |
WrkfrcExpfmdm重定向作业 | 重定向到计划作业 |
HPCustomSlushBucketPageDevice | 对于租户配置页上的列表收集器 |
HPAdditionalData | 用于加载物理资产的功能 |
HPAdditionalData主页 | 显示加载物理资产引导设置任务 |
HPAdditionalDevicetypeselectionPage | 对于 GS 中的主要设备类型选择 |
HPIREConfirmPage设备 | 用于显示 IRE 确认功能 |
HPIRE页面 | 显示 IRE 确认步骤 |
HPWrkfrc附加设备选择主页 | 用于模块中的主要设备类型选择 |
注意 ：创建了UI页面以在引导式设置中使用其端点，以避免在重定向URL中使用系统ID。
6.11 通知
通知一览表供参考：
通知名称 | 描述 |
Wrkfrc Exp Fleet DM 集成失败 | 在发现 SNOW 和 HP 之间的集成失败时触发 |
WrkfrcehpdmIREConfirmation_mail | 当用户选择确认 IRE 确认步骤时触发 |
6.12 事件注册表
事件注册表列表供参考：
事件注册表名称 | 描述 |
x_hpws_wrkfrcexpdm.hp.dm.failure.notify | 要触发通知：Wrkfrc Exp 集成失败 |
6.13 通知电子邮件脚本
通知电子邮件脚本供参考：
通知电子邮件脚本名称 | 描述 |
wrkfrc_exp_dm_failure_notification | 这用于显示通知的电子邮件正文：Wrkfrc Exp 集成失败 |
IREConfirmation邮件 | 发送 IRE 确认步骤的电子邮件 |
6.14 系统属性
系统属性列表供参考：
名字 | 描述 |
x_hpws_wrkfrcexpdm.rec.prod.company | 持有记录制作者的 sysid：HP WXP 设备管理公司 |
x_hpws_wrkfrcexpdm.failureNotif_rcrdprdcr | 保存记录生成者的 sysID：HP Workforce Experience Device Mgmt Group/Email for Failure Notification |
x_hpws_wrkfrcexpdm.hp.dm.application | 保存应用程序的 sysID：HP WXP 设备管理 |
x_hpws_wrkfrcexpdm.api.fastn.device.api.key | HP WXP 设备管理 API 密钥 |
x_hpws_wrkfrcexpdm.relatedlink.page.size | 相关链接页面大小 |
x_hpws_wrkfrcexpdm.租户 | 合作伙伴/公司的 tenantId |
x_hpws_wrkfrcexpdm.company.租户 | 子公司（包括父公司）的公司 tenantIds |
x_hpws_wrkfrcexpdm.device.fastn.space.id | 惠普员工体验 API 空间 ID |
x_hpws_wrkfrcexpdm.selected.租户 | 选定租户 |
x_hpws_wrkfrcexpdm.email_notify | 保存接收失败通知的电子邮件地址。 |
x_hpws_wrkfrcexpdm.batch.size | HP WXP 设备管理页面大小 |
x_hpws_wrkfrcexpdm.device.fastn.api.baseurl | fastn 设备管理的基本 URL |
x_hpws_wrkfrcexpdm.config_complete | 指示 HP WXP 设备管理应用程序的配置是否完成 |
x_hpws_wrkfrcexpdm.sch_job | 保存计划作业的 sys ID |
x_hpws_wrkfrcexpdm.记录计数 | 对于设备类型选择页面上的设备计数 |
x_hpws_wrkfrcexpdm.physicalassetdata_computer | 存储要导入的计算机设备类型的选择 |
x_hpws_wrkfrcexpdm.physicalassetdata_docks | 存储要导入的扩展坞设备类型的选择 |
x_hpws_wrkfrcexpdm.physicalassetdata_monitor | 存储要导入的监视器设备类型的选择 |
x_hpws_wrkfrcexpdm.tenant.type | 保留租户类型：合作伙伴或直接客户 |
x_hpws_wrkfrcexpdm.selected.tenants.name | 收集所选租户的名称 |
6.15 出站集成 [REST 消息]
REST 消息列表以供参考：
名字 | 应用 |
HP WXP 设备管理 | HP Workforce Experience Platform 设备管理 |
6.16 REST 消息 – HTTP 方法
HTTP 方法列表供参考：
名字 | 身份验证类型 | 应用 |
硬件保修 | 从父级继承 | HP Workforce Experience Platform 设备管理 |
获取资产 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取资产详细信息 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取电池风险因素 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取硬件蓝屏详细信息 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取实物资产 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取计算机资源 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取合作伙伴的客户 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
获取用于监视的实物资产 | 无身份验证 | HP Workforce Experience Platform 设备管理 |
6.17 模块
参考模块列表：
名字 | 应用 | 可见性角色 |
所有设备 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.user、x_hpws_wrkfrcexpdm.admin |
所有资产 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.用户 |
计算机 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.user、x_hpws_wrkfrcexpdm.admin |
检查同步日志 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
配置 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
联系 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.user、x_hpws_wrkfrcexpdm.admin |
引导式设置 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
HP WXP 设备暂存 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
进口 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
出站休息 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
计划作业 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
设置 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
支持 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.user、x_hpws_wrkfrcexpdm.admin |
App 隐私政策 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
租户配置 | 惠普员工体验平台活动管理 | x_hpws_wrkfrcexpdm.admin |
设备类型选择 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.admin |
外设 | HP Workforce Experience Platform 设备管理 | x_hpws_wrkfrcexpdm.user， x_hpws_wrkfrcexpdm.admin |
6.18 图片
图片列表供参考：
名字 | 应用 |
x_hpws_wrkfrcexpdm。AppPriPolicy.png | HP Workforce Experience Platform 设备管理 |
x_hpws_wrkfrcexpdm。ContactModuleHelp.png | HP Workforce Experience Platform 设备管理 |
x_hpws_wrkfrcexpdm。ContactModule.png | HP Workforce Experience Platform 设备管理 |
x_hpws_wrkfrcexpdm。HPLogo.png | HP Workforce Experience Platform 设备管理 |
x_hpws_wrkfrcexpdm。ContactHome.png | HP Workforce Experience Platform 设备管理 |
6.19 UI作
UI作列表以供参考：
UI作名称 | 描述 |
同步 CI | 同步 CI |
获取蓝屏错误 | 显示与蓝屏错误相关的 CI 属性 |
获取电池风险因素 | 显示与电池风险因素相关的 CI 属性 |
获得硬件保修 | 显示与硬件保修相关的 CI 属性 |
获取其他属性 | 显示 CI 附加属性 |
注意：这些 UI作在记录上作为相关链接cmdb_ci_computer显示。
6.20 业务规则
业务规则列表供参考：
业务规则名称 | 描述 |
|---|---|
填充correlation_id | |
HP_WXP_DEVICEAPP_Deactive_Select_Tenant |
7. 部署和实施
部署和实现部分详细介绍了部署过程、应用程序依赖项、安装步骤、演示数据、环境设置和回滚计划。
7.1 部署流程
访问 ServiceNow App Store 上的 HP Workforce Experience Platform 设备管理应用程序列表并购买。
确保所有应用程序依赖项都已解决（请参阅下面的应用程序依赖项）。
进行应用程序的安装（请参阅下面的安装步骤）。
必须针对每个环境执行部署过程。
7.2 应用程序依赖关系
应用程序需要以下依赖项：
1. CMDB插件：com.snc.cmdb
7.3 安装步骤
要安装 HP Workforce Experience Platform 设备管理应用程序，请按照下列步骤作（安装 ServiceNow Store 应用程序）：
导航到所有>系统应用程序>所有可用应用程序>全部
搜索“HP Workforce Experience Platform Device Management”
单击“安装”按钮开始安装应用程序
安装完成后，单击“关闭”按钮
7.4 演示数据
安装 HP Workforce Experience Platform 设备管理应用程序不需要演示数据。
HP Workforce Experience 平台最适合在具有多个环境的 ServiceNow 中使用：生产实例和 UAT 实例。
生产实例 – 大多数客户（应用程序用户）将访问作用域内应用程序的环境。
UAT 实例 – 应首先将发布部署到的环境。
7.6 回滚计划
要从 ServiceNow App Store 回滚 HP Workforce Experience Platform 设备管理应用程序，请按照以下步骤作（回滚 ServiceNow Store 应用程序）：
1. 转到系统应用程序>我的公司应用程序
2. 搜索并单击 HP Workforce Experience Platform 设备管理 应用程序。
3. 在记录中，选择回滚相关链接
4. 导航回系统应用程序>我的公司应用程序并进行验证。
8. 维护和支持
维护和支持部分概述了 HP Workforce Experience Platform 设备管理应用程序的支持程序、SLA 定义信息以及联系方式/详细信息。此外，还列出了版本控制策略。
8.1 应用程序更新
如果应用程序需要更新，可以使用以下步骤（安装 ServiceNow Store 应用程序的更新）：
导航到系统应用程序>所有可用应用程序>全部
在这里，使用过滤器或搜索栏找到应用程序
如果有可用更新，请选择版本
点击“更新”
8.2 支持程序
客户应从他们的服务台/支持团队开始报告任何问题，并确定是否需要 HP Workforce Experience 支持团队获得进一步帮助。如果客户被指示联系 HP Workforce Experience 寻求技术支持，则下面提供了运营时间/天数以及联系方式/详细信息。
支持工作时间：美国东部时间上午 8 点至下午 5 点
支持运营日：周一至周五（美国节假日除外）
联系方式：HP Workforce Experience Platform： 支持
单击“帮助和支持”
单击电子邮件部分下的请求
8.3 版本控制策略
应用程序管理员负责确定哪个版本最好。可以通过以下步骤（安装版本 ServiceNow Store 应用程序）来管理 HP Workforce Experience Platform 设备管理应用程序的版本。
导航到系统应用程序>所有可用应用程序>全部
使用过滤器或搜索栏查找 HP Workforce Experience Platform 设备管理应用程序。
如果有新版本可用，请选择新版本。
单击“更新”。
9. 附录
附录部分包含整个文档的术语和参考词汇表。此外，附录还包含用于管理 ServiceNow Store 应用程序的文档链接、所需插件的链接以及 HP Workforce Experience 平台的链接。
9.1 术语表
下面列出的术语具有提供的定义，并且存在于整个文档中。
应用程序管理员： 具有与管理员类似的提升权限和权限的用户，但专门用于作用域应用程序。应用程序管理员角色包含超出作用域应用内管理员权限的权限。默认情况下，可以访问作用域应用的所有模块。
应用用户： 具有与 itil 用户类似的大多数查看权限和权限的用户，但专门用于作用域应用程序。默认情况下，只能访问作用域应用程序的特定模块。
HP Workforce Experience Platform 设备管理： 应用程序的长名称。
HP WXP 设备管理： 应用程序的简称。
wrkfrc_exp： 后端项中使用的应用程序的缩写简称。
Fastn.ai： 人工智能驱动的 API 编排平台，HP Workforce Experience 应用程序将 Proactive Insights 数据连接到 ServiceNow。
9.2 相关资源
联系我们
如需任何帮助、 create a support 案例或电子邮件 support@wxp.hp.com。