TDD：ServiceNow 裝置管理

簡介

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 表之間的預定義現場映射
HP Workforce Experience 資料持續更新至 CI 紀錄
隨選遙測數據（硬體健康狀況、藍屏錯誤、電池狀態、保固資訊等）

下方的使用情境圖從不同角色（如 HP 和 ServiceNow）的角度，視覺化地呈現了整合過程。

3. 應用程式架構

應用架構部分包含高階架構圖、應用範圍資訊、資料流程圖，以及與其他系統/應用程式的整合。這些設計反映應用程式元件的互動方式及資料流動方式。

4. 資料模型

資料模型部分包含實體關係圖（ERD）、包含欄位名稱、類型與關係的資料表定義，以及存取控制需求。

4.1 資料模型敘事

4.2 資料表名稱 - HP Workforce Experience 裝置匯入集

set（x_hpws_wrkfrcexpdm_hp_workforce_experience_device_import_set）

柱名	欄位標籤	強制性	小學	類型	最大長度
組織ID	組織編號	錯誤	錯誤	弦	40
sys_id	系統識別碼	錯誤	沒錯	系統識別碼（GUID）	32
操作系統	作業系統	錯誤	錯誤	弦	50
最後出現	最後一次出現	錯誤	錯誤	弦	40
OSRELEASE	發行	錯誤	錯誤	弦	50
序號	序號	錯誤	錯誤	弦	40
製造商	製造商	錯誤	錯誤	弦	50
創造者	創造的T族	錯誤	錯誤	弦	40
裝置類型	裝置類型	錯誤	錯誤	弦	50
圖像	圖像	錯誤	錯誤	弦	50
韌體版本	韌體版本	錯誤	錯誤	弦	40
記憶	記憶	錯誤	錯誤	弦	50
別名	別名	錯誤	錯誤	弦	50
生物轉移	BIOS 版本	錯誤	錯誤	弦	70
製造日期	製造日期	錯誤	錯誤	弦	40
名稱	名稱	錯誤	錯誤	弦	50
地點	地理位置	錯誤	錯誤	弦	40
裝置模型	裝置模型	錯誤	錯誤	弦	70
資產標籤	資產標籤	錯誤	錯誤	弦	50
轉化	作業系統版本	錯誤	錯誤	弦	50
產品	產品 SKU	錯誤	錯誤	弦	50
資料截至目前	截至日期的資料	錯誤	錯誤	弦	50
生命週期狀態	生命週期狀態	錯誤	錯誤	弦	40
處理器	處理器	錯誤	錯誤	弦	50

存取控制要求

供參考的前十字韌帶列表：

名稱	運作	類型	角色
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 → 匯入設定表→電腦紀錄

匯入集合表：HP Workforce Experience 的資料將插入匯入集合暫存表中。

6.2 流程流程

HP WXP 裝置管理

電腦紀錄

進口套組分段表

排程工作

6.3 匯入集 Web Services

供參考的匯入集網路服務列表：

名稱	應用
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 勞動力體驗平台中公司、製造商及地點的數值一致，以避免不符。

若未找到匹配或公司名稱與地點名稱不符，電腦資料表（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 員工體驗裝置管理群組/故障通知電子郵件

以確保輸入時間不是未來日期

在變化上

將電子郵件地址設為系統屬性

HP 員工體驗裝置管理群組/故障通知電子郵件

以所選群組的電子郵件地址設定系統屬性值

提交

6.9 目錄介面政策

目錄介面政策列表供參考：

名稱

目錄項目

描述

適用於目錄項目檢視 [目錄 UI 政策]

適用於目標紀錄 [目錄 UI 政策]

6.10 使用者介面頁面

參考 UI 頁面列表：

使用者介面頁面名稱	描述
WrkfrcExpfmdmRedirectContact	轉接到唱片製作人
WrkfrcExpfmdmRedirectEmail	轉接到唱片製作人
WrkfrcExpfmdmRedirectCompany	轉接到唱片製作人
WrkfrcExpfmdmRPSuccess	在唱片製作人提交時顯示成功訊息
extra_fields	以顯示 API 的屬性
發現源	顯示設定 Discovery Source 的步驟
battery_risk_factors	在電腦記錄中顯示 API 屬性
bluescreen_errors	在電腦記錄中顯示 API 屬性
~~hw_health~~	~~在電腦記錄中顯示 API 屬性~~
WrkfrcExpDMAppPrivacyPolicy	顯示應用程式隱私政策模組
WrkfrcExpDMGuidedSetupUp	傳遞 Guided setup 的 sys id
hw_warranty	在電腦記錄中顯示 API 屬性
WrkfrcExpfmdmRedirectJob	重新導向到排定的任務
HPCustomSlushBucketPageDevice	關於租戶設定頁面的清單收集器
HPAdditionalData	關於載入實體資產的功能性
HPAdditionalDataMainPage	顯示實體資產載入的引導設定任務
HPAdditionalDevicetypeselectionPage	在 GS 中選擇主要裝置類型
HPIREConfirmPageDevice	用於顯示IRE確認功能
HPIRE梅恩佩奇	顯示 IRE 確認步驟
HPWrkfrcAdditionalDeviceSelectionMainPage	模組中主要裝置類型的選擇

注意：已建立 UI 頁面，以便在引導設定中使用其端點，以避免在重定向 URL 中使用 Sys ID。

6.11 通知

參考通知列表：

