Compartilhar via

Referência de metadados para Azure Boards Analytics

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

O serviço análise coleta todas as atividades de atualização e definição de rastreamento de trabalho do Azure Boards. Você pode executar consultas do Analytics diretamente no navegador e usar uma combinação de propriedades para filtrar uma consulta, agregar dados ou criar um relatório. Para obter mais informações, consulte Definir consultas básicas usando o OData Analytics.

Este artigo descreve a maioria das propriedades que você pode usar para gerar um relatório de análise de acompanhamento de trabalho. A análise armazena todos os campos de acompanhamento de trabalho como propriedades, exceto para campos HTML/rich-text e histórico. Campos personalizados são adicionados automaticamente ao Analytics como propriedades personalizadas.

Observação

Este artigo fornece descrições de entidades, propriedades e tipos enumerados compatíveis com o modelo de dados do Analytics. Para consultar o modelo de dados, consulte Construir consultas OData para Análise.

Visão geral dos conjuntos de entidades

Ao consultar o Analytics para obter dados de acompanhamento de trabalho, consulte a entidade WorkItems definida para gerar relatórios de status e rollup. Use a entidade WorkItemSnapshot definida para gerar relatórios de tendência, burndown e burn up.

Use outros tipos de entidade, como Área, Iteração, Projeto ou Equipe para filtrar dados ou selecionar propriedades para relatar. Para obter relatórios de exemplo, consulte relatórios de exemplo e índice de referência rápida.

Observação

Para gerar relatórios de status e tendência em execuções de teste, resultados de teste ou outros dados de teste, consulte os tipos de entidade WorkItems e WorkItemSnapshot e filtre com base nos tipos de entidade TestRuns, TestPoints, TestResultsDaily, TestSuite ou TestPointHistorySnapshot . Para obter mais informações, consulte Referência de metadados de teste para Azure DevOps.

Conjunto de entidades Tipo de entidade Descrição
Áreas Área Caminhos de área do item de trabalho, com propriedades para agrupamento e filtragem por hierarquia de área.
Datas CalendarDate Datas usadas para filtrar e agrupar outras entidades usando relações.
Iterações Iteração Caminhos de iteração do item de trabalho, com propriedades para agrupamento e filtragem por hierarquia de iteração.
BoardLocations BoardLocation Locais de célula de placa, conforme identificado por coluna de placa, raia e divisão, incluindo configurações históricas da placa. Para obter uma descrição de cada campo do quadro, consulte Fluxo de trabalho e campos do quadro.
Processos Processo Informações de lista de pendências usadas para expandir ou filtrar itens de trabalho e tipos de item de trabalho. Para obter um exemplo que usa Processos para filtrar um relatório, consulte Relatório de exemplo de acompanhamento de requisitos. Com suporte para a versão do Analytics v2.0 e posterior.
Projetos Projeto Todos os projetos definidos para uma organização ou coleção de projetos.
Marcas Etiqueta Todas as marcas de item de trabalho para cada projeto. Para obter um exemplo que usa Marcas para filtrar um relatório, consulte Relatório de exemplo de burndown de versão.
Equipes Equipe Todas as equipes definidas para o projeto. Para obter um exemplo que usa o Teams para filtrar um relatório, consulte Adicionar uma segmentação de equipe a um relatório do Power BI.
Usuários Usuário Informações do usuário usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo Atribuídas a ou Criadas por.
WorkItemBoardSnapshot WorkItemBoardSnapshot Tipo de entidade composta que descreve o estado de cada item de trabalho em cada data do calendário, incluindo o local da placa. Usado para gerar relatórios de tendência. Para obter um relatório de exemplo, consulte Relatório de exemplo do CFD (Diagrama de Fluxo Cumulativo).
WorkItemLinks WorkItemLink Links entre itens de trabalho, por exemplo Filho, Pai e Relacionado. Inclui apenas a revisão mais recente de links, sem histórico e não inclui hiperlinks.
RevisõesDeItensDeTrabalho WorkItemRevision Todas as revisões históricas do item de trabalho, incluindo a revisão atual. Não inclui itens de trabalho excluídos.
WorkItemSnapshot WorkItemSnapshot Tipo de entidade composta que descreve o estado de cada item de trabalho em cada data do calendário. Usado para dar suporte a relatórios de tendências. Para obter um relatório de exemplo, consulte Relatório de exemplo de tendências de bugs.
Workitems Workitem Estado atual dos itens de trabalho. Usado para dar suporte a relatórios status. Para obter um relatório de exemplo, consulte Rollup child work item values to parent sample report.
WorkItemTypeFields WorkItemTypeField Propriedades do item de trabalho para cada tipo de item de trabalho e processo. Usado para dar suporte à criação de relatórios.

Instantâneos

Os conjuntos de entidades de instantâneo de acompanhamento de trabalho são WorkItemSnapshot e WorkItemBoardSnapshot. Um instantâneo é gravado no Analytics ao mesmo tempo todos os dias e fornece um registro dos valores definidos para um item de trabalho para esse dia. Você pode usar instantâneos para gerar relatórios de tendência.

