Informes de datos personalizados

  • Publicado el Mar 18, 2026
  • 9 minuto(s) leído(s)
  • s
  • s
 Prev Next

Introducción

Los Informes de Datos Personalizados en el módulo de Analítica de la plataforma HP Workforce Experience (WXP) permiten a los clientes recopilar datos a nivel de dispositivo que no están disponibles a través del agente estándar de WXP Insights. Los usuarios suben scripts PowerShell (empaquetados en formato JSON), los ejecutan en grupos de dispositivos seleccionados y generan informes analíticos estructurados dentro de WXP.

Esta función admite a:

  • Recuperación de datos de evaluación basada en scripts

  • Creación de informes de datos personalizados (máximo 10 por inquilino)

  • Monitorización en tiempo real del progreso

  • Panel de KPI clicable

  • Capacidades de exportación de Excel (XLS)

  • Perforaciones a nivel de dispositivo

Requisitos previos y acceso

Requisitos de suscripción

Los clientes deben tener una de las siguientes suscripciones:

  • Prueba de WXP Pro

  • WXP Pro

  • WXP Elite

Acceso Basado en Roles (RBAC)

Los usuarios con los siguientes roles pueden ejecutar scripts y crear o visualizar Informes de Datos Personalizados:

  • Administración de TI

  • Especialista en Servicios para Socios

  • Administrador de socios (autorizado y no autorizado incorporado)

Estos puestos tienen acceso completo a la función.

Los usuarios con los siguientes roles pueden ver Informes de Datos Personalizados pero no pueden ejecutar scripts:

  • Administrador de soporte de HP

  • Administrador de informes

Para estos roles, las opciones de Cancelar y Reiniciar no están disponibles. Pueden descargar informes elegibles pero no pueden iniciar ni cancelar trabajos. Todos los demás puestos no tienen acceso a esta función.

Para los roles de Socio, debe seleccionarse un tenant cliente antes de que la funcionalidad esté disponible.

Las acciones realizadas dentro de la función de Informes de Datos Personalizados se conservan en los registros de auditoría.

  1. Requisitos de scripts y gestión de datos

Formato de guion

La salida del script debe generarse en formato JSON. El archivo de script define:

  • Metadatos de los scripts

  • Propiedades de ejecución

  • Parámetros opcionales

  • Esquema de salida esperado

  • El orden en que se muestran los datos en el informe

Se utiliza PowerShell para la ejecución, pero el artefacto subido debe seguir el formato de envolvente JSON definido.

Ejemplo

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
 }

Informe de ejemplo

Estructura de salida JSON (limitación de informes)

Los informes solo admiten una jerarquía JSON de un solo nivel.

Ejemplo de formato soportado:

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

Ejemplo de formato no soportado:

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

Si se devuelven estructuras anidadas, los datos no se renderizan en columnas estructuradas. En cambio, aparece bajo StdOut.

Nota:

  • Gestión de URLs: Las URLs se aceptan en la salida de scripts. Las URLs aparecen como enlaces clicables en las vistas de informes cuando corresponde.

  • Manejo de traducción: Los datos se muestran en el mismo formato que devuelve el guion, sin traducción ni modificación.

  • Gestión de fecha y hora: Los valores de fecha y hora devueltos como parte de la salida del script se muestran exactamente como se devolvieron. No se convierten ni normalizan a ninguna zona horaria. Esto garantiza la fidelidad bruta del guion sin transformaciones en el backend.

  1. Creación de un informe de datos personalizado

