Aangepaste datarapporten

Inleiding

Aangepaste datarapporten in de Analytics-module van het HP Workforce Experience-platform (WXP) stellen klanten in staat om apparaatniveaugegevens te verzamelen die niet beschikbaar zijn via de standaard WXP Insights-agent. Gebruikers uploaden PowerShell-scripts (verpakt in JSON-formaat), voeren deze uit in geselecteerde apparaatgroepen en genereren gestructureerde analyserapporten binnen WXP.

Deze functie ondersteunt:

• Scriptgebaseerde evaluatiegegevensopvraging

• Aanmaak van aangepaste gegevensrapporten (maximaal 10 per tenant)

• Realtime voortgangsmonitoring

• Klikbaar KPI-dashboard

• Excel (XLS) exportmogelijkheden

• Apparaatniveau drilldowns

Vereisten en toegang

Abonnementsvereisten

Klanten moeten een van de volgende abonnementen hebben:

• WXP Pro Trial

• WXP Pro

• WXP Elite

Rolgebaseerde Toegang (RBAC)

Gebruikers met de volgende rollen kunnen scripts uitvoeren en aangepaste datarapporten aanmaken of bekijken:

• IT-administratie

• Partner Service Specialist

• Partnerbeheerder (geautoriseerd en niet-geautoriseerd onboarded)

Deze rollen hebben volledige toegang tot de functie.

Gebruikers met de volgende rollen kunnen aangepaste datarapporten bekijken, maar geen scripts uitvoeren:

• HP Support Admin

• Rapportbeheer

Voor deze rollen zijn de opties Annuleren en Herstarten niet beschikbaar. Ze kunnen in aanmerking komende rapporten downloaden, maar kunnen geen opdrachten starten of annuleren. Alle andere rollen hebben geen toegang tot deze functie.

Voor partnerrollen moet een klanttenant worden geselecteerd voordat functionaliteit beschikbaar komt.

Acties die binnen de functie Custom Data Reports worden uitgevoerd, worden bewaard in auditlogboeken.

1. Scriptvereisten en gegevensverwerking

Scriptformaat

Scriptuitvoer moet in JSON-formaat worden gegenereerd. Het scriptbestand definieert:

• Scriptmetadata

• Uitvoeringseigenschappen

• Optionele parameters

• Verwacht uitvoerschema

• De volgorde waarin gegevens in het rapport worden weergegeven

PowerShell wordt gebruikt voor de uitvoering, maar het geüploade artefact moet het gedefinieerde JSON-wrapperformaat volgen.

Voorbeeld

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
 }

Voorbeeldrapport

JSON Outputstructuur (Rapportagebeperking)

Rapportage ondersteunt alleen een JSON-hiërarchie op één niveau.

Voorbeeld van een ondersteund formaat:

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

Voorbeeld van niet-ondersteund formaat:

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

Als geneste structuren worden teruggegeven, wordt de data niet weergegeven in gestructureerde kolommen. In plaats daarvan staat het onder StdOut.

Opmerking:

• URL-behandeling: URL's worden geaccepteerd in de scriptuitvoer. URL's verschijnen als klikbare links in rapportageweergaven waar van toepassing.

• Vertaalafhandeling: Gegevens worden weergegeven in hetzelfde formaat dat door het script wordt teruggegeven zonder vertaling of wijziging.

• Datum- en tijdafhandeling: Datum- en tijdwaarden die als onderdeel van de scriptoutput worden teruggegeven, worden exact weergegeven zoals geretourneerd. Ze worden niet omgezet of genormaliseerd naar een bepaalde tijdzone. Dit zorgt voor ruwe scriptkwaliteit zonder backendtransformatie.

2. Een aangepast datarapport maken

Volg deze stappen om apparaatgegevens op te halen die niet beschikbaar zijn via standaard WXP Insights-telemetrie.

1. Log in op WXP. De startpagina wordt weergegeven

2. Klik in het linkermenu van WXP op Analytics > Aangepaste Data Reports. De bestaande rapporten worden weergegeven.