Por padrão, todas as tabelas de instantâneo são modeladas como tabelas de fatos de instantâneo diárias. Uma consulta para um intervalo de tempo obtém um valor para cada dia e longos intervalos de tempo resultam em um grande número de registros. Se você não precisar de uma precisão tão alta, poderá usar instantâneos semanais ou mensais. Para obter mais informações, consulte Usar instantâneos semanais ou mensais para consultas de tendência que abrangem um longo período de tempo.

Revisões de item de trabalho

Sempre que você atualiza um item de trabalho, o sistema cria uma nova revisão e registra-o no campo, o System.RevisedDate que é útil para especificar um filtro de histórico. Você pode representar a data revisada pelas propriedades e RevisedDate (DateTime) pelas RevisedDateSK (Int32) propriedades.

Use a propriedade de chave substituta da última data para obter o melhor desempenho. Essa chave mostra a data em que uma revisão foi criada ou mostra o valor "9999-01-01T00:00:00Z" nulo datetime OData para revisões ativas ou incompletas. Se você quiser todas as datas desde o {startDate}, inclusive, adicione o seguinte filtro à sua consulta: RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Use a entidade WorkItemRevisions definida para carregar todas as revisões de um determinado item de trabalho. A consulta retorna todas as revisões de item de trabalho histórico, incluindo a revisão atual, para os itens de trabalho nos quais você filtra, não incluindo itens de trabalho excluídos.

Propriedades compartilhadas entre tipos de entidade

As propriedades que você pode selecionar em um modo de exibição análise correspondem a campos de acompanhamento de trabalho regulares e propriedades de Análise selecionadas, como Dias de Tempo de Ciclo e Dias de Tempo de Entrega. Essas propriedades são definidas para os seguintes tipos de entidade, a menos que especificado de outra forma:

  • Workitem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Observação

A tabela a seguir lista e descreve a maioria das propriedades que você pode selecionar em um modo de exibição análise, incluindo campos de acompanhamento de trabalho regulares e outras propriedades do Analytics.

