Mukautetut tietoraportit

Johdanto

HP Workforce Experience -alustan (WXP) analytiikkamoduulin räätälöidyt dataraportit mahdollistavat asiakkaille laitetason datan keräämisen, jota ei ole saatavilla tavallisen WXP Insights -agentin kautta. Käyttäjät lataavat PowerShell-skriptejä (paketoituina JSON-muodossa), suorittavat ne valituille laiteryhmille ja tuottavat rakenteellisia analytiikkaraportteja WXP:ssä.

Tämä ominaisuus tukee:

• Skriptipohjainen arviointidatan haku

• Mukautetun dataraportin luominen (enintään 10 per vuokralainen)

• Reaaliaikainen edistymisen seuranta

• Klikattava KPI-hallintapaneeli

• Excel (XLS) -vientiominaisuudet

• Laitetason harjoitukset

Ennakkovaatimukset ja pääsy

Tilausvaatimukset

Asiakkailla tulee olla jokin seuraavista tilauksista:

• WXP Pro -kokeilu

• WXP Pro

• WXP Elite

Roolipohjainen pääsy (RBAC)

Seuraavat roolit käyttävät käyttäjät voivat ajaa skriptejä ja luoda tai tarkastella Custom Data Reports -raportteja:

• IT-hallinto

• Kumppanipalveluasiantuntija

• Partner-ylläpitäjä (valtuutettu ja ei-valtuutettu perehdytetty)

Näillä rooleilla on täysi pääsy ominaisuuteen.

Seuraavien roolien käyttäjät voivat tarkastella Custom Data Reportsia, mutta eivät voi ajaa skriptejä:

• HP-tuki ylläpitäjä

• Raportti ylläpitäjä

Näissä rooleissa peruutus- ja uudelleenkäynnistysvaihtoehtoja ei ole saatavilla. He voivat ladata kelvollisia raportteja, mutta eivät voi aloittaa tai peruuttaa työpaikkoja. Kaikilla muilla rooleilla ei ole pääsyä tähän ominaisuuteen.

Partner-rooleissa asiakasvuokralainen on valittava ennen kuin toiminnallisuus tulee saataville.

Custom Data Reports -ominaisuudessa tehdyt toiminnot tallennetaan auditointilokeihin.

1. Skriptivaatimukset ja datankäsittely

Käsikirjoitusmuoto

Skriptin tulostus on generoitava JSON-muodossa. Skriptitiedosto määrittelee:

• Skriptin metatiedot

• Suoritusominaisuudet

• Valinnaiset parametrit

• Odotettu tulosskeema

• Tietojen näyttämisjärjestys raportissa

PowerShelliä käytetään suoritukseen, mutta ladatun artefaktin on noudatettava määriteltyä JSON-kääremuotoa.

Esimerkki

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
 }

Esimerkkiraportti

JSON-tulostusrakenne (raportointirajoitukset)

Raportointi tukee vain yksitasoista JSON-hierarkiaa.

Esimerkki tuetusta muodosta:

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

Esimerkki tuettomasta muodosta:

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

Jos sisäkkäiset rakenteet palautetaan, data ei renderöity rakenteellisissa sarakkeissa. Sen sijaan se esiintyy StdOutin alla.

Huomautus:

• URL-käsittely: URL-osoitteet hyväksytään skriptitulosteessa. URL-osoitteet näkyvät klikattavina linkkeinä raportointinäkyvissä tarvittaessa.

• Käännöksen käsittely: Data näytetään samassa muodossa, jonka skripti palauttaa, ilman käännöksiä tai muutoksia.

• Päivämäärän ja ajan käsittely: Skriptin tuotosta palautetut päivämäärä- ja aikaarvot näytetään täsmälleen palautetuina. Niitä ei muunneta tai normalisoida mihinkään aikavyöhykkeeseen. Tämä takaa raakan skriptin tarkkuuden ilman taustan muunnoksia.

2. Mukautetun dataraportin luominen

Noudata näitä vaiheita hakeaksesi laitetietoja, joita ei ole saatavilla tavallisen WXP Insights -telemetrian kautta.

1. Kirjaudu WXP:hen. Etusivu näkyy

2. WXP:n vasemmasta valikosta klikkaa Analytics > Custom Data Reports. Nykyiset raportit näytetään.

3. Klikkaa Lisää. Lisää raportti -sivu näytetään skriptin valitsemista tai lataamista varten mukautettuun tiedonkeruuseen.

