Partilhar via

Referência de metadados para o Azure Boards Analytics

  • Artigo

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

O serviço Analytics recolhe toda a atividade de acompanhamento de trabalho definida e atualizada através dos Painéis do Azure. O Google Analytics 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 Google Analytics.

Este artigo descreve a maioria das propriedades que você pode usar para gerar um relatório do Google Analytics 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 seu navegador. Para obter mais informações, consulte Definir consultas básicas usando o OData Analytics. Se você é novo no acompanhamento de trabalho e nos Painéis do Azure, recomendamos que revise os seguintes artigos:

Nota

São fornecidas descrições das entidades, propriedades e tipos enumerados suportados pelo modelo de dados do Google Analytics. Este é um rascunho inicial. Por favor, 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 Analytics.

Visão geral dos conjuntos de entidades

Ao consultar dados de acompanhamento de trabalho do Google Analytics, use um dos seguintes tipos de entidade ou conjuntos de entidades.

  • Consulta WorkItems para gerar relatórios de status e rollup
  • Consulta WorkItemSnapshot 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 relatórios. Para obter um resumo dos relatórios de exemplo, consulte Relatórios de exemplo e índice de referência rápida.

Nota

Para gerar relatórios de status e tendência sobre tipos de item de trabalho específicos do teste, consulte os WorkItems tipos de entidade e filtre WorkItemSnapshot 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 , TestPoints, TestResultsDailyTestSuite ou TestPointHistorySnapshot entidade. Para obter mais informações, consulte Referência de metadados de teste para o Azure DevOps.

EntitySet EntityType Description
Áreas Área O item de trabalho Caminhos de á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 A localização das células do tabuleiro, conforme identificado por coluna de prancha, raia e divisão, inclui configurações históricas do tabuleiro. Para obter uma descrição de cada campo do painel, consulte Fluxo de trabalho e campos do quadro.
Processos Processo Informações da lista de pendências usadas para expandir ou filtrar itens de trabalho e tipos de itens de trabalho. Para obter um exemplo que usa Processos para filtrar um relatório, consulte Relatório de exemplo de controle de requisitos. Compatível com a versão do Analytics v2.0 e posterior.
Projetos Projeto Todos os projetos definidos para uma organização (nuvem) ou coleção de projetos (local).
Etiquetas Tag Todas as tags de item de trabalho para cada projeto. Para obter um exemplo que usa Tags para filtrar um relatório, consulte Relatório de exemplo de burndown de versão.
Equipas Equipa Todas as equipas definidas para o projeto. Para obter um exemplo que usa o Teams para filtrar um relatório, consulte Adicionar uma segmentação de dados de equipe a um relatório do Power BI.
Utilizadores Utilizador Informações do usuário que são usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo , Atribuído a, Criado por.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Composto) O estado de cada item de trabalho em cada data do calendário, incluindo a localização do quadro, usado para gerar relatórios de tendências. Para obter um relatório de exemplo, consulte Relatório de exemplo de diagrama de fluxo cumulativo (CFD).
WorkItemLinks WorkItemLink Os links entre itens de trabalho, por exemplo, Filho, Pai e Relacionado. Inclui apenas a última revisão de links, sem histórico. Os hiperlinks não estão incluídos.
WorkItemRevisions WorkItemRevision Todas as revisões de itens de trabalho históricos, incluindo a revisão atual. Não inclui itens de trabalho excluídos.
WorkItemSnapshot WorkItemSnapshot (Composto) 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.
Itens de Trabalho Item de trabalho O estado atual dos itens de trabalho. Usado para dar suporte a relatórios de status. Para obter um relatório de exemplo, consulte Acumular valores de item de trabalho filho para relatório de exemplo pai.
WorkItemTypeFields WorkItemTypeField As propriedades do item de trabalho para cada tipo e processo de item de trabalho. Usado para dar suporte à construção de relatórios.

Sobre instantâneos

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