Nome de exibição Nome da propriedade Tipo de dados Descrição Nome de referência
Aceito por Microsoft_VSTS_CodeReview_AcceptedBy UserSK Nome da pessoa que respondeu a uma revisão de código. (Processo CMMI) Microsoft.VSTS.CodeReview.AcceptedBy
Data aceita AcceptedDate Data e Hora Data e hora em que a pessoa respondeu à revisão de código. (Processo CMMI) Microsoft.VSTS.CodeReview.AcceptedDate
Ativado por ActivatedBy, ActivatedByUserSK UserSK Nome do membro da equipe que ativou ou reativou o item de trabalho. Microsoft.VSTS.Common.ActivatedBy
Data de Ativação ActivatedDate Data e Hora Data e hora em que um membro da equipe ativou ou reativou um bug ou item de trabalho. Microsoft.VSTS.CodeReview.ActivatedDate
Atividade Activity fio Tipo de atividade ou disciplina atribuída para executar uma tarefa. Os valores permitidos são: Implantação, Design, Desenvolvimento, Documentação, Requisitos e Teste. (Processos Agile, Scrum e Basic) Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset (representa uma data e hora com um desvio em relação ao horário UTC) Dados e hora em que a entidade foi atualizada pela última vez.
Tipo de Aplicativo fio Tipo de aplicativo no qual os stakeholders fornecem comentários. Os valores padrão são Aplicativo Web, Computador Remoto e Aplicativo Cliente. Tipos válidos são especificados no arquivo de configuração de processo para projetos que usam um processo XML local. Microsoft_VSTS_Feedback_ApplicationType
Caminho de Área AreaPath, AreaSK fio Os itens de trabalho da área de trabalho do produto ou da área de equipe se agrupam. Deve ser um nó válido na hierarquia do projeto. System.AreaPath
Atribuído a AssignedTo, AssignedToUserSK UserSK Nome do membro da equipe que atualmente possui o item de trabalho. System.AssignedTo
ID de teste automatizada AutomatedTestId fio ID do teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestId
Nome de teste automatizado AutomatedTestName fio Nome do membro da equipe que ativou ou reativou o item de trabalho. Microsoft.VSTS.TCM.AutomatedTestName
Armazenamento automatizado de teste AutomatedTestStorage fio Assembly que contém o teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo automatizado de teste AutomatedTestType fio Tipo de teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestType
Status de Automação AutomatedStatus fio Status de um caso de teste com os valores aceitos Automatizado, Não Automatizado ou Planejado. Microsoft.VSTS.TCM.AutomationStatus
Prioridade da lista de pendências BacklogPriority Duplo Número atribuído por um processo em segundo plano do sistema usado para empilhar classificação ou acompanhar a sequência de itens em uma lista de pendências ou placa. (Processo de Scrum) Microsoft.VSTS.Common.BacklogPriority
Bloqueado Blocked fio Indicação de que nenhum trabalho adicional pode ser executado no item de trabalho. Os valores válidos são Sim ou Não. (Processo CMMI) Microsoft.VSTS.CMMI.Blocked
Valor comercial BusinessValue Duplo Unidade subjetiva de medida que captura o valor comercial relativo de um item ou recurso de backlog do produto em comparação com outros itens do mesmo tipo. Os números mais altos atribuídos ao item são considerados com mais valor comercial do que os itens atribuídos a números mais baixos. Microsoft.VSTS.Common.BusinessValue
Alterado por ChangedBy, ChangedByUserSK UserSK Nome da pessoa que modificou o item de trabalho mais recentemente. System.ChangedBy
Data da Alteração ChangedDate Data e Hora Data e hora em que o item de trabalho foi modificado. System.ChangedDate
ChangedDateSK Int32 Data em que o item de trabalho foi modificado, expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
ChangedOn Navegação Propriedade de navegação para a Date entidade para a data em que o item de trabalho foi modificado, no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Fechado por ClosedBy, ClosedByUserSK UserSK Nome da pessoa que fechou um item de trabalho. Microsoft.VSTS.Common.ClosedBy
Data de fechamento ClosedDate ClosedDateSK ClosedOn Data e Hora Data e hora em que um item de trabalho foi fechado. Microsoft.VSTS.Common.ClosedDate
Contagem de Comentários CommentCount Int32 Número de comentários adicionados à seção Discussão do item de trabalho. System.CommentCount
Cometeu Committed fio Indicação se o requisito é confirmado no projeto. Os valores válidos são Sim ou Não. (Processo CMMI) Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Data da propriedade de navegação capturada pelo Analytics que armazena quando o item de trabalho inseriu um estado de fluxo de trabalho associado à categoria de estado Concluído .
CompletedOn Navegação Propriedade de navegação para a Date entidade para a data em que o item de trabalho inseriu um estado de fluxo de trabalho associado à categoria de estado Concluído , no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Trabalho concluído CompletedWork Duplo Medida da quantidade de trabalho gasto em uma tarefa. Microsoft.VSTS.Scheduling.CompletedWork
Criado por CreatedBy, CreatedByUserSK UserSK Nome da pessoa que criou o item de trabalho. Microsoft.VSTS.Common.CreatedBy
Data da Criação CreatedDate, CreatedDateSK Data e Hora Data em que o item de trabalho foi criado, expresso no fuso horário definido para a organização. Normalmente usado para filtragem e exibição. Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Data em que o item de trabalho foi criado, expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
CreatedOn Navegação Propriedade de navegação para a Date entidade para a data em que o item de trabalho foi criado, no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Dias de Tempo do Ciclo CycleTimeDays Duplo Tempo de ciclo calculado desde a primeira inserção de uma categoria de estado em andamento ou resolvido até a inserção de uma categoria de estado concluído . Para obter mais informações, consulte Widgets Lead Time e Cycle Time.
Disciplina Discipline fio Tipo de atividade ou disciplina atribuída a uma tarefa. Os valores permitidos são: Análise, Desenvolvimento, Teste, Educação do Usuário e Experiência do Usuário. (Processo CMMI) Microsoft.VSTS.Common.Activity
Data de conclusão DueDate Data e Hora Data de conclusão prevista para que um problema ou item de trabalho seja resolvido. (Processo Agile) Microsoft.VSTS.Scheduling.DueDate
Esforço Effort Duplo Quantidade estimada de trabalho que um item de backlog do produto (processo scrum) ou problema (processo básico) requer para implementar. Microsoft.VSTS.Scheduling.Effort
Data de Conclusão FinishDate Data e Hora Data e hora em que o agendamento indica que um item de trabalho deve ser concluído. Microsoft.VSTS.Scheduling.FinishDate
Encontrado em FoundIn fio Número de build do produto, também conhecido como revisão, no qual um bug foi encontrado. Microsoft.VSTS.Build.FoundIn
Data do InProgress InProgressDate Data e Hora Data armazenada da análise que captura a data e hora em que um item de trabalho foi movido para um estado que pertence à categoria de estado Em Andamento .
InProgressDateSK Int32 Data em que o item de trabalho foi movido para um Estado que pertence à categoria de estado Em Andamento , expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
Compilação de integração IntegrationBuild fio Número de build do produto que incorpora o código ou corrige um bug. Microsoft.VSTS.Build.IntegrationBuild
É Atual IsCurrent booleano Suporte para filtrar os dados para exibir o instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor como True. Válido para os tipos de entidade WorkItemRevision, WorkItemBoardSnapshot e BoardLocation.
É a Última Revisão do Dia IsLastRevisionOfDay booleano Indicação de que o instantâneo representa a última revisão do dia quando definido como True.
É a Última Revisão do Período IsLastRevisionOfPeriod booleano Indicação de que o instantâneo representa a última revisão do período quando definido como True.
Problema Issue fio Indicação de que a etapa compartilhada está associada a um resultado esperado. Os valores permitidos são Sim e Não. Microsoft.VSTS.Common.Issue
Dias de tempo de entrega LeadTimeDays Duplo Tempo de entrega calculado com base na criação do item de trabalho ou na inserção de uma categoria de estado proposta para inserir uma categoria de estado concluído . Para obter mais informações, consulte Widgets Lead Time e Cycle Time.
Estimativa Original OriginalEstimate Duplo Medida da quantidade de trabalho necessária para concluir uma tarefa. Microsoft.VSTS.Scheduling.OriginalEstimate
ID do item de trabalho pai ParentWorkItemId Int32 ID exclusiva que identifica o item de trabalho vinculado como um pai. Útil para gerar relatórios cumulativos. O campo Pai é válido para os tipos de entidade WorkItemRevision e WorkItem. System.Parent
Prioridade Priority Int32 Classificação subjetiva do bug, problema, tarefa ou caso de teste no que diz respeito à empresa. Os valores incluem 1, 2 ou 3. Microsoft.VSTS.Common.Priority
Nome do Projeto ProjectName Navegação Nome do projeto ao qual o item de trabalho pertence. Para obter detalhes, consulte as propriedades do Project. System.TeamProject
ProjectSK GUID GUID atribuído ao projeto ao qual o item de trabalho pertence.
Classificação Reason fio Número de estrelas que um item recebe de um revisor em um sistema de classificação baseado em estrela (Resposta de Comentários). O número é armazenado no sistema e escrito como 0 - Não Classificado, 1 - Pobre, 2 - Justo, 3 - Bom, 4 - Muito Bom, ou 5 - Excelente. Válido para os tipos de entidade WorkItemRevision e WorkItem . Microsoft.VSTS.Common.Rating
Motivo Reason fio Motivo pelo qual o item de trabalho está no estado atual. Cada transição de um estado de fluxo de trabalho para outro está associada a um motivo correspondente. System.Reason
Trabalho restante RemainingWork Duplo Medida da quantidade de trabalho que resta para concluir uma tarefa. Microsoft.VSTS.Scheduling.RemainingWork
Resolvido por ResolvedBy, ResolvedByUserSK UserSK Nome do membro da equipe que resolveu o bug ou a história do usuário. Microsoft.VSTS.Common.ResolvedBy
Data de resolução ResolvedDate Data e Hora Data e hora em que o bug ou a história do usuário foi resolvida. Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Data em que o item de trabalho foi resolvido, expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
ResolvedOn Navegação Propriedade de navegação para a Date entidade para a data em que o item de trabalho foi resolvido, no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Motivo Resolvido ResolvedReason fio Motivo pelo qual o bug foi resolvido, como Corrigido. Microsoft.VSTS.Common.ResolvedReason
Revisão Revision Int32 Número atribuído à revisão histórica de um item de trabalho. System.Rev
Data de Revisada RevisedDate Data e Hora Data e hora em que um item de trabalho foi modificado ou atualizado.
RevisedDateSK Int32 Data em que o item de trabalho foi revisado, expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
RevisedOn Navegação Propriedade de navegação para a Date entidade para a data em que o item de trabalho foi revisado, no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Risco Risk Duplo Classificação subjetiva de incerteza relativa sobre a conclusão bem-sucedida do item de trabalho. Os valores válidos incluem 1 – Alto, 2 – Médio e 3 – Baixo. Microsoft.VSTS.Common.Risk
Gravidade Severity Duplo Classificação subjetiva do efeito de um bug, problema ou risco no projeto. Os valores válidos incluem 1 – Crítico, 2 – Alto, 3 – Médio e 4 – Baixo. Microsoft.VSTS.Common.Severity
Tamanho Size Duplo Estimar a quantidade de trabalho que um requisito requer para implementar. (Processo CMMI) Microsoft.VSTS.Scheduling.Size
Classificação da pilha StackRank Duplo Número atribuído por um processo em segundo plano do sistema usado para empilhar classificação ou acompanhar a sequência de itens em uma lista de pendências ou placa. (Processos Agile, Scrum e Basic) Microsoft.VSTS.Common.StackRank
Data de Início StartDate Data e Hora Data e hora atribuídas a um item de trabalho para que o trabalho seja iniciado. Microsoft.VSTS.Scheduling.StartDate
Estado State fio Estado atual do item de trabalho. Os valores válidos para o estado são específicos para cada tipo de item de trabalho e personalizações feitas a ele. System.State
Categoria de Estado StateCategory fio Como as Placas do Azure e os widgets de painel selecionados tratam cada estado de fluxo de trabalho. As categorias de estado incluem Proposed, In Progress, Resolved, Removed e Completed. Para obter mais informações, consulte Como usar estados de fluxo de trabalho e categorias de estado. Válido somente para o WorkItemRevision tipo de entidade.
Data da Alteração de Estado StateChangeDate Data e Hora Data e hora em que o valor do campo Estado foi alterado. Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Data em que o estado do item de trabalho foi alterado, expresso como YYYYMMDD no fuso horário definido para a organização. Usado por ferramentas externas para unir entidades relacionadas.
StateChangeOn Navegação Propriedade de navegação para a Date entidade para a data em que um estado de item de trabalho foi alterado, no fuso horário definido para a organização. Normalmente usado para referenciar propriedades da Date entidade em groupby instruções .
Pontos de História StoryPoints Duplo Estimativa da quantidade de trabalho que uma história de usuário precisa implementar, normalmente agregada como uma soma. (Processo Agile) Microsoft.VSTS.Scheduling.StoryPoints
Marcas TagNames fio Lista delimitada por ponto-e-vírgula de marcas atribuídas a um ou mais itens de trabalho para fins de filtragem ou consulta. System.Tags
Data de Destino TargetDate Data e Hora Data de conclusão prevista para que um problema ou outro item de trabalho seja resolvido ou concluído. Microsoft.VSTS.Scheduling.TargetDate
Tipo de Pacote de Teste fio Tipo de pacote de teste. Os valores válidos incluem Baseado em Consulta, Baseado em Requisitos e Estático. Microsoft_VSTS_TCM_TestSuiteType
ID do tipo do pacote de teste Int64 Número atribuído pelo sistema correspondente à categoria do conjunto de testes. Aplicável somente a conjuntos de testes. Os valores atribuídos são 1 (estático), 2 (baseado em consulta) e 3 (baseado em requisito). Microsoft_VSTS_TCM_TestSuiteTypeId
Criticidade do tempo TimeCriticality Duplo Unidade subjetiva de medida que captura como o valor de negócios diminui ao longo do tempo. Valores mais altos indicam que um recurso ou épico é inerentemente mais crítico do que itens com valores mais baixos. Microsoft.VSTS.Common.TimeCriticality
Título Title fio Descrição breve resumindo o item de trabalho que ajuda os membros da equipe a distingui-lo de outros itens de trabalho em uma lista. System.Title
Área de Valor ValueArea fio Área do valor do cliente endereçada pelo item épico, de recurso ou de backlog. Os valores incluem Arquitetura ou Negócios. Microsoft.VSTS.Common.ValueArea
Marca de agua Watermark fio Campo gerenciado pelo sistema que incrementa com alterações feitas em um item de trabalho. Válido para os tipos de entidade WorkItemRevision e WorkItem . System.Watermark
ID do Item de Trabalho WorkItemId Int32 Identificador exclusivo atribuído a um item de trabalho. Uma ID de item de trabalho é exclusiva em todos os projetos dentro de uma organização ou coleção de projetos. System.Id
WorkItemRevisionSK Int32 Chave exclusiva de análise para a revisão do item de trabalho, usada por ferramentas externas para unir entidades relacionadas.
Tipo de Item de Trabalho WorkItemType fio Nome do tipo de item de trabalho. Os tipos de item de trabalho disponíveis são baseados no processo que o projeto usa. Para obter mais informações, consulte Sobre processos e modelos de processo. System.WorkItemType