3. Klik op Toevoegen. De pagina Rapport toevoegen wordt weergegeven om een script te selecteren of te uploaden voor aangepaste gegevensverzameling.

4. Elk script toont een Beschrijving, Versie en Operatie.

   1. De lijst wordt automatisch gefilterd om evaluatiescripts te tonen.

5. Als parameters gedefinieerd zijn, zijn ze vooraf ingevuld en bewerkbaar.

6. Kies het publiek door één of meer groepen te selecteren. Scroll naar beneden om het totale aantal apparaten in de geselecteerde doelgroep te berekenen.

   1. Het aantal apparaten toont het aantal unieke apparaten over de geselecteerde groepen.

   2. Als een apparaat tot meerdere groepen behoort, draait het script slechts één keer op dat apparaat.

7. Voeg een titel en optionele beschrijving toe aan het rapport.

8. Publiceer het script.

Tenantlimiet: Een tenant kan tot 10 aangepaste datarapporten hebben. Om een elfde rapport te maken, moet ten minste één bestaand rapport worden verwijderd. Elke gebruiker met rapportweergaverechten kan toegang krijgen tot alle Custom Data Reports binnen de tenant, ongeacht wie ze heeft aangemaakt.

3. Lijst met aangepaste gegevensrapporten

De volgende kolommen worden weergegeven:

• Naam en beschrijving van het rapport

• Gemaakt door

• Gemaakt op

• Algemene status

  • In uitvoering

  • Voltooid (maximaal 24 uur na het starten van de scriptuitvoering)

  • Verlopen

  • Geannuleerd

• Export

• Verwijderen

De volgende validatieregels zijn van toepassing:

• Bulkverwijdering is niet toegestaan.

• Bulkexport is niet toegestaan.

• Een rapport met de status "In Progress" kan niet worden verwijderd.

• Meldingen met de status Voltooid, Geannuleerd of Verlopen kunnen worden verwijderd.

• Rapporten met de status In Progress, Voltooid of Geannuleerd kunnen worden gedownload.

• Verlopen rapporten kunnen niet worden gedownload.

3. Privacy en Beveiliging

IT-beheerder (Eerste Gebruik per Tenant)

Wanneer een IT-beheerder voor het eerst een Custom Data Report aanmaakt binnen een tenant, moet hij de voorwaarden accepteren. Deze bevestiging wordt slechts één keer getoond en alleen aan de eerste IT-beheerder in die tenant. Volgende IT-beheerders worden niet gevraagd.

Partnerbeheerder of Servicespecialist

Bij het aanmaken van een Custom Data Report namens een klant moet de gebruiker de voorwaarden één keer per klanttenant accepteren. De acceptabele is tracker per huurder.

4. Het bekijken en monitoren van een aangepast datarapport

Elk aangepast datarapport toont het volgende:

• Rapportnaam en beschrijving

• Scriptnaam (gelinkt)

• Publieksdefinitie

• Totaal aantal apparaten

• Startdatum en -tijd

• Voltooiingsdatum en -tijd

• Vervaldatum

• Rapportagestatus

  • In uitvoering

  • Voltooid

  • Geannuleerd

  • Verlopen

• Downloadoptie

• Verwijderoptie (indien in aanmerking)

Opmerking: Het script wordt één keer uitgevoerd. Het draait niet continu of op een terugkerend schema. Gebruikers kunnen het echter altijd gebruiken wanneer dat nodig is.

Voortgangsbalk

De voortgangsbalk toont het volgende:

• Voltooide apparaten

• Foutieve apparaten

• Niet-verwerkte apparaten

• Totaal publiek

Een Rapport annuleren

Je kunt een rapport alleen annuleren als de status In Progress is. Bij annulering:

• De status wordt bijgewerkt naar Geannuleerd.

• De Rapportpagina toont de gebruiker die heeft opgezegd en het tijdstip van annulering.

• De optie Herstarten verschijnt kort daarna.

Een Rapport opnieuw starten

Je kunt een rapport opnieuw starten dat in de volgende status staat:

• Voltooid

• Geannuleerd

• Verlopen

Gedrag:

