Referência de metadados para Azure Boards Analytics

  • Artigo

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

O serviço análise coleta todas as atividades de acompanhamento de trabalho definidas e atualizadas por meio de Azure Boards. A análise armazena como propriedades todos os campos de acompanhamento de trabalho, exceto os campos HTML/rich-text e Histórico. As propriedades personalizadas para campos personalizados são adicionadas automaticamente ao Analytics.

Este artigo descreve a maioria das propriedades que você pode usar para gerar um relatório de Análise para acompanhamento de trabalho. Você usa uma combinação de propriedades para filtrar uma consulta, agregar dados ou criar um relatório. Você pode executar essas consultas diretamente no navegador. Para saber mais, confira Definir consultas básicas usando o OData Analytics. Se você não estiver familiarizado com o acompanhamento de trabalho e Azure Boards, recomendamos que você examine os seguintes artigos:

Observação

Descrições das entidades, propriedades e tipos enumerados compatíveis com o modelo de dados do Analytics são fornecidas. Este é um rascunho antecipado. Forneça comentários sobre as áreas que você gostaria de ter mais informações. 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 dados de acompanhamento de trabalho, use um dos seguintes tipos de entidade ou conjuntos de entidades.

  • WorkItems Consulta para gerar relatórios de status e rollup
  • WorkItemSnapshot Consulta para gerar relatórios de tendência, burndown e burnup

Use outros tipos de entidade, como Area, Iteration, Project, Teamou outras entidades para filtrar dados ou selecionar propriedades para relatar. Para obter um resumo dos relatórios de exemplo, consulte Relatórios de exemplo e índice de referência rápida.

Observação

Para gerar relatórios de tendência e status em tipos de item de trabalho específicos de teste, consulte os WorkItems tipos de entidade e WorkItemSnapshot e filtre com base no tipo de item de trabalho. Para obter informações sobre execuções de teste, resultados de teste ou outros dados de teste, consulte os TestRunstipos de entidade , TestPoints, TestResultsDailyou TestSuiteTestPointHistorySnapshot . Para saber mais, confira Referência de metadados de teste para o Azure DevOps.

EntitySet EntityType Descrição
Áreas Área O item de trabalho Caminhos da Área, com propriedades para agrupamento e filtragem por hierarquia de área.
Datas CalendarDate As datas usadas para filtrar e agrupar outras entidades usando relações.
Iterações Iteração O item de trabalho Caminhos de Iteração, com propriedades para agrupamento e filtragem por hierarquia de iteração.
BoardLocations BoardLocation Os locais das células do quadro Kanban, conforme identificado por coluna de placa, raia e divisão, incluem configurações históricas do quadro. Para obter uma descrição de cada campo de quadro Kanban, consulte Fluxo de trabalho e campos de placa Kanban.
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 Project Todos os projetos definidos para uma organização (nuvem) ou coleção de projetos (local).
Tags Tag 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.
Teams 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ído a, Criado por.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Composição) O estado de cada item de trabalho em cada data de calendário, incluindo o local do quadro Kanban, 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 Os links entre itens de trabalho, por exemplo, Filho, Pai e Relacionado. Inclui apenas a revisão mais recente de links, sem histórico. Os hiperlinks não estão incluídos.
WorkItemRevisions 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 (Composição) O estado de cada item de trabalho em cada data de 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 O 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 As propriedades do item de trabalho para cada tipo de item de trabalho e processo. Usado para dar suporte à criação de relatórios.

Sobre instantâneos

Há dois conjuntos de entidades de instantâneo de acompanhamento de trabalho: WorkItemSnapshot e WorkItemBoardSnapshot.

Um instantâneo fornece um registro dos valores definidos para um item de trabalho todos os dias. O registro é gravado no Analytics uma vez por dia ao mesmo tempo todos os dias. Você usa instantâneos quando deseja gerar um relatório de tendência. Por padrão, todas as tabelas instantâneo são modeladas como tabelas de fatos instantâneo diárias. Se você consultar um intervalo de tempo, ele obterá um valor para cada dia. Intervalos de tempo longos 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 até mesmo mensais.

Para saber mais, confira Diretrizes de consulta OData, Use instantâneos semanais ou mensais para consultas de tendência que abrangem um longo período de tempo.

Sobre revisões de item de trabalho