As propriedades de navegação OData são os atributos de referência de uma entidade que aponta para outra entidade. A tabela a seguir fornece um resumo das propriedades de navegação, suas restrições referenciais e os tipos de entidade para os quais elas são válidas.

Nome de exibição Nome Restrição referencial Propriedade referencial Tipos de entidade válidos
ChangedOn ChangedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn ClosedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn CreatedDateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn ResolvedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
StateChangeOn StateChangeDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
InProgressOn InProgressDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
CompletedOn CompletedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ChangedOn ChangedDateSK DateSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
RevisedOn RevisedDateSK DateSK WorkItemRevision, WorkItemSnapshot
Date DateSK DateSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Áreas Area AreaSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Iterações Iteration IterationSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Atribuído a AssignedTo AssignedToUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Alterado por ChangedBy ChangedByUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Criado por CreatedBy CreatedByUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Ativado por ActivatedBy ActivatedByUserSK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Fechado por ClosedBy ClosedBySK UserSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvidoPor ResolvedBy ResolvedByUserSK UserSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Equipes Área, BoardLocation, Iteração, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Marcas WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projeto Project ProjectSK ProjectSK Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField
Processos WorkItemRevision, WorkItem, WorkItemSnapshot
Revisões Workitem
Links Workitem
Filhos Workitem
Pai Workitem
descendentes Workitem
Workitem* WorkItemId WorkItemRevision

