Criar um widget do Analytics para o Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode criar seu próprio widget do Analytics para exibir em um dashboard no Azure DevOps. O widget de exemplo no github demonstra:

  • Como renderizar linhas de tendência associadas aos estados do item de trabalho
  • Como consultar um conjunto de dados, o whe que um usuário configurará por meio da exibição de configuração do widget
  • Como criar e publicar o widget no marketplace do Azure DevOps

Com essas informações, você poderá criar seu próprio widget do Analytics.

Exibição da configuração com visualização do Widget

Observação

O serviço de Análise é habilitado automaticamente e tem suporte em produção para todos os Azure DevOps Services. A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em disponibilidade geral. Recomendamos que você o use e nos envie comentários. Os dados disponíveis dependem da versão. A versão mais recente com suporte é v2.0e a versão prévia mais recente é v4.0-preview. Para obter mais informações, consulte Controle de versão da API OData.

Observação

O serviço Analytics é instalado automaticamente e tem suporte em produção para todas as novas coleções de projetos para Azure DevOps Server 2020 e versões posteriores. A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em disponibilidade geral. Recomendamos que você o use e nos envie comentários. Se você atualizou do Azure DevOps Server 2019, poderá instalar o serviço de Análise durante a atualização.

Os dados disponíveis dependem da versão. A versão mais recente com suporte é v2.0e a versão prévia mais recente é v4.0-preview. Para obter mais informações, consulte Controle de versão da API OData.

Observação

O serviço de Análise está em versão prévia para Azure DevOps Server 2019. Você pode habilitá-lo ou instalá-lo para uma coleção de projetos. A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em Versão Prévia. Recomendamos que você o use e nos envie comentários.

Os dados disponíveis dependem da versão. A versão mais recente com suporte é v2.0e a versão prévia mais recente é v4.0-preview. Para obter mais informações, consulte Controle de versão da API OData.

Pré-requisitos

Este exemplo fornece um widget pronto, abrangendo noções básicas de tópicos em Painéis, Gráficos e Análise. Os documentos a seguir fornecem mais base nos detalhes demonstrados neste exemplo:

  1. Criar uma Extensão de Widget do Azure DevOps, referenciar o exemplo de extensões do Widget
  2. Renderizar um controle de gráfico do Azure DevOps, referenciar Adicionar um gráfico
  3. Consultar o OData do Analytics

Fornecer uma exibição de configuração

  1. Execute consultas de análise simples exigidas por controles de interface do usuário usados para configurar uma exibição.
  2. Gerenciar o estado da interface do usuário de configuração, com atualizações baseadas em ações do usuário e com novos dados de consultas do Analytics.
  3. Renderize a interface do usuário de configuração usando Typescript e React.

Renderizar dados em um Widget

  1. Executar uma consulta configurada pelo usuário como uma solicitação POST
  2. Interpretar dados da análise para renderizar um gráfico

Próximas etapas

Para evitar o excesso de complexidade na amostra, omitimos determinadas tecnologias e práticas, que um widget de produção certamente deve incluir. O exemplo ui-fabric-react no github realça um processo de build que exerce esses detalhes.

  1. Agrupamento javaScript e minificação de conteúdo – o conjunto de arquivos de script pequenos e soltos no exemplo pode ser carregado muito mais rapidamente quando combinado em um único arquivo e minificado.
  2. Controles de interface do usuário do Fabric – Os controles de interface do usuário do Fabric fornecem um conjunto avançado de componentes de interface do usuário de configuração para React.