Um instantâneo fornece um registro dos valores definidos para um item de trabalho a cada dia. O registro é gravado no Google Analytics uma vez por dia, no mesmo horário todos os dias. Você usa instantâneos quando deseja gerar um relatório de tendências. Por padrão, todas as tabelas de instantâneo são modeladas como tabelas de fatos de instantâneo diário. Se você consultar um intervalo de tempo, ele obterá um valor para cada dia. Longos intervalos de tempo resultam em um grande número de registros. Se você não precisa de uma precisão tão alta, pode usar instantâneos semanais ou até mensais.

Para obter mais informações, consulte Diretrizes de consulta OData, Usar 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

Cada vez que você atualiza um item de trabalho, o sistema cria uma nova revisão e registra essa ação no campo, o System.RevisedDate que a 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 substituta de data. Ele representa a data em que uma revisão foi criada ou tem null 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 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 filtrados. Ele não inclui itens de trabalho excluídos.

Propriedades compartilhadas em vários tipos de entidade

As propriedades que você pode selecionar em uma visualização do Google Analytics correspondem aos campos de acompanhamento de trabalho regulares e selecionam as propriedades do Google Analytics, 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

Nota

O serviço Analytics não armazena dados para campos de texto longos atribuídos ao tipo de dados HTML ou rich text. Isso inclui os campos Descrição e Histórico. O Google Analytics também não armazena contagens de links ou arquivos anexados. Para obter uma lista completa dos 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 aos 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 padrão e de item de trabalho usados em modelos de processo, Campos usados para controlar itens de trabalho do 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 a apresentar
Property name		 Tipo de dados 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 de aceitação
AcceptedDate		 DateTime Data e hora em que a pessoa respondeu à revisão do 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 necessária para executar uma tarefa.
Microsoft.VSTS.Common.Activity

