Brugerdefinerede datarapporter

Indførelsen

Brugerdefinerede datarapporter i analysemodulet på HP Workforce Experience-platformen (WXP) gør det muligt for kunder at indsamle data på enhedsniveau, som ikke er tilgængelige via den standard WXP Insights-agent. Brugere uploader PowerShell-scripts (pakket i JSON-format), udfører dem på tværs af udvalgte enhedsgrupper og genererer strukturerede analyserapporter i WXP.

Denne funktion understøtter:

• Scriptbaseret evalueringsdatahentning

• Oprettelse af brugerdefineret datarapport (maksimalt 10 pr. lejer)

• Overvågning af fremskridt i realtid

• Klikbart KPI-dashboard

• Excel (XLS) eksportmuligheder

• Enhedsniveau drilldowns

Forudsætninger og adgang

Abonnementskrav

Kunder skal have et af følgende abonnementer:

• WXP Pro Trial

• WXP Pro

• WXP Elite

Rollebaseret adgang (RBAC)

Brugere med følgende roller kan køre scripts og oprette eller se brugerdefinerede datarapporter:

• IT-administration

• Partner Service Specialist

• Partneradministrator (autoriseret og ikke-autoriseret onboardet)

Disse roller har fuld adgang til funktionen.

Brugere med følgende roller kan se brugerdefinerede datarapporter, men kan ikke køre scripts:

• HP Support Admin

• Rapportadministration

For disse roller er Annuller og Genstart ikke tilgængelige. De kan downloade berettigede rapporter, men kan ikke igangsætte eller annullere jobs. Alle andre roller har ikke adgang til denne funktion.

For partnerroller skal en kundelejer vælges, før funktionalitet bliver tilgængelig.

Handlinger udført i funktionen Custom Data Reports gemmes i revisionslogfiler.

1. Scriptkrav og datahåndtering

Manuskriptformat

Scriptoutput skal genereres i JSON-format. Scriptfilen definerer:

• Scriptmetadata

• Udførelsesegenskaber

• Valgfrie parametre

• Forventet outputskema

• Rækkefølgen, hvori data vises i rapporten

PowerShell bruges til eksekvering, men det uploadede artefakt skal følge det definerede JSON-wrapper-format.

Eksempel

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
 }

Eksempelrapport

JSON outputstruktur (rapporteringsbegrænsning)

Rapportering understøtter kun et enkelt-niveau JSON-hierarki.

Eksempel på understøttet format:

{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}

Eksempel på et ikke-understøttet format:

{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}

Hvis indlejrede strukturer returneres, vises dataene ikke i strukturerede kolonner. I stedet optræder den under StdOut.

Bemærk:

• URL-håndtering: URL'er accepteres i scriptoutput. URL'er vises som klikbare links i rapporteringsvisninger, hvor det er relevant.

• Oversættelseshåndtering: Data vises i samme format, som scriptet returnerer uden oversættelse eller ændring.

• Håndtering af dato og tid: Dato- og tidsværdier, der returneres som en del af scriptoutputtet, vises præcis som returneret. De er ikke konverteret eller normaliseret til nogen tidszone. Dette sikrer rå script-nøjagtighed uden backend-transformation.

2. Oprettelse af en brugerdefineret datarapport

Følg disse trin for at hente enhedsdata, som ikke er tilgængelige via standard WXP Insights-telemetri.

1. Log ind på WXP. Forsiden vises

2. Fra venstre menu i WXP klikker du på Analytics > Custom Data Reports. De eksisterende rapporter vises.

3. Klik på Tilføj dem. Tilføje-rapportsiden vises for at vælge eller uploade et script til brugerdefineret dataindsamling.

4. Hvert script viser en beskrivelse, version og operation.

   1. Listen filtreres automatisk for at vise evalueringsscripts.

5. Hvis parametrene var definerede, er de forudfyldte og kan redigeres.

6. Vælg målgruppen ved at vælge en eller flere grupper. Scroll ned for at beregne det samlede antal enheder i den valgte målgruppe.

   1. Enhedsantallet viser antallet af unikke enheder på tværs af de valgte grupper.

   2. Hvis en enhed tilhører flere grupper, kører scriptet kun én gang på den enhed.

7. Tilføj en titel og valgfri beskrivelse til rapporten.

8. Udgiv manuskriptet.

Lejergrænse: En lejer kan have op til 10 brugerdefinerede datarapporter. For at oprette en ellevte rapport skal mindst én eksisterende rapport slettes. Enhver bruger med tilladelser til at vise rapporter kan få adgang til alle Custom Data Reports inden for lejeren, uanset hvem der har oprettet dem.

3. Listetabel for brugerdefinerede datarapporter

Følgende kolonner vises:

• Rapportens navn og beskrivelse

• Oprettet af

• Oprettet på

• Samlet status

  • Under udvikling

  • Fuldført (maksimalt 24 timer efter scriptudførelse starter)

  • Udløbet

  • Aflyst

• Eksport

• Slet

Følgende valideringsregler gælder:

• Massesletning er ikke tilladt.

• Bulk-eksport er ikke tilladt.

• En rapport med status "Under behandling" kan ikke slettes.

• Rapporter med status Fuldført, Annulleret eller Udløbet kan slettes.

• Rapporter med status som Igangværende, Afsluttet eller Annulleret kan downloades.

• Udløbne rapporter kan ikke downloades.

3. Privatliv og sikkerhed

IT-administration (Første brug pr. lejer)