Sempre que você atualiza um item de trabalho, o sistema cria uma nova revisão e registra essa ação no campo, o que o System.RevisedDate torna útil para especificar um filtro de histórico. A data revisada é representada pelas RevisedDate propriedades (DateTime) e RevisedDateSK (Int32). Para obter o melhor desempenho, use a última chave alternativa de data. Ele representa a data em que uma revisão foi criada ou tem nulo para revisões ativas ou incompletas.

Se você quiser todas as datas desde a {startDate} inclusão, adicione o filtro a seguir à consulta.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Você usa o WorkItemRevisions conjunto de entidades 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 que você filtra. Ele não inclui itens de trabalho excluídos.

Propriedades compartilhadas em vários 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 selecione Propriedades de análise, como Dias de Tempo de Ciclo e Dias de Tempo de Entrega. Essas propriedades, a maioria das quais são listadas e descritas na tabela a seguir, são definidas para os seguintes tipos de entidade, a menos que especificado de outra forma.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Observação

O serviço de Análise não armazena dados para campos de texto longo atribuídos ao tipo de dados HTML ou rich text. Isso inclui os campos Descrição e Histórico . A análise também não armazena contagens de arquivos anexados ou de link. Para obter uma lista completa de campos definidos nos modelos de processo padrão, consulte Índice de campo de item de trabalho. Para obter descrições de cada tipo de dados, consulte Campos de consulta, operadores e macros.
Nem todas as propriedades associadas a campos específicos do processo Scrum e CMMI estão incluídas na tabela a seguir. Para obter uma lista desses campos, consulte Descrições de campo para campos de item de trabalho e padrão usados em modelos de processo, Campos usados para acompanhar itens de trabalho CMMI.

Muitas propriedades são baseadas em data ou no usuário. Essas propriedades estão associadas aos conjuntos de entidades CalendarDate e User descritos em Data do calendário, Projeto e Referência de metadados do usuário.

Nome de exibição
Property name		 Data type Descrição
Reference name
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		 DateTime 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		 DateTime Data e hora em que um membro da equipe ativou ou reativou um bug ou item de trabalho.
Microsoft.VSTS.CodeReview.ActivatedDate
Atividade
Activity		 String O tipo de atividade que é necessária para executar uma tarefa.
Microsoft.VSTS.Common.Activity

