Criar uma visualização de pontuação em tempo real para um widget de pontuação

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Para ver a pontuação atual, use uma visualização de pontuação em tempo real em um widget de pontuação. Você também pode mostrar uma linha de tendência de pontuações.

    Antes de Iniciar

    • O indicador para o qual você deseja as pontuações em tempo real deve ter a propriedade Mostrar pontuação em tempo real habilitada.
    • Função necessária: pa_power_user ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Este recurso faz parte do front-end IU principal. Ele não é compatível com Análise da plataforma painéis ou Construtor de IU páginas, exceto de forma limitada quando migrado no modo de compatibilidade. Para criar componentes Análise da plataforma, consulte Visualizações de dados no Análise da plataforma ou Filtros em Análise da plataforma.

    Uma visualização de pontuação em tempo real mostra a pontuação atual e a mudança absoluta e percentual entre esta pontuação e a pontuação na última coleta de dados programada anterior. A pontuação é calculada quando um usuário do painel abre um painel que contém o widget. Esta visualização é semelhante a uma exibição de Gráfico em um Hub de análise. Você também pode mostrar uma linha de tendência de mudanças absolutas ou percentuais nas pontuações.

    Para obter mais informações, consulte Pontuações em tempo real.

    Aviso:
    • As pontuações em tempo real podem diferir por visualizador e diferir das pontuações coletadas. As pontuações em tempo real são obtidas diretamente das tabelas de fatos relevantes. Portanto, as Listas de Controle de Acesso (ACL) dessas tabelas de fatos determinam as pontuações em tempo real que cada usuário conectado vê.
    • Se o widget tiver muitos elementos de dados, ele não poderá ser atualizado em tempo real. Nesse caso, será exibida uma mensagem instruindo o visualizador a atualizar o widget manualmente.
    Figura 1. Visualização de pontuação em tempo real
    Visualização de pontuação em tempo real de incidentes em aberto

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Widgets.
    2. Clique em Nova.
    3. Nos campos Nome e Legenda, dê ao widget um nome e uma legenda que reflitam as informações que estão sendo exibidas.
    4. No campo Tipo, selecione Pontuação.
      Se você alterar o valor de Tipo depois de preencher outros campos, esses campos serão limpos.
    5. No campo Visualização, selecione Pontuação em tempo real.
    6. No campo Indicador, selecione o indicador para o qual você deseja mostrar as pontuações.
    7. Opcional: Preencha qualquer um dos seguintes campos:
      Campo Descrição
      Detalhamento e elemento Somente as pontuações que correspondem ao elemento especificado deste detalhamento são mostradas. Selecione valores para Detalhamento e Elemento. Caso contrário, somente as pontuações que não estão associadas a nenhum elemento do detalhamento serão mostradas.
      Nota:
      Em vez de especificar um elemento para o detalhamento de primeiro nível, você pode especificar um filtro de elementos na guia Configurações de elementos. Use filtros de elementos para criar visualizações pessoais. Para obter mais informações, consulte Configurações adicionais para widgets de série temporal.
      Importante:
      Se o widget for para um indicador de fórmula, todos os indicadores que contribuem na fórmula devem oferecer suporte ao detalhamento. Caso contrário, uma mensagem de erro em vez de um valor aparecerá no widget em um painel.
    8. Para que o widget siga os elementos de detalhamento selecionados em um painel de detalhamento, siga estas etapas:
      1. Selecione Acompanhar elemento.

        Selecionar esta opção remove a capacidade de definir um segundo detalhamento e elemento no widget.

      2. Opcional: Defina quais detalhamentos disponíveis serão seguidos em Detalhamento seguido.
        Os painéis de detalhamento permitem selecionar uma origem de detalhamento e elementos. No entanto, um indicador pode usar mais de um detalhamento baseado na mesma origem de detalhamento. Use esta configuração para determinar quais desses detalhamentos serão aplicados em um painel de detalhamento.

        Por exemplo, o indicador Número de incidentes em aberto usa dois detalhamentos: Atribuído a e Aberto por. Ambos os detalhamentos são baseados na origem de detalhamento Users.Active. Considere o caso em que você cria um widget para este indicador e faz com que o widget siga elementos nos painéis de detalhamento. Você deseja que o widget exiba valores separados para os elementos do detalhamento Atribuído a. Portanto, selecione Atribuído a no campo Detalhamento seguido.

      Nota:
      O observador de registro não é compatível com widgets de pontuação quando vários elementos são selecionados em um painel de detalhamento. Nesse caso, o tempo real é atualizado somente na atualização da página.
      Para obter mais informações, consulte Configurar widgets para painéis de detalhamento.
    9. Opcional: Selecione um modelo.
      Nome do modeloDescrição
      Modelo 1 A linha mostra a mudança absoluta na pontuação.
      Modelo 2 A linha mostra a mudança percentual na pontuação.
      Modelo 3 A linha não é exibida.
      As visualizações de pontuação em tempo real usam o Modelo 2 por padrão.
    10. Na guia Configurações de elemento, você pode selecionar um filtro de elemento em vez de selecionar um elemento específico no campo Elemento.
      Use esta abordagem para personalizar quais detalhamentos são mostrados, dependendo do visualizador. Para obter mais informações sobre como usar filtros de elemento para personalizar widgets, consulte Recursos visuais personalizados.
    11. Clique em Enviar.

    O que Fazer Depois

    Para exibir o widget, adicione-o a um painel ou portal.