Når en IT-administrator opretter en Custom Data Report for første gang inden for en lejer, skal de acceptere betingelserne. Denne bekræftelse vises kun én gang og kun til den første IT-administrator i den pågældende lejer. Efterfølgende IT-administratorer bliver ikke bedt om det.

Partneradministrator eller servicespecialist

Når brugeren opretter en brugerdefineret datarapport på vegne af en kunde, skal brugeren acceptere vilkårene én gang pr. kundelejer. Det acceptable er tracker pr. lejer.

4. Visning og overvågning af en tilpasset datarapport

Hver Custom Data Report viser følgende:

• Rapportens navn og beskrivelse

• Scriptnavn (linket)

• Målgruppedefinition

• Samlet antal enheder

• Startdato og -tidspunkt

• Færdiggørelsesdato og -tidspunkt

• Udløbsdato

• Rapportstatus

  • Under udvikling

  • Færdiggjort

  • Aflyst

  • Udløbet

• Downloadmulighed

• Slet-mulighed (hvis berettiget)

Bemærk: Manuskriptet kører én gang. Den kører ikke kontinuerligt eller på en gentagen tidsplan. Dog kan brugere køre det, når det er nødvendigt.

Fremgangsbar

Fremdriftsbjælken viser følgende:

• Færdige enheder

• Fejlbehæftede enheder

• Ikke-behandlede enheder

• Samlet publikum

Annullering af en rapport

Du kan kun annullere en rapport, når status er i gang. Ved aflysning:

• Status opdateres til Annulleret.

• Rapportsiden viser brugeren, der annullerede, og tidspunktet for annulleringen.

• Genstart-muligheden dukker op kort efter.

Genstart af en rapport

Du kan genstarte en rapport, der er i følgende status:

• Færdiggjort

• Aflyst

• Udløbet

Adfærd:

• Genstarter på alle originale enheder.

• Historiske data slettes.

• Manuskript, parametre og målgruppe kan ikke ændres.

• Publikum kan variere, hvis gruppemedlemskabet har ændret sig.

5. Udløbsregler

En Custom Data Report udløber 11 dage efter script-eksekveringen (24-timers fuldførelsesvindue plus 10 dages opbevaring) eller 10 dage efter at alle enheder viser status Fuldført eller Fejlbehandlet, hvis de er under 24 timer.

Hvis rapporten annulleres, udløber den 10 dage efter annulleringen.

De udløbne rapporter:

• Kan ikke downloades.

• Data fjernes fra enhedssider.

6. Visning af offentliggjort brugerdefineret datarapport

Klikbare KPI'er på rapporten

KPI'er vises baseret på enhedens status:

• Under udvikling

• Færdiggjort

• Fejlagtig

• Ikke behandlet

Adfærd:

• KPI'er påvirkes ikke af tabelfiltrering.

• Ved at klikke på en KPI aktiveres et tabelfilter.

• Multi-select KPI-filtre er tilladt.

• Filtre bevares pr. fane, indtil de fjernes.

• Filtre overføres ikke mellem fanerne Indhold og Detaljer.

Visning af Indholdsfanen

Indholdsfanen viser kun enheder med Status Fuldført.

Standardsorteringen er baseret på serienummeret.

Følgende kolonner vises.

• Enhedsserienummer (linket til den respektive enhedsdetaljeside)

• Enhedsnavn

• Én kolonne pr. dataelement

  • Ændringer overføres til enhedsdetaljesiden

• Output (StdOut)

• Starttid

Hvis ingen data returneres, vises beskeden, der henviser brugeren til fanen Detaljer .

Visning af fanen Detaljerne

Dette er standardsorteringsrækkefølgen:

1. Fejl

2. Under udvikling

3. Ikke behandlet

4. Færdiggjort

Følgende kolonner vises:

• Enhedsserienummer

• Enhedsnavn

• Sidst indlogget bruger

• Script Exit Code

• Output (link til StdOut eller fejlvisning)

7. Eksport af en tilpasset datarapport

Brugere kan eksportere filtrerede resultater til en Excel (XLS)-fil, som indeholder to faner:

• Indhold

• Detaljer

Du kan eksportere rapporter i følgende statusser:

• Under udvikling

• Færdiggjort

• Aflyst

Bemærk: Eksport er ikke tilgængelig for udløbne rapporter.

8. Adgang til enhedsdetaljer

Du kan åbne den tilsvarende side med enhedsdetaljer ved at klikke på et hvilket som helst serienummer, der er angivet under fanen Indhold eller Detaljer i Custom Data Report. Dette giver en bekvem måde at se alle brugerdefinerede data, der indsamles til den enhed, på et centralt sted, hvilket gør fejlfinding mere effektiv.

Fanen Custom Data inkluderer:

• Link til brugerdefineret datarapport

• Hver indfanget dataelement og værdi

• Rapportens udløbsdato

• Status

• Manuskriptnavn

• Script Exit Code

• Outputlink

• Download XLS-muligheden

De udløbne data er ikke synlige.

Bemærk: For udfyldte, annullerede eller udløbne rapporter:

• Hvis scriptet slettes, eller alle grupper slettes, vises call-to-action som Create.

• Hvis scriptet og mindst én gruppe stadig eksisterer, vises call-to-action som Restart.

9. Udnyttelse af Custom Data Report API'en

For yderligere information, se vores Developer Portal-dokumentation om API'er, der tillader kunder at forespørge brugerdefinerede datarapporter: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Kontakt os

For enhver hjælp, lav en supportsag eller e-mail support@wxp.hp.com.