Partilhar via

Referência de metadados para o Azure Boards Analytics

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

O serviço Analytics recolhe todas as atividades de controlo de trabalho, definição e atualização dos Painéis do Azure. Você pode executar consultas do Google Analytics diretamente em seu 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 do Google Analytics de acompanhamento de trabalho. O Google Analytics armazena todos os campos de acompanhamento de trabalho como propriedades, exceto os campos HTML/rich-text e histórico. Os campos personalizados são adicionados automaticamente ao Google Analytics como propriedades personalizadas.

Nota

Este artigo fornece descrições de entidades, propriedades e tipos enumerados suportados pelo modelo de dados do Google Analytics. 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, consulte o conjunto de entidades WorkItems para gerar relatórios de status e rollup. Use o conjunto de entidades WorkItemSnapshot para gerar relatórios de tendência, burndown e gravação.

Use outros tipos de entidade, como Área, Iteração, Projeto ou Equipe para filtrar dados ou selecionar propriedades para relatório. Para 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 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 o 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 de item de trabalho, com propriedades para agrupamento e filtragem por hierarquia de iteração.
BoardLocations BoardLocation Localizações das células do tabuleiro, identificadas por coluna do tabuleiro, raia e divisão, incluindo 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 ou coleção de projetos.
Etiquetas Etiqueta 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.
Users Utilizador Informações do usuário usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo, Atribuído a ou Criado por.
CapturaDeQuadroDeItensDeTrabalho CapturaDeQuadroDeItensDeTrabalho Tipo de entidade composta que descreve 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 Links entre itens de trabalho, por exemplo, Filho, Pai e Relacionado. Inclui apenas a última revisão de links, sem histórico, e não inclui hiperlinks.
Revisões de Itens de Trabalho 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 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.
Itens de Trabalho Item de trabalho 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 Propriedades de item de trabalho para cada tipo de item de trabalho e processo. Usado para dar suporte à construção de relatórios.

Instantâneos

Os conjuntos de entidades de instantâneo de controle de trabalho são WorkItemSnapshot e WorkItemBoardSnapshot. Um instantâneo grava no Google Analytics no mesmo horário 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ências.

Por padrão, todas as tabelas de instantâneo são modeladas como tabelas de fatos de instantâneo diário. Uma consulta para um intervalo de tempo obtém um valor para cada dia, e 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 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

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

Use a última propriedade de chave substituta de 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 pretender todas as datas desde o {startDate}, inclusive, adicione o seguinte filtro à sua consulta: RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Use o conjunto de entidades WorkItemRevisions 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, não incluindo itens de trabalho excluídos.

Propriedades compartilhadas entre 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 às propriedades selecionadas do Google Analytics, 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:

  • Item de trabalho
  • WorkItemRevision
  • WorkItemSnapshot
  • CapturaDeQuadroDeItensDeTrabalho

Nota

A tabela a seguir lista e descreve a maioria das propriedades que você pode selecionar em uma visualização do Google Analytics, incluindo campos de acompanhamento de trabalho regulares e outras propriedades do Google Analytics.