4. Jokainen skripti näyttää kuvauksen, version ja toiminnon.

   1. Lista suodatetaan automaattisesti näyttämään arviointiskriptejä.

5. Jos parametrit on määritelty, ne ovat valmiiksi täytetty ja muokattavissa.

6. Valitse yleisö valitsemalla yksi tai useampi ryhmä. Selaa alas laskeaksesi valitun yleisön laitteiden kokonaismäärän.

   1. Laitteiden määrä näyttää yksilöllisten laitteiden määrän valittujen ryhmien välillä.

   2. Jos laite kuuluu useampaan ryhmään, skripti suoritetaan kyseisellä laitteella vain kerran.

7. Lisää raporttiin otsikko ja vapaaehtoinen kuvaus.

8. Julkaise käsikirjoitus.

Vuokralaisen raja: Vuokralaisella voi olla enintään 10 Custom Data Report -raporttia. Yhdestoista raportin luomiseksi vähintään yksi olemassa oleva raportti on poistettava. Jokainen käyttäjä, jolla on raporttien katseluoikeudet, voi käyttää kaikkia vuokralaisen omia tietoraportteja riippumatta siitä, kuka ne on luonut.

3. Mukautettujen tietoraporttien listataulu

Seuraavat sarakkeet on esitetty:

• Raportin nimi ja kuvaus

• Luonut

• Luotu

• Yleinen tilanne

  • Kesken

  • Suoritettu (enintään 24 tuntia skriptin suorituksen alkamisen jälkeen)

  • Vanhentunut

  • Peruttu

• Vienti

• Poista

Seuraavat validointisäännöt pätevät:

• Massapoisto ei ole sallittua.

• Massavienti ei ole sallittua.

• Raporttia, jonka tila on "Käynnissä", ei voi poistaa.

• Raportit, joiden tila on Valmis, Peruttu tai Vanhentunut, voidaan poistaa.

• Raportit, joiden tila on käynnissä, valmistunut tai peruutettu, voi ladata.

• Vanhentuneita raportteja ei voi ladata.

3. Yksityisyys ja turvallisuus

IT-hallinto (ensimmäinen käyttö per vuokralainen)

Kun IT-ylläpitäjä luo ensimmäistä kertaa Custom Data Report -raportin vuokralaisessa, hänen on hyväksyttävä ehdot. Tämä vahvistus näytetään vain kerran ja vain ensimmäiselle IT-ylläpitäjälle kyseisessä vuokralaisessa. Seuraavia IT-ylläpitäjiä ei pyydetä.

Partner-ylläpitäjä tai palveluasiantuntija

Kun luodaan Custom Data Report -raporttia asiakkaan puolesta, käyttäjän on hyväksyttävä ehdot kerran per asiakasvuokralainen. Hyväksyttävä on seuranja per vuokralainen.

4. Mukautetun dataraportin tarkastelu ja seuranta

Jokainen Custom Data Report näyttää seuraavat tiedot:

• Raportin nimi ja kuvaus

• Käsikirjoituksen nimi (linkitetty mukaan)

• Yleisön määritelmä

• Laitteiden kokonaismäärä

• Aloituspäivä ja -aika

• Valmistumisaika ja -aika

• Viimeinen käyttöpäivä

• Raportin tila

  • Kesken

  • Valmis

  • Peruttu

  • Vanhentunut

• Latausvaihtoehto

• Poistovaihtoehto (jos se on oikeutettu)

Huomautus: Käsikirjoitus pyörii kerran. Se ei toimi jatkuvasti tai toistuvasti. Käyttäjät voivat kuitenkin käyttää sitä tarvittaessa.

Edistyspalkki

Edistymispalkki näyttää seuraavaa:

• Valmiit laitteet

• Virheelliset laitteet

• Ei-prosessoituja laitteita

• Kokonaisyleisö

Raportin peruuttaminen

Voit peruuttaa ilmoituksen vain, kun tila on käynnissä. Peruutuksen yhteydessä:

• Tila päivittyy muotoon Peruutettu.

• Raporttisivulla näkyy käyttäjä, joka peruutti, sekä peruutusajankohdan.

• Uudelleenkäynnistysvaihtoehto ilmestyy pian sen jälkeen.

Raportin uudelleenkäynnistys

Voit käynnistää raportin uudelleen, joka on seuraavissa tiloissa:

• Valmis

• Peruttu

• Vanhentunut

Käyttäytyminen:

• Käynnistys uudelleen kaikilla alkuperäisillä laitteilla.

