Introduzione
I Custom Data Report nel modulo Analytics della piattaforma HP Workforce Experience (WXP) permettono ai clienti di raccogliere dati a livello di dispositivo che non sono disponibili tramite l'agente standard WXP Insights. Gli utenti caricano script PowerShell (confezionati in formato JSON), li esegue su gruppi di dispositivi selezionati e generano report di analisi strutturati all'interno di WXP.
Questa funzione supporta:
Recupero dati di valutazione basato su script
Creazione di report dati personalizzati (massimo 10 per tenant)
Monitoraggio in tempo reale dei progressi
Dashboard KPI cliccabile
Capacità di esportazione di Excel (XLS)
Drilldown a livello di dispositivo
Prerequisiti e accesso
Requisiti per l'abbonamento
I clienti devono avere uno dei seguenti abbonamenti:
Prova WXP Pro
WXP Pro
WXP Elite
Accesso basato sul ruolo (RBAC)
Gli utenti con i seguenti ruoli possono eseguire script e creare o visualizzare Report Dati Personalizzati:
Amministrazione IT
Specialista del Servizio Partner
Amministratore Partner (autorizzato e non autorizzato onboard)
Questi ruoli hanno pieno accesso alla funzione.
Gli utenti con i seguenti ruoli possono visualizzare Report Dati Personalizzati ma non possono eseguire script:
Admin Supporto HP
Amministrazione Report
Per questi ruoli, le opzioni Annulla e Riavvio non sono disponibili. Possono scaricare report idonei ma non possono avviare o cancellare lavori. Tutti gli altri ruoli non hanno accesso a questa funzione.
Per i ruoli Partner, deve essere selezionato un tenant cliente prima che la funzionalità diventi disponibile.
Le azioni eseguite all'interno della funzione Custom Data Report sono conservate nei log di audit.
Requisiti di script e gestione dei dati
Formato di Script
L'output degli script deve essere generato in formato JSON. Il file script definisce:
Metadati degli script
Proprietà di esecuzione
Parametri opzionali
Schema di output atteso
L'ordine in cui i dati vengono visualizzati nel rapporto
PowerShell viene utilizzato per l'esecuzione, ma l'artefatto caricato deve seguire il formato JSON wrapper definito.
Esempio
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
}
Esempio di rapporto
Struttura di output JSON (Limitazione di report)
La reportistica supporta solo una gerarchia JSON a un solo livello.
Esempio di formato supportato:
{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}
Esempio di formato non supportato:
{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}
Se vengono restituite strutture annidate, i dati non vengono visualizzati in colonne strutturate. Invece, appare sotto StdOut.
Nota:
Gestione degli URL: gli URL sono accettati nell'output degli script. Gli URL appaiono come link cliccabili nelle visualizzazioni dei report dove applicabile.
Gestione della traduzione: I dati sono visualizzati nello stesso formato restituito dallo script senza traduzione o modifica.
Gestione di data e ora: i valori di data e ora restituiti come parte dell'output dello script sono visualizzati esattamente come restituiti. Non vengono convertite o normalizzate in nessun fuso orario. Questo garantisce fedeltà grezze dello script senza trasformazioni nel backend.
Creazione di un report dati personalizzato
Segui questi passaggi per recuperare i dati del dispositivo che non sono disponibili tramite la telemetria standard di WXP Insights.
Accedi a WXP. È visualizzata la Home Page
Dal menu sinistro di WXP, clicca su Analytics > Custom Data Reports. I rapporti esistenti sono visualizzati.
Clicca su Aggiungi. La pagina Aggiungi report viene visualizzata per selezionare o caricare uno script per la raccolta dati personalizzata.
Ogni script mostra una Descrizione, una Versione e un'Operazione.
L'elenco viene filtrato automaticamente per mostrare gli script di Valutazione.
Se i parametri fossero definiti, sono pre-popolati e modificabili.
Scegli il pubblico selezionando uno o più gruppi. Scorri verso il basso per calcolare il numero totale di dispositivi nel pubblico selezionato.
Il conteggio dei dispositivi mostra il numero di dispositivi unici tra i gruppi selezionati.
Se un dispositivo appartiene a più gruppi, lo script viene eseguito una sola volta su quel dispositivo.
Aggiungi un titolo e una descrizione opzionale per il rapporto.
Pubblica la sceneggiatura.
Limite di Inquilini: Un inquilino può avere fino a 10 Report Dati Personalizzati. Per creare un undicesimo rapporto, almeno un rapporto esistente deve essere eliminato. Qualsiasi utente con permessi di visualizzazione dei report può accedere a tutti i Report Dati Personalizzati all'interno del tenant, indipendentemente da chi li ha creati.
Tabella di elenco dei report dati personalizzati
Sono visualizzate le seguenti colonne:
Nome del rapporto e descrizione
Creato da
Creato su
Stato generale
In corso
Completato (massimo 24 ore dall'inizio dell'esecuzione dello script)
Scaduto
Cancellato
Esportazione
Elimina
Si applicano le seguenti regole di validazione:
La cancellazione massiva non è consentita.
L'esportazione all'ingrosso non è consentita.
Un rapporto con lo stato "In corso" non può essere cancellato.
I report con lo stato Completato, Cancellato o Scaduto possono essere eliminati.
I report con stato In corso, Completato o Cancellato possono essere scaricati.
I report scadenti non possono essere scaricati.
Privacy e sicurezza
Amministrazione IT (Primo Utilizzo per Inquilino)
Quando un Amministratore IT crea per la prima volta un Report Personalizzato all'interno di un tenant, deve accettare i termini. Questa conferma viene mostrata solo una volta e esclusivamente al primo Amministratore IT in quel tenant. Gli Amministratori IT successivi non sono richiesti.
Amministratore Partner o Specialista del Servizio
Quando si crea un Report Personalizzato sui Dati per conto di un cliente, l'utente deve accettare i termini una volta per ogni cliente inquilino. L'opzione accettabile è il tracciamento per inquilino.
Visualizzazione e monitoraggio di un report dati personalizzato
Ogni Report Dati Personalizzati mostra quanto segue:
Nome del rapporto e descrizione
Nome della sceneggiatura (linkato)
Definizione del pubblico
Numero totale di dispositivi
Data e ora di inizio
Data e ora di completamento
Data di scadenza
Stato del rapporto
In corso
Completato
Cancellato
Scaduto
Opzione download
Opzione cancella (se idoneo)
Nota: lo script viene eseguito una sola volta. Non funziona in modo continuo né con un programma ricorrente. Tuttavia, gli utenti possono usarlo ogni volta che necessario.
Barra di Progresso
La barra di avanzamento mostra quanto segue:
Dispositivi completati
Dispositivi con errori
Dispositivi non processati
Pubblico totale
Cancellazione di un rapporto
Puoi cancellare una segnalazione solo quando lo stato è in corso. Dopo la cancellazione:
Lo stato si aggiorna su Cancellato.
La pagina del Report mostra l'utente che ha cancellato e l'orario della cancellazione.
L'opzione Riavvio appare poco dopo.
Riavvio di un rapporto
Puoi riavviare un report che si trova nei seguenti stati:
Completato
Cancellato
Scaduto
Comportamento:
Riavvia su tutti i dispositivi originali.
I dati storici vengono cancellati.
Copione, parametri e pubblico non possono essere modificati.
Il pubblico può differire se l'appartenenza al gruppo è cambiata.
Regole di scadenza
Un Custom Data Report scade 11 giorni dopo l'inizio dell'esecuzione dello script (finestra di completamento di 24 ore più 10 giorni di conservazione) oppure 10 giorni dopo che tutti i dispositivi mostrano lo stato di Completato o Errore se sotto le 24 ore.
Se la segnalazione viene annullata, scade 10 giorni dopo la cancellazione.
I rapporti scaduti:
Non può essere scaricato.
I dati vengono rimossi dalle pagine dei dispositivi.
Visualizzazione del Rapporto Personalizzato Pubblicato
KPI cliccabili sul Report
I KPI sono visualizzati in base allo stato del dispositivo:
In corso
Completato
Errore
Non processato
Comportamento:
I KPI non sono influenzati dal filtraggio delle tabelle.
Cliccando su un KPI si applica un filtro a tabella.
Sono consentiti filtri KPI a selezione multipla.
I filtri vengono mantenuti per scheda fino alla rimossa.
I filtri non si trasferiscono tra le schede Contenuto e Dettagli.
Visualizzazione della scheda Contenuti
La scheda Contenuti mostra solo i dispositivi con lo stato Completato.
L'ordinamento predefinito si basa sul Numero di Serie.
Le seguenti colonne sono mostrate.
Numero di Serie del Dispositivo (collegato alla rispettiva pagina dei dettagli del dispositivo)
Nome dispositivo
Una colonna per ogni elemento dati
Le modifiche si propagano alla pagina dettagli del dispositivo
Output (StdOut)
Orario di inizio
Se non vengono restituiti dati, viene visualizzato un messaggio che indirizza l'utente alla scheda Dettagli .
Visualizzazione della scheda Dettagli
La scheda Dettagli mostra tutti i dispositivi definiti nel pubblico, indipendentemente dallo stato. Questa scheda è principalmente utilizzata per diagnosticare dispositivi che hanno uno stato diverso da Completato.
Questo è l'ordine di ordinamento predefinito:
Errore
In corso
Non processato
Completato
Sono visualizzate le seguenti colonne:
Numero di serie del dispositivo
Nome dispositivo
Ultimo utente connesso
Codice di uscita dello script
Output (link alla vista StdOut o Error)
Esportazione di un report di dati personalizzati
Gli utenti possono esportare i risultati filtrati in un file Excel (XLS), che include due schede:
Contenuto
Dettagli
Puoi esportare i report nei seguenti stati:
In corso
Completato
Cancellato
Nota: Esportazioni non disponibili per i report scaduti.
Accesso alla pagina Dettagli del Dispositivo
Puoi aprire la corrispondente pagina Dettagli del Dispositivo cliccando su qualsiasi Numero di Serie indicato nella scheda Contenuti o Dettagli del Report Dati Personalizzati. Questo offre un modo comodo per visualizzare tutti i dati personalizzati raccolti per quel dispositivo in una posizione centralizzata, rendendo la risoluzione dei problemi più efficiente.
La scheda Dati Personalizzati include:
Link al Report Personalizzato dei Dati
Ogni elemento e valore dati catturati
Data di scadenza del rapporto
Stato
Nome del copione
Codice di uscita dello script
Collegamento di uscita
Opzione download XLS
I dati scaduti non sono visibili.
Nota: Per segnalazioni completate, annullate o scadute:
Se lo script viene eliminato o tutti i gruppi vengono eliminati, la chiamata all'azione mostrata è Crea.
Se lo script e almeno un gruppo esistono ancora, la chiamata all'azione mostrata è Restart.
Sfruttare l'API Personalizzata dei Report Dati
Per ulteriori informazioni, consulta la nostra documentazione del Portale Sviluppatori sulle API che permettono ai clienti di interrogare report dati personalizzati: https://developers.workforceexperience.hp.com/docs/v1/customdatareport
Contattaci
Per qualsiasi assistenza, crea un caso di supporto o invia una email support@wxp.hp.com.