Benutzerdefinierte Datenberichte

Einleitung

Benutzerdefinierte Datenberichte im Analytics-Modul der HP Workforce Experience Plattform (WXP) ermöglichen es Kunden, Geräte auf Geräteebene zu sammeln, die nicht über den Standard-WXP Insights-Agenten verfügbar sind. Benutzer laden PowerShell-Skripte hoch (im JSON-Format verpackt), führen sie über ausgewählte Gerätegruppen hinaus aus und erstellen strukturierte Analyseberichte innerhalb von WXP.

Diese Funktion unterstützt:

• Skriptbasierte Evaluationsdatenabruf

• Erstellung von benutzerdefinierten Datenberichten (maximal 10 pro Tenant)

• Echtzeit-Fortschrittsüberwachung

• Anklickbares KPI-Dashboard

• Excel (XLS) Exportfunktionen

• Geräteebene Drilldowns

Voraussetzungen und Zugang

Abonnementanforderungen

Kunden müssen eines der folgenden Abonnements besitzen:

• WXP Pro Trial

• WXP Pro

• WXP Elite

Rollenbasierter Zugriff (RBAC)

Benutzer mit den folgenden Rollen können Skripte ausführen und benutzerdefinierte Datenberichte erstellen oder ansehen:

• IT-Verwaltung

• Partnerservice-Spezialist

• Partner Admin (autorisiert und nicht autorisiert Onboarded)

Diese Rollen haben vollen Zugriff auf das Feature.

Benutzer mit den folgenden Rollen können benutzerdefinierte Datenberichte ansehen, aber keine Skripte ausführen:

• HP Support Admin

• Berichtsverwaltung

Für diese Rollen stehen die Optionen "Abbrechen" und "Neustarten" nicht zur Verfügung. Sie können berechtigte Berichte herunterladen, aber keine Aufträge initiieren oder kündigen. Alle anderen Rollen haben keinen Zugriff auf diese Funktion.

Für Partnerrollen muss ein Kunden-Tenant ausgewählt werden, bevor Funktionalität verfügbar wird.

Aktionen, die innerhalb der Funktion Benutzerdefinierte Datenberichte ausgeführt werden, werden in Audit-Logs gespeichert.

1. Skriptanforderungen und Datenverarbeitung

Skriptformat

Die Skriptausgabe muss im JSON-Format erzeugt werden. Die Skriptdatei definiert:

• Skriptmetadaten

• Ausführungseigenschaften

• Optionale Parameter

• Erwartetes Ausgabeschema

• Die Reihenfolge, in der Daten im Bericht angezeigt werden

PowerShell wird zur Ausführung verwendet, aber das hochgeladene Artefakt muss dem definierten JSON-Wrapper-Format folgen.

Beispiel

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
 }

Beispielbericht

JSON-Ausgabestruktur (Berichtsbeschränkung)

Reporting unterstützt nur eine einstufige JSON-Hierarchie.

Beispiel für ein unterstütztes Format:

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

Beispiel für ein nicht unterstütztes Format:

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

Wenn verschachtelte Strukturen zurückgegeben werden, werden die Daten nicht in strukturierten Spalten wiedergegeben. Stattdessen erscheint es unter StdOut.

Hinweis:

• URL-Verarbeitung: URLs werden in der Skriptausgabe akzeptiert. URLs erscheinen, wo angebracht, als anklickbare Links in Berichtsansichten.

• Übersetzungshandhabung: Die Daten werden im gleichen Format angezeigt, das vom Skript ohne Übersetzung oder Änderung zurückgegeben wird.

• Datums- und Uhrzeitverarbeitung: Datums- und Zeitwerte, die als Teil der Skriptausgabe zurückgegeben werden, werden exakt wie zurückgegeben angezeigt. Sie werden nicht in eine Zeitzone umgewandelt oder normalisiert. Dies gewährleistet eine reine Skripttreue ohne Backend-Transformation.

2. Erstellung eines benutzerdefinierten Datenberichts

Befolgen Sie diese Schritte, um Gerätedaten abzurufen, die nicht über die Standard-Telemetrie von WXP Insights verfügbar sind.

1. Melden Sie sich bei WXP an. Die Startseite wird angezeigt

2. Im linken Menü von WXP klicken Sie auf Analytics > Benutzerdefinierte Datenberichte. Die vorhandenen Berichte werden angezeigt.

3. Klicken Sie auf Hinzufügen. Die Seite Bericht hinzufügen wird angezeigt, um ein Skript für die individuelle Datenerhebung auszuwählen oder hochzuladen.

