Introduktion
Anpassade datarapporter i analysmodulen på HP Workforce Experience-plattformen (WXP) gör det möjligt för kunder att samla in enhetsnivådata som inte är tillgänglig via den vanliga WXP Insights-agenten. Användare laddar upp PowerShell-skript (paketerade i JSON-format), kör dem över utvalda enhetsgrupper och genererar strukturerade analysrapporter inom WXP.
Denna funktion stödjer:
Skriptbaserad utvärderingsdatahämtning
Skapande av anpassad datarapport (max 10 per hyresgäst)
Övervakning av framsteg i realtid
Klickbar KPI-dashboard
Excels (XLS) exportmöjligheter
Enhetsnivå-drilldowns
Förkunskapskrav och tillgång
Prenumerationskrav
Kunder måste ha en av följande prenumerationer:
WXP Pro Trial
WXP Pro
WXP Elite
Rollbaserad åtkomst (RBAC)
Användare med följande roller kan köra skript och skapa eller visa anpassade datarapporter:
IT-administration
Partnerservicespecialist
Partneradministratör (auktoriserad och icke-auktoriserad onboardad)
Dessa roller har full tillgång till funktionen.
Användare med följande roller kan se anpassade datarapporter men kan inte köra skript:
HP Support Admin
Rapportadministration
För dessa roller finns inte alternativen Avbryt och Omstart. De kan ladda ner berättigade rapporter men kan inte initiera eller avbryta jobb. Alla andra roller har inte tillgång till denna funktion.
För partnerroller måste en kundhyresgäst väljas innan funktionalitet blir tillgänglig.
Åtgärder som utförs inom funktionen Anpassade datarapporter sparas i revisionsloggar.
Skriptkrav och datahantering
Manusformat
Skriptutgång måste genereras i JSON-format. Skriptfilen definierar:
Skriptmetadata
Exekveringsegenskaper
Valfria parametrar
Förväntat utdataschema
Ordningen i vilken data visas i rapporten
PowerShell används för exekveringen, men den uppladdade artefakten måste följa det definierade JSON-wrapperformatet.
Exempel
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
}
Exempelrapport
JSON-utdatastruktur (rapporteringsbegränsning)
Rapportering stöder endast en JSON-hierarki på en nivå.
Exempel på stödd format:
{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}
Exempel på ett format som inte stöds:
{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}
Om nästlade strukturer returneras, renderas inte datan i strukturerade kolumner. Istället förekommer den under StdOut.
Notera:
URL-hantering: URL:er accepteras i skriptutdata. URL:er visas som klickbara länkar i rapporteringsvyer där det är tillämpligt.
Översättningshantering: Data visas i samma format som returneras av skriptet utan översättning eller modifiering.
Datum- och tidhantering: Datum- och tidsvärden som returneras som en del av skriptets utdata visas exakt som de returnerades. De konverteras eller normaliseras inte till någon tidszon. Detta säkerställer rå skriptkvalitet utan backend-transformation.
Skapa en anpassad datarapport
Följ dessa steg för att hämta enhetsdata som inte är tillgänglig via standard WXP Insights-telemetri.
Logga in på WXP. Startsidan visas
Från vänstermenyn i WXP, klicka på Analys > Anpassade datarapporter. De befintliga rapporterna visas.
Klicka på Lägg till. Sidan Lägg till rapport visas för att välja eller ladda upp ett skript för anpassad datainsamling.
Varje skript visar en beskrivning, version och operation.
Listan filtreras automatiskt för att visa utvärderingsskript.
Om parametrarna definierades är de förfyllda och redigerbara.
Välj målgruppen genom att välja en eller flera grupper. Scrolla ner för att räkna ut det totala antalet enheter i den valda målgruppen.
Enhetsräkningen visar antalet unika enheter i de valda grupperna.
Om en enhet tillhör flera grupper körs skriptet bara en gång på den enheten.
Lägg till en titel och valfri beskrivning för rapporten.
Publicera manuset.
Hyresgästgräns: En hyresgäst kan ha upp till 10 anpassade datarapporter. För att skapa en elfte rapport måste minst en befintlig rapport tas bort. Alla användare med behörighet att visa rapporter kan komma åt alla anpassade datarapporter inom hyresgästen, oavsett vem som skapade dem.
Tabell för lista över anpassade datarapporter
Följande kolumner visas:
Rapportens namn och beskrivning
Skapad av
Skapad på
Övergripande status
Pågående
Slutförd (max 24 timmar efter att skriptets exekvering startat)
Utgången
Nedlagd
Export
Radera
Följande valideringsregler gäller:
Massradering är inte tillåten.
Bulkexport är inte tillåten.
En rapport med status "Under arbete" kan inte raderas.
Rapporter med statusen Slutförd, Avbrutna eller Utgångna kan raderas.
Rapporter med status som Pågår, Slutförd eller Avbokad kan laddas ner.
Utgångna rapporter kan inte laddas ner.
Integritet och säkerhet
IT-administratör (första användning per hyresgäst)
När en IT-administratör skapar en anpassad datarapport för första gången inom en hyresgäst måste de acceptera villkoren. Denna bekräftelse visas endast en gång och endast till den första IT-administratören i den hyresgästen. Efterföljande IT-administratörer blir inte tillfrågade.
Partneradministratör eller tjänstespecialist
När användaren skapar en anpassad datarapport för en kunds räkning måste de acceptera villkoren en gång per kundhyresgäst. Det godkända är tracker per hyresgäst.
Visning och övervakning av en anpassad datarapport
Varje anpassad datarapport visar följande:
Rapportens namn och beskrivning
Skriptnamn (länkat)
Publikdefinition
Totalt antal enheter
Startdatum och tid
Färdigställandedatum och tid
Utgångsdatum
Rapportstatus
Pågående
Färdigställd
Nedlagd
Utgången
Nedladdningsalternativ
Borttagningsalternativ (om det är berättigat)
Notera: Manuset körs en gång. Den körs inte kontinuerligt eller enligt ett återkommande schema. Användare kan dock köra den när det behövs.
Framstegsindikator
Framstegsfältet visar följande:
Färdiga enheter
Felbelagda enheter
Ej bearbetade enheter
Total publik
Avbryta en rapport
Du kan bara avbryta en anmälan när statusen är Pågår. Vid avbokning:
Statusen uppdateras till Avbruten.
Rapportsidan visar användaren som avbokade och tiden för avbokningen.
Omstart-alternativet dyker upp strax därefter.
Omstart av en rapport
Du kan starta om en rapport som har följande status:
Färdigställd
Nedlagd
Utgången
Beteende:
Startar om på alla originalenheter.
Historisk data raderas.
Manus, parametrar och målgrupp kan inte ändras.
Publiken kan skilja sig om gruppmedlemskapet har ändrats.
Utgångsregler
En anpassad datarapport upphör 11 dagar efter att skriptets körning startat (24-timmars slutförandefönster plus 10 dagars bevarande) eller 10 dagar efter att alla enheter visat status Slutförd eller Felbevarad om de är under 24 timmar.
Om rapporten avbryts upphör den 10 dagar efter avbokningen.
De utgångna rapporterna:
Kan inte laddas ner.
Data tas bort från enhetssidor.
Visning av publicerad anpassad datarapport
Klickbara KPI:er i rapporten
KPI:er visas baserat på enhetens status:
Pågående
Färdigställd
Felbehandlade
Ej behandlad
Beteende:
KPI:er påverkas inte av tabellfiltrering.
Att klicka på en KPI applicerar ett tabellfilter.
Multi-select KPI-filter är tillåtna.
Filter behålls per flik tills de tas bort.
Filter överförs inte mellan flikarna Innehåll och Detaljer.
Att se fliken Innehåll
Innehållsfliken visar endast enheter med status Slutförd.
Standardsorteringen baseras på serienumret.
Följande kolumner visas.
Enhetsserienummer (länkad till respektive enhetsdetaljsida)
Enhetsnamn
En kolumn per dataelement
Ändringar sprids till enhetsdetaljsidan
Utgång (StdOut)
Starttid
Om ingen data returneras, visas meddelandet som leder användaren till fliken Detaljer .
Visning av detaljfliken
Detaljfliken visar alla enheter som definierats i målgruppen, oavsett status. Denna flik används främst för att felsöka enheter som har en annan status än Slutförd.
Detta är standardsorteringsordningen:
Fel
Pågående
Ej behandlad
Färdigställd
Följande kolumner visas:
Enhetsserienummer
Enhetsnamn
Senast inloggad användare
Skript avslutningskod
Utdata (länk till StdOut eller felvy)
Exportera en anpassad datarapport
Användare kan exportera filtrerade resultat till en Excel (XLS)-fil, som innehåller två flikar:
Innehåll
Detaljer
Du kan exportera rapporter i följande statusar:
Pågående
Färdigställd
Nedlagd
Obs: Exporter är inte tillgängliga för utgångna rapporter.
Åtkomst till enhetsinformationssidan
Du kan öppna motsvarande sida för enhetsdetaljer genom att klicka på något serienummer som finns angivet under fliken Innehåll eller Detaljer i rapporten om anpassade data. Detta ger ett bekvämt sätt att se all anpassad data som samlats in för enheten på en central plats, vilket gör felsökningen mer effektiv.
Fliken Anpassad data inkluderar:
Länk till anpassad datarapport
Varje infångat dataelement och värde
Rapporteras bäst före-datum
Status
Manusnamn
Skript avslutningskod
Utgångslänk
Ladda ner XLS-alternativet
De utgångna uppgifterna är inte synliga.
Obs: För slutförda, avbokade eller utgångna rapporter:
Om skriptet tas bort eller alla grupper raderas, visas anropet Create.
Om skriptet och minst en grupp fortfarande finns är den uppmaning till handling som visas Restart.
Utnyttja Custom Data Report API
För ytterligare information, se vår dokumentation från Developer Portal om API:er som låter kunder fråga anpassade datarapporter: https://developers.workforceexperience.hp.com/docs/v1/customdatareport
Kontakta oss
För all hjälp, skapa ett supportärende eller mejla. support@wxp.hp.com