Nome a apresentar 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 de aceitação AcceptedDate Data e Hora 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 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 Corda Tipo de atividade ou disciplina atribuída para executar uma tarefa. Os valores permitidos são: Implantação, Design, Desenvolvimento, Documentação, Requisitos e Testes. (Processos Agile, Scrum e Básico) Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate Desvio de Data e Hora Dados e hora em que a entidade foi atualizada pela última vez.
Tipo de Aplicação Corda Tipo de aplicação sobre a qual as partes interessadas fornecem 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 Corda Recurso do produto ou grupo de itens de trabalho da área da equipe. 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 automatizado AutomatedTestId Corda ID do teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestId
Nome do teste automatizado AutomatedTestName Corda Nome do membro da equipe que ativou ou reativou o item de trabalho. Microsoft.VSTS.TCM.AutomatedTestName
Armazenamento de teste automatizado AutomatedTestStorage Corda Assembly que contém o teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestStorage
Tipo de teste automatizado AutomatedTestType Corda Tipo de teste que automatiza o caso de teste. Microsoft.VSTS.TCM.AutomatedTestType
Status de automação AutomatedStatus Corda 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, classificar ou rastrear a sequência de itens em uma lista de pendências ou quadro. (Processo Scrum) Microsoft.VSTS.Common.BacklogPriority
Bloqueado Blocked Corda 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 de Negócio BusinessValue Duplo 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. Considera-se que o item atribuído a números mais altos tem mais valor comercial do que os itens atribuídos a números inferiores. Microsoft.VSTS.Common.BusinessValue
Alterado por ChangedBy, ChangedByUserSK UserSK Nome da pessoa que modificou o item de trabalho mais recentemente. System.ChangedBy
Data alterada 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. 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 Nome da pessoa que fechou um item de trabalho. Microsoft.VSTS.Common.ClosedBy
Data de encerramento 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
Empenhado Committed Corda Indicar 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 Google Analytics que armazena quando o item de trabalho entrou em um estado de fluxo de trabalho associado à categoria Estado 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 de fluxo de trabalho associado à categoria Estado 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 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 de 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. Comumente 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. 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 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 Corda 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 Data e Hora Data de vencimento prevista para um problema ou item de trabalho a ser resolvido. (Processo ágil) Microsoft.VSTS.Scheduling.DueDate
Esforço Effort Duplo Quantidade estimada de trabalho que um item de lista de pendências 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 cronograma indica que um item de trabalho deve ser concluído. Microsoft.VSTS.Scheduling.FinishDate
Encontrado em FoundIn Corda Número de compilação do produto, também conhecido como revisão, no qual foi encontrado um bug. Microsoft.VSTS.Build.FoundIn
Data InProgress InProgressDate Data e Hora 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 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 Corda Número de compilação 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 Corda 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 Prazo de Entrega LeadTimeDays Duplo Tempo de entrega calculado a partir da criação do item de trabalho ou da entrada de uma categoria de estado Proposto para entrar em 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ário 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 pai. Útil para gerar relatórios de rollup. 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 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 Propriedades do projeto. System.TeamProject
ProjectSK GUID GUID atribuído ao projeto ao qual o item de trabalho pertence.
Avaliação Reason Corda Número de estrelas que um item recebe de um revisor em um sistema de classificação baseado em estrelas (Feedback Response). O número é armazenado no sistema e escrito como 0 - Não classificado, 1 - Ruim, 2 - Regular, 3 - Bom, 4 - Muito Bom, ou 5 - Excelente. Válido para os tipos de entidade WorkItemRevision e WorkItem . Microsoft.VSTS.Common.Rating
Razão Reason Corda Razão pela 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 falta 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 resolvido. 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. 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 Corda 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 revisão 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. 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 Avaliação subjetiva da 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 Avaliaçã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 de pilha StackRank Duplo 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 Data e Hora Data e hora atribuídas a um item de trabalho para que o trabalho seja iniciado. Microsoft.VSTS.Scheduling.StartDate
Distrito State Corda 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 Corda Como os Painéis do Azure e widgets de painel selecionados tratam cada estado do fluxo de trabalho. As categorias de estado 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 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. 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 um estado de 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 Estimativa da quantidade de trabalho que uma história de usuário requer para implementar, geralmente agregada como uma soma. (Processo ágil) Microsoft.VSTS.Scheduling.StoryPoints
Etiquetas TagNames Corda 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 Data e Hora Data de vencimento prevista para um problema ou outro item de trabalho a ser resolvido ou concluído. Microsoft.VSTS.Scheduling.TargetDate
Tipo de suíte de teste Corda 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 Número atribuído pelo sistema correspondente à categoria do conjunto de testes. Aplicável apenas a 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 Unidade de medida subjetiva que captura como o valor do negócio diminui ao longo do tempo. Valores mais altos indicam que um épico ou recurso é inerentemente mais crítico em termos de tempo do que itens com valores mais baixos. Microsoft.VSTS.Common.TimeCriticality
Título Title Corda Breve descrição 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 Corda Área de valor para o cliente abordada pelo item épico, recurso ou lista de pendências. Os valores incluem Arquitetura ou Negócios. Microsoft.VSTS.Common.ValueArea
Marca d'água Watermark Corda Campo gerenciado pelo sistema que é incrementado com as 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. Um ID de item de trabalho é exclusivo em todos os projetos dentro de uma organização ou coleção de projetos. System.Id
WorkItemRevisionSK Int32 Chave exclusiva do Analytics para a revisão do item de trabalho, usada por ferramentas externas para unir entidades relacionadas.
Tipo de item de trabalho WorkItemType Corda 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 são válidas.