O tipo de atividade ou disciplina que é atribuída a uma tarefa. Os valores permitidos são: Implantação, Design, Desenvolvimento, Documentação, Requisitos e Teste. (Processo ágil, Scrum e Básico)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Os dados e a hora em que a entidade foi atualizada pela última vez.
Tipo de Aplicativo String O tipo de aplicativo sobre o qual os stakeholders fornecerão comentários. Os valores padrão são Aplicativo Web, Computador Remoto e Aplicativo Cliente. Os tipos válidos são especificados no arquivo de configuração do processo para projetos que usam um processo XML local.
Microsoft_VSTS_Feedback_ApplicationType
Caminho de Área
AreaPath
AreaSK		 String Agrupa os itens de trabalho no recurso do produto ou nas áreas da equipe. A área deve ser um nó válido na hierarquia de projetos.
System.AreaPath
Atribuído a
AssignedTo
AssignedToUserSK		 UserSK O nome do membro da equipe que possui atualmente o item de trabalho.
System.AssignedTo
ID de teste automatizada
AutomatedTestId		 String O ID do teste que automatiza o caso de teste.
Microsoft.VSTS.TCM.AutomatedTestId
Nome de teste automatizado
AutomatedTestName		 String Nome do membro da equipe que ativou ou reativou o item de trabalho.
Microsoft.VSTS.TCM.AutomatedTestName
Armazenamento automatizado de teste
AutomatedTestStorage		 String O assembly que contém o teste que automatiza o caso de teste.
Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo automatizado de teste
AutomatedTestType		 String O tipo de teste que automatiza o caso de teste.
Microsoft.VSTS.TCM.AutomatedTestType
Status de Automação
AutomatedStatus		 String O status de um caso de teste com os seguintes valores aceitos: Automatizado, Não Automatizado ou Planejado.
Microsoft.VSTS.TCM.AutomationStatus
Prioridade da lista de pendências
BacklogPriority		 Double Um 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 Scrum)
Microsoft.VSTS.Common.BacklogPriority
Bloqueado
Blocked		 String Indica 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		 Double Uma unidade de medida subjetiva que registra o valor comercial relativo de um item da lista de pendências de produtos ou recurso em relação a outros itens do mesmo tipo. Um item com um número mais alto deve ser considerado como tendo mais valor comercial do que um item com um número mais baixo.
Microsoft.VSTS.Common.BusinessValue
Alterado por
ChangedBy
ChangedByUserSK		 UserSK O nome da pessoa que modificou o item de trabalho mais recentemente.
System.ChangedBy
Data da Alteração
ChangedDate		 DateTime Data e hora em que o item de trabalho foi modificado.
System.ChangedDate
ChangedDateSK Int32 A 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 O nome da pessoa que fechou um item de trabalho.
Microsoft.VSTS.Common.ClosedBy
Data de fechamento
ClosedDate
ClosedDateSK
ClosedOn		 DateTime Data e hora em que um item de trabalho foi fechado.
Microsoft.VSTS.Common.ClosedDate
Contagem de Comentários
CommentCount		 Int32 O número de comentários adicionados à seção Discussão do item de trabalho.
System.CommentCount
Cometeu
Committed		 String Indica 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 estado de fluxo de trabalho 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 estado de fluxo de trabalho 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		 Double Uma medida da quantidade de trabalho gasta em uma tarefa.
Microsoft.VSTS.Scheduling.CompletedWork
Criado por
CreatedBy
CreatedByUserSK		 UserSK O nome da pessoa que criou o item de trabalho.
Microsoft.VSTS.Common.CreatedBy
Data da Criação
CreatedDate
CreatedDateSK		 DateTime A data em que o item de trabalho foi criado, expresso no fuso horário definido para a organização. Normalmente usado para filtragem e para exibição.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 A 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		 Double O 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 saber mais, confira Widgets tempo de entrega e tempo de ciclo.
Disciplina
Discipline		 String O tipo de atividade ou disciplina que é 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		 DateTime A data de conclusão prevista pela qual um problema ou item de trabalho será resolvido. (Processo Agile)
Microsoft.VSTS.Scheduling.DueDate
Esforço
Effort		 Double Uma estimativa da quantidade de trabalho que um item de lista de pendências do produto (processo Scrum) ou um problema (processo básico) exigirá para implementar.
Microsoft.VSTS.Scheduling.Effort
Data de Conclusão
FinishDate		 DateTime Data e hora em que o agendamento indica que um item de trabalho será concluído.
Microsoft.VSTS.Scheduling.FinishDate
Encontrado em
FoundIn		 String O número da compilação do produto, ou revisão, em que um bug foi encontrado.
Microsoft.VSTS.Build.FoundIn
Data do InProgress
InProgressDate		 DateTime 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 A 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		 String O número da compilação do produto que incorpora o código ou as correções de um bug.
Microsoft.VSTS.Build.IntegrationBuild
É Atual
IsCurrent		 Booliano Dá suporte à filtragem dos dados para exibir a instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor Truecomo .
Válido para estes tipos de entidade: WorkItemRevision, WorkItemBoardSnapshote BoardLocation.
É a Última Revisão do Dia
IsLastRevisionOfDay		 Booliano Indica que o instantâneo representa a última revisão do dia quando definido Truecomo .
É a Última Revisão do Período
IsLastRevisionOfPeriod		 Booliano Indica que o instantâneo representa a última revisão do período quando definido Truecomo .
Problema
Issue		 String Indica 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		 Double O prazo de entrega é calculado a partir da criação do item de trabalho ou da inserção de uma categoria de estado Proposta para inserir uma categoria de estado Concluído . Para saber mais, confira Widgets tempo de entrega e tempo de ciclo.
Estimativa Original
OriginalEstimate		 Double Uma medida da quantidade de trabalho necessária para concluir uma tarefa.
Microsoft.VSTS.Scheduling.OriginalEstimate
ID do item de trabalho pai
ParentWorkItemId		 Int32 A ID exclusiva que identifica o item de trabalho vinculado como um pai. Útil para gerar relatórios cumulativos. O campo Pai está disponível no Azure DevOps Server 2020 e versões posteriores. Válido para estes tipos de entidade: WorkItemRevision e WorkItem.
System.Parent
Prioridade
Priority		 Int32 Uma classificação subjetiva do bug, problema, tarefa ou caso de teste, conforme ele se relaciona ao negócio. 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 Data do calendário, Projeto e Referência de metadados do usuário, Propriedades do projeto.
System.TeamProject
ProjectSK GUID GUID atribuído ao projeto ao qual o item de trabalho pertence.
Classificação
Reason		 String O número de estrelas que um item recebe de um revisor, em um sistema de classificação baseado em estrelas. (Resposta de comentários) O número é armazenado no sistema e escrito da seguinte maneira:- 0 - Não Classificado, 1 - Pobre, 2 - Justo, 3 - Bom, 4 - Muito Bom e 5 - Excelente. Válido para esses tipos de entidade: WorkItemRevision e WorkItem.
Microsoft.VSTS.Common.Rating
Motivo
Reason		 String O 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		 Double Uma medida da quantidade de trabalho que resta para concluir uma tarefa.
Microsoft.VSTS.Scheduling.RemainingWork
Resolvido por
ResolvedBy
ResolvedByUserSK		 UserSK O nome do membro de equipe que resolveu o bug ou a história do usuário.
Microsoft.VSTS.Common.ResolvedBy
Data de resolução
ResolvedDate		 DateTime A data e a hora em que o bug ou a história do usuário foi resolvido.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 A 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		 String O motivo pelo qual o bug foi resolvido (ex.: ele foi corrigido).
Microsoft.VSTS.Common.ResolvedReason
Revisão
Revision		 Int32 Um número que é atribuído à revisão histórica de um item de trabalho.
System.Rev
Data de Revisada
RevisedDate		 DateTime Data e hora em que um item de trabalho foi modificado ou atualizado.
RevisedDateSK Int32 A 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		 Double Uma classificação subjetiva da incerteza relativa sobre a conclusão bem-sucedida do histórico do usuário. Os valores válidos incluem: 1 – Alto, 2 – Médio e 3 – Baixo.
Microsoft.VSTS.Common.Risk
Gravidade
Severity		 Double Uma 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		 Double Uma estimativa da quantidade de trabalho que um requisito (processo CMMI) requer para implementar.
Microsoft.VSTS.Scheduling.Size
Classificação da pilha
StackRank		 Double Um 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 ágeis, Scrum e Básicos)
Microsoft.VSTS.Common.StackRank
Data de Início
StartDate		 DateTime Data e hora atribuídas a um item de trabalho para que o trabalho seja iniciado.
Microsoft.VSTS.Scheduling.StartDate
State
State		 String O 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		 String As categorias de estado determinam como Azure Boards e selecione dashboard widgets tratam cada estado de fluxo de trabalho. As categorias de estado em uso incluem: Propostas, Em Andamento, Resolvidas, Removidas e Concluídas. Para saber mais, confira 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		 DateTime A data e a hora em que o valor do campo Estado foi alterado.
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 A data em que o Estado de um 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 o Estado de um 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		 Double Uma estimativa da quantidade de trabalho que uma história de usuário (processo Agile) requer para implementar, normalmente agregada como uma soma.
Microsoft.VSTS.Scheduling.StoryPoints
Marcas
TagNames		 String 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		 DateTime A data de conclusão prevista pela qual um problema ou outro item de trabalho será resolvido ou concluído.
Microsoft.VSTS.Scheduling.TargetDate
Tipo de Pacote de Teste String Especifica o tipo de conjunto de testes. 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 Um número atribuído pelo sistema que corresponde à categoria do conjunto de testes e aplicável somente aos conjuntos de testes. Os valores atribuídos são: 1 (estático), 2 (baseado em consulta) e 3 (baseado em requisitos).
Microsoft_VSTS_TCM_TestSuiteTypeId
Criticidade do tempo
TimeCriticality		 Double Uma unidade subjetiva de medida que captura como o valor comercial diminui ao longo do tempo. Valores mais altos indicam que o épico ou o recurso é inerentemente mais crítico do que aqueles itens com valores mais baixos.
Microsoft.VSTS.Common.TimeCriticality
Título
Title		 String Uma breve descrição que resume do que se trata o item de trabalho e ajuda os membros da equipe a distinguirem esse de outros itens de trabalho em uma lista.
System.Title
Área de Valor
ValueArea		 String A área do valor do cliente abordada pelo item épico, recurso ou lista de pendências. Os valores incluem: Arquitetura ou Negócios.
Microsoft.VSTS.Common.ValueArea
Marca de agua
Watermark		 String Um campo gerenciado pelo sistema que incrementa com alterações feitas em um item de trabalho. Válido para estes tipos de entidade: WorkItemRevision e WorkItem.
System.Watermark
ID do Item de Trabalho
WorkItemId		 Int32 O identificador exclusivo atribuído a um item de trabalho. As IDs de item de trabalho são exclusivas em todos os projetos e dentro de uma organização ou coleção de projetos.
System.Id
WorkItemRevisionSK Int32 A chave exclusiva do Analytics para a revisão do item de trabalho que é usada por ferramentas externas para unir entidades relacionadas.
Tipo de Item de Trabalho
WorkItemType		 String O nome do tipo de item de trabalho. Os tipos de item de trabalho são definidos com base no processo usado quando você criou seu projeto. Para obter mais informações, consulte Sobre processos e modelos de processo.
System.WorkItemType

