簡介
HP Workforce Experience 平台（WXP）分析模組中的自訂資料報告，讓客戶能收集標準 WXP Insights 代理無法取得的裝置層級資料。使用者上傳 PowerShell 腳本（以 JSON 格式封裝），在選定的裝置群組間執行，並在 WXP 內產生結構化分析報告。
此功能支援：
基於腳本的評估資料檢索
自訂資料報告建立（每個租戶最多 10 個）
即時進度監控
可點擊KPI儀表板
Excel （XLS） 匯出功能
裝置層級鑽孔
先決條件與進入條件
訂閱需求
客戶必須擁有以下其中一項訂閱：
WXP 專業版試煉
WXP Pro
WXP 精英
基於角色的存取（RBAC）
具備以下角色的使用者可執行腳本並建立或查看自訂資料報告：
資訊管理
合作夥伴服務專員
合作夥伴管理員（授權與非授權入職）
這些角色可以完全使用這個功能。
具有以下角色的使用者可以查看自訂資料報告，但無法執行腳本：
HP 支援管理員
檢舉管理員
這些角色無法使用取消與重新開始的選項。他們可以下載符合資格的報告，但無法啟動或取消工作。其他所有職務都無法使用此功能。
對於合作夥伴角色，必須先選擇客戶租戶，功能才會開放。
自訂資料報告功能中執行的動作會被保留在稽核日誌中。
腳本需求與資料處理
劇本格式
腳本輸出必須以 JSON 格式產生。腳本檔案定義：
腳本元資料
執行性質
可選參數
預期輸出結構
報告中資料顯示的順序
執行時使用 PowerShell，但上傳的產物必須遵循定義的 JSON 包裝格式。
範例
Sample script for reference, to get OS and device information:
sample script for reference:
#Requires -Version 5.1
function Try-Get { param([ScriptBlock]$Block) try { & $Block } catch { $null } }
function Round2 { param([double]$n) return [math]::Round($n, 2) }
# --- Collect Data ---
$os = Try-Get { Get-CimInstance Win32_OperatingSystem }
$comp = Try-Get { Get-CimInstance Win32_ComputerSystem }
$bios = Try-Get { Get-CimInstance Win32_BIOS }
$cpu = Try-Get { Get-CimInstance Win32_Processor | Select-Object -First 1 }
$hostname = $env:COMPUTERNAME
$osName = if ($os) { $os.Caption } else { $null }
$osBuild = Try-Get { (Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion').CurrentBuild }
$mfgr = if ($comp) { $comp.Manufacturer } else { $null }
$model = if ($comp) { $comp.Model } else { $null }
$cpuName = if ($cpu) { $cpu.Name } else { $null }
$ramTotalGB = if ($comp) { Round2($comp.TotalPhysicalMemory / 1GB) } else { $null }
$systemType = if ($comp) { $comp.SystemType } else { $null }
# --- OS Install Date (robust: WMI first, registry fallback) ---
$osInstall = $null
# Try WMI DMTF date
if ($os -and $os.InstallDate -and $os.InstallDate.Length -ge 8) {
try {
$osInstall = [Management.ManagementDateTimeConverter]::ToDateTime($os.InstallDate).ToString('yyyy-MM-dd')
} catch { $osInstall = $null }
}
# Fallback: registry InstallDate (Unix epoch seconds)
if (-not $osInstall) {
try {
$reg = Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion'
if ($reg.InstallDate -and [int]$reg.InstallDate -gt 0) {
$epoch = [datetime]'1970-01-01T00:00:00Z'
$osInstall = ($epoch.AddSeconds([int]$reg.InstallDate)).ToLocalTime().ToString('yyyy-MM-dd')
}
} catch { }
}
# --- Last patch info (non-admin) ---
$lastPatch = $null
$patches = Try-Get { Get-HotFix }
if ($patches) {
$latest = $patches | Sort-Object -Property InstalledOn -Descending | Select-Object -First 1
if ($latest) { $lastPatch = '{0} on {1}' -f $latest.HotFixID, ($latest.InstalledOn.ToString('yyyy-MM-dd')) }
}
# --- Build JSON Object (10 fields) ---
$payload = [pscustomobject]@{
Hostname = $hostname
OSName = $osName
OSBuild = $osBuild
Manufacturer = $mfgr
Model = $model
CPUName = $cpuName
RAMTotalGB = $ramTotalGB
SystemType = $systemType
OSInstallDate = $osInstall
LastPatch = $lastPatch
}
範例報告
JSON 輸出結構（報告限制）
報告僅支援單一層級的 JSON 階層結構。
支援格式範例：
{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}
不支援格式範例：
{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}
若回傳巢狀結構，資料不會以結構化欄位呈現。相反地，它會出現在 StdOut 類別。
註：
URL 處理：腳本輸出中接受 URL。在適用時，網址會以可點擊連結的形式出現在報表檢視中。
翻譯處理：資料以腳本回傳的格式顯示，無需翻譯或修改。
日期與時間處理：腳本輸出中回傳的日期與時間值會完全照回傳顯示。它們不會被轉換或正規化到任何時區。這確保了原始腳本的忠實度，且不會進行後端轉換。
建立自訂資料報告
請依照以下步驟取得標準 WXP Insights 遙測無法取得的裝置資料。
登入 WXP。 首頁 會顯示
從 WXP 左側選單，點選「 分析 」> 「自訂資料報告」。現有的報告會被顯示出來。
點擊 新增。新增 報告 頁面顯示，可選擇或上傳腳本以進行自訂資料收集。
每個腳本會顯示一個 描述、 版本和 操作。
清單會自動篩選以顯示評估腳本。
如果參數已定義，它們會預先填充並可編輯。
選擇聽眾時，請選擇一個或多個團體。向下捲動可計算所選受眾中的裝置總數。
裝置數量顯示所選群組中獨特裝置的數量。
如果裝置屬於多個群組，腳本只會在該裝置上執行一次。
為報告加上標題和可選的描述。
發表劇本。
租戶上限：一個租戶最多可擁有 10 份自訂資料報告。要建立第十一份報告，至少必須刪除一份現有報告。任何擁有報告檢視權限的使用者，都可以存取租戶內所有自訂資料報告，不論是誰建立的。
自訂資料報告清單表
以下欄位顯示：
報告名稱與說明
創作人
誕生日
整體狀況
進行中
已完成（腳本執行開始後最長24小時內）
已過期
取消
出口
刪除
適用以下驗證規則：
不允許大量刪除。
不允許大量出口。
狀態為「進行中」的報告無法刪除。
狀態為「已完成」、「取消」或「過期」的報告可能會被刪除。
可下載狀態為進行中、已完成或取消的報告。
過期報告無法下載。
隱私與安全
IT 管理員（首次使用單位租戶）
當 IT 管理員首次在租戶內建立自訂資料報告時，必須接受這些條款。這個確認只會顯示一次，且只顯示給該租戶的第一位 IT 管理員。後續的 IT 管理員不會被提示。
合作夥伴管理員或服務專員
當使用者代表客戶建立自訂資料報告時，必須在每個客戶租戶中接受一次條款。可接受的是每租戶的追蹤器。
檢視與監控自訂資料報告
每個自訂資料報告顯示以下內容：
報告名稱與說明
劇本名稱（連結）
受眾定義
裝置總數
開始日期與時間
完工日期與時間
有效期限
報告狀態
進行中
完成
取消
已過期
下載選項
刪除選項（如果符合條件）
註：劇本只會播一次。它並非連續播出或定期播出。不過，使用者可以在需要時執行。
進度條
進度條顯示以下內容：
完成的裝置
錯誤裝置
未處理裝置
總觀眾數
取消報告
只有當狀態為進行中時，才能取消報告。取消時：
狀態更新為取消。
舉報頁面會顯示取消的使用者及取消時間。
隨後不久會出現 重新啟動 選項。
重新啟動報告
你可以重新啟動處於以下狀態的報告：
完成
取消
已過期
行為：
所有原始裝置都會重啟。
歷史資料會被刪除。
劇本、參數和觀眾群都無法修改。
若團體成員變動，受眾可能會有所不同。
到期規則
自訂資料報告在腳本執行開始後11天（24小時完成時間加上10天保留期限）到期，若未超過24小時，則在所有裝置顯示已完成或錯誤狀態後10天內失效。
如果報告被取消，則在取消後10天內失效。
過期報告：
無法下載。
裝置頁面的資料會被移除。
檢視已發表的自訂資料報告
報告中可點擊的KPI
KPI 會根據裝置狀態顯示：
進行中
完成
錯誤
未處理
行為：
KPI 不會受到表格篩選的影響。
點擊 KPI 會套用表格篩選器。
允許多重選擇的關鍵績效指標篩選器。
過濾器會保留在每個分片中，直到移除。
篩選器不會在內容與細節分頁間轉移。
查看內容標籤
內容標籤只顯示已完成的裝置。
預設排序是根據序號來決定的。
以下欄位會顯示出來。
裝置序號（連結至相關裝置詳情頁面）
裝置名稱
每個資料元素一欄
變更會傳到裝置詳情頁面
產出（標準）
開賽時間
若未回傳資料，則會顯示訊息引導使用者至 「詳情 」標籤。
查看詳情標籤
詳細資料標籤會顯示受眾中所有已定義的裝置，不論狀態如何。此分頁主要用於排除狀態 非完成的裝置故障。
以下是預設的排序順序：
錯誤
進行中
未處理
完成
以下欄位顯示：
裝置序號
裝置名稱
最後登入使用者
腳本退出代碼
輸出（連結至標準出軌或錯誤檢視）
匯出自訂資料報告
使用者可以匯出篩選結果後的 Excel（XLS）檔案，該檔案包含兩個分頁：
內容
詳情
您可以匯出以下狀態的報告：
進行中
完成
取消
注意：匯出資料無法用於過期報告。
存取裝置詳情頁面
您可以點擊自訂資料報告內容或詳情標籤中列出的任何序號，開啟對應的裝置詳細資料頁面。這提供了一種方便的方式，讓該裝置能集中查看所有收集的自訂資料，提升故障排除效率。
自訂資料標籤包括：
自訂資料報告連結
每個擷取的資料元素與值
報告到期日
現況
劇本名稱
腳本退出代碼
輸出連結
下載 XLS 選項
過期的資料無法顯示。
注意：關於已完成、取消或過期的報告：
如果腳本被刪除或所有群組都被刪除，顯示的行動呼籲是 「創建」。
如果該腳本和至少一個群組仍然存在，顯示的行動呼籲是「 重新啟動」。
善用自訂資料報告 API
如需更多資訊，請參閱我們的開發者入口網站文件，介紹允許用戶查詢自訂資料報告的 API： https://developers.workforceexperience.hp.com/docs/v1/customdatareport
聯絡我們
如需協助，請 建立支援案件 或電子郵件 support@wxp.hp.com。