Egendefinerte datarapporter

Introduksjon

Tilpassede datarapporter i analysemodulen til HP Workforce Experience-plattformen (WXP) gjør det mulig for kunder å samle inn data på enhetsnivå som ikke er tilgjengelig via den vanlige WXP Insights-agenten. Brukere laster opp PowerShell-skript (pakket i JSON-format), kjører dem på tvers av utvalgte enhetsgrupper, og genererer strukturerte analyserapporter i WXP.

Denne funksjonen støtter:

• Skriptbasert evalueringsdatahenting

• Opprettelse av egendefinert datarapport (maksimalt 10 per leietaker)

• Sanntids fremdriftsovervåking

• Klikkbart KPI-dashbord

• Excel (XLS) eksportmuligheter

• Enhetsnivå-drilldowns

Forutsetninger og tilgang

Abonnementskrav

Kunder må ha ett av følgende abonnementer:

• WXP Pro Trial

• WXP Pro

• WXP Elite

Rollebasert tilgang (RBAC)

Brukere med følgende roller kan kjøre skript og opprette eller se tilpassede datarapporter:

• IT-administrasjon

• Partnertjenestespesialist

• Partneradministrator (autorisert og ikke-autorisert onboardet)

Disse rollene har full tilgang til funksjonen.

Brukere med følgende roller kan se tilpassede datarapporter, men kan ikke kjøre skript:

• HP Support Admin

• Rapportadministrasjon

For disse rollene er ikke alternativene Avbryt og Omstart tilgjengelige. De kan laste ned kvalifiserte rapporter, men kan ikke starte eller kansellere jobber. Alle andre roller har ikke tilgang til denne funksjonen.

For partnerroller må en kundeleietaker velges før funksjonalitet blir tilgjengelig.

Handlinger utført i funksjonen Custom Data Reports lagres i revisjonsloggene.

1. Skriptkrav og datahåndtering

Manusformat

Skriptutdata må genereres i JSON-format. Skriptfilen definerer:

• Skriptmetadata

• Utførelsesegenskaper

• Valgfrie parametere

• Forventet utgangsskjema

• Rekkefølgen dataene vises i rapporten

PowerShell brukes til utførelse, men den opplastede artefakten må følge det definerte JSON-wrapperformatet.

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-utgangsstruktur (rapporteringsbegrensning)

Rapportering støtter kun et JSON-hierarki på ett nivå.

Eksempel på støttet format:

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

Eksempel på et ikke-støttet format:

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

Hvis nestede strukturer returneres, gjengis ikke dataene i strukturerte kolonner. I stedet vises det under StdOut.

Merk:

• URL-håndtering: URL-er aksepteres i skriptutdata. URL-er vises som klikkbare lenker i rapporteringsvisninger der det er aktuelt.

• Oversettelseshåndtering: Data vises i samme format som returneres av skriptet uten oversettelse eller endring.

• Håndtering av dato og tid: Dato- og tidsverdier som returneres som en del av skriptets utdata, vises nøyaktig som returnert. De blir ikke konvertert eller normalisert til noen tidssone. Dette sikrer rå skriptkvalitet uten backend-transformasjon.

2. Opprettelse av en tilpasset datarapport

Følg disse trinnene for å hente enhetsdata som ikke er tilgjengelig via standard WXP Insights-telemetri.

1. Logg inn på WXP. Hjemmesiden vises

2. Fra venstre meny i WXP klikker du på Analyser > Tilpassede datarapporter. De eksisterende rapportene vises.

3. Klikk Legg til. Legge til rapport-siden vises for å velge eller laste opp et skript for egendefinert datainnsamling.

4. Hvert skript viser en beskrivelse, versjon og operasjon.

   1. Listen filtreres automatisk for å vise evalueringsskript.

5. Hvis parametere var definert, er de forhåndsfylte og redigerbare.

6. Velg målgruppen ved å velge én eller flere grupper. Bla ned for å beregne det totale antallet enheter i den valgte målgruppen.

   1. Antall enheter viser antall unike enheter på tvers av de valgte gruppene.

   2. Hvis en enhet tilhører flere grupper, kjører skriptet bare én gang på den enheten.

7. Legg til en tittel og valgfri beskrivelse for rapporten.

8. Publiser manuset.

Leietakergrense: En leietaker kan ha opptil 10 tilpassede datarapporter. For å opprette en ellevte rapport må minst én eksisterende rapport slettes. Enhver bruker med rapportvisningstillatelser kan få tilgang til alle Custom Data Reports i leietakeren, uavhengig av hvem som har opprettet dem.

3. Listetabell for tilpassede datarapporter

Følgende kolonner vises:

• Rapportens navn og beskrivelse

• Opprettet av

• Opprettet på

• Generell status

  • Under utvikling

  • Fullført (maks 24 timer etter at skriptkjøring startet)

  • Utløpt

  • Kansellert

• Eksport

• Slett

Følgende valideringsregler gjelder:

• Massesletting er ikke tillatt.

• Bulkeksport er ikke tillatt.

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

• Rapporter med status Fullført, Kansellert eller Utløpt kan slettes.

• Rapporter med status som Pågående, Fullført eller Avlyst kan lastes ned.

• Utløpte rapporter kan ikke lastes ned.

3. Personvern og sikkerhet

IT-administrasjon (første bruk per leietaker)