As propriedades de navegação no 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 e propriedade		 Válido para tipos de entidade
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
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Teams Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Marcas WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Project Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Processos WorkItemRevision, WorkItem, WorkItemSnapshot
Revisões WorkItem
Links WorkItem
Filhos WorkItem
Pai WorkItem
Descendants WorkItem
Workitem WorkItemId WorkItemRevision

Prever funções

As duas funções a seguir têm suporte para a entidade WorkItem . Essas funções são usadas para dar suporte a tendências preditivas em relatórios e widgets internos do Analytics selecionados.

  • PredictTags
  • Predict

BoardLocation e WorkItemBoardSnapshot

As propriedades listadas e descritas na tabela a seguir são definidas para os seguintes tipos de entidade, a menos que indicado especificamente. Com esses campos, você pode filtrar dados de item de trabalho com base no status de um item de trabalho dentro do nível de coluna de quadro Kanban, raia ou lista de pendências de uma equipe.

  • BoardLocation
  • WorkItemBoardSnapshot

Para obter um exemplo que consulta o WorkItemBoardSnapshot conjunto de entidades, consulte Relatório de exemplo do CFD (Diagrama de Fluxo Cumulativo).

Nome de exibição
Property name		 Data type Descrição
Reference name
ID da placa
BoardId		 Guid O GUID exclusivo atribuído a um quadro Kanban. Cada equipe está associada a um ou mais quadros Kanban.
Nome de referência da categoria do quadro
BoardCategoryReferenceName		 String O nome atribuído à categoria de tipos de item de trabalho usados para preencher um quadro Kanban. Por exemplo, a placa de lista de pendências do produto está associada à categoria Requisitos. Para saber mais, confira Personalizar suas listas de pendências ou quadros (processo de herança).
Nome do quadro
BoardName		 String O nome atribuído ao quadro Kanban. Por exemplo, Histórias, Itens de Lista de Pendências, Recursos e Épicos.
Nível da placa
BoardLevel		 Int32 O número atribuído ao quadro Kanban com base em onde ele está na hierarquia de quadros Kanban.
Tipo de lista de pendências
BacklogType		 String O nome do tipo de lista de pendências. Por exemplo, Iteração, Requisito ou Portfólio.
Nome da Coluna
ColumnName		 String O nome da coluna do quadro Kanban que um item de trabalho está atribuído no momento, como Ativo, Fechado, Confirmado, Concluído ou outro rótulo de coluna personalizado.
System.BoardColumn
Ordem da Coluna
ColumnOrder		 Int32 O número atribuído à coluna do quadro Kanban em termos de sua sequência dentro do quadro Kanban.
Concluído
Done		 Enumerated Indica o local da coluna dividida. Os valores válidos estão listados abaixo para BoardColumnSplit.
Limite de Item de Coluna
ColumnItemLimit		 Int32 O número atribuído à coluna do quadro Kanban em termos de sua sequência.
Is Board Visible
IsBoardVisible		 Booliano Indica se a equipe optou por tornar um quadro visível ou não.
É Divisão de Coluna
IsColumnSplit		 Booliano Indica se uma coluna foi dividida em colunas Doing and Done , conforme descrito em Dividir colunas no quadro Kanban para mostrar o trabalho em andamento.
É Atual
IsCurrent		 Booliano Propriedade que dá suporte à filtragem dos dados para exibir a instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor Truecomo .
É a Faixa Padrão
IsDefaultLane		 Booliano Propriedade que indica que o item de trabalho é atribuído à raia padrão (True) ou não (False).
Está concluído
IsDone		 Booliano A atribuição atual do item de trabalho a Doing (False) ou Done (True) em uma coluna Kanban. Atribuído somente quando split-columns está habilitado para uma coluna de quadro Kanban.
System.BoardColumnDone
ID da faixa
LaneId		 Guid O GUID exclusivo atribuído a uma pista de natação de placa Kanban. Cada equipe pode adicionar uma ou mais pistas de natação a uma placa Kanban. Para saber mais sobre raias, confira Acelerar o trabalho da sua equipe usando raias em sua placa Kanban.
Nome da Faixa
LaneName		 String O nome atribuído à raia do quadro Kanban.
System.BoardLane
Ordem de Faixa
LaneOrder		 Int32 O número atribuído à raia da placa Kanban em termos de sua sequência.

