--- title: "사용자 지정 데이터 보고서" slug: "custom-data-reports" updated: 2026-03-18T16:39:51Z published: 2026-03-18T16:40:40Z canonical: "learn.workforceexperience.hp.com/custom-data-reports" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt > Use this file to discover all available pages before exploring further. # 사용자 지정 데이터 보고서 ## 소개 HP Workforce Experience 플랫폼(WXP)의 **분석** 모듈 내 **맞춤형 데이터 보고서를** 통해 고객은 표준 WXP Insights 에이전트를 통해 제공되지 않는 장치 수준 데이터를 수집할 수 있습니다. 사용자는 JSON 형식으로 포장된 PowerShell 스크립트를 업로드하고, 선택한 장치 그룹에서 실행하며, WXP 내에서 구조화된 분석 보고서를 생성합니다. 이 기능은 다음을 지원합니다: - 스크립트 기반 평가 데이터 검색 - 사용자 지정 데이터 보고서 생성 (테넌트당 최대 10개) - 실시간 진행 상황 모니터링 - 클릭 가능한 KPI 대시보드 - 엑셀(XLS) 내보내기 기능 - 장치 수준 드릴다운 ### 전제 조건 및 접근 #### 구독 요건 고객은 다음 구독 중 하나를 보유해야 합니다: - WXP 프로 체험판 - WXP 프로 - WXP 엘리트 #### 역할 기반 접근(RBAC) 다음 역할을 가진 사용자는 스크립트를 실행하고 사용자 지정 데이터 보고서를 생성하거나 볼 수 있습니다: - IT 관리자 - 파트너 서비스 전문가 - 파트너 관리자(인가된 인가자와 비인가의 온보딩) 이 역할들은 이 기능에 완전한 접근 권한을 가집니다. 다음 역할을 가진 사용자는 사용자 지정 데이터 보고서를 볼 수 있지만 스크립트를 실행할 수는 없습니다: - HP 지원 관리자 - 관리자 신고 이 역할들에는 취소 및 재시작 옵션이 제공되지 않습니다. 적격 보고서를 다운로드할 수는 있지만, 작업을 시작하거나 취소할 수는 없습니다. 다른 모든 역할은 이 기능을 이용할 수 없습니다. 파트너 역할의 경우, 기능이 제공되기 전에 고객 테넌트를 선택해야 합니다. 사용자 지정 데이터 보고서 기능에서 수행된 작업은 감사 로그에 유지됩니다. 1. ### 스크립트 요구사항 및 데이터 처리 #### 스크립트 형식 스크립트 출력은 JSON 형식으로 생성되어야 합니다. 스크립트 파일은 다음과 같이 정의합니다: - 스크립트 메타데이터 - 실행 특성 - 선택 매개변수 - 기대 출력 스키마 - 보고서에서 데이터가 표시되는 순서 실행에는 PowerShell이 사용되지만, 업로드된 산출물은 정의된 JSON 래퍼 형식을 따라야 합니다. #### 예시 ```plaintext 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 } ``` #### 샘플 보고서 ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/image-WD0Z1WVW.png?sv=2026-02-06&spr=https&st=2026-11-19T16%3A39%3A50Z&se=2026-11-19T17%3A39%3A50Z&sr=b&sp=r&sig=PCiaVZuSWKKhHv%2BUywYqZl31rNwZW2SjLDTXMSCmq6M%3D) #### JSON 출력 구조 (보고 제한) 리포팅은 단일 수준의 JSON 계층 구조만 지원합니다. **지원되는 형식의 예시:** ```plaintext { "BIOSVersion": "1.23.4", "ThinkCellEnabled": "True", "AIExtensionDetected": "Yes" } ``` **지원되지 않는 형식의 예:** ```plaintext { "Device": { "BIOS": { "Version": "1.23.4" } } } ``` 중첩된 구조가 반환되면 데이터는 구조화된 열로 렌더링되지 않습니다. 대신 StdOut 항목에 표시됩니다. > **참고**: > > - **URL 처리:** 스크립트 출력에서 URL이 허용됩니다. 해당 시 URL은 보고 뷰에서 클릭 가능한 링크로 나타납니다. > - **번역 처리**: 데이터는 스크립트가 반환하는 동일한 형식으로 변환이나 수정 없이 표시됩니다. > - **날짜 및 시간 처리**: 스크립트 출력의 일부로 반환된 날짜와 시간 값은 반환된 그대로 표시됩니다. 이 번호들은 어떤 시간대에도 변환되거나 정규화되지 않습니다. 이로 인해 백엔드 변환 없이 원시 스크립트 충실도를 보장합니다. 1. ### 사용자 지정 데이터 보고서 생성 표준 WXP Insights 텔레메트리로 제공되지 않는 장치 데이터를 가져오기 위해 다음 단계를 따르세요. 1. WXP에 로그인하세요. **홈** 페이지가 표시됩니다 2. WXP의 왼쪽 메뉴에서 **Analytics** > **Custom Data Reports**를 클릭하세요. 기존 보고서가 표시됩니다. 3. **추가를** 클릭하세요. **보고서 추가(Add Report** page) 페이지는 사용자 지정 데이터 수집을 위한 스크립트를 선택하거나 업로드할 수 있도록 표시됩니다. 4. 각 스크립트는 **설명**, **버전**, **그리고 연산**을 표시합니다. 1. 목록은 자동으로 평가 스크립트를 표시하도록 필터링됩니다. 5. 매개변수가 정의되어 있다면, 미리 채워져 있고 편집 가능합니다. 6. 한 개 이상의 그룹을 선택하여 청중을 선택하세요. 아래로 스크롤하여 선택한 대상의 총 기기 수를 계산하세요. 1. 장치 수는 선택된 그룹 내 고유 장치 수를 나타냅니다. 2. 장치가 여러 그룹에 속해 있다면, 스크립트는 해당 장치에서 한 번만 실행됩니다. 7. 보고서에 제목과 선택적 설명을 추가하세요. 8. 대본을 출판하세요. > **임차인 한도**: 한 임차인은 최대 10개의 맞춤형 데이터 보고서를 가질 수 있습니다. 열한 번째 보고서를 생성하려면 최소 하나의 기존 보고서를 삭제해야 합니다. 보고서 열람 권한이 있는 모든 사용자는 테넌트 내 모든 사용자 지정 데이터 보고서에 접근할 수 있으며, 누가 만들었든 상관없습니다. 1. ### 사용자 지정 데이터 보고서 목록 표 다음 열들이 표시되어 있습니다: - 보고서 이름 및 설명 - 제작자 - 창조된 지 - 전반적인 현황 - 진행 중 - 완료 (스크립트 실행 시작 후 최대 24시간 이내) - 만료 - 취소됨 - 수출 - 삭제 다음과 같은 검증 규칙이 적용됩니다: - 대량 삭제는 허용되지 않습니다. - 대량 수출은 허용되지 않습니다. - "진행 중"이라는 상태의 보고서는 삭제할 수 없습니다. - 완료, 취소, 만료 상태가 된 신고는 삭제될 수 있습니다. - 진행 중, 완료, 취소 상태의 보고서를 다운로드할 수 있습니다. - 만료된 보고서는 다운로드할 수 없습니다. 1. ### 프라이버시와 보안 #### IT 관리자 (테넌트별 첫 사용 IT 관리자가 테넌트 내에서 처음으로 사용자 지정 데이터 보고서를 생성할 때는 약관을 수락해야 합니다. 이 확인은 해당 테넌트의 첫 번째 IT 관리자에게만 한 번만 표시됩니다. 이후 IT 관리자는 알림을 받지 않습니다. #### 파트너 관리자 또는 서비스 전문가 고객을 대신해 사용자 지정 데이터 보고서를 생성할 때, 사용자는 각 고객 테넌트당 한 번씩 약관에 동의해야 합니다. 허용되는 것은 세입자별 추적기입니다. 1. ### 맞춤형 데이터 보고서 보기 및 모니터링 각 사용자 지정 데이터 보고서는 다음과 같은 내용을 보여줍니다: - 보고서 이름 및 설명 - 스크립트 이름 (링크됨) - 청중 정의 - 총 장치 수 - 시작 일과 시간 - 완공일과 시간 - 만료일 - 보고서 현황 - 진행 중 - 완성됨 - 취소됨 - 만료 - 다운로드 옵션 - 삭제 옵션(자격이 될 경우) > **참고**: 대본은 한 번만 진행됩니다. 이 프로그램은 연속적이거나 정기 일정으로 운영되지 않습니다. 하지만 사용자는 필요할 때마다 실행할 수 있습니다. #### 프로그레스 바 진행 바는 다음과 같이 표시됩니다: - 완성된 장치 - 오류 장치 - 처리되지 않은 기기 - 총 관객 ### 신고 취소하기 신고는 진행 중일 때만 취소할 수 있습니다. 취소 시: - 상태 업데이트는 취소됨. - 신고 페이지에는 취소한 사용자와 취소 시각이 표시됩니다. - 곧이어 **재시작** 옵션이 나타납니다. ### 보고서 재시작 다음 상태의 보고서를 다시 시작할 수 있습니다: - 완성됨 - 취소됨 - 만료 **행동:** - 원래 기기에서 모두 재시작됩니다. - 과거 데이터는 삭제됩니다. - 대본, 매개변수, 관객은 변경할 수 없습니다. - 그룹 구성원이 변경되면 청중이 다를 수 있습니다. 1. ### 만료 규칙 커스텀 데이터 리포트는 스크립트 실행 시작 후 11일(완료 기간 및 10일 유지 기간) 또는 모든 장치가 완료 또는 오류 상태로 표시된 후 10일 이내에 만료됩니다. 보고서가 취소되면 취소 후 10일 후에 만료됩니다. > **만료된 보고서들**: > > - 다운로드할 수 없습니다. > - 기기 페이지에서 데이터가 제거됩니다. 1. ### 게시된 맞춤 데이터 보고서 보기 #### 보고서에서 클릭 가능한 KPI KPI는 장치 상태를 기반으로 표시됩니다: - 진행 중 - 완성됨 - 오류 - 처리 안 됨 **행동:** - KPI는 테이블 필터링의 영향을 받지 않습니다. - KPI를 클릭하면 테이블 필터가 적용됩니다. - 다중 선택 KPI 필터가 허용됩니다. - 필터는 제거될 때까지 탭당 유지됩니다. - 필터는 콘텐츠와 세부 정보 탭 간에 전송되지 않습니다. #### 콘텐츠 탭 보기 **콘텐츠** 탭에는 완료 상태인 장치만 표시됩니다. 기본 정렬은 일련번호를 기준으로 합니다. 다음 열들이 표시됩니다. - 장치 일련번호 (해당 장치 상세 페이지에 링크됨) - 장치 이름 - 데이터 요소당 한 열 - 변경 사항은 장치 상세 페이지로 전파됩니다 - 출력 (표준) - 시작 시간 데이터가 반환되지 않으면 사용자가 **'상세 정보** ' 탭으로 이동하도록 안내하는 메시지가 표시됩니다. #### 상세 정보 탭 보기 **상세** 정보 탭에서는 상태와 상관없이 청중에 정의된 모든 기기가 표시됩니다. 이 탭은 주로 완료 이외 의 상태인 기기를 문제 해결하는 데 사용됩니다. 기본 정렬 순서는 다음과 같습니다: 1. 오류 2. 진행 중 3. 처리 안 됨 4. 완성됨 다음 열들이 표시되어 있습니다: - 장치 일련번호 - 장치 이름 - 마지막 로그인 사용자 - 스크립트 종료 코드 - 출력 (StdOut 또는 오류 뷰 링크) 1. ### 사용자 지정 데이터 보고서 내보내기 사용자는 필터링된 결과가 두 개의 탭을 포함하는 엑셀(XLS) 파일로 내보낼 수 있습니다: - 내용 - 세부 사항 다음과 같은 상태로 보고서를 내보낼 수 있습니다: - 진행 중 - 완성됨 - 취소됨 > **참고**: 만료된 보고서에는 내보내기가 불가합니다. 1. ### 장치 세부 정보 페이지 접근 사용자 지정 데이터 보고서의 **콘텐츠** 또는 **세부 정보** 탭에 나열된 일련번호를 클릭하면 해당 장치 상세 정보를 열 수 있습니다. 이로 인해 해당 기기에서 수집된 모든 맞춤형 데이터를 중앙 집중식으로 볼 수 있어 문제 해결이 더욱 효율적입니다. **커스텀 데이터** 탭에는 다음이 포함됩니다: - 사용자 지정 데이터 보고서 링크 - 각 캡처된 데이터 요소와 값 - 신고 만료일 - 현황 - 스크립트 이름 - 스크립트 종료 코드 - 출력 링크 - XLS 다운로드 옵션 만료된 데이터는 보이지 않습니다. > **참고**: 완료, 취소 또는 만료된 보고서에 대해: > > - 스크립트가 삭제되거나 모든 그룹이 삭제되면, 표시되는 행동 요청은 **'생성(Create**)'입니다. > - 스크립트와 적어도 한 그룹이 아직 존재한다면, 표시되는 행동 호출은 **재시작(Restart**)입니다. 1. ### 맞춤형 데이터 보고서 API 활용 추가 정보는 고객이 맞춤 데이터 보고서를 조회할 수 있도록 하는 API에 관한 개발자 포털 문서를 참고하세요: [https://developers.workforceexperience.hp.com/docs/v1/customdatareport](https://developers.workforceexperience.hp.com/docs/v1/customdatareport) ### 문의하기 도움이 필요하시면 [지원 케이스](https://learn.workforceexperience.hp.com/docs/ko/creating-a-support-case) 나 이메일을 `support@wxp.hp.com`작성해 주세요.