通知名稱	描述
Wrkfrc Exp 艦隊 DM 整合失敗	當 SNOW 與 HP 之間發現整合失敗時，該機制會觸發
WrkfrcehpdmIREConfirmation_mail	在使用者選擇確認 IRE 確認步驟時觸發

6.12 事件登錄

活動登記清單供參考：

事件登記處名稱	描述
x_hpws_wrkfrcexpdm.hp.dm.failure.notify	觸發通知：Wrkfrc 經驗值整合失敗

6.13 通知電子郵件腳本

通知電子郵件腳本供參考：

通知電子郵件腳本名稱	描述
wrkfrc_exp_dm_failure_notification	此訊息用於顯示通知的電子郵件正文：Wrkfrc Exp Integration Failure
IREConfirmation郵件	發送電子郵件進行 IRE 確認步驟

6.14 系統屬性

系統屬性參考列表：

名稱	描述
x_hpws_wrkfrcexpdm.rec.prod.company	持有唱片製作人 HP WXP 裝置管理公司的 sysid
x_hpws_wrkfrcexpdm.failureNotif_rcrdprdcr	儲存記錄產生者的 sysID：HP Workforce Experience Device Management群組/失敗通知電子郵件
x_hpws_wrkfrcexpdm.hp.dm.application	儲存應用程式的 sysID：HP WXP Device Management
x_hpws_wrkfrcexpdm.api.fastn.device.api.key	HP WXP 裝置管理 API 金鑰
x_hpws_wrkfrcexpdm.relatedlink.page.size	相關連結頁面大小
x_hpws_wrkfrcexpdm.租戶	合夥人/公司的租戶編號
x_hpws_wrkfrcexpdm.company.tenants	公司子女的租戶ID，包括母公司
x_hpws_wrkfrcexpdm.device.fastn.space.id	HP Workforce Experience API 空間識別碼
x_hpws_wrkfrcexpdm.selected.tenants	精選租戶
x_hpws_wrkfrcexpdm.email_notify	持有收到失敗通知的電子郵件地址。
x_hpws_wrkfrcexpdm.batch.size	HP WXP 裝置管理頁面大小
x_hpws_wrkfrcexpdm.device.fastn.api.baseurl	fastn 裝置管理的基礎網址
x_hpws_wrkfrcexpdm.config_complete	顯示 HP WXP 裝置管理應用程式的設定是否已完成
x_hpws_wrkfrcexpdm.sch_job	儲存排程工作的 sys ID
x_hpws_wrkfrcexpdm.count_of_records	關於裝置數量，請參考裝置類型選擇頁面
x_hpws_wrkfrcexpdm.physicalassetdata_computer	儲存要匯入的電腦裝置類型選擇
x_hpws_wrkfrcexpdm.物理資產資料_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.user
電腦	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
應用程式隱私政策	HP Workforce Experience Platform 裝置管理	x_hpws_wrkfrcexpdm.admin
租戶配置	HP 勞動力體驗平台事件管理	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 動作名稱	描述
同步 CI	要同步 CI
會出現藍屏錯誤	顯示與藍幕錯誤相關的 CI 屬性
了解電池風險因素	顯示與電池風險因子相關的CI屬性
取得硬體保固	顯示與硬體保固相關的 CI 屬性
獲得額外屬性	顯示 CI 的額外屬性

注意：這些 UI 動作會以相關連結的形式顯示在cmdb_ci_computer紀錄中。

6.20 商業規則

商業規則列表供參考：

商業規則名稱	描述
correlation_id
HP_WXP_DEVICEAPP_Deactive_Select_Tenant

商業規則名稱

描述

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 實例。

生產實例（Production Instance） — 大多數客戶（應用程式使用者）會存取指定範圍應用程式的環境。
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 體驗平台：支援
1. 點擊 幫助與支援
2. 在電子郵件區塊下點選「請求」

8.3 版本控制策略

應用程式管理員負責判斷哪個版本最適合。管理 HP Workforce 體驗平台裝置管理應用程式的版本可透過以下步驟完成（安裝版本、ServiceNow 儲存應用程式）。

導航至系統應用程式>所有可用應用程式>
使用篩選器或搜尋欄找到 HP Workforce Experience Platform 裝置管理應用程式。
如果有新版本，請選擇新版本。
點擊「更新」。

9. 附錄

附錄部分包含全文中術語與參考文獻的詞彙表。此外，附錄還包含管理 ServiceNow Store 應用程式的文件連結、所需外掛連結，以及 HP Workforce Experience 平台的連結。

9.1 術語詞彙表

以下列出的術語有明確定義，並貫穿全文件。

應用程式管理員： 擁有類似管理員權限的提升權限與權限的使用者，但專門用於作用域應用。應用程式管理員角色包含超出權限的權限。預設可存取作用域應用的所有模組。
應用程式使用者： 使用者的瀏覽權限與權限大致類似於 itil 使用者，但專門針對有範圍的應用程式。預設只能存取有範圍應用程式的特定模組。
HP Workforce Experience Platform Device Management： 應用程式的長名稱。
HP WXP 裝置管理： 應用程式的簡稱。
wrkfrc_exp： 後端項目中應用程式的縮寫名稱。
Fastn.ai： AI 驅動的 API 協調平台，HP Workforce Experience 應用程式將 Proactive Insights 資料連結至 ServiceNow。

9.2 相關資源

聯絡我們

如需任何協助，請建立支援案例或來信至 support@wxp.hp.com。