Nome a apresentar 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
Equipas Area, BoardLocation, Iteração, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Etiquetas WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projeto Project ProjectSK ProjectSK Etiqueta, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField
Processos WorkItemRevision, WorkItem, WorkItemSnapshot
Revisões Item de trabalho
Ligações Item de trabalho
Crianças Item de trabalho
Elemento Principal Item de trabalho
Descendentes Item de trabalho
Item de trabalho* WorkItemId WorkItemRevision

*A entidade WorkItem também suporta as PredictTags funções e Predict , que suportam tendências preditivas em widgets e relatórios do Analytics incorporados 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 indicado. Você pode usar esses campos para 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. Para obter um exemplo que consulta o conjunto de entidades WorkItemBoardSnapshot, consulte Relatório de exemplo de CFD (Cumulative Flow Diagram).

Nome a apresentar Nome da propriedade Tipo de dados Descrição
Identificação da placa BoardId GUID 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 Corda Nome atribuído à categoria de tipo de item de trabalho usada 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 Corda Nome atribuído ao quadro, por exemplo, Histórias, Itens da lista de pendências, Recursos ou Épicos.
Nível do Conselho de Administração BoardLevel Int32 Número atribuído ao conselho de administração com base no seu lugar na hierarquia dos conselhos de administração.
Tipo de lista de pendências BacklogType Corda Nome do tipo de lista de pendências, por exemplo, Iteração, Requisito ou Portfólio.
Nome da coluna ColumnName Corda Nome da coluna do quadro à qual um item de trabalho está atribuído no momento, como Ativo, Fechado, Confirmado, Concluído ou um rótulo de coluna personalizado. Nome de referência: System.BoardColumn
Ordem das colunas ColumnOrder Int32 Número atribuído à coluna do quadro em termos da sua sequência dentro do quadro.
Concluído Done Enumerado Indicador da localização da coluna dividida.*
Limite de itens de coluna ColumnItemLimit Int32 Número atribuído à coluna do quadro em termos da sua sequência.
A placa é visível IsBoardVisible booleano Indicação de se a equipa optou por tornar visível um quadro.
A coluna está dividida IsColumnSplit booleano Indicação de se uma coluna está dividida em colunas Concluído e Concluído , conforme descrito em Dividir colunas no quadro para mostrar o trabalho em andamento.
É atual IsCurrent booleano Propriedade que suporta a filtragem de dados para exibir o instantâneo mais recente dos itens de trabalho filtrados quando definido como True.
É a pista padrão IsDefaultLane booleano Indicação de que o item de trabalho é atribuído à raia padrão quando definido como True.
Está Feito IsDone booleano Atribuição atual do item de trabalho dentro de uma coluna para Fazer se False ou Concluído quando True. Válido apenas quando a divisão de colunas está habilitada para uma coluna de quadro. Nome de referência: System.BoardColumnDone
Identificação da faixa de rodagem LaneId GUID GUID exclusivo atribuído a uma raia de prancha. Cada equipa pode adicionar uma ou mais raias a uma prancha. Para obter mais informações sobre raias, consulte Acelerar o trabalho da sua equipe usando raias na prancha.
Nome da pista LaneName Corda Nome atribuído à raia da prancha. Nome de referência: System.BoardLane
Ordem da faixa de rodagem LaneOrder Int32 Número atribuído à raia da prancha em termos de sequência.

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

Nome do membro valor Nome a apresentar
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 Data e Hora Marca d'água que indica a última vez que os dados do Google 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 na sua profundidade a partir do nível da raiz.
Área Id AreaId GUID Identificador exclusivo atribuído a um caminho de área na criação.
Nível de Área 1 a Nível de Área 14 AreaLevel1 através de AreaLevel14 Corda Nível de nó de um caminho de área até 14 níveis aninhados. O Nível de Área 1 sempre corresponde ao nó raiz e ao nome do projeto.
Nome da área AreaName Corda Nome definido para o caminho da área na criação.
Caminho da Área AreaPath Corda Caminho completo do caminho da área começando com o nó raiz.

Importante

A exclusão de valores de Caminho de Área ou a reconfiguração de valores de Caminho de Iteração causa perda irreversível de dados nos seguintes gráficos:

  • Burndown e burn up gráficos de widgets
  • Gráficos de Burndown do Sprint
  • Gráficos de velocidade para equipas com percursos de área alterados
  • Gráficos de tendência históricos que fazem referência aos valores de Caminho de Área e Caminho de Iteração , conforme definido no momento para cada item de trabalho

