Estrutura do conjunto de dados de vistas do Analytics
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Cada vista do Analytics define um conjunto de dados no Power BI. Os conjuntos de dados são as tabelas e propriedades utilizadas para criar visualizações. Os conjuntos de dados gerados pelo Conector de Dados do Power BI para Azure DevOps têm as seguintes características:
- As entidades e os campos associados disponíveis no Analytics são nivelados (desnormalizados) numa única tabela. Por exemplo, o nome de utilizador em "Criado Por" é modelado como uma cadeia de carateres (Nome de Utilizador), em vez do ID de utilizador. Elimina a necessidade de criar relações entre tabelas para criar relatórios.
- Os dados históricos são modelados como instantâneos para cada período de tempo, portanto, os relatórios de tendências são simples.
Para obter mais informações sobre o Power BI e os conjuntos de dados, consulte Power BI – conceitos básicos para o serviço Power BI.
Nivelar o ponto final OData do Analytics
O ponto final OData do Analytics fornece uma representação normalizada dos dados do Analytics. Os dados são normalizados principalmente para o suporte de relatórios sobre as relações "muitos-para-muitos" que existem entre os dados, como itens de trabalho e as etiquetas associadas.
O Conector de Dados do Power BI representa estes dados como uma única tabela para que as relações mostradas no nosso Modelo de dados do Analytics não necessitem de ser recriadas no Power BI. Esta representação permite filtrar imediatamente campos complexos, como etiquetas de item de trabalho.
O processo simplifica muito a colocação dos seus relatórios em funcionamento. No entanto, nem todos os campos disponíveis através do ponto final OData do Analytics estão disponíveis para seleção numa vista do Analytics.
Campos selecionáveis nas vistas do Analytics
Os campos que pode selecionar numa vista do Analytics correspondem aos campos normais de monitorização de trabalho e aos campos de arquivo de dados do Analytics.
Campos de monitorização de trabalho
Pode selecionar todos os campos de monitorização de trabalho numa vista do Analytics, exceto os seguintes campos:
- Campos que não fazem parte do projeto onde a vista foi criada
- Campos de texto longos, como Descrição, Histórico e outros campos com um tipo de dados HTML
- Campos de contagem de ligações de item de trabalho, como ExternalLinkCount, HyperLinkCount, AttachedFileCount, RelatedLinkCount
- Campos específicos da API REST, como Limite de Tamanho, IsDeleted
- Campos com relações muitos-para-muitos , como Equipa, Coluna do Painel, Nome do Painel
Importante
Os campos de identidade ou nome de pessoa, como Criado Por, Atribuído A, etc., são campos selecionáveis, no entanto, não é possível selecioná-los nesta altura como critérios de campo para fins de filtragem de itens de trabalho.
Para obter uma descrição de cada campo de monitorização de item de trabalho, consulte Referência de entidades e propriedades para o Azure Boards.
Campos de armazenamento de dados do Analytics
Pode selecionar os seguintes campos baseados no Análise numa vista do Analytics:
| Campo | Descrição |
|---|---|
| Tempo de Ciclo | Tempo para um item de trabalho passar de uma categoria de estado de "Em Curso" para "Concluído". |
| Data (incluída automaticamente no histórico) | Suporta a visualização do histórico diário, semanal ou mensal do conjunto filtrado de itens de trabalho. |
| É Atual (incluído automaticamente no histórico) | Suporta a filtragem dos dados para ver o instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor como True. |
| Prazo | Tempo para um item de trabalho passar de uma categoria de estado de "Proposto" para "Concluído". |
| ID do Item de Trabalho Principal | O ID do Item de Trabalho para o elemento principal de um item de trabalho. |
| Nome do Projeto | Equivalente ao campo do projeto. |
| Revisão | Um número que é atribuído à revisão histórica de um item de trabalho. |
| Etiquetas | Lista de etiquetas delimitada por ponto e vírgula. |
| WorkItemRevisionSK | A chave exclusiva do Analytics para a revisão do item de trabalho, utilizada para associar entidades relacionadas. |
Para obter informações sobre categorias de estado, consulte Estados de fluxo de trabalho e categorias de estado. Para obter informações mais detalhadas sobre o modelo de dados do Analytics, consulte Modelo de dados para o Analytics.
Para aceder a quaisquer outros campos disponíveis através do Analytics, inclua as Chaves de Substituição (SK) ou o ID do Item de Trabalho correspondentes na vista do Analytics. Em seguida, crie as tabelas de mapeamento necessárias com base na Propriedade de Navegação do Analytics.
- Iterações (IterationSK)
- Áreas (AreaSK)
- Equipas (AreaSK – gerar tabela de mapeamento com base na Propriedade de Navegação de Equipas )
- BoardLocations (AreaSK – gerar Tabela de mapeamento com base na Propriedade de Navegação BoardLocations )
- Datas (DateSK)
- Processo (AreaSK – gerar Tabela de mapeamento com base na Propriedade de Navegação do Processo )
- WorkItemLinks (ID do Item de Trabalho)
Relações de dados
Compreender o Modelo de dados do Analytics é essencial para criar boas relações entre entidades.
Por predefinição, quando são devolvidos dados básicos do Analytics, os dados são relacionados conforme mostrado na figura abaixo:
As Etiquetas, as Equipas e os Utilizadores não estão relacionados com quaisquer outros dados. A relação destas entidades baseia-se na forma como se relacionam. Podem estar relacionadas de duas formas:
- Relações muitos-para-muitos que não são facilmente processadas nestes modelos
- Há várias relações entre as entidades, como entre utilizadores e itens de trabalho. Estão relacionadas por:
- Atribuído A
- Criado Por
- Alterado Por
- E assim sucessivamente
Pode processar com múltiplas relações de forma bastante simples. Por exemplo, no modelo predefinido, pode editar a consulta, selecionar a coluna AssignedTo da tabela WorkItems e expandir a coluna para incluir todos os dados da tabela Utilizadores e pode repetir este processo também para as colunas Criado Por e Alterado Por. Isto faz com que tenha múltiplas ligações de uma tabela para outra, o que não é permitido.
Outra razão para expandir colunas deste modo é processar as relações circulares que também não são permitidas. Por exemplo, siga o seguinte caminho: Projetos > Áreas > Itens de Trabalho > Projetos. Apresenta um problema circular típico. E se pretendesse ver quais áreas faziam parte de um determinado projeto? O modelo como é criado tem relações entre Áreas e Itens de Trabalho e Projetos e Itens de Trabalho, mas os Projetos não podem ser relacionados com Áreas porque isso completa a relação circular e, como tal, não é permitido. Para processar este cenário, pode expandir a coluna Projeto na tabela Áreas. Para tal, execute os seguintes passos:
Selecione Editar Consultas no separador Base.
Selecione a Consulta de áreas.
Desloque-se até à Coluna do projeto (a última coluna) e selecione o ícone Expandir na parte superior da coluna.
Desmarque todas as colunas, exceto ProjectName e selecione OK.
Agora já pode listar Áreas por Projeto e obter uma contagem de Áreas em cada projeto.
Artigos relacionados
- Representação de dados históricos no Analytics
- Modelo de dados para o Analytics
- Descrição geral da integração do Power BI
- Índice do campo dos itens de trabalho
- Categorias de item de trabalho
- Tarefas pendentes, painéis e planos
- Ligar-se com o Conector de Dados do Power BI
- Conector de Dados – Exemplos de relatórios
- Funções disponíveis no Conector de Dados do Power BI