*A entidade WorkItem também dá suporte a PredictTags funções e Predict funções, que dão suporte a tendências preditivas em widgets e relatórios internos do Analytics selecionados.

BoardLocation e WorkItemBoardSnapshot

A tabela a seguir lista e descreve as propriedades definidas para os tipos de entidade BoardLocation e WorkItemBoardSnapshot , a menos que anotado. Você pode usar esses campos para filtrar dados de item de trabalho com base no status de um item de trabalho dentro do nível de coluna de quadro, linha de natação ou backlog de uma equipe. Para obter um exemplo que consulta o conjunto de entidades WorkItemBoardSnapshot , consulte o relatório de exemplo CFD (Diagrama de Fluxo Cumulativo).

Nome de exibição Nome da propriedade Tipo de dados Descrição
ID da placa BoardId GUID GUID exclusivo atribuído a um quadro. Cada equipe está associada a um ou mais quadros.
Nome de referência da categoria do quadro BoardCategoryReferenceName fio Nome atribuído à categoria de tipo de item de trabalho usada para preencher uma placa. Por exemplo, a placa de lista de pendências do produto está associada à categoria Requisitos. Para obter mais informações, confira Personalizar as listas de pendências ou quadros (processo de herança).
Nome do quadro BoardName fio Nome atribuído ao quadro, por exemplo, Histórias, Itens de Lista de Pendências, Recursos ou Épicos.
Nível da placa BoardLevel Int32 Número atribuído ao quadro com base no local em que ele se encontra dentro da hierarquia de quadros.
Tipo de lista de pendências BacklogType fio Nome do tipo de lista de pendências, por exemplo Iteração, Requisito ou Portfólio.
Nome da Coluna ColumnName fio Nome da coluna de quadro a que um item de trabalho está atribuído no momento, como Active, Closed, Committed, Done ou um rótulo de coluna personalizado. Nome de Referência: System.BoardColumn
Ordem da Coluna ColumnOrder Int32 Número atribuído à coluna de quadro em termos de sua sequência dentro do quadro.
Concluído Done Enumerado Indicador do local da coluna dividida.*
Limite de Item de Coluna ColumnItemLimit Int32 Número atribuído à coluna de quadro em termos de sua sequência.
A placa está visível? IsBoardVisible booleano Indicação de se a equipe optou por tornar um conselho visível.
É Divisão de Coluna IsColumnSplit booleano Indicação de se uma coluna é dividida em colunas Doing and Done , conforme descrito em Colunas divididas em seu quadro para mostrar o trabalho em andamento.
É Atual IsCurrent booleano Propriedade que dá suporte à filtragem dos dados para exibir o instantâneo mais recente dos itens de trabalho filtrados quando definido como True.
É a Faixa Padrão IsDefaultLane booleano Indicação de que o item de trabalho é atribuído à pista de natação padrão quando definido como True.
Está concluído IsDone booleano Atribuição atual do item de trabalho em uma coluna para Fazer se False ou Concluído quando True. Válido somente quando as colunas divididas estiverem habilitadas para uma coluna de quadro. Nome de Referência: System.BoardColumnDone
ID da faixa LaneId GUID GUID exclusivo atribuído a uma pista de natação de placa. Cada equipe pode adicionar uma ou mais raias a uma placa. Para obter mais informações sobre raias, consulte Acelerar o trabalho da sua equipe usando raias em seu quadro.
Nome da Faixa LaneName fio Nome atribuído à pista de natação da placa. Nome de Referência: System.BoardLane
Ordem de Faixa LaneOrder Int32 Número atribuído à linha de natação da placa em termos de sua sequência.