Você pode excluir caminhos de área e iteração somente quando eles não forem mais usados por nenhum item de trabalho. Ao excluir esses caminhos, não é mais possível recuperar seus dados históricos.

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 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 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 Data e Hora Marca d'água que indica a última vez que os dados do Google 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 a partir do nível raiz.
Data de Fim EndDate Data e Hora Data de término definida para o caminho de iteração.
EstáTerminado 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 através de IterationLevel14 Corda Nível de nó de um caminho de iteração 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 Corda Nome definido para um caminho de iteração na criação.
Caminho de iteração IterationPath Corda Caminho de iteração completo começando com o nó raiz. A iteração deve ser um nó válido na hierarquia do projeto. Nome de referência: System.IterationPath
Data de Início StartDate Data e Hora Data de início definida para o caminho de iteração.

Importante

A exclusão de valores de Caminho de Área ou a reconfiguração de valores de Caminho de Iteração causa perda irreversível de dados nos seguintes gráficos:

  • Burndown e burn up gráficos de widgets
  • Gráficos de Burndown do Sprint
  • Gráficos de velocidade para equipas com percursos de área alterados
  • Gráficos de tendência históricos que fazem referência aos valores de Caminho de Área e Caminho de Iteração , conforme definido no momento para cada item de trabalho

Você pode excluir caminhos de área e iteração somente quando eles não forem mais usados por nenhum item de trabalho. Ao excluir esses caminhos, não é mais possível recuperar seus dados históricos.

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. Use essas propriedades para filtrar ou relatar dados de controle de trabalho em tipos de item de trabalho para um projeto ou equipe.

Nota

As versões v-2.0, v3.0-preview e v4.0-preview do Analytics suportam o tipo de entidade Process e o conjunto de entidades Processes .

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 Data e Hora 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 Corda 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 uma lista de pendências na criação.
Nível de lista de pendências BacklogLevel Corda Nível de lista de pendências associado ao tipo de item de trabalho. O null valor retornará 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 Corda Nome definido para um tipo de item de trabalho.
Tem Backlog HasBacklog Corda 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á desativado.
É tipo de bug IsBugType booleano Indicação se o tipo de item de trabalho pertence à categoria Bug .
É suprimido IsDeleted booleano Indicação 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:

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
ID da etiqueta TagId GUID ID exclusivo atribuído à tag na criação.
Nome da tag TagName Corda Nome da tag.

Equipas

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 Data e Hora Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
ID da Equipa TeamId GUID ID exclusivo atribuído à equipe na criação.
Nome da Equipa TeamName Corda Nome da equipa.

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 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 Data e Hora Marca d'água que indica a última vez que os dados do Google Analytics foram atualizados.
WorkItemLinkSK Int32 Chave substituta atribuída à entidade WorkItemLink .
Data de criação CreatedDate GUID Data em que o link foi criado.
Comentário Comment Corda Comentário adicionado quando o link foi criado.
Data de eliminação DeletedDate Corda Data em que o link foi excluído.
ID do tipo de link LinkTypeId Int32 ID atribuído ao item de trabalho vinculado de destino.
Nome do tipo de link LinkTypeName Corda Nome amigável atribuído ao tipo de link.
Nome de referência do tipo de link LinkTypeReferenceName Corda 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, 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 para frente e para trás.
ID do item de trabalho de origem SourceWorkItemId Int32 ID atribuído ao item de trabalho de origem do link.
ID do item de trabalho de destino TargetWorkItemId Int32 ID atribuído 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:

CamposDoTipoDeItemDeTrabalho

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 Corda Nome amigável atribuído a um campo pelo sistema ou na criação.
Nome de referência do campo FieldReferenceName Corda Nome de referência atribuído a um campo pelo sistema ou na criação de um campo personalizado.
Tipo de campo FieldType Corda Tipo de dados atribuído a um campo.
Tipo de item de trabalho WorkItemType Corda Tipo de item de trabalho para o qual um campo está 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 mais informações, consulte os seguintes artigos:

Propriedades personalizadas

Os campos personalizados são adicionados automaticamente ao serviço Analytics como propriedades personalizadas. Custom_ ou Custom. é precedido do nome do imóvel. Verifique os metadados da sua coleção conforme descrito em Consultar os metadados. O exemplo a seguir mostra 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>

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

Os dados para tipos de item de trabalho personalizados são adicionados automaticamente ao serviço 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, com Custom_ ou Custom. anexado ao GUID da 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 de Portfólios.

Conteúdo relacionado

  • Last updated on