소개
HP Workforce Experience 플랫폼(WXP)의 분석 모듈 내 맞춤형 데이터 보고서를 통해 고객은 표준 WXP Insights 에이전트를 통해 제공되지 않는 장치 수준 데이터를 수집할 수 있습니다. 사용자는 JSON 형식으로 포장된 PowerShell 스크립트를 업로드하고, 선택한 장치 그룹에서 실행하며, WXP 내에서 구조화된 분석 보고서를 생성합니다.
이 기능은 다음을 지원합니다:
스크립트 기반 평가 데이터 검색
사용자 지정 데이터 보고서 생성 (테넌트당 최대 10개)
실시간 진행 상황 모니터링
클릭 가능한 KPI 대시보드
엑셀(XLS) 내보내기 기능
장치 수준 드릴다운
전제 조건 및 접근
구독 요건
고객은 다음 구독 중 하나를 보유해야 합니다:
WXP 프로 체험판
WXP 프로
WXP 엘리트
역할 기반 접근(RBAC)
다음 역할을 가진 사용자는 스크립트를 실행하고 사용자 지정 데이터 보고서를 생성하거나 볼 수 있습니다:
IT 관리자
파트너 서비스 전문가
파트너 관리자(인가된 인가자와 비인가의 온보딩)
이 역할들은 이 기능에 완전한 접근 권한을 가집니다.
다음 역할을 가진 사용자는 사용자 지정 데이터 보고서를 볼 수 있지만 스크립트를 실행할 수는 없습니다:
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이 허용됩니다. 해당 시 URL은 보고 뷰에서 클릭 가능한 링크로 나타납니다.
번역 처리: 데이터는 스크립트가 반환하는 동일한 형식으로 변환이나 수정 없이 표시됩니다.
날짜 및 시간 처리: 스크립트 출력의 일부로 반환된 날짜와 시간 값은 반환된 그대로 표시됩니다. 이 번호들은 어떤 시간대에도 변환되거나 정규화되지 않습니다. 이로 인해 백엔드 변환 없이 원시 스크립트 충실도를 보장합니다.
사용자 지정 데이터 보고서 생성
표준 WXP Insights 텔레메트리로 제공되지 않는 장치 데이터를 가져오기 위해 다음 단계를 따르세요.
WXP에 로그인하세요. 홈 페이지가 표시됩니다
WXP의 왼쪽 메뉴에서 Analytics > Custom Data Reports를 클릭하세요. 기존 보고서가 표시됩니다.
추가를 클릭하세요. 보고서 추가(Add Report page) 페이지는 사용자 지정 데이터 수집을 위한 스크립트를 선택하거나 업로드할 수 있도록 표시됩니다.
각 스크립트는 설명, 버전, 그리고 연산을 표시합니다.
목록은 자동으로 평가 스크립트를 표시하도록 필터링됩니다.
매개변수가 정의되어 있다면, 미리 채워져 있고 편집 가능합니다.
한 개 이상의 그룹을 선택하여 청중을 선택하세요. 아래로 스크롤하여 선택한 대상의 총 기기 수를 계산하세요.
장치 수는 선택된 그룹 내 고유 장치 수를 나타냅니다.
장치가 여러 그룹에 속해 있다면, 스크립트는 해당 장치에서 한 번만 실행됩니다.
보고서에 제목과 선택적 설명을 추가하세요.
대본을 출판하세요.
임차인 한도: 한 임차인은 최대 10개의 맞춤형 데이터 보고서를 가질 수 있습니다. 열한 번째 보고서를 생성하려면 최소 하나의 기존 보고서를 삭제해야 합니다. 보고서 열람 권한이 있는 모든 사용자는 테넌트 내 모든 사용자 지정 데이터 보고서에 접근할 수 있으며, 누가 만들었든 상관없습니다.
사용자 지정 데이터 보고서 목록 표
다음 열들이 표시되어 있습니다:
보고서 이름 및 설명
제작자
창조된 지
전반적인 현황
진행 중
완료 (스크립트 실행 시작 후 최대 24시간 이내)
만료
취소됨
수출
삭제
다음과 같은 검증 규칙이 적용됩니다:
대량 삭제는 허용되지 않습니다.
대량 수출은 허용되지 않습니다.
"진행 중"이라는 상태의 보고서는 삭제할 수 없습니다.
완료, 취소, 만료 상태가 된 신고는 삭제될 수 있습니다.
진행 중, 완료, 취소 상태의 보고서를 다운로드할 수 있습니다.
만료된 보고서는 다운로드할 수 없습니다.
프라이버시와 보안
IT 관리자 (테넌트별 첫 사용
IT 관리자가 테넌트 내에서 처음으로 사용자 지정 데이터 보고서를 생성할 때는 약관을 수락해야 합니다. 이 확인은 해당 테넌트의 첫 번째 IT 관리자에게만 한 번만 표시됩니다. 이후 IT 관리자는 알림을 받지 않습니다.
파트너 관리자 또는 서비스 전문가
고객을 대신해 사용자 지정 데이터 보고서를 생성할 때, 사용자는 각 고객 테넌트당 한 번씩 약관에 동의해야 합니다. 허용되는 것은 세입자별 추적기입니다.
맞춤형 데이터 보고서 보기 및 모니터링
각 사용자 지정 데이터 보고서는 다음과 같은 내용을 보여줍니다:
보고서 이름 및 설명
스크립트 이름 (링크됨)
청중 정의
총 장치 수
시작 일과 시간
완공일과 시간
만료일
보고서 현황
진행 중
완성됨
취소됨
만료
다운로드 옵션
삭제 옵션(자격이 될 경우)
참고: 대본은 한 번만 진행됩니다. 이 프로그램은 연속적이거나 정기 일정으로 운영되지 않습니다. 하지만 사용자는 필요할 때마다 실행할 수 있습니다.
프로그레스 바
진행 바는 다음과 같이 표시됩니다:
완성된 장치
오류 장치
처리되지 않은 기기
총 관객
신고 취소하기
신고는 진행 중일 때만 취소할 수 있습니다. 취소 시:
상태 업데이트는 취소됨.
신고 페이지에는 취소한 사용자와 취소 시각이 표시됩니다.
곧이어 재시작 옵션이 나타납니다.
보고서 재시작
다음 상태의 보고서를 다시 시작할 수 있습니다:
완성됨
취소됨
만료
행동:
원래 기기에서 모두 재시작됩니다.
과거 데이터는 삭제됩니다.
대본, 매개변수, 관객은 변경할 수 없습니다.
그룹 구성원이 변경되면 청중이 다를 수 있습니다.
만료 규칙
커스텀 데이터 리포트는 스크립트 실행 시작 후 11일(완료 기간 및 10일 유지 기간) 또는 모든 장치가 완료 또는 오류 상태로 표시된 후 10일 이내에 만료됩니다.
보고서가 취소되면 취소 후 10일 후에 만료됩니다.
만료된 보고서들:
다운로드할 수 없습니다.
기기 페이지에서 데이터가 제거됩니다.
게시된 맞춤 데이터 보고서 보기
보고서에서 클릭 가능한 KPI
KPI는 장치 상태를 기반으로 표시됩니다:
진행 중
완성됨
오류
처리 안 됨
행동:
KPI는 테이블 필터링의 영향을 받지 않습니다.
KPI를 클릭하면 테이블 필터가 적용됩니다.
다중 선택 KPI 필터가 허용됩니다.
필터는 제거될 때까지 탭당 유지됩니다.
필터는 콘텐츠와 세부 정보 탭 간에 전송되지 않습니다.
콘텐츠 탭 보기
콘텐츠 탭에는 완료 상태인 장치만 표시됩니다.
기본 정렬은 일련번호를 기준으로 합니다.
다음 열들이 표시됩니다.
장치 일련번호 (해당 장치 상세 페이지에 링크됨)
장치 이름
데이터 요소당 한 열
변경 사항은 장치 상세 페이지로 전파됩니다
출력 (표준)
시작 시간
데이터가 반환되지 않으면 사용자가 '상세 정보 ' 탭으로 이동하도록 안내하는 메시지가 표시됩니다.
상세 정보 탭 보기
상세 정보 탭에서는 상태와 상관없이 청중에 정의된 모든 기기가 표시됩니다. 이 탭은 주로 완료 이외 의 상태인 기기를 문제 해결하는 데 사용됩니다.
기본 정렬 순서는 다음과 같습니다:
오류
진행 중
처리 안 됨
완성됨
다음 열들이 표시되어 있습니다:
장치 일련번호
장치 이름
마지막 로그인 사용자
스크립트 종료 코드
출력 (StdOut 또는 오류 뷰 링크)
사용자 지정 데이터 보고서 내보내기
사용자는 필터링된 결과가 두 개의 탭을 포함하는 엑셀(XLS) 파일로 내보낼 수 있습니다:
내용
세부 사항
다음과 같은 상태로 보고서를 내보낼 수 있습니다:
진행 중
완성됨
취소됨
참고: 만료된 보고서에는 내보내기가 불가합니다.
장치 세부 정보 페이지 접근
사용자 지정 데이터 보고서의 콘텐츠 또는 세부 정보 탭에 나열된 일련번호를 클릭하면 해당 장치 상세 정보를 열 수 있습니다. 이로 인해 해당 기기에서 수집된 모든 맞춤형 데이터를 중앙 집중식으로 볼 수 있어 문제 해결이 더욱 효율적입니다.
커스텀 데이터 탭에는 다음이 포함됩니다:
사용자 지정 데이터 보고서 링크
각 캡처된 데이터 요소와 값
신고 만료일
현황
스크립트 이름
스크립트 종료 코드
출력 링크
XLS 다운로드 옵션
만료된 데이터는 보이지 않습니다.
참고: 완료, 취소 또는 만료된 보고서에 대해:
스크립트가 삭제되거나 모든 그룹이 삭제되면, 표시되는 행동 요청은 '생성(Create)'입니다.
스크립트와 적어도 한 그룹이 아직 존재한다면, 표시되는 행동 호출은 재시작(Restart)입니다.
맞춤형 데이터 보고서 API 활용
추가 정보는 고객이 맞춤 데이터 보고서를 조회할 수 있도록 하는 API에 관한 개발자 포털 문서를 참고하세요: https://developers.workforceexperience.hp.com/docs/v1/customdatareport
문의하기
도움이 필요하시면 지원 케이스 나 이메일을 support@wxp.hp.com작성해 주세요.