O tipo de atividade ou disciplina atribuída a uma tarefa. Os valores permitidos são: Implantação, Design, Desenvolvimento, Documentação, Requisitos e Testes. (Processo Agile, 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 Aplicação String O tipo de aplicação sobre o qual as partes interessadas fornecerão comentários. Os valores padrão são Aplicativo Web, Máquina Remota 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 da Área
AreaPath
AreaSK		 String Agrupa os itens de trabalho em recursos de produto ou áreas de equipe. A área deve ser um nó válido na hierarquia do projeto.
System.AreaPath
Atribuído a
AssignedTo
AssignedToUserSK		 UserSK O nome do membro da equipe que atualmente possui o item de trabalho.
System.AssignedTo
ID de teste automatizado
AutomatedTestId		 String A ID do teste que automatiza o caso de teste.
Microsoft.VSTS.TCM.AutomatedTestId
Nome do teste automatizado
AutomatedTestName		 String Nome do membro da equipe que ativou ou reativou o item de trabalho.
Microsoft.VSTS.TCM.AutomatedTestName
Armazenamento de teste automatizado
AutomatedTestStorage		 String O assembly que contém o teste que automatiza o caso de teste.
Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo de teste automatizado
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		 Duplo Um número atribuído por um processo em segundo plano do sistema usado para empilhar, classificar ou rastrear a sequência de itens em uma lista de pendências ou quadro. (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 de Negócio
BusinessValue		 Duplo Uma unidade de medida subjetiva que captura o valor comercial relativo de um item ou recurso da lista de pendências de um produto em comparação com outros itens do mesmo tipo. Um item ao qual é atribuído um número mais elevado deve ser considerado como tendo mais valor comercial do que um item ao qual é atribuído um número inferior.
Microsoft.VSTS.Common.BusinessValue
Alterado por
ChangedBy
ChangedByUserSK		 UserSK O nome da pessoa que modificou o item de trabalho mais recentemente.
System.ChangedBy
Data alterada
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, expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a 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. Comumente 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 encerramento
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
Empenhado
Committed		 String Indica se o requisito está comprometido 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 entrou em um estado do fluxo de trabalho associado à categoria Estado do 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 entrou em um estado do fluxo de trabalho associado à categoria Estado do fluxo de trabalho concluído, no fuso horário definido para a organização. Comumente usado para referenciar propriedades da Date entidade em groupby instruções.
Obra Concluída
CompletedWork		 Duplo Uma medida da quantidade de trabalho gasto 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 de criação
CreatedDate
CreatedDateSK		 DateTime A data em que o item de trabalho foi criado, expressa no fuso horário definido para a organização. Normalmente utilizado para filtragem e visualização.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 A data em que o item de trabalho foi criado, expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a 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. Comumente usado para referenciar propriedades da Date entidade em groupby instruções.
Dias de Tempo de Ciclo
CycleTimeDays		 Duplo O tempo de ciclo é calculado desde a primeira entrada em uma categoria de estado Em Andamento ou Resolvido até a entrada em uma categoria de estado Concluído . Para obter mais informações, consulte Widgets Lead Time e Cycle Time.
Disciplina
Discipline		 String O 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 Vencimento
DueDate		 DateTime A data de vencimento prevista até a qual um problema ou item de trabalho será resolvido. (Processo ágil)
Microsoft.VSTS.Scheduling.DueDate
Esforço
Effort		 Duplo Uma estimativa da quantidade de trabalho que um item de lista de pendências do produto (processo Scrum) ou problema (processo básico) exigirá para implementar.
Microsoft.VSTS.Scheduling.Effort
Data de Conclusão
FinishDate		 DateTime Data e hora em que o cronograma indica que um item de trabalho será concluído.
Microsoft.VSTS.Scheduling.FinishDate
Encontrado em
FoundIn		 String O número de compilação do produto, também conhecido como revisão, no qual um bug foi encontrado.
Microsoft.VSTS.Build.FoundIn
Data InProgress
InProgressDate		 DateTime Data armazenada do Google Analytics que captura a data-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 , expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a entidades relacionadas.
Construção de integração
IntegrationBuild		 String O número de compilação do produto que incorpora o código ou corrige um bug.
Microsoft.VSTS.Build.IntegrationBuild
É atual
IsCurrent		 Boolean Suporta a filtragem dos dados para ver o instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor como True.
Válido para estes tipos de entidade: WorkItemRevision, WorkItemBoardSnapshot, e BoardLocation.
É a última revisão do dia
IsLastRevisionOfDay		 Boolean Indica que o instantâneo representa a última revisão do dia quando definido como True.
É a última revisão do período
IsLastRevisionOfPeriod		 Boolean Indica que o instantâneo representa a última revisão do período quando definido como True.
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 Prazo de Entrega
LeadTimeDays		 Duplo O prazo de entrega é calculado a partir da criação do item de trabalho ou da entrada de uma categoria de estado Proposto até a entrada de uma categoria de estado Concluído . Para obter mais informações, consulte Widgets Lead Time e Cycle Time.
Estimativa original
OriginalEstimate		 Duplo 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 pai. Útil para gerar relatórios de rollup. 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 em relação 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, Referência de metadados do projeto e do usuário, Propriedades do projeto.
System.TeamProject
ProjectSK GUID GUID atribuído ao projeto ao qual o item de trabalho pertence.
Avaliaçã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 do feedback) O número é armazenado no sistema e escrito da seguinte forma:- 0 - Não classificado, 1 - Ruim, 2 - Regular, 3 - Bom, 4 - Muito Bom, e 5 - Excelente. Válido para estes tipos de entidade: WorkItemRevision e WorkItem.
Microsoft.VSTS.Common.Rating
Razão
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		 Duplo 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 da 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, expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a 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. Comumente usado para referenciar propriedades da Date entidade em groupby instruções.
Motivo resolvido
ResolvedReason		 String A razão pela qual o bug foi resolvido (por exemplo, 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 revisão
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, expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a 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. Comumente usado para referenciar propriedades da Date entidade em groupby instruções.
Risco
Risk		 Duplo Uma classificação subjetiva da incerteza relativa sobre a conclusão bem-sucedida da história do usuário. Os valores válidos incluem: 1 - Alto, 2 - Médio e 3 - Baixo.
Microsoft.VSTS.Common.Risk
Gravidade
Severity		 Duplo 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		 Duplo Uma estimativa da quantidade de trabalho que um requisito (processo CMMI) requer para implementar.
Microsoft.VSTS.Scheduling.Size
Classificação de pilha
StackRank		 Duplo Um número atribuído por um processo em segundo plano do sistema usado para empilhar, classificar ou rastrear a sequência de itens em uma lista de pendências ou quadro. (Processos Agile, Scrum e Básico)
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
Distrito
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 nele.
System.State
Categoria do Estado
StateCategory		 String As categorias de estado determinam como os Painéis do Azure e os widgets de painel selecionados tratam cada estado do fluxo de trabalho. As categorias de estado em uso incluem: Proposto, Em andamento, Resolvido, Removido e Concluído. Para obter mais informações, consulte Como usar estados e categorias de estado do fluxo de trabalho. Válido apenas para o tipo de WorkItemRevision entidade.
Data de 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, expressa como YYYYMMDD no fuso horário definido para a organização. Utilizado por ferramentas externas para aderir a 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. Comumente usado para referenciar propriedades da Date entidade em groupby instruções.
Pontos da história
StoryPoints		 Duplo Uma estimativa para a quantidade de trabalho que uma história de usuário (processo Agile) requer para implementar, geralmente agregada como uma soma.
Microsoft.VSTS.Scheduling.StoryPoints
Etiquetas
TagNames		 String Lista delimitada por ponto-e-vírgula de tags atribuídas a um ou mais itens de trabalho para fins de filtragem ou consulta.
System.Tags
Data-alvo
TargetDate		 DateTime A data de vencimento prevista até a qual um problema ou outro item de trabalho será resolvido ou concluído.
Microsoft.VSTS.Scheduling.TargetDate
Tipo de suíte 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 conjunto de testes Int64 Um número atribuído ao sistema que corresponde à categoria do conjunto de testes e aplicável apenas 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		 Duplo Uma unidade de medida subjetiva que captura como o valor do negócio diminui ao longo do tempo. Valores mais altos indicam que o épico ou recurso é inerentemente mais crítico em termos de tempo do que aqueles itens com valores mais baixos.
Microsoft.VSTS.Common.TimeCriticality
Título
Title		 String Uma breve descrição que resume o que é o item de trabalho e ajuda os membros da equipe a distingui-lo de outros itens de trabalho em uma lista.
System.Title
Área de Valor
ValueArea		 String A área de valor do cliente abordada pelo item épico, recurso ou lista de pendências. Os valores incluem: Arquitetura ou Negócio.
Microsoft.VSTS.Common.ValueArea
Marca d'água
Watermark		 String Um campo gerenciado pelo sistema que é incrementado com as 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 Google Analytics para a revisão do item de trabalho que é usada por ferramentas externas para ingressar 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 a apresentar Designação
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
Resolvidopor ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Equipas Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Etiquetas WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projeto Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Processos WorkItemRevision, WorkItem, WorkItemSnapshot
Revisões WorkItem
Ligações WorkItem
Crianças WorkItem
Elemento Principal WorkItem
Descendentes WorkItem
Item de trabalho WorkItemId WorkItemRevision

Prever funções

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

  • 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 especificamente indicado. Com esses campos, você pode filtrar dados de item de trabalho com base no status de um item de trabalho dentro da coluna do quadro, raia ou nível de lista de pendências de uma equipe.

  • BoardLocation
  • WorkItemBoardSnapshot

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

Nome a apresentar
Property name		 Tipo de dados Descrição
Reference name
Identificação da placa
BoardId		 GUID O GUID exclusivo atribuído a uma placa. Cada equipa está associada a um ou mais quadros.
Nome de referência da categoria da placa
BoardCategoryReferenceName		 String O nome atribuído à categoria de tipos de item de trabalho usados para preencher um quadro. Por exemplo, a placa de lista de pendências do produto está associada à categoria Requisitos. Para obter mais informações, consulte Personalizar suas listas de pendências ou quadros (processo de herança).
Nome da placa
BoardName		 String O nome atribuído ao quadro. Por exemplo, Histórias, Itens da lista de pendências, Recursos e Épicos.
Nível do Conselho de Administração
BoardLevel		 Int32 O número atribuído ao conselho com base no seu lugar na hierarquia dos conselhos.
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 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 das colunas
ColumnOrder		 Int32 O número atribuído à coluna do quadro em termos da sua sequência dentro do quadro.
Concluído
Done		 Enumerated Indica o local da coluna dividida. Os valores válidos estão listados abaixo para BoardColumnSplit.
Limite de itens de coluna
ColumnItemLimit		 Int32 O número atribuído à coluna do quadro em termos da sua sequência.
A placa é visível
IsBoardVisible		 Boolean Indica se a equipe optou por tornar um quadro visível ou não.
A coluna está dividida
IsColumnSplit		 Boolean Indica se uma coluna foi dividida em colunas Concluído e Concluído, conforme descrito em Dividir colunas no quadro para mostrar o trabalho em andamento.
É atual
IsCurrent		 Boolean Propriedade que suporta a filtragem dos dados para exibir o instantâneo mais recente do conjunto filtrado de itens de trabalho definindo o valor como True.
É a pista padrão
IsDefaultLane		 Boolean Propriedade que indica que o item de trabalho está atribuído à raia padrão (True) ou não (False).
Está Feito
IsDone		 Boolean A atribuição atual do item de trabalho a Fazer (Falso) ou Concluído (Verdadeiro) dentro de uma coluna. Apenas atribuído quando a divisão de colunas está ativada para uma coluna do quadro.
System.BoardColumnDone
Identificação da faixa de rodagem
LaneId		 GUID O GUID exclusivo atribuído a uma raia de natação de prancha. Cada equipa pode adicionar uma ou mais raias a um tabuleiro. Para obter mais informações sobre raias, consulte Acelerar o trabalho da sua equipe usando raias na prancha.
Nome da pista
LaneName		 String O nome atribuído à raia da prancha.
System.BoardLane
Ordem da faixa de rodagem
LaneOrder		 Int32 O número atribuído à raia da prancha em termos de sequência.

Membros enumerados BoardColumnSplit

A tabela a seguir lista os nomes dos membros para o BoardColumnSplit tipo enumerado, que podem ser usados para filtrar itens de trabalho na coluna Quadro Concluído ou Concluído.

Nome do membro valor Display name
Doing 0 Fazer
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 Áreas , que está associado ao campo Caminho da Área . As chaves substitutas 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 a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google 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 a partir do nível raiz.
Área Id AreaId GUID Identificador exclusivo atribuído a um Caminho de Área quando ele é criado.
Área Nível 1 a
Nível de Área 14		 AreaLevel1 através de
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 da área AreaName String Nome definido para o Caminho da Área quando ele é criado.
Caminho da Á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 causa perda de dados irreversível. Por exemplo, gráficos de widgets de burndown e burnup, burndown de sprint e gráficos de velocidade para equipes com caminhos de área alterados não exibirão dados precisos. Os gráficos de tendência históricos fazem referência ao Caminho de Área e ao Caminho de Iteração conforme foram definidos no momento para cada item de trabalho. Uma vez excluído, você não pode recuperar dados históricos para esses caminhos.
  • Você só pode excluir caminhos de área e iteração que não são mais usados por nenhum item de trabalho.

As propriedades de navegação para o tipo de entidade Area e o conjunto de entidades Areas incluem Project e Teams.

Para obter mais informações 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 de Iteração . As chaves substitutas 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 a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
Number Int32 Um valor inteiro atribuído a um nó Caminho 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 a partir do nível raiz.
Data de Fim EndDate DateTime Data de término definida para o caminho de iteração.
IsEnded IsEnded Boolean 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 até
Iteração Nível 14		 IterationLevel1 através de
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 do projeto.
System.IterationPath
Data de Início StartDate DateTime Data de início definida para o caminho de iteração.

Importante

  • Excluir caminhos de área ou reconfigurar caminhos de iteração causa perda de dados irreversível. Por exemplo, gráficos de widgets de burndown e burnup, burndown de sprint e gráficos de velocidade para equipes com caminhos de área alterados não exibirão dados precisos. Os gráficos de tendência históricos fazem referência ao Caminho de Área e ao Caminho de Iteração conforme foram definidos no momento para cada item de trabalho. Uma vez excluído, você não pode recuperar dados históricos para esses caminhos.
  • Você só pode excluir caminhos de área e iteração que não são mais usados por nenhum item de trabalho.

As propriedades de navegação para o tipo de entidade Iteration e o conjunto de entidades Iterations 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 Processes. As chaves substitutas associadas ao Processo incluem ProcessSK, ProjectSKe TeamSK. Você pode usar essas propriedades para filtrar ou relatar dados de controle de trabalho com base nos tipos de item de trabalho usados por um projeto ou equipe.

Nota

O tipo de entidade Process e o conjunto de entidades Processes são suportados com as versões v-2.0, v3.0-preview e v4.0-preview do Analytics.

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

Nome a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
ProjectSK GUID Chave do projeto associada ao processo.
TeamSK GUID Chave de equipa associada ao processo.
Nome de referência da categoria da 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. Exemplos incluem Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Nome da lista de pendências BacklogName Boolean 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 Backlog HasBacklog String Indica se o tipo de item de trabalho pertence a uma lista de pendências.
É tipo oculto IsHiddenType Boolean Indica se o tipo de item de trabalho foi desativado.
É tipo de bug IsBugType Boolean Indica se o tipo de item de trabalho pertence à categoria Bug.
É suprimido IsDeleted Boolean Indica se o tipo de item de trabalho foi excluído.

Para obter mais informações sobre listas de pendências de processo e tipos de item de trabalho, consulte 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 do Google Analytics.

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

Etiquetas

As propriedades a seguir são válidas para o conjunto de entidades Tags . As chaves substitutas associadas à Tag incluem TagSK e ProjectSK. As propriedades de navegação incluem Project e sua restrição ProjectSKreferencial. Para obter mais informações sobre como usar tags, consulte Adicionar tags 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 a apresentar Nome Tipo de dados Descrição
Tag Id TagId GUID O ID exclusivo atribuído à tag quando ela é criada.
Nome da tag TagName String O nome da tag.

Teams

As propriedades a seguir são válidas para o tipo de entidade Team e o conjunto de entidades Teams. As chaves substitutas associadas ao Team 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 ágeis e Criar ou adicionar uma equipe.

Nome a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
ID da Equipa TeamId GUID O ID exclusivo atribuído à equipe quando ela é criada.
Nome da Equipa TeamName String O nome da equipa.

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 substituta de referência da propriedade é WorkItemLinkSK. Query WorkItemLinks para relatar sobre pai/filho, relacionado, antecessor/sucessor ou outros tipos de link.

Nome a apresentar Nome Tipo de dados Descrição
AnalyticsUpdatedDate DateTime Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
WorkItemLinkSK Int32 A chave substituta atribuída à WorkItemLink entidade.
Data de 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 eliminação DeletedDate String Data em que o link foi excluído.
ID do tipo de link LinkTypeId Int32 O ID atribuído ao item de trabalho de destino ao qual está 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 Boolean O valor do atributo de tipo de link que indica o tipo de link permite relações circulares quando o valor é definido como True. Por exemplo, links de tipo de árvore restringem relações circulares.
O tipo de link é direcional LinkTypeIsDirectional Boolean O valor do atributo de tipo de link que indica o tipo de link é direcional. Os tipos de link direcional são definidos em pares com um componente para frente e para trás.
ID do item de trabalho de origem SourceWorkItemId Int32 O ID atribuído ao item de trabalho de origem vinculado.
ID do item de trabalho de destino TargetWorkItemId Int32 O ID atribuído ao item de trabalho de destino ao qual está vinculado.

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

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

WorkItemTypeFields

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

Nome a apresentar Nome Tipo de dados Descrição
Nome do campo FieldName String Nome amigável atribuído a um campo pelo sistema ou quando ele é criado.
Nome de referência do 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

Os campos personalizados são adicionados automaticamente ao serviço Analytics como uma propriedade personalizada. Custom_ ou Custom. é precedido do nome do imóvel. Verifique os metadados da sua coleção conforme descrito em Construct OData queries for Analytics, componentes de URL para consultar os metadados. O exemplo a seguir fornece a sintaxe de metadados para o campo personalizado, Risk Opportunity.

<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>