Membros enumerados BoardColumnSplit

A tabela a seguir lista os nomes de membro para o BoardColumnSplit tipo enumerado, que pode ser usado para filtrar itens de trabalho na coluna do quadro Doing ou Done .

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

Para saber mais 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 Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
Number Int32 Um valor inteiro atribuído a um nó caminho de área quando ele é criado.
Profundidade Depth Int32 O nível no qual o Caminho da Área é definido com base em sua profundidade do nível raiz.
ID da área AreaId GUID Identificador exclusivo atribuído a um Caminho de Área quando ele é criado.
Nível de Área 1 a
Nível de Área 14		 AreaLevel1 até
AreaLevel14		 String O nome associado ao nível do nó de um caminho de área. Há suporte para até 14 níveis aninhados. Por exemplo, o Nível de Área 1 sempre corresponde ao nó raiz e ao nome do projeto.
Nome de área AreaName String Nome definido para o Caminho da Área quando ele é criado.
Caminho de Área AreaPath String Caminho completo do Caminho da Área começando com o nó raiz.

Importante

Excluir caminhos de área ou reconfigurar caminhos de iteração pode causar uma perda de dados e não pode ser revertido. Por exemplo, gráficos de widget burndown ou burnup, burndown de sprint e gráficos de velocidade para equipes cujos Caminhos de Área são alterados não refletirão os dados corretos. Gráficos de tendências históricos referenciam o Caminho da Área e o Caminho da Iteração , conforme definido em um ponto no passado para cada item de trabalho. Quando um Caminho de Área ou Caminho de Iteração é excluído, os dados históricos para ele não podem ser recuperados.

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

