Introduction
Les rapports de données personnalisés dans le module Analytics de la plateforme HP Workforce Experience (WXP) permettent aux clients de collecter des données au niveau de l’appareil qui ne sont pas disponibles via l’agent standard WXP Insights. Les utilisateurs téléchargent des scripts PowerShell (emballés en format JSON), les exécutent sur des groupes d’appareils sélectionnés et génèrent des rapports analytiques structurés dans WXP.
Cette fonctionnalité prend en compte :
Récupération des données d’évaluation basée sur des scripts
Création de rapports de données personnalisés (maximum 10 par locataire)
Suivi en temps réel de l’avancement
Tableau de bord KPI cliquable
Capacités d’exportation d’Excel (XLS)
Forages au niveau des dispositifs
Prérequis et accès
Exigences d’abonnement
Les clients doivent avoir l’un des abonnements suivants :
Essai WXP Pro
WXP Pro
WXP Elite
Accès basé sur les rôles (RBAC)
Les utilisateurs ayant les rôles suivants peuvent exécuter des scripts et créer ou consulter des rapports de données personnalisés :
Administrateur informatique
Spécialiste des services partenaires
Administrateur partenaire (autorisé et non autorisé intégré)
Ces rôles ont un accès complet à la fonctionnalité.
Les utilisateurs ayant les rôles suivants peuvent consulter des rapports de données personnalisés mais ne peuvent pas exécuter de scripts :
Administrateur Support HP
Administrateur de rapport
Pour ces rôles, les options Annuler et Redémarrer ne sont pas disponibles. Ils peuvent télécharger des rapports éligibles mais ne peuvent ni initier ni annuler des emplois. Tous les autres rôles n’ont pas accès à cette fonctionnalité.
Pour les rôles de partenaire, un locataire client doit être sélectionné avant que la fonctionnalité ne devienne disponible.
Les actions effectuées dans la fonctionnalité Rapports de données personnalisés sont conservées dans les journaux d’audit.
Exigences de script et gestion des données
Script Format
La sortie du script doit être générée au format JSON. Le fichier script définit :
Métadonnées de script
Propriétés d’exécution
Paramètres optionnels
Schéma de sortie attendu
L’ordre dans lequel les données sont affichées dans le rapport
PowerShell est utilisé pour l’exécution, mais l’artefact téléchargé doit suivre le format de wrapper JSON défini.
Exemple
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
}
Rapport exemple
Structure de sortie JSON (limitation de rapport)
Les rapports ne supportent qu’une hiérarchie JSON à un seul niveau.
Exemple de format pris en charge :
{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}
Exemple de format non pris en charge :
{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}
Si des structures imbriquées sont retournées, les données ne sont pas rendues en colonnes structurées. À la place, il apparaît sous StdOut.
Note :
Gestion des URL : Les URL sont acceptées dans la sortie des scripts. Les URL apparaissent sous forme de liens cliquables dans les vues de rapports lorsque cela est pertinent.
Gestion de la traduction : Les données sont affichées dans le même format que le script sans traduction ni modification.
Gestion de la date et de l’heure : Les valeurs de date et d’heure retournées dans la sortie du script sont affichées exactement comme elles ont été renvoyées. Ils ne sont ni convertis ni normalisés à aucun fuseau horaire. Cela garantit une fidélité brute des scripts sans transformation en arrière-plan.
Création d’un rapport de données personnalisé
Suivez ces étapes pour récupérer les données de l’appareil qui ne sont pas disponibles via la télémétrie standard WXP Insights.
Connectez-vous à WXP. La page d’accueil est affichée
Dans le menu de gauche de WXP, cliquez sur Analytique > Rapports de données personnalisés. Les rapports existants sont affichés.
Cliquez sur Ajouter. La page Ajouter un rapport s’affiche pour sélectionner ou télécharger un script pour la collecte de données personnalisées.
Chaque script affiche une description, une version et un fonctionnement.
La liste est automatiquement filtrée pour afficher les scripts d’évaluation.
Si des paramètres étaient définis, ils sont pré-remplis et modifiables.
Choisissez le public en sélectionnant un ou plusieurs groupes. Faites défiler vers le bas pour calculer le nombre total d’appareils dans le public sélectionné.
Le nombre d’appareils indique le nombre d’appareils uniques parmi les groupes sélectionnés.
Si un appareil appartient à plusieurs groupes, le script ne s’exécute qu’une seule fois sur cet appareil.
Ajoutez un titre et une description optionnelle pour le rapport.
Publiez le scénario.
Limite de locataire : Un locataire peut disposer d’un maximum de 10 rapports de données personnalisés. Pour créer un onzième rapport, au moins un rapport existant doit être supprimé. Tout utilisateur disposant des permissions de consultation de rapports peut accéder à tous les rapports de données personnalisés du locataire, quel que soit leur auteur.
Tableau de liste des rapports de données personnalisés
Les colonnes suivantes sont affichées :
Nom du rapport et description
Créé par
Créé sur
Statut général
En cours
Terminé (maximum 24 heures après le début de l’exécution du script)
Expiré
Annulé
Exportation
Supprimer
Les règles de validation suivantes s’appliquent :
La suppression massive n’est pas autorisée.
L’exportation en gros n’est pas autorisée.
Un rapport avec un statut « En cours » ne peut pas être supprimé.
Les rapports avec statut Terminé, Annulé ou Expiré peuvent être supprimés.
Les rapports avec statut en cours, Terminé ou Annulé peuvent être téléchargés.
Les rapports expirés ne peuvent pas être téléchargés.
Confidentialité et sécurité
Administration informatique (Première utilisation par locataire)
Lorsqu’un administrateur informatique crée pour la première fois un rapport de données personnalisé dans un locataire, il doit accepter les conditions. Cette confirmation n’est montrée qu’une seule fois et uniquement au premier administrateur informatique dans ce locataire. Les administrateurs informatiques suivants ne sont pas sollicités.
Administrateur partenaire ou spécialiste du service
Lors de la création d’un rapport de données personnalisé au nom d’un client, l’utilisateur doit accepter les conditions une fois par locataire client. L’acceptable est un suivi par locataire.
Consultation et suivi d’un rapport de données personnalisé
Chaque rapport de données personnalisé affiche les éléments suivants :
Nom du rapport et description
Nom du script (lié)
Définition du public
Nombre total d’appareils
Date et heure de début
Date et heure d’achèvement
Date d’expiration
Statut du rapport
En cours
Achèvement
Annulé
Expiré
Option de téléchargement
Option de suppression (si éligible)
Note : Le script s’exécute une seule fois. Il ne fonctionne pas de façon continue ni selon un calendrier récurrent. Cependant, les utilisateurs peuvent l’exécuter quand ils sont nécessaires.
Barre de progression
La barre de progression indique ce qui suit :
Dispositifs terminés
Dispositifs avec des erreurs
Dispositifs non traités
Public total
Annuler un rapport
Vous ne pouvez annuler un signalement que lorsque le statut est en cours. Après l’annulation :
Les mises à jour de statut de Annulé.
La page de rapport affiche l’utilisateur qui a annulé et l’heure de l’annulation.
L’option Redémarrage apparaît peu après.
Redémarrer un rapport
Vous pouvez relancer un rapport dans les statuts suivants :
Achèvement
Annulé
Expiré
Comportement :
Redémarre sur tous les appareils d’origine.
Les données historiques sont supprimées.
Le script, les paramètres et le public ne peuvent pas être modifiés.
Le public peut différer si l’adhésion au groupe a changé.
Règles d’expiration
Un Rapport de Données Personnalisé expire 11 jours après le début de l’exécution du script (fenêtre de complétion de 24 heures plus 10 jours de rétention) ou 10 jours après que tous les appareils affichent le statut Terminé ou Erreur si cela fait moins de 24 heures.
Si le rapport est annulé, il expire 10 jours après l’annulation.
Les rapports expirés :
Impossible de télécharger.
Les données sont supprimées des pages d’appareils.
Consultation du rapport de données personnalisées publié
KPI cliquables sur le rapport
Les KPI sont affichés en fonction de l’état de l’appareil :
En cours
Achèvement
Erreur
Non traité
Comportement :
Les KPI ne sont pas affectés par le filtrage de tables.
Cliquer sur un KPI applique un filtre de table.
Les filtres KPI à sélection multiple sont autorisés.
Les filtres sont conservés par onglet jusqu’à leur retraite.
Les filtres ne se transfèrent pas entre les onglets Contenu et Détails.
Affichage de l’onglet Contenu
L’onglet Contenu affiche uniquement les appareils avec le statut Terminé.
Le tri par défaut est basé sur le numéro de série.
Les colonnes suivantes sont affichées.
Numéro de série de l’appareil (lié à la page de détails des appareils respectifs)
Nom de l’appareil
Une colonne par élément de données
Les modifications se propagent à la page de détails de l’appareil
Sortie (StdOut)
Heure de début
Si aucune donnée n’est retournée, un message s’affiche dirigeant l’utilisateur vers l’onglet Détails .
Affichage de l’onglet Détails
L’onglet Détails affiche tous les appareils définis dans le public, quel que soit leur statut. Cet onglet est principalement utilisé pour dépanner les appareils ayant un statut autre que Terminé.
Voici l’ordre de tri par défaut :
Erreur
En cours
Non traité
Achèvement
Les colonnes suivantes sont affichées :
Numéro de série de l’appareil
Nom de l’appareil
Dernier utilisateur connecté
Code de sortie de script
Sortie (lien vers la vue StdOut ou Error)
Exportation d’un rapport de données personnalisé
Les utilisateurs peuvent exporter les résultats filtrés vers un fichier Excel (XLS), qui comprend deux onglets :
Contenu
Détails
Vous pouvez exporter des rapports dans les statuts suivants :
En cours
Achèvement
Annulé
Note : Les exportations ne sont pas disponibles pour les rapports expirés.
Accès à la page des détails de l’appareil
Vous pouvez ouvrir la page Détails de l’appareil correspondante en cliquant sur n’importe quel numéro de série indiqué dans l’onglet Contenu ou Détails du Rapport de Données Personnalisées. Cela offre un moyen pratique de consulter toutes les données personnalisées collectées pour cet appareil dans un emplacement centralisé, rendant le dépannage plus efficace.
L’onglet Données personnalisées comprend :
Lien vers un rapport de données personnalisé
Chaque élément de données et valeur capturés
Date d’expiration du rapport
Statut
Nom du script
Code de sortie de script
Liaison de sortie
Option téléchargement XLS
Les données expirées ne sont pas visibles.
Note : Pour les rapports complétés, annulés ou expirés :
Si le script est supprimé ou si tous les groupes sont supprimés, l’appel à l’action affiché est Créer.
Si le script et au moins un groupe existent encore, l’appel à l’action affiché est Restart.
Exploitation de l’API de Rapport de Données Personnalisé
Pour plus d’informations, consultez notre documentation du Portail Développeur sur les API permettant aux clients d’interroger des rapports de données personnalisés : https://developers.workforceexperience.hp.com/docs/v1/customdatareport
Contactez-nous
Pour toute assistance, créez un dossier de support ou envoyez un e-mail support@wxp.hp.com.