Introdução
Relatórios de Dados Personalizados no módulo de Análise da plataforma HP Workforce Experience (WXP) permitem que os clientes coletem dados em nível de dispositivo que não estão disponíveis pelo agente padrão WXP Insights. Os usuários enviam scripts PowerShell (embalados em formato JSON), executam-nos em grupos selecionados de dispositivos e geram relatórios analíticos estruturados dentro do WXP.
Este recurso suporta:
Recuperação de dados de avaliação baseada em scripts
Criação de Relatório de Dados Personalizado (máximo 10 por inquilino)
Monitoramento de progresso em tempo real
Painel de KPI clicável
Capacidades de exportação do Excel (XLS)
Perfurações em nível de dispositivo
Pré-requisitos e acesso
Requisitos de assinatura
Os clientes devem ter uma das seguintes assinaturas:
Teste WXP Pro
WXP Pro
WXP Elite
Acesso Baseado em Funções (RBAC)
Usuários com os seguintes papéis podem executar scripts e criar ou visualizar Relatórios de Dados Personalizados:
Administração de TI
Especialista em Serviços a Parceiros
Administrador de Parceiros (autorizado e não autorizado no integrado)
Esses cargos têm acesso total ao recurso.
Usuários com as seguintes funções podem visualizar Relatórios de Dados Personalizados, mas não podem executar scripts:
Administrador de Suporte HP
Administração de Relatórios
Para esses papéis, as opções de Cancelar e Reiniciar não estão disponíveis. Eles podem baixar relatórios elegíveis, mas não podem iniciar ou cancelar trabalhos. Todos os outros cargos não têm acesso a esse recurso.
Para funções de Parceiro, um tenant cliente deve ser selecionado antes que a funcionalidade fique disponível.
As ações realizadas dentro do recurso Relatórios de Dados Personalizados são mantidas nos logs de auditoria.
Requisitos de Script e Tratamento de Dados
Formato do Roteiro
A saída do script deve ser gerada em formato JSON. O arquivo script define:
Metadados do script
Propriedades de execução
Parâmetros opcionais
Esquema de saída esperado
A ordem em que os dados são exibidos no relatório
O PowerShell é usado para execução, mas o artefato enviado deve seguir o formato de wrapper JSON definido.
Exemplo
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
}
Relatório de Exemplo
Estrutura de Saída JSON (Limitação de Relatório)
O relatório suporta apenas uma hierarquia JSON de nível único.
Exemplo de formato suportado:
{
"BIOSVersion": "1.23.4",
"ThinkCellEnabled": "True",
"AIExtensionDetected": "Yes"
}
Exemplo de formato não suportado:
{
"Device": {
"BIOS": {
"Version": "1.23.4"
}
}
}
Se estruturas aninhadas forem retornadas, os dados não são renderizados em colunas estruturadas. Em vez disso, aparece como StdOut.
Nota:
Tratamento de URLs: URLs são aceitas na saída de scripts. URLs aparecem como links clicáveis nas visualizações de relatório, quando aplicável.
Tratamento de tradução: Os dados são exibidos no mesmo formato retornado pelo script, sem tradução ou modificação.
Tratamento de data e hora: Os valores de data e hora retornados como parte da saída do script são exibidos exatamente como retornados. Eles não são convertidos ou normalizados para nenhum fuso horário. Isso garante fidelidade bruta do script sem transformação no backend.
Criando um Relatório de Dados Personalizado
Siga estes passos para recuperar dados do dispositivo que não estejam disponíveis por meio da telemetria padrão WXP Insights.
Faça login na WXP. A página inicial é exibida
No menu esquerdo do WXP, clique em Análise > Relatórios de Dados Personalizados. Os relatórios existentes são exibidos.
Clique em Adicionar. A página de Adicionar relatório é exibida para selecionar ou enviar um script para coleta de dados personalizada.
Cada script exibe uma Descrição, Versão e Operação.
A lista é automaticamente filtrada para mostrar scripts de Avaliação.
Se os parâmetros foram definidos, eles já estão preenchidos e editáveis.
Escolha o público selecionando um ou mais grupos. Role para baixo para calcular o número total de dispositivos no público selecionado.
A contagem de dispositivos mostra o número de dispositivos únicos entre os grupos selecionados.
Se um dispositivo pertence a vários grupos, o script roda apenas uma vez nesse dispositivo.
Adicione um título e uma descrição opcional para o relatório.
Publique o roteiro.
Limite de Inquilino: Um inquilino pode ter até 10 Relatórios de Dados Personalizados. Para criar um décimo primeiro relatório, pelo menos um relatório existente deve ser excluído. Qualquer usuário com permissões de visualização de relatórios pode acessar todos os Relatórios de Dados Personalizados dentro do tenant, independentemente de quem os criou.
Tabela de Lista de Relatórios de Dados Personalizados
As colunas a seguir são exibidas:
Nome do Relatório e Descrição
Criado por
Criado em
Status Geral
Em andamento
Concluído (máximo 24 horas após o início da execução do script)
Expirado
Cancelado
Exportação
Excluir
As seguintes regras de validação se aplicam:
Exclusão em massa não é permitida.
Exportação em grande escala não é permitida.
Um relatório com status "Em andamento" não pode ser excluído.
Relatórios com status Concluído, Cancelado ou Expirado podem ser excluídos.
Relatórios com status em andamento, Concluído ou Cancelado podem ser baixados.
Relatórios vencidos não podem ser baixados.
Privacidade e segurança
Administração de TI (Primeiro Uso por Inquilino)
Quando um Administrador de TI cria um Relatório de Dados Personalizado pela primeira vez dentro de um inquilino, ele deve aceitar os termos. Essa confirmação é mostrada apenas uma vez e somente ao primeiro Administrador de TI naquele locatário. Administradores de TI subsequentes não são solicitados.
Administrador de Parceiros ou Especialista em Serviços
Ao criar um Relatório de Dados Personalizado em nome de um cliente, o usuário deve aceitar os termos uma vez por inquilino do cliente. O aceitável é rastrear por inquilino.
Visualização e Monitoramento de um Relatório de Dados Personalizado
Cada Relatório de Dados Personalizados exibe o seguinte:
Nome do relatório e descrição
Nome do script (linkado)
Definição de público
Número total de dispositivos
Data e hora de início
Data e hora de conclusão
Data de validade
Status do relatório
Em andamento
Concluído
Cancelado
Expirado
Opção de download
Opção de exclusão (se elegível)
Nota: O script roda uma única vez. Não funciona continuamente ou em um cronograma recorrente. No entanto, os usuários podem executá-lo sempre que necessário.
Barra de Progresso
A barra de progresso mostra o seguinte:
Dispositivos concluídos
Dispositivos com erro
Dispositivos não processados
Público total
Cancelando um Relatório
Você só pode cancelar um relatório quando o status estiver em andamento. Após o cancelamento:
As atualizações de status para Cancelado.
A página de Relatório mostra o usuário que cancelou e o horário do cancelamento.
A opção Reiniciar aparece logo em seguida.
Reiniciando um Relatório
Você pode reiniciar um relatório que esteja nos seguintes status:
Concluído
Cancelado
Expirado
Comportamento:
Reinicia em todos os dispositivos originais.
Os dados históricos são excluídos.
Roteiro, parâmetros e público não podem ser modificados.
O público pode diferir se a filiação ao grupo tiver mudado.
Regras de Validade
Um Relatório de Dados Personalizado expira 11 dias após o início da execução do script (janela de conclusão de 24 horas mais 10 dias de retenção) ou 10 dias após todos os dispositivos mostrarem o status de Concluído ou Erro, se for inferior a 24 horas.
Se o relatório for cancelado, ele expira 10 dias após o cancelamento.
Os relatórios vencidos:
Não pode ser baixada.
Os dados são removidos das páginas dos dispositivos.
Visualizando o Relatório de Dados Personalizados Publicado
KPIs clicáveis no relatório
KPIs são exibidos com base no status do dispositivo:
Em andamento
Concluído
Erro
Não Processado
Comportamento:
KPIs não são afetados pelo filtro de tabelas.
Clicar em um KPI aplica um filtro de tabela.
Filtros de KPI com múltipla seleção são permitidos.
Filtros mantidos por aba até serem removidos.
Filtros não são transferidos entre as abas de Conteúdo e Detalhes.
Visualizando a Aba de Conteúdo
A aba Conteúdo mostra apenas dispositivos com status Concluído.
A ordenação padrão é baseada no Número de Série.
As colunas a seguir são exibidas.
Número de Série do Dispositivo (vinculado à página de detalhes do respectivo dispositivo)
Nome do Dispositivo
Uma coluna por elemento de dados
Mudanças propagadas para a página de detalhes do dispositivo
Saída (StdOut)
Horário de Início
Se nenhum dado for retornado, a mensagem é exibida direcionando o usuário para a aba Detalhes .
Visualizando a Aba de Detalhes
A aba Detalhes mostra todos os dispositivos definidos no público, independentemente do status. Esta aba é usada principalmente para diagnosticar dispositivos que tenham um status diferente de Concluído.
Esta é a ordem padrão de ordenação:
Erro
Em andamento
Não Processado
Concluído
As colunas a seguir são exibidas:
Número de Série do Dispositivo
Nome do Dispositivo
Último usuário logado
Código de Saída do Script
Saída (link para a vista StdOut ou Erro)
Exportando um Relatório de Dados Personalizado
Os usuários podem exportar resultados filtrados para um arquivo Excel (XLS), que inclui duas abas:
Conteúdo
Detalhes
Você pode exportar relatórios nos seguintes status:
Em andamento
Concluído
Cancelado
Nota: Exportações não disponíveis para relatórios de expiração.
Acessando a Página de Detalhes do Dispositivo
Você pode abrir a página de Detalhes do Dispositivo correspondente clicando em qualquer Número de Série listado na aba Conteúdo ou Detalhes do Relatório de Dados Personalizados. Isso oferece uma maneira conveniente de visualizar todos os dados personalizados coletados para aquele dispositivo em um local centralizado, tornando a solução de problemas mais eficiente.
A aba Dados Personalizados inclui:
Link para o Relatório de Dados Personalizados
Cada elemento de dados capturado e valor
Data de validade do relatório
Status
Nome do Roteiro
Código de Saída do Script
Link de saída
Opção XLS para baixar
Os dados expirados não são visíveis.
Nota: Para relatórios concluídos, cancelados ou expirados:
Se o script for excluído ou todos os grupos forem excluídos, a chamada para ação exibida é Criar.
Se o script e pelo menos um grupo ainda existirem, a chamada para ação exibida é Reiniciar.
Aproveitando a API de Relatórios de Dados Personalizados
Para informações adicionais, consulte nossa documentação do Portal para Desenvolvedores sobre APIs que permitem aos clientes consultar relatórios de dados personalizados: https://developers.workforceexperience.hp.com/docs/v1/customdatareport
Entre em contato conosco
Para qualquer ajuda, crie um caso de suporte ou envie um e-mail support@wxp.hp.com.