Para saber mais sobre caminhos de á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 Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
Number Int32 Um valor inteiro atribuído a um nó Demarcador de Iteração quando ele é criado.
Profundidade Depth Int32 O nível no qual o Caminho de Iteração é definido com base em sua profundidade do nível raiz.
Data de Término EndDate DateTime Data de término definida para o Caminho da Iteração.
IsEnded IsEnded Booliano Quando definido como True, indica que a Data de Término do Caminho de Iteração está no passado.
ID da iteração IterationId GUID Identificador exclusivo atribuído a um caminho de iteração quando ele é criado.
Iteração Nível 1 a
Nível de iteração 14		 IterationLevel1 até
IterationLevel14		 String O nome associado ao nível do nó de um caminho de iteração. Há suporte para até 14 níveis aninhados. Por exemplo, o Nível de Iteração 1 sempre corresponde ao nó raiz e ao nome do projeto.
Nome da iteração IterationName String Nome definido para um caminho de iteração quando ele é criado.
Caminho de Iteração IterationPath String Caminho completo do Caminho de Iteração começando com o nó raiz. A iteração deve ser um nó válido na hierarquia de projetos.
System.IterationPath
Data de Início StartDate DateTime Data de início definida para o Caminho da Iteração.

Importante

Excluir caminhos de área ou reconfigurar caminhos de iteração pode causar uma perda de dados e não pode ser revertido. Por exemplo, gráficos de widget burndown ou burnup, burndown de sprint e gráficos de velocidade para equipes cujos Caminhos de Área são alterados não refletirão os dados corretos. Gráficos de tendências históricos referenciam o Caminho da Área e o Caminho da Iteração , conforme definido em um ponto no passado para cada item de trabalho. Quando um caminho de área ou caminho de iteração é excluído, os dados históricos para ele não podem ser recuperados.

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