*A tabela a seguir lista os nomes de membro para o BoardColumnSplit tipo enumerado, que você pode usar para filtrar itens de trabalho nas colunas do quadro Fazendo ou Concluído .

Nome do membro Valor Nome de exibição
Doing 0 Fazendo
Done 1 Concluído
Unknown 2 Desconhecido (não dividido)

Para obter mais informações sobre colunas de quadro para uma equipe, consulte os seguintes artigos:

Áreas

As propriedades a seguir são válidas para o conjunto de entidades Areas , que está associado ao campo Caminho da Área . As chaves alternativas associadas à Área incluem AreaSK e ProjectSK. Você pode usar essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho com base em atribuições de caminho de área.

Nome de exibição Nome Tipo de dados Descrição
AnalyticsUpdatedDate Data e Hora Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
Number Int32 Valor inteiro atribuído a um nó de caminho de área na criação.
Profundidade Depth Int32 Nível do caminho da área com base em sua profundidade do nível raiz.
ID da área AreaId GUID Identificador exclusivo atribuído a um caminho de área na criação.
Nível da Área 1 até o Nível da Área 14 AreaLevel1 por AreaLevel14 fio Nível de nó de um caminho de área de até 14 níveis aninhados. O Nível de Área 1 sempre corresponde ao nó raiz e ao nome do projeto.
Nome de área AreaName fio Nome definido para o caminho da área na criação.
Caminho de Área AreaPath fio Caminho completo do caminho da área começando com o nó raiz.

Importante

Excluir valores de Caminho da Área ou reconfigurar valores de caminho de iteração causa perda irreversível de dados nos seguintes gráficos:

  • Gráficos de widget burndown e burn up
  • Gráficos de burndown do sprint
  • Gráficos de velocidade para equipes com trajetórias de área alteradas
  • Gráficos de tendências históricos que fazem referência aos valores caminho de área e caminho de iteração conforme definido no momento para cada item de trabalho