Sigue estos pasos para recuperar datos de dispositivos que no estén disponibles mediante la telemetría estándar de WXP Insights.

  1. Inicia sesión en WXP. Se muestra la página principal

  2. Desde el menú izquierdo de WXP, haz clic en Analítica > Informes de Datos Personalizados. Se muestran los informes existentes.

  3. Haz clic en Añadir. La página de Añadir informe se muestra para seleccionar o subir un script para la recopilación de datos personalizada.

  4. Cada script muestra una Descripción, Versión y Operación.

    1. La lista se filtra automáticamente para mostrar los scripts de Evaluación.

  5. Si los parámetros estaban definidos, ya están pre-rellenados y editables.

  6. Elige el público seleccionando uno o más grupos. Desplázate hacia abajo para calcular el número total de dispositivos en la audiencia seleccionada.

    1. El recuento de dispositivos muestra el número de dispositivos únicos entre los grupos seleccionados.

    2. Si un dispositivo pertenece a varios grupos, el script se ejecuta solo una vez en ese dispositivo.

  7. Añade un título y una descripción opcional para el informe.

  8. Publica el guion.

Límite de inquilinos: Un inquilino puede tener hasta 10 Informes de Datos Personalizados. Para crear un undécimo informe, al menos uno existente debe ser eliminado. Cualquier usuario con permisos para ver informes puede acceder a todos los Informes de Datos Personalizados dentro del tenant, independientemente de quién los haya creado.

  1. Tabla de Lista de Informes de Datos Personalizados

Se muestran las siguientes columnas:

  • Nombre del informe y descripción

  • Creado por

  • Creado en

  • Estado general

    • En Progreso

    • Completado (máximo 24 horas después del inicio de la ejecución del script)

    • Caducado

    • Cancelado

  • Exportación

  • Borrar

Se aplican las siguientes reglas de validación:

  • No se permite la eliminación masiva.

  • No se permite la exportación a granel.

  • Un informe con estado "En progreso" no puede ser eliminado.

  • Los informes con estado Completado, Cancelado o Caducado pueden ser eliminados.

  • Se pueden descargar informes con estado como En progreso, Completado o Cancelado.

  • No se pueden descargar los informes caducados.

  1. Privacidad y seguridad

Administración de TI (Primer Uso Por Inquilino)

Cuando un Administrador de TI crea por primera vez un Informe de Datos Personalizado dentro de un inquilino, debe aceptar los términos. Esta confirmación se muestra solo una vez y únicamente al primer administrador de TI en ese inquilino. No se solicita a los administradores de TI posteriores.

Administrador de Socios o Especialista en Servicio

Al crear un Informe de Datos Personalizado en nombre de un cliente, el usuario debe aceptar los términos una vez por cada inquilino del cliente. Lo aceptable es un seguimiento por inquilino.

  1. Visualización y seguimiento de un informe de datos personalizado

Cada Informe de Datos Personalizados muestra lo siguiente:

  • Nombre del informe y descripción

  • Nombre del guion (enlazado)

  • Definición de audiencia

  • Número total de dispositivos

  • Fecha y hora de inicio

  • Fecha y hora de finalización

  • Fecha de caducidad

  • Estado del informe

    • En Progreso

    • Completado

    • Cancelado

    • Caducado

  • Opción de descarga

  • Opción de eliminar (si es elegible)

Nota: El script se ejecuta una sola vez. No se ejecuta de forma continua ni con un horario recurrente. Sin embargo, los usuarios pueden ejecutarlo cuando sea necesario.

Barra de progreso

La barra de progreso muestra lo siguiente:

  • Dispositivos terminados

  • Dispositivos con errores

  • Dispositivos no procesados

  • Audiencia total

Cancelación de un informe

Solo puedes cancelar un informe cuando el estado esté en curso. Tras la cancelación:

  • El estado se actualiza a Cancelado.

  • La página de Informe muestra el usuario que canceló y la hora de la cancelación.

  • La opción de Reiniciar aparece poco después.

Reiniciar un informe

Puedes reiniciar un informe que esté en los siguientes estados:

  • Completado

  • Cancelado

  • Caducado

Comportamiento:

  • Se reinicia en todos los dispositivos originales.

  • Se eliminan los datos históricos.

  • El guion, los parámetros y la audiencia no pueden modificarse.

  • La audiencia puede diferir si la membresía del grupo ha cambiado.

  1. Reglas de caducidad