Para saber mais 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. Você pode usar essas propriedades para filtrar ou relatar dados de acompanhamento de trabalho com base em tipos de item de trabalho usados por um projeto ou equipe.

Observação

O tipo de entidade Process e o conjunto de entidades Processes têm suporte com versões v-2.0, v3.0-preview e v4.0-preview do Analytics.

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 Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez 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 String O 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.RequirementCategory, , Microsoft.TaskCategory.
Nome da lista de pendências BacklogName Booliano O 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 caminho de iteração quando ele é criado.
Nível de lista de pendências BacklogLevel String Especifica o nível de lista de pendências associado ao tipo de item de trabalho. Se o tipo de item de trabalho não estiver associado a um nível de lista de pendências, o valor retornado será null.
Tipo de Item de Trabalho WorkItemType String Nome definido para um tipo de item de trabalho.
Tem lista de pendências HasBacklog String Indica se o tipo de item de trabalho pertence a uma lista de pendências.
É tipo oculto IsHiddenType Booliano Indica se o tipo de item de trabalho foi desabilitado.
É tipo de bug IsBugType Booliano Indica se o tipo de item de trabalho pertence à categoria Bug.
Está Excluído IsDeleted Booliano Indica se o tipo de item de trabalho foi excluído.

Para saber mais sobre listas de pendências de processo e tipos de item de trabalho, confira os seguintes artigos:

Tipos de item de trabalho personalizados e categorias de lista de pendências personalizadas

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 lista de pendências são definidos. Custom_ é anexado ao GUID de categoria. Por exemplo, para o tipo de item de trabalho personalizado portfólio com uma lista de pendências portfólios, um GUID é atribuído à categoria personalizada, como Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

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 Project e sua restrição ProjectSKreferencial . Para saber mais 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 Data type Descrição
ID da marca TagId GUID A ID exclusiva atribuída à marca quando ela é criada.
Nome da Marca TagName String O nome da marcação.

Teams

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 Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
ID da equipe TeamId GUID A ID exclusiva atribuída à equipe quando ela é criada.
Nome da Equipe TeamName String O nome da equipe.

As propriedades de navegação para o conjunto de entidades do Teams incluem Projects, Arease Iterations.

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 Data type Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez em que os dados do Analytics foram atualizados.
WorkItemLinkSK Int32 A chave alternativa atribuída à WorkItemLink entidade.
Data da Criação CreatedDate GUID Data em que o link foi criado.
Comentário Comment String Comentário adicionado quando o link foi criado.
Data de Exclusão DeletedDate String Data em que o link foi excluído.
ID do tipo de link LinkTypeId Int32 A ID atribuída ao item de trabalho de destino vinculado.
Nome do Tipo de Link LinkTypeName String O nome amigável atribuído ao tipo de link.
Nome de referência do tipo de link LinkTypeReferenceName String O nome de referência atribuído ao tipo de link.
O tipo de link é acíclico LinkTypeIsAcyclic Booliano O valor do atributo de tipo de link que indica que o tipo de link permite relações circulares quando o valor é definido como True. Por exemplo, os links de tipo de árvore restringem relações circulares.
O tipo de link é direcional LinkTypeIsDirectional Booliano O valor do atributo de tipo de link que indica que 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 A ID atribuída ao item de trabalho de origem vinculado.
ID do Item de Trabalho de Destino TargetWorkItemId Int32 A ID atribuída ao item de trabalho de destino vinculado.

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

Para saber mais sobre links e tipos de link, confira os seguintes artigos:

WorkItemTypeFields

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 Data type Descrição
Nome do Campo FieldName String Nome amigável atribuído a um campo pelo sistema ou quando ele é criado.
Nome da Referência de Campo FieldReferenceName String Nome de referência atribuído a um campo pelo sistema ou quando um campo personalizado é criado.
Tipo de campo FieldType String Tipo de dados atribuído a um campo.
Tipo de Item de Trabalho WorkItemType String Nome dos tipos de item de trabalho para os quais um campo é definido.

As propriedades de navegação incluem 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 informações adicionais, consulte os seguintes artigos:

Propriedades personalizadas

Campos personalizados são adicionados automaticamente ao serviço de Análise como uma propriedade personalizada. Custom_ ou Custom. é acrescentado ao nome da propriedade. Verifique os metadados da coleção, conforme descrito em Construir consultas OData para Análise, componentes de URL para consultar os metadados. O exemplo a seguir fornece 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>