4. Jedes Skript zeigt eine Beschreibung, Version und Operation an.

   1. Die Liste wird automatisch gefiltert, um Evaluationsskripte anzuzeigen.

5. Wenn Parameter definiert sind, sind sie vorab befüllt und bearbeitbar.

6. Wählen Sie die Zielgruppe, indem Sie eine oder mehrere Gruppen auswählen. Scrollen Sie nach unten, um die Gesamtzahl der Geräte in der ausgewählten Zielgruppe zu berechnen.

   1. Die Anzahl der Geräte zeigt die Anzahl der eindeutigen Geräte in den ausgewählten Gruppen an.

   2. Wenn ein Gerät zu mehreren Gruppen gehört, wird das Skript auf diesem Gerät nur einmal ausgeführt.

7. Fügen Sie einen Titel und eine optionale Beschreibung für den Bericht hinzu.

8. Veröffentlichen Sie das Drehbuch.

Mieterbegrenzung: Ein Mieter kann bis zu 10 benutzerdefinierte Datenberichte haben. Um einen elften Bericht zu erstellen, muss mindestens ein bestehender Bericht gelöscht werden. Jeder Benutzer mit Berichtsanzeigeberechtigungen kann auf alle benutzerdefinierten Datenberichte innerhalb des Mieters zugreifen, unabhängig davon, wer sie erstellt hat.

3. Tabelle der benutzerdefinierten Datenberichte

Die folgenden Spalten werden angezeigt:

• Name und Beschreibung des Berichts

• Erstellt von

• Erstellt am

• Gesamtstatus

  • In Arbeit

  • Abgeschlossen (maximal 24 Stunden nach Beginn der Skriptausführung)

  • Abgelaufen

  • Eingestellt

• Export

• Löschen

Die folgenden Validierungsregeln gelten:

• Massenlöschung ist nicht erlaubt.

• Der Massenexport ist nicht erlaubt.

• Ein Bericht mit dem Status "In Progress" kann nicht gelöscht werden.

• Berichte mit dem Status Abgeschlossen, Storniert oder Abgelaufen können gelöscht werden.

• Berichte mit dem Status In Progress, Abgeschlossen oder Abgebrochen können heruntergeladen werden.

• Abgelaufene Berichte können nicht heruntergeladen werden.

3. Privatsphäre und Sicherheit

IT-Admin (Erstverwendung pro Tenant)

Wenn ein IT-Administrator zum ersten Mal innerhalb eines Mieters einen benutzerdefinierten Datenbericht erstellt, muss er die Bedingungen akzeptieren. Diese Bestätigung wird nur einmal und nur dem ersten IT-Administrator in diesem Tenant angezeigt. Nachfolgende IT-Administratoren werden nicht aufgefordert.

Partneradministrator oder Service-Spezialist

Beim Erstellen eines benutzerdefinierten Datenberichts im Namen eines Kunden muss der Nutzer die Bedingungen einmal pro Kundenmieter akzeptieren. Das Akzeptierte ist der Tracker pro Mieter.

4. Ansehen und Überwachung eines benutzerdefinierten Datenberichts

Jeder benutzerdefinierte Datenbericht zeigt Folgendes an:

• Name und Beschreibung des Berichts

• Skriptname (verlinkt)

• Zielgruppendefinition

• Gesamtzahl der Geräte

• Startdatum und -zeit

• Fertigstellungsdatum und -zeit

• Ablaufdatum

• Berichtsstatus

  • In Arbeit

  • Abgeschlossen

  • Abgesagt

  • Abgelaufen

• Download-Option

• Löschoption (falls berechtigt)

Hinweis: Das Drehbuch läuft einmal. Sie läuft nicht durchgehend oder nach einem wiederkehrenden Zeitplan. Nutzer können es jedoch jederzeit ausführen.

Fortschrittsleiste

Die Fortschrittsleiste zeigt Folgendes:

• Fertige Geräte

• Fehlerbehaftete Geräte

• Nicht verarbeitete Geräte

• Gesamtpublikum

Kündigung eines Berichts

Du kannst einen Bericht nur stornieren, wenn der Status "In Progress" ist. Bei der Stornierung:

• Der Status aktualisiert sich auf Storniert.

• Die Berichtsseite zeigt den Nutzer an, der gekündigt hat, sowie den Zeitpunkt der Stornierung.

• Kurz darauf erscheint die Neustart-Option .

Neustart eines Berichts

Sie können einen Bericht neu starten, der sich in folgendem Status befindet:

• Abgeschlossen

• Abgesagt

• Abgelaufen

Verhalten:

• Neustarts auf allen Originalgeräten.

• Historische Daten werden gelöscht.

