--- title: "Relatórios de Dados Personalizados" slug: "custom-data-reports" updated: 2026-03-18T15:26:29Z published: 2026-03-18T15:33:39Z canonical: "learn.workforceexperience.hp.com/custom-data-reports" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt > Use this file to discover all available pages before exploring further. # Relatórios de Dados Personalizados ## 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. 1. ### 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 ```plaintext 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 ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/image-WD0Z1WVW.png?sv=2026-02-06&spr=https&st=2026-11-16T19%3A55%3A10Z&se=2026-11-16T20%3A55%3A10Z&sr=b&sp=r&sig=BVBRTws2LP8el0N7wBBXTKFijpHgFQQre%2BxzBnyTDLc%3D) #### 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:** ```plaintext { "BIOSVersion": "1.23.4", "ThinkCellEnabled": "True", "AIExtensionDetected": "Yes" } ``` **Exemplo de formato não suportado:** ```plaintext { "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. 1. ### 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. 1. Faça login na WXP. A **página inicial** é exibida 2. No menu esquerdo do WXP, clique em **Análise** > **Relatórios de Dados Personalizados**. Os relatórios existentes são exibidos. 3. Clique **em Adicionar**. A **página de Adicionar relatório** é exibida para selecionar ou enviar um script para coleta de dados personalizada. 4. Cada script exibe uma **Descrição**, **Versão** e **Operação**. 1. A lista é automaticamente filtrada para mostrar scripts de Avaliação. 5. Se os parâmetros foram definidos, eles já estão preenchidos e editáveis. 6. Escolha o público selecionando um ou mais grupos. Role para baixo para calcular o número total de dispositivos no público selecionado. 1. A contagem de dispositivos mostra o número de dispositivos únicos entre os grupos selecionados. 2. Se um dispositivo pertence a vários grupos, o script roda apenas uma vez nesse dispositivo. 7. Adicione um título e uma descrição opcional para o relatório. 8. 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. 1. ### 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. 1. ### 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. 1. ### 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. 1. ### 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. 1. ### 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: 1. Erro 2. Em andamento 3. Não Processado 4. 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) 1. ### 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. 1. ### 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**. 1. ### 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](https://developers.workforceexperience.hp.com/docs/v1/customdatareport) ### Entre em contato conosco Para qualquer ajuda, [crie um caso](https://learn.workforceexperience.hp.com/docs/pt/creating-a-support-case) de suporte ou envie um e-mail `support@wxp.hp.com`.