Você só pode excluir caminhos de área e iteração quando eles não são mais usados por itens de trabalho. Ao excluir esses caminhos, você não pode mais recuperar seus dados históricos.

As propriedades de navegação para o tipo de entidade área e o conjunto de entidades Áreas incluem o Project e o Teams.

Para obter mais informações sobre o Caminho da Área, consulte os seguintes artigos:

Iterações

As propriedades a seguir são válidas para o conjunto de entidades iterações , que está associado ao campo Caminho da Iteração . As chaves alternativas associadas à iteração incluem IterationSK e ProjectSK. Você pode usar essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho com base em atribuições de caminho de iteração.

Nome de exibição Nome Tipo de dados Descrição
AnalyticsUpdatedDate Data e Hora Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
Number Int32 Valor inteiro atribuído a um nó de caminho de iteração na criação.
Profundidade Depth Int32 Nível do caminho de iteração com base em sua profundidade do nível raiz.
Data de Término EndDate Data e Hora Data de término definida para o caminho da iteração.
EstáConcluído IsEnded booleano Indicação de que a data de término do caminho de iteração está no passado quando definida como True.
ID da iteração IterationId GUID Identificador exclusivo atribuído a um caminho de iteração na criação.
Nível de Iteração 1 a Nível de Iteração 14 IterationLevel1 por IterationLevel14 fio Nível de nó de um caminho de iteração de até 14 níveis aninhados. O Nível de Iteração 1 sempre corresponde ao nó raiz e ao nome do projeto.
Nome da iteração IterationName fio Nome definido para um caminho de iteração na criação.
Caminho de Iteração IterationPath fio Caminho de iteração completo começando com o nó raiz. A iteração deve ser um nó válido na hierarquia de projetos. Nome de Referência: System.IterationPath
Data de Início StartDate Data e Hora Data de início definida para o caminho da iteração.

Importante

Excluir valores de Caminho da Área ou reconfigurar valores de caminho de iteração causa perda irreversível de dados nos seguintes gráficos:

  • Gráficos de widget burndown e burn up
  • Gráficos de burndown do sprint
  • Gráficos de velocidade para equipes com trajetórias de área alteradas
  • Gráficos de tendências históricos que fazem referência aos valores caminho de área e caminho de iteração conforme definido no momento para cada item de trabalho

Você só pode excluir caminhos de área e iteração quando eles não são mais usados por itens de trabalho. Ao excluir esses caminhos, você não pode mais recuperar seus dados históricos.

As propriedades de navegação para o tipo de entidade iteração e o conjunto de entidades iterações incluem Project e Teams.

Para obter mais informações sobre caminhos de iteração, consulte os seguintes artigos:

Processos

As propriedades a seguir são válidas para o tipo de entidade Process e o conjunto de entidades Process . As chaves substitutas associadas ao Processo incluem ProcessSK, ProjectSKe TeamSK. Use essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho em tipos de item de trabalho para um projeto ou equipe.

Observação

As versões v-2.0, v3.0-preview e v4.0-preview Analytics dão suporte ao tipo de entidade Process e ao conjunto de entidades Process .

Você pode usar essas propriedades para filtrar dados de acompanhamento de trabalho com base em um nível de lista de pendências.

Nome de exibição Nome Tipo de dados Descrição
AnalyticsUpdatedDate Data e Hora Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
ProjectSK GUID Chave do projeto associada ao processo.
TeamSK GUID Chave de equipe associada ao processo.
Nome de referência da categoria de lista de pendências BacklogCategoryReferenceName fio Nome de referência de categoria atribuído à lista de pendências associada ao tipo de item de trabalho. Os exemplos incluem Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategorye Microsoft.TaskCategory.
Nome da lista de pendências BacklogName booleano Nome de referência atribuído à lista de pendências associada ao tipo de item de trabalho
Tipo de lista de pendências BacklogType GUID Identificador exclusivo atribuído a um backlog na criação.
Nível de lista de pendências BacklogLevel fio Nível de lista de pendências associado ao tipo de item de trabalho. O null valor será retornado se o tipo de item de trabalho não estiver associado a um nível de lista de pendências.
Tipo de Item de Trabalho WorkItemType fio Nome definido para um tipo de item de trabalho.
Tem lista de pendências HasBacklog fio Indicação se o tipo de item de trabalho pertence a uma lista de pendências.
É tipo oculto IsHiddenType booleano Indicação se o tipo de item de trabalho está desabilitado.
É tipo de bug IsBugType booleano Indicação se o tipo de item de trabalho pertence à categoria Bug .
Está Excluído IsDeleted booleano Indicação se o tipo de item de trabalho é excluído.

Para obter mais informações sobre listas de pendências de processo e tipos de item de trabalho, consulte os seguintes artigos:

Marcações