Når en IT-administrator oppretter en Custom Data Report for første gang innenfor en leietaker, må de akseptere vilkårene. Denne bekreftelsen vises kun én gang og kun til den første IT-administratoren i den aktuelle leietakeren. Påfølgende IT-administratorer blir ikke bedt om det.

Partneradministrator eller tjenestespesialist

Når man oppretter en egendefinert datarapport på vegne av en kunde, må brukeren akseptere vilkårene én gang per kundeleietaker. Det akseptable er tracker per leietaker.

4. Visning og overvåking av en tilpasset datarapport

Hver Custom Data Report viser følgende:

• Rapportens navn og beskrivelse

• Skriptnavn (lenket)

• Publikumsdefinisjon

• Totalt antall enheter

• Startdato og -tidspunkt

• Ferdigstillelsesdato og -tidspunkt

• Utløpsdato

• Rapportstatus

  • Under utvikling

  • Fullført

  • Kansellert

  • Utløpt

• Nedlastingsalternativ

• Slett-alternativ (hvis kvalifisert)

Merk: Manuset går én gang. Den kjører ikke kontinuerlig eller på en tilbakevendende tidsplan. Brukere kan imidlertid kjøre den når som helst.

Fremdriftsbar

Fremdriftslinjen viser følgende:

• Fullførte enheter

• Feilaktige enheter

• Ikke-prosesserte enheter

• Total publikum

Kansellering av en rapport

Du kan kun kansellere en rapport når statusen er pågående. Ved kansellering:

• Statusen oppdateres til Kansellert.

• Rapportsiden viser brukeren som kansellerte og tidspunktet for kanselleringen.

• Muligheten for å starte på nytt dukker opp kort tid etter.

Gjenoppstart av en rapport

Du kan starte en rapport på nytt som er i følgende status:

• Fullført

• Kansellert

• Utløpt

Atferd:

• Starter på nytt på alle originale enheter.

• Historiske data slettes.

• Manus, parametere og publikum kan ikke endres.

• Publikum kan variere hvis gruppemedlemskapet har endret seg.

5. Utløpsregler

En Custom Data Report utløper 11 dager etter at skriptets utførelse starter (24-timers fullføringsvindu pluss 10 dagers oppbevaring) eller 10 dager etter at alle enheter viser Fullført eller Feilstatus hvis de er under 24 timer.

Hvis rapporten blir kansellert, utløper den 10 dager etter kanselleringen.

De utgåtte rapportene:

• Kan ikke lastes ned.

• Data fjernes fra enhetssider.

6. Visning av publisert tilpasset datarapport

Klikkbare KPI-er på rapporten

KPI-er vises basert på enhetsstatus:

• Under utvikling

• Fullført

• Feilet

• Ikke behandlet

Atferd:

• KPI-er påvirkes ikke av tabellfiltrering.

• Å klikke på en KPI aktiverer et tabellfilter.

• Multi-select KPI-filtre er tillatt.

• Filtre beholdt per fane til de fjernes.

• Filtre overføres ikke mellom fanene Innhold og Detaljer.

Visning av innholdsfanen

Innhold-fanen viser kun enheter med Fullført-status.

Standardsorteringen er basert på serienummeret.

Følgende kolonner vises.

• Enhetsserienummer (lenket til respektive enhetsdetaljside)

• Enhetsnavn

• Én kolonne per dataelement

  • Endringer overføres til enhetsdetaljsiden

• Output (StdOut)

• Starttid

Hvis ingen data returneres, vises meldingen som leder brukeren til Detaljer-fanen .

Visning av detaljfanen

Dette er standard sorteringsrekkefølge:

1. Feil

2. Under utvikling

3. Ikke behandlet

4. Fullført

Følgende kolonner vises:

• Enhetsserienummer

• Enhetsnavn

• Siste innloggede bruker

• Skriptets avslutningskode

• Utgang (lenke til StdOut eller feilvisning)

7. Eksport av en egendefinert datarapport

Brukere kan eksportere filtrerte resultater til en Excel (XLS)-fil, som inkluderer to faner:

• Innhold

• Detaljer

Du kan eksportere rapporter i følgende statuser:

• Under utvikling

• Fullført

• Kansellert

Merk: Eksport er ikke tilgjengelig for utløpte rapporter.

8. Tilgang til enhetsdetaljsiden

Du kan åpne den tilsvarende enheten Detaljer-siden ved å klikke på et hvilket som helst serienummer som er oppført under fanen Innhold eller Detaljer i Custom Data Report. Dette gir en praktisk måte å se alle tilpassede data samlet inn for enheten på et sentralt sted, noe som gjør feilsøking mer effektiv.

Fanen Custom Data inkluderer:

• Lenke til tilpasset datarapport

• Hver fanget dataelement og verdi

• Rapporter utløpsdato

• Status

• Manusnavn

• Skriptets avslutningskode

• Utgangslenke

• Last ned XLS-alternativet

De utgåtte dataene er ikke synlige.

Merk: For fullførte, kansellerte eller utløpte rapporter:

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

• Hvis skriptet og minst én gruppe fortsatt eksisterer, er call-to-action som vises Restart.

9. Utnyttelse av Custom Data Report API

For mer informasjon, se vår Developer Portal-dokumentasjon om API-er som lar kunder spørre i tilpassede datarapporter: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Kontakt oss

For hjelp, opprett en supportsak eller e-post support@wxp.hp.com.