Un Informe de Datos Personalizado expira 11 días después del inicio de la ejecución del script (ventana de finalización de 24 horas más 10 días de retención) o 10 días después de que todos los dispositivos muestren el estado de Completado o Error si hay menos de 24 horas.

Si el informe se cancela, caduca 10 días después de la cancelación.

Los informes caducados:

  • No se puede descargar.

  • Los datos se eliminan de las páginas de dispositivos.

  1. Consulta del informe de datos personalizados publicado

KPIs clicables en el informe

Los KPIs se muestran en función del estado del dispositivo:

  • En Progreso

  • Completado

  • Error

  • No procesado

Comportamiento:

  • Los KPIs no se ven afectados por el filtrado de tablas.

  • Hacer clic en un KPI aplica un filtro de tabla.

  • Se permiten filtros KPI de selección múltiple.

  • Los filtros se mantienen por pestaña hasta que se eliminen.

  • Los filtros no se transfieren entre las pestañas de Contenido y Detalles.

Visualización de la pestaña de contenido

La pestaña de Contenido muestra solo dispositivos con estado Completado.

La ordenación por defecto se basa en el número de serie.

Se muestran las siguientes columnas.

  • Número de serie del dispositivo (vinculado a la página de detalles del dispositivo correspondiente)

  • Nombre del dispositivo

  • Una columna por elemento de datos

    • Los cambios se propagan a la página de detalles del dispositivo

  • Salida (StdOut)

  • Hora de inicio

Si no se devuelven datos, se muestra un mensaje que dirige al usuario a la pestaña Detalles .

Ver la pestaña de Detalles

La pestaña de Detalles muestra todos los dispositivos definidos en la audiencia, independientemente del estado. Esta pestaña se utiliza principalmente para diagnosticar dispositivos que tienen un estado distinto a Completado.

Este es el orden de clasificación por defecto:

  1. Error

  2. En Progreso

  3. No procesado

  4. Completado

Se muestran las siguientes columnas:

  • Número de serie del dispositivo

  • Nombre del dispositivo

  • Último usuario iniciado sesión

  • Código de salida del script

  • Salida (enlace a vista StdOut o Error)

  1. Exportación de un informe de datos personalizado

Los usuarios pueden exportar resultados filtrados a un archivo Excel (XLS), que incluye dos pestañas:

  • Contenido

  • Detalles

Puedes exportar informes en los siguientes estados:

  • En Progreso

  • Completado

  • Cancelado

Nota: Exportaciones no disponibles para informes caducados.

  1. Página de Acceso a Detalles del Dispositivo

Puedes abrir la página correspondiente de Detalles del Dispositivo haciendo clic en cualquier Número de Serie que aparezca en la pestaña Contenido o Detalles del Informe de Datos Personalizados. Esto proporciona una forma cómoda de ver todos los datos personalizados recopilados para ese dispositivo en una ubicación centralizada, haciendo que la resolución de problemas sea más eficiente.

La pestaña de Datos Personalizados incluye:

  • Enlace al informe de datos personalizado

  • Cada elemento de datos y valor capturado

  • Fecha de caducidad del informe

  • Estado

  • Nombre del guion

  • Código de salida del script

  • Enlace de salida

  • Opción XLS para descargar

Los datos caducados no son visibles.

Nota: Para informes completados, cancelados o caducados:

  • Si el script se elimina o se eliminan todos los grupos, la llamada a la acción que se muestra es Crear.

  • Si el guion y al menos un grupo siguen existiendo, la llamada a la acción que se muestra es Reiniciar.

  1. Aprovechando la API de Informes de Datos Personalizados

Para más información, consulte nuestra documentación del Portal para Desarrolladores sobre APIs que permiten a los clientes consultar informes de datos personalizados: https://developers.workforceexperience.hp.com/docs/v1/customdatareport

Contáctanos

Para cualquier ayuda, crea un caso de soporte o un correo electrónico support@wxp.hp.com.

Artículos relacionados