• Drehbuch, Parameter und Zielgruppe können nicht verändert werden.

• Das Publikum kann unterschiedlich sein, wenn sich die Gruppenzugehörigkeit geändert hat.

5. Ablaufregeln

Ein benutzerdefinierter Datenbericht verfällt 11 Tage nach Beginn der Skriptausführung (24-Stunden-Abschlussfenster plus 10 Tage Aufbewahrung) oder 10 Tage nachdem alle Geräte den Status "Abgeschlossen" oder "Fehlerbehaftet" zeigen, wenn er unter 24 Stunden liegt.

Wenn der Bericht storniert wird, läuft er 10 Tage nach der Stornierung ab.

Die abgelaufenen Berichte:

• Kann nicht heruntergeladen werden.

• Daten werden von Geräteseiten entfernt.

6. Ansehen von veröffentlichten benutzerdefinierten Datenberichten

Klickbare KPIs im Bericht

KPIs werden basierend auf dem Gerätestatus angezeigt:

• In Arbeit

• Abgeschlossen

• Fehlerhaft

• Nicht verarbeitet

Verhalten:

• KPIs werden nicht von Tabellenfiltern beeinflusst.

• Das Klicken auf einen KPI verwendet einen Tabellenfilter.

• Multiselect-KPI-Filter sind erlaubt.

• Filter werden pro Tab bis zum Entfernen beibehalten.

• Filter werden nicht zwischen den Inhalts- und Details-Tabs übertragen.

Ansicht des Inhalts-Reiters

Der Inhalts-Tab zeigt nur Geräte mit dem Status "abgeschlossen" an.

Die Standardsortierung basiert auf der Seriennummer.

Die folgenden Spalten werden angezeigt.

• Geräteseriennummer (verlinkt auf die jeweilige Gerätedetailseite)

• Gerätename

• Eine Spalte pro Datenelement

  • Änderungen werden auf der Geräteinformationsseite weitergeleitet

• Ausgabe (StdOut)

• Startzeit

Wenn keine Daten zurückgegeben werden, wird die Nachricht angezeigt, die den Benutzer zum Reiter Details weiterleitet.

Anzeigen des Details-Reiters

Dies ist die Standard-Sortierreihenfolge:

1. Fehler

2. In Arbeit

3. Nicht verarbeitet

4. Abgeschlossen

Die folgenden Spalten werden angezeigt:

• Geräteseriennummer

• Gerätename

• Zuletzt eingeloggter Nutzer

• Skript-Exitcode

• Ausgabe (Link zu StdOut oder Fehleransicht)

7. Exportieren eines benutzerdefinierten Datenberichts

Benutzer können gefilterte Ergebnisse in eine Excel-(XLS)-Datei exportieren, die zwei Tabs enthält:

• Inhalt

• Details

Sie können Berichte in den folgenden Statusrichtungen exportieren:

• In Arbeit

• Abgeschlossen

• Eingestellt

Hinweis: Exporte sind für abgelaufene Berichte nicht verfügbar.

8. Zugriff auf die Seite mit Gerätedetails

Sie können die entsprechende Seite mit Gerätedetails öffnen, indem Sie auf eine beliebige Seriennummer klicken, die im Reiter Inhalt oder Details im Custom Data Report aufgeführt ist. Dies bietet eine bequeme Möglichkeit, alle benutzerdefinierten Daten, die für das Gerät gesammelt wurden, an einem zentralen Ort einzusehen, was die Fehlersuche effizienter macht.

Der Tab Benutzerdefinierte Daten umfasst:

• Link zum benutzerdefinierten Datenbericht

• Jedes erfasste Datenelement und jeder Wert

• Melde-Ablaufdatum

• Status

• Schriftname

• Skript-Exitcode

• Ausgangsverbindung

• XLS-Option herunterladen

Die abgelaufenen Daten sind nicht sichtbar.

Hinweis: Für ausgefüllte, stornierte oder abgelaufene Berichte:

• Wenn das Skript gelöscht wird oder alle Gruppen gelöscht werden, wird der angezeigte Aufruf zur Aktion erstellt.

• Wenn das Skript und mindestens eine Gruppe noch existieren, ist der angezeigte Aufruf zum Aktion Neustart.

9. Nutzung der Custom Data Report API

Weitere Informationen finden Sie in unserer Entwicklerportal-Dokumentation zu APIs, die es Kunden ermöglichen, benutzerdefinierte Datenberichte abzusuchen: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Kontaktieren Sie uns

Für jegliche Unterstützung erstellen Sie bitte einen Support-Fall oder eine E-Mail support@wxp.hp.com.