• Historialliset tiedot poistetaan.

• Käsikirjoitusta, parametreja ja yleisöä ei voi muuttaa.

• Yleisö voi vaihdella, jos ryhmän jäsenyys on muuttunut.

5. Vanhenemissäännöt

Mukautettu tietoraportti vanhenee 11 päivää skriptin suorituksen alkamisen jälkeen (24 tunnin suoritusikkuna plus 10 päivän säilytys) tai 10 päivää sen jälkeen, kun kaikki laitteet näyttävät valmiin tai virheellisen tilan, jos alle 24 tuntia.

Jos ilmoitus peruutetaan, se vanhenee 10 päivää peruutuksen jälkeen.

Vanhentuneet raportit:

• Ei voi ladata.

• Tiedot poistetaan laitesivuilta.

6. Julkaistun räätälöidyn datan raportin katsominen

Raportin klikattavat KPI:t

KPI:t näytetään laitteen tilan perusteella:

• Kesken

• Valmis

• Virhe

• Ei käsitelty

Käyttäytyminen:

• KPI:t eivät vaikuta taulukkosuodatuksesta.

• KPI:n klikkaaminen käyttää taulukkosuodatinta.

• Monivalintaiset KPI-suodattimet ovat sallittuja.

• Suodattimet säilytetään per välilehti, kunnes ne poistettiin.

• Suodattimet eivät siirry Sisältö- ja Tiedot-välilehtien välillä.

Sisältövälilehden katsominen

Sisältö-välilehdellä näkyy vain laitteet, joiden tila on Valmis.

Oletuslajittelu perustuu sarjanumeroon.

Seuraavat sarakkeet on esitetty.

• Laitteen sarjanumero (linkitetty kyseisen laitteen tietosivulle)

• Laitteen nimi

• Yksi sarake per tietoelementti

  • Muutokset leviävät laitetietosivulle

• Lähtö (StdOut)

• Aloitusaika

Jos tietoja ei palauteta, näytetään viesti, joka ohjaa käyttäjän Tiedot-välilehdelle.

Yksityiskohdat -välilehden katsominen

Tämä on oletuslajittelujärjestys:

1. Virhe

2. Kesken

3. Ei käsitelty

4. Valmis

Seuraavat sarakkeet on esitetty:

• Laitteen sarjanumero

• Laitteen nimi

• Viimeksi kirjautunut käyttäjä

• Skriptin poistumiskoodi

• Tulostus (linkki StdOutiin tai virhenäkymään)

7. Mukautetun dataraportin vienti

Käyttäjät voivat viedä suodatetut tulokset Excel (XLS) -tiedostoon, jossa on kaksi välilehteä:

• Sisältö

• Yksityiskohdat

Voit viedä raportteja seuraavissa tiloissa:

• Kesken

• Valmis

• Peruttu

Huomautus: Vienti ei ole saatavilla vanhentuneille raporteille.

8. Laitteen tietosivun käyttö

Voit avata vastaavan laitetiedot -sivun klikkaamalla mitä tahansa sarjanumeroa, joka on listattu Custom Data Reportin Sisältö- tai Tiedot-välilehdellä. Tämä tarjoaa kätevän tavan tarkastella kaikkia laitteita varten kerättyjä räätälöityjä tietoja keskitetyssä paikassa, mikä tekee vianetsinnästä tehokkaampaa.

Mukautetut tiedot -välilehti sisältää:

• Linkki Custom Data Reportiin

• Jokainen tallennettu tietoelementti ja arvo

• Raportin viimeinen käyttöpäivä

• Tila

• Käsikirjoituksen nimi

• Skriptin poistumiskoodi

• Lähtölinkki

• Lataa XLS-vaihtoehto

Vanhentuneet tiedot eivät ole näkyvissä.

Huomautus: Valmiit, peruutetut tai vanhentuneet raportit:

• Jos skripti poistetaan tai kaikki ryhmät poistetaan, näytetty toimintakutsu on Luo.

• Jos skripti ja ainakin yksi ryhmä ovat vielä olemassa, näytetty toimintakehotus on Restart.

9. Custom Data Report API:n hyödyntäminen

Lisätietoja löytyy Developer Portal -dokumentaatiostamme API-rajapinnoista, joiden avulla asiakkaat voivat hakea räätälöityjä dataraportteja: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Ota yhteyttä

Jos haluat apua, laadi tukitapaus tai sähköposti. support@wxp.hp.com