• Herstart op alle originele apparaten.

• Historische gegevens worden verwijderd.

• Script, parameters en publiek kunnen niet worden aangepast.

• Het publiek kan verschillen als het groepslidmaatschap is veranderd.

5. Vervalregels

Een Custom Data Report verloopt 11 dagen na de start van de scriptuitvoering (24-uur voltooiingsvenster plus 10 dagen retentie) of 10 dagen nadat alle apparaten de status Voltooid of Fout tonen als het minder dan 24 uur is.

Als het rapport wordt geannuleerd, verloopt het 10 dagen na annulering.

De verlopen rapporten:

• Kan niet worden gedownload.

• Gegevens worden verwijderd van apparaatpagina's.

6. Het bekijken van gepubliceerd aangepast datarapport

Klikbare KPI's in het rapport

KPI's worden weergegeven op basis van de apparaatstatus:

• In uitvoering

• Voltooid

• Fout gemaakt

• Niet verwerkt

Gedrag:

• KPI's worden niet beïnvloed door tabelfiltering.

• Door op een KPI te klikken, wordt een tabelfilter toegepast.

• Multi-select KPI-filters zijn toegestaan.

• Filters behouden per tabblad totdat ze verwijderd zijn.

• Filters worden niet overgezet tussen tabblad Inhoud en Details.

Het tabblad Inhoud bekijken

Het tabblad Inhoud toont alleen apparaten met de status Voltooid.

De standaardsortering is gebaseerd op het serienummer.

De volgende kolommen worden weergegeven.

• Apparaatserienummer (gelinkt naar de betreffende apparaatgegevenspagina)

• Apparaatnaam

• Eén kolom per data-element

  • Wijzigingen worden voortgeplant naar de pagina met apparaatdetails

• Output (StdOut)

• Starttijd

Als er geen gegevens worden teruggegeven, wordt het bericht weergegeven dat de gebruiker naar het tabblad Details verwijst.

Het tabblad Details bekijken

Dit is de standaard sorteervolgorde:

1. Fout

2. In uitvoering

3. Niet verwerkt

4. Voltooid

De volgende kolommen worden weergegeven:

• Apparaatserienummer

• Apparaatnaam

• Laatst ingelogde gebruiker

• Script Exit Code

• Output (link naar StdOut of foutweergave)

7. Exporteren van een aangepast datarapport

Gebruikers kunnen gefilterde resultaten exporteren naar een Excel (XLS)-bestand, dat twee tabbladen bevat:

• Inhoud

• Details

Je kunt rapporten exporteren in de volgende statussen:

• In uitvoering

• Voltooid

• Geannuleerd

Opmerking: Exporten zijn niet beschikbaar voor verlopen rapporten.

8. Pagina Toegang tot apparaatgegevens

Je kunt de bijbehorende pagina met apparaatdetails openen door op een willekeurig serienummer te klikken dat staat in het tabblad Inhoud of Details van het Aangepast Gegevensrapport. Dit biedt een handige manier om alle aangepaste gegevens die voor dat apparaat zijn verzameld op een centrale locatie te bekijken, waardoor het oplossen van problemen efficiënter wordt.

Het tabblad Aangepaste Gegevens bevat:

• Link naar aangepast datarapport

• Elk vastgelegd data-element en waarde

• Vervaldatum melden

• Status

• Schriftnaam

• Script Exit Code

• Uitgangslink

• Download XLS-optie

De verlopen gegevens zijn niet zichtbaar.

Opmerking: Voor voltooide, geannuleerde of verlopen rapporten:

• Als het script wordt verwijderd of alle groepen zijn verwijderd, wordt de call-to-action weergegeven Create.

• Als het script en ten minste één groep nog bestaan, wordt de weergegeven call-to-action restart.

9. Gebruikmaken van de Custom Data Report API

Voor meer informatie, raadpleeg onze documentatie van het Developer Portal over API's waarmee klanten aangepaste datarapporten kunnen opvragen: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Neem contact met ons op

Voor hulp kunt u een supportcase of e-mail support@wxp.hp.comaanmaken.