As propriedades a seguir são válidas para o conjunto de entidades Tags . As chaves substitutas associadas a Tag incluem TagSK e ProjectSK. As propriedades de navegação incluem o Project e sua restrição ProjectSKreferencial. Para obter mais informações sobre como usar marcas, consulte Adicionar marcas de item de trabalho para categorizar e filtrar listas e quadros.

Você pode usar essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho.

Nome de exibição Nome Tipo de dados Descrição
ID da marca TagId GUID ID exclusiva atribuída à marca na criação.
Nome da Marca TagName fio Nome da marca.

Equipes

As propriedades a seguir são válidas para o tipo de entidade Team e o conjunto de entidades do Teams . As chaves substitutas associadas à Equipe incluem TeamSK e ProjectSK. Você pode usar essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho com base em atribuições de equipe. Para obter informações sobre como usar e adicionar equipes, consulte Sobre equipes e ferramentas Agile e Criar ou adicionar uma equipe.

Nome de exibição Nome Tipo de dados Descrição
AnalyticsUpdatedDate Data e Hora Marca d'água que indica a última vez que os dados do Analytics foram atualizados.
ID da equipe TeamId GUID ID exclusiva atribuída à equipe na criação.
Nome da Equipe TeamName fio Nome da equipe.

As propriedades de navegação para o conjunto de entidades do Teams incluem Projetos, Áreas e Iterações.

As propriedades a seguir são válidas para o conjunto de entidades WorkItemLinks . A chave alternativa de referência de propriedade é WorkItemLinkSK. Consulte WorkItemLinks para relatar sobre pai/filho, relacionado, predecessor/sucessor ou outros tipos de link.

Nome de exibição Nome Tipo de dados Descrição
AnalyticsUpdatedDate Data e Hora Marca d'água que indica a última vez que os dados do Analytics foram atualizados.
WorkItemLinkSK Int32 Chave substituta atribuída à entidade WorkItemLink .
Data da Criação CreatedDate GUID Data em que o link foi criado.
Comentário Comment fio Comentário adicionado quando o link foi criado.
Data de Exclusão DeletedDate fio Data em que o link foi excluído.
ID do tipo de link LinkTypeId Int32 ID atribuída ao item de trabalho vinculado de destino.
Nome do Tipo de Link LinkTypeName fio Nome amigável atribuído ao tipo de link.
Nome de referência do tipo de link LinkTypeReferenceName fio Nome de referência atribuído ao tipo de link.
O tipo de link é acíclico LinkTypeIsAcyclic booleano Indicação de que o tipo de link permite relações circulares quando definido como True. Por exemplo, os links de tipo de árvore restringem relações circulares.
O tipo de link é direcional LinkTypeIsDirectional booleano Indicação se o tipo de link é direcional. Os tipos de link direcional são definidos em pares com um componente de avanço e inverso.
ID do Item de Trabalho de Origem SourceWorkItemId Int32 ID atribuída ao item de trabalho de origem do link.
ID do Item de Trabalho de Destino TargetWorkItemId Int32 ID atribuída ao item de trabalho de destino do link.

As propriedades de navegação para o tipo de entidade WorkItemLink incluem Projects, SourceWorkItem e TargetWorkItem.

Para obter mais informações sobre links e tipos de links, consulte os seguintes artigos:

CamposDeTipoDeItemDeTrabalho

As propriedades a seguir são válidas para o conjunto de entidades WorkItemTypeFields . As chaves de referência de propriedade são FieldName, ProjectSKe WorkItemType.

Nome de exibição Nome Tipo de dados Descrição
Nome do Campo FieldName fio Nome amigável atribuído a um campo pelo sistema ou na criação.
Nome da Referência de Campo FieldReferenceName fio Nome de referência atribuído a um campo pelo sistema ou na criação de um campo personalizado.
Tipo de campo FieldType fio Tipo de dados atribuído a um campo.
Tipo de Item de Trabalho WorkItemType fio Tipo de item de trabalho para o qual um campo é definido.

As propriedades de navegação incluem o Project. Para obter um índice de todos os campos definidos para um projeto, consulte Descrições de campo para campos de item de trabalho. Para obter mais informações, consulte os seguintes artigos:

Propriedades personalizadas

Campos personalizados são adicionados automaticamente ao serviço analytics como propriedades personalizadas. Custom_ ou Custom. é acrescentado ao nome da propriedade. Verifique os metadados da coleção, conforme descrito em Consultar os metadados. O exemplo a seguir mostra a sintaxe de metadados para o campo personalizado Oportunidade de Risco.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>

Tipos de item de trabalho personalizado e categorias de lista de pendências

Os dados para tipos de item de trabalho personalizados são adicionados automaticamente ao serviço de Análise. Uma categoria personalizada é criada quando um tipo de item de trabalho personalizado e um nível de backlog são definidos, com Custom_ ou Custom. pré-acrescentados ao GUID de categoria. Por exemplo, uma categoria personalizada, como Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 pode ser atribuída ao tipo de item de trabalho personalizado portfólio em uma lista de pendências portfólios.

Conteúdo relacionado

  • Last updated on