Adicionar e modificar os campos de Item de trabalho para a emissão de relatórios de suporte

Artigo
08/01/2011

Você pode usar campos de item de trabalho para controlar os dados para um tipo de item de trabalho, para definir os critérios de filtro para consultas e usar em relatórios. Qualquer campo, exceto os campos de sistema, que você deseja que apareça em um relatório deve ser definido no arquivo de definição para os tipos de itens de trabalho que controlará o campo. Os campos de sistema são automaticamente definidos para cada tipo de item de trabalho. No entanto, eles devem ser incluídos no formulário de item de trabalho para oferecer suporte a entrada de dados.

Para oferecer suporte a relatórios, você pode adicionar campos ou alterar os atributos de campos existentes. Quando você adicionar ou modificar os campos, você deve aplicar as convenções de nomeação sistemáticos para certificar-se de que os dados é logicamente agrupados em pastas no SQL Server cubo do Analysis Services.

Neste tópico

Práticas recomendadas
Usar um campo existente
Lista de campos que são definidos para uma coleção de projeto de equipe
Atributos de campo Reportable
Alterar um atributo reportável para um campo
Adicionar campos ao relatório de suporte
Verifique se as alterações feitas aos atributos de campo Reportable
Práticas recomendadas ao atribuir nomes de referência de emissão de relatórios
Reportável campos que são definidos em modelos de processo do MSF

Práticas recomendadas

Antes de adicionar ou modificar um campo, revise as seguintes práticas recomendadas:

Determine se você pode usar um campo que já está definido na coleção de projeto de equipe que contém o seu projeto de equipe. O uso de um campo existente oferece suporte a relatórios de projetos cruzados.
Determinar se você pode usar um campo que já está definido na coleção de outro projeto na implantação de Visual Studio Team Foundation Server. O uso de um campo existente oferece suporte a relatórios de projetos cruzados.
Você pode ter no máximo 1.024 campos em cada coleção de projeto e não mais do que 1.024 campos de reportável exclusivos em todas as coleções de projeto durante uma implantação do Team Foundation Server. Mesclado a contagem de campos como um campo reportable.
Instituir um procedimento padrão e examine o processo para adicionar e modificar os campos em modelos de processo, projetos de equipe ou coleções de projeto.

Use as convenções de nomenclatura sistemáticos ao rótulo de campos para a emissão de relatórios. Quando você atribuir nomes de referência de maneira sistemática entre todas as coleções de projeto de equipe em uma implantação do Team Foundation Server, você garante um depósito mais consistente e utilizável e o esquema do cubo, e evitar conflitos de esquema no depósito. Para obter mais informações, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse.

Você pode atribuir a até quatro atributos de rótulo para um campo de item de trabalho:

Observação
Campos definidos nos modelos de processo de Microsoft Solutions Framework não são atribuídos a um nome de relatório ou um nome de referência de relatório. Por padrão, os atributos de nome e o nome de referência são usados.

name. O nome amigável do campo que aparece nos menus drop-down de consultas de itens de trabalho. O nome amigável deve ser exclusivo em todos os campos são definidos em um projeto de equipe. Além disso, o nome amigável pode ser diferente da etiqueta do exibida é atribuída ao campo no formulário de item de trabalho. Para obter mais informações, consulte Referência de elemento do controle XML.
refname. O rótulo exclusivo que é atribuído ao campo que distingue ele do que todos os outros campos são definidos na coleção de projeto de equipe. O valor é atribuído para o refname não pode ser alterado.

Para requisitos e restrições de nomes amigáveis e nomes de referência para campos, consulte Convenções de nomenclatura para objetos de rastreamento de Item de trabalho.
reportingname. Atributo opcional. O nome é usado para identificar um campo nos relatórios. Quando não explicitamente definido, o valor é atribuído para o name atributo é usado.
reportingrefname. Atributo opcional. O rótulo exclusivo que é atribuído a um campo reportable que distinga de todos os outros campos reportável são definidos em todas as coleções de projeto de equipe. Quando não explicitamente definido, o valor é atribuído para o refname atributo é usado. Para as convenções de nomenclatura recomendadas, consulte de práticas recomendadas ao atribuir nomes de referência de emissão de relatórios posteriormente neste tópico.

Observação

Os nomes de referência de relatório são visíveis somente a partir de um relatório de tabela dinâmica ou cubo do Analysis Services.

Observação
Os nomes de referência de relatório são visíveis somente a partir de um relatório de tabela dinâmica ou cubo do Analysis Services.

Usar um campo existente

Você deve usar um campo que já está definido, se esse campo coincide com as informações que você deseja controlar e reportar. Para usar um campo existente, execute as seguintes etapas:

Identifica o campo que você deseja usar. Use o witadmin listfields para identificar os campos e seus atributos que são definidos para todos os conjuntos de projeto. Para obter mais informações, consulte Lista de campos que são definidos para uma coleção de projeto de equipe posteriormente neste tópico.
Determine se o campo é reportable e se os atributos reportável atender às suas necessidades de geração de relatórios.
Se não for reportable, use o witadmin changefield para alterar o atributo reportable para as coleções de projeto no qual ele é usado. Para obter mais informações, consulte alterar um atributo reportável para um campo posteriormente neste tópico.
Para a coleção de projeto onde o campo não está definido, adicione-o para os arquivos de definição de XML para os tipos de item de trabalho que você deseja usar para rastrear dados. Para obter mais informações, consulte Adicionar campos ao relatório de suporte posteriormente neste tópico.

Lista de campos que são definidos para uma coleção de projeto de equipe

Você pode usar o witadmin listfields comando para os campos de lista e seus atributos. Você pode listar todos os campos são definidos em uma coleção de projeto ou um campo especificado. O witadmin listfields comando tem a seguinte sintaxe:

witadmin listfields /collection:CollectionURL /n:RefName

Para obter mais informações, consulte Campos de Item de trabalho e atribuídos a campos de atributos de exibição de lista.

Atributos de campo Reportable

Campos Reportável têm um reportable o valor do atributo de Detail, Dimension, ou Measure. Os seguintes atributos determinam como os campos de item de trabalho são exportados e processados nos bancos de dados do depósito de dados:

reportingtype. Para incluir um campo nos relatórios, você deve atribuir um dos seguintes valores para o reportable atributo:
- Atribuir Detail para exportar o campo no banco de dados relacional warehouse, mas não para o cubo. Como mostra o exemplo a seguir, use o Detail tipo somente para campos de número inteiro, duplo, seqüência ou DateTime:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Atribuir Dimension para exportar o campo para o banco de dados relacional warehouse e o cubo. Como mostra o exemplo a seguir, use Dimension somente para campos de número inteiro, duplo, seqüência ou DateTime. Esse valor é útil incluir campos que são usados para filtrar relatórios (por exemplo, campos que contêm listas de valores válidos).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Atribuir Measure para suportar o processamento de valores pré-calculados no cubo. Use o Measure tipo somente para o inteiro e campos Double.
  
  Quando você atribuir a medida como o reportingtype, você deve atribuir sum como o formula, como mostra o exemplo a seguir:
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname. Você pode atribuir um nome de referência diferente a um campo que está marcado como reportable. Se nenhum valor for especificado, o valor é atribuído para o refname atributo é usado.

Você pode usar esse atributo para mesclar ou divergem de campos que são incluídos nos relatórios. Para mesclar os dois campos que têm os nomes distintos de referência e que são definidos nas coleções de outro projeto, atribuir o mesmo reportingrefname a ambos. Para uma diferenciação dois campos que têm o mesmo nome de referência, mas que são definidos nas coleções de outro projeto, atribuir uma outra reportingrefname para cada campo.

Você deve mesclar campos sempre que possível para minimizar o número de campos no depósito e manter sob o limite máximo de campos Reportável de 1024. Você pode gerar relatórios de entre grupos com campos mesclados.

reportingname. Você pode atribuir um rótulo diferente a um campo que é usado para exibir dados em relatórios. Se nenhum valor for especificado, amigável para o nome que é atribuído para o name atributo é usado. O valor é atribuído para o reportingname é exibido no cubo. O valor é atribuído para o reportingrefname não aparecer.

Importante
Você deve usar as práticas recomendadas para o rótulo de campos de emissão de relatórios para que eles são agrupados em relatórios de tabela dinâmica. Para obter mais informações, consulte de práticas recomendadas ao atribuir nomes de referência de emissão de relatórios.

Alterar um atributo reportável para um campo de Item de trabalho

Você pode fazer um campo existente reportável alterando as atribuições de atributo do campo são definidas para uma coleção de projeto. Um campo existente é definido em um ou mais definições de tipo de item de trabalho. Além disso, você pode alterar todos os atributos que determinam como um campo é processado em depósitos de dados.

Você pode usar a seguinte seqüência de etapas para alterar a atribuição do atributo de um campo:

Você pode usar o witadmin changefield comando para alterar uma atribuição de atributo para um campo. Exercício este comando para uma coleção de projeto de equipe. Use a seguinte sintaxe:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Para fazer um campo existente reportável, altere o reportingtype. Por exemplo, para tornar o AW.Campo de Common.TeamPriority disponível para filtragem de relatórios, atribua o valor de dimensão a ela:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].
(Opcional) Se você tiver mais de uma coleção de projeto, convém fazer alterações de semelhantes para o campo de item de trabalho é definido na coleção. Para evitar conflitos de esquema quando você exporta e bancos de dados de depósito de dados de processo para os dados, você deve atribuir os mesmos valores para esses atributos em todas as coleções:
- Tipo de campo (o valor para este campo não pode ser alterado para um campo existente).
- Tipo de relatório.
- Nome do relatório.
Para obter mais informações, consulte Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse.
Após ter feito todas as alterações para os campos de item de trabalho que você deseja usar para a emissão de relatórios, você deve processar os bancos de dados do depósito de dados. Você pode usar o ProcessWarehouse e ProcessAnalysis serviços da Web, que estão disponíveis através do WarehouseControlWebService.

Esta etapa garante que as pessoas que usam os relatórios não ver um erro quando você altera os atributos de campo. Para obter mais informações, consulte Processar manualmente o cubo do Analysis Services e Data Warehouse de Team Foundation Server.

Para obter mais informações, consulte Gerenciando os campos de Item de trabalho [witadmin].

Adicionar campos ao relatório de suporte

Você pode adicionar campos à definição de um tipo de item de trabalho ou de tipos. Quando você adiciona o campo, você deve adicionar a mesma definição de elemento de campo para todos os tipos de itens de trabalho para o qual o campo oferecerá suporte a emissão de relatórios. Se desejar que o campo para oferecer suporte a relatórios de projetos cruzados, o campo deve ser adicionado a todos os tipos de item de trabalho em todos os projetos de equipe serão relatados no.

Para obter mais informações, consulte os seguintes tópicos:

Verifique se as alterações feitas aos atributos de campo Reportable

Você pode verificar as alterações que fez a atributos de campo reportable os depósitos de dados sob demanda de processamento e, em seguida, verificando os relatórios para verificar que elas são atualizadas. Ou você pode esperar até que os trabalhos de adaptador de depósito é executado. Por padrão, o banco de dados relacional é processado minutos. No entanto, o cubo é processado a cada duas horas por padrão.

Observação
Para obter mais informações sobre o WarehouseControlWebService, consulte Processar manualmente o cubo do Analysis Services e Data Warehouse de Team Foundation Server.

Processar o data warehouse relacional sob demanda usando o ProcessWarehouse WarehouseControlWebService.
Processar o cubo sob demanda usando o ProcessAnalysisDatabase WarehouseControlWebService.
Verifique se que os relatórios sejam atualizados. Exiba um relatório através do painel de controle ou o Report Manager. Para obter mais informações, consulte Painéis (Agile) ou Relatório (Agile).

Práticas recomendadas ao atribuir nomes de referência de emissão de relatórios

Para relatar os nomes de referência, que você deseja atribuir rótulos para que você encontre facilmente os campos no relatório de tabela dinâmica e o cubo. Você pode obter isso aplicando as convenções de nomenclatura sistemáticos para que os campos são agrupados em uma seqüência lógica. Além disso, se os campos não estiverem agrupados de maneira útil, você pode alterar o nome de referência de relatório de um campo.

Aplicar uma convenção de nomenclatura sistemática se torna cada vez mais importante, porque todos os dados reportável de todos os projetos de equipe são definidos em todas as coleções de projeto são gravados em um único data warehouse relacional. Dados de depósito é, em seguida, processados e gravados o cubo. Como campos de item de trabalho são gerenciados distintamente para cada conjunto de projetos, etiquetas diferentes podem ser aplicadas e podem levar a um conjunto de campos que não está bem organizado para oferecer suporte à criação de relatórios.

Campos de item de trabalho que têm um tipo reportável da dimensão correspondem a atributos de dimensão no cubo. Atributos de dimensão são organizados em pastas que são baseadas no nome de referência do relatório que é atribuído no modelo de processo ou definição de tipo de item de trabalho. Os seguintes tipos de mapeamento ocorrer:

Campos que têm "Sistema" prefixo são intrínseco e listados diretamente sob a dimensão de Item de trabalho, com um "Item de trabalho" anexado.
Outros campos são colocados em pastas cujos nomes correspondem aos prefixos em seus nomes de referência. Por exemplo, os campos que têm "Microsoft.VSTS.Common" prefixo são listadas sob a pasta ou seja rotulado "Microsoft VSTS comum."

Como mostra a ilustração a seguir, uma pasta é adicionada para cada grupo de prefixo de campos que compartilham o prefixo comum:

Pasta<>>estrutura no cubo de dados OLAP

A tabela a seguir lista os campos cujos nomes de referência começam com "Sistema" e que estão listados no relatório de tabela dinâmica com o prefixo "Item de trabalho". Esses campos são colocados diretamente sob a dimensão de Item de trabalho. Todos os outros campos são colocados em pastas cujos nomes correspondem aos prefixos em seus nomes de referência.

Observação
Implantações que não usam a versão Enterprise do SQL Server Analysis Services não tem acesso aos recursos de tradução que são fornecidos por versão. Nessas implantações, os campos são identificados por seus nomes de referência completa no cubo, com '.' substituído por '_' (por exemplo, "System_Id" e "system_title").

Nome no relatório de tabela dinâmica e de cubo	Nome de referência	Tipo de dados
Caminho de Item.Area de trabalho	System.AreaPath	TreeType
Item.Assigned de trabalho para	System.AssignedTo	String
Item.Changed de trabalho por	System.ChangedBy	String
Data de Item.Changed de trabalho	System.ChangedDate	DateTime
Item.Created de trabalho por	System.Created por	String
Data de Item.Created de trabalho	System.CreatedDate	DateTime
Item.ID de trabalho	System.ID	Integer
Caminho de Item.Iteration de trabalho	System.IterationPath	TreeType
Estado de Item.Previous de trabalho	System.PreviousState	String
Item.Reason de trabalho	System. Reason	String
Item.Rev de trabalho	System.rev	Integer
Item.State de trabalho	System.State	String
Item.Title de trabalho	System.title	String
Tipo de Item de Item.Work de trabalho	System.WorkItemType	String

A tabela a seguir lista os campos que aparecem no relatório de tabela dinâmica na pasta rotulada "Microsoft.VSTS.Common" sob a dimensão de Item de trabalho. Esses campos têm nomes de referência que começam com "Microsoft.VSTS.Common".

Nome no relatório de tabela dinâmica e de cubo	Nome de referência	Tipo de dados
Item.Activated de trabalho por	Microsoft.VSTS.Common.ActivatedBy	String
Data de Item.Activated de trabalho	Microsoft.VSTS.Common.ActivatedDate	DateTime
Item.Closed de trabalho por	Microsoft.VSTS.Common.ClosedBy	String
Data de Item.Closed de trabalho	Microsoft.VSTS.Common.ClosedDate	DateTime
Item.Created de trabalho por	Microsoft.VSTS.Common.CreatedBy	String
Data de Item.Created de trabalho	Microsoft.VSTS.Common.CreatedDate	DateTime
Item.Resolved de trabalho por	Microsoft.VSTS.Common.ResolvedBy	String
Data de Item.Resolved de trabalho	Microsoft.VSTS.Common.ResolvedDate	DateTime
Razão de Item.Resolved de trabalho	Microsoft.VSTS.Common.ResolvedReason	String
Prioridade de trabalho	Microsoft.VSTS.Common.Priority	Integer
Item.Severity de trabalho	Microsoft.VSTS.Common.severity	String
Classificação de Item.Stack de trabalho	Microsoft.VSTS.Common.StackRank	Double

Reportável campos que são definidos em modelos de processo do MSF

As tabelas a seguir listam os campos que são definidos nos modelos de processo de Microsoft Solutions Framework (MSF) e as atribuições padrão dos campos. Esses campos são exibidos somente para projetos de equipe que foram criados com a versão 5.0 de um modelo de processo do MSF. Apenas os campos estão definidos para serem reportável são listados.

Campos de detalhes
Campos de dimensão
Campos de medida

Para obter uma lista completa dos campos que são definidos nos modelos de processo do MSF, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF. Se você atualizou um projeto de equipe, talvez você precise executar tarefas adicionais antes de trabalhar com alguns desses campos. Para obter mais informações, consulte Atualizando um projeto de equipe atualizada para novos recursos de acesso.

Campos de detalhes

Nome do campo

Descrição

Nome de referência

Tipo de dados

Status de automação

O status de um caso de teste. Você pode especificar os seguintes valores:

Não automatizado
Planejado

Microsoft.VSTS.TCM.AutomationStatus

String

Campos de dimensão

Nome do campo	Descrição	Nome de referência	Tipo de dados
ID	O identificador exclusivo é atribuído a um item de trabalho. IDs de item de trabalho são exclusivas em todos os projetos de equipe e itens de trabalho que são definidos em uma coleção de projeto de equipe.	System.ID	Integer
Título	Uma breve descrição que resume o que o item de trabalho e ajuda os usuários a diferenciá-lo de outros itens de trabalho em uma lista.	System.title	String
Projeto de equipe	O projeto de equipe ao qual o item de trabalho pertence.	System.teamproject	String
Tipo de Item de trabalho	O nome do tipo de item de trabalho.	System.WorkItemType	String
Área	Grupos de itens de trabalho em áreas de recurso ou a equipe de produto. A área deve ser um nó válido na hierarquia do projeto.	System.AreaPath	TreePath
Iteração	Agrupa os itens de trabalho nomeadas oportunidades ou períodos de tempo. A iteração deve ser um nó válido na hierarquia do projeto.	System.IterationPath	TreePath
Alterado por	O nome do membro da equipe que modificou o item de trabalho mais recentemente.	System.ChangedBy	String
Atividade	O tipo de atividade que é necessário para executar uma tarefa.	Microsoft.VSTS.Common.Activity	String
Rev.	Um número que é atribuído a revisão de históricos de um item de trabalho.	System.rev	Integer
Data de vencimento	A previsão devido data pelo qual uma tarefa será concluída.	Microsoft.VSTS.Scheduling.DueDate	DateTime
Data de término	A data e hora quando a agenda indica que a tarefa será concluída.	Microsoft.VSTS.Scheduling.FinishDate	DateTime
Data de início	A data e hora quando a agenda indica que a tarefa será iniciada.	Microsoft.VSTS.Scheduling.StartDate	DateTime
Encontrado em	O produto número da compilação, também conhecido como uma revisão, na qual um bug foi encontrado.	Microsoft.VSTS.Build.FoundIn	String
Criação de integração	Número de compilação do produto que incorpora o código ou corrige um bug.	Microsoft.VSTS.Build.IntegrationBuild	String
Atribuído À	O nome do membro da equipe que atualmente é proprietário do item de trabalho.	System.AssignedTo	String
Motivo	O motivo que o item de trabalho está no estado atual. Os valores são específicos para o estado e o tipo de item de trabalho. O campo não é controlado para casos de teste ou compartilhados etapas.	System. Reason	String
Estado	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.	System.State	String
Ativado por	Nome do membro da equipe que ativou ou reativado o item de trabalho.	Microsoft.VSTS.Common.ActivatedBy	String
Data ativada	Data e hora quando o item de trabalho foi ativado ou reativado.	Microsoft.VSTS.Common.ActivatedDate	DateTime
Fechado por	Nome do membro da equipe que fechou o item de trabalho.	Microsoft.VSTS.Common.ClosedBy	String
Data de fechamento	Data e hora quando um item de trabalho foi fechado.	Microsoft.VSTS.Common.ClosedDate	DateTime
Criado por	Nome do membro da equipe que criou o item de trabalho.	Microsoft.VSTS.Common.CreatedBy	String
Data de criação	Data e hora em que um item de trabalho foi criado.	Microsoft.VSTS.Common.CreatedDate	DateTime
Resolvido por	Nome do membro da equipe que é resolvido a história de bug ou usuário.	Microsoft.VSTS.Common.ResolvedBy	String
Data resolvida	Data e hora quando a história de usuário ou o bug foi resolvida.	Microsoft.VSTS.Common.ResolvedDate	DateTime
Motivo resolvido	O motivo pelo qual o bug foi resolvido (por exemplo, ele foi corrigido).	Microsoft.VSTS.Common.ResolvedReason	String
Prioridade	Uma classificação subjetiva do bug, problema, tarefa ou caso de teste como ela se relaciona com os negócios. Você pode especificar os seguintes valores: 1: Produto não pode fornecer sem a resolução bem-sucedida no item de trabalho e devem ser abordado assim que possível. 2: Produto não é fornecido sem a resolução bem-sucedida no item de trabalho, mas ele não precisa ser resolvida imediatamente. 3: Resolução de item de trabalho é opcional, com base em recursos, tempo e riscos.	Microsoft.VSTS.Common.Priority	Integer
Classificação	Uma classificação subjetiva da história de usuário, a tarefa, o problema ou o bug em comparação comparada outros itens de trabalho do mesmo tipo. Um item que é atribuído um número menor deve ser corrigido antes de um item que é atribuído um número maior.	Microsoft.VSTS.Common.Rank	Double
Pontos de história	Unidade de medida que captura o tamanho de uma história de usuário subjetiva. Se você atribuir mais pontos para uma história de usuário, você indica que mais trabalho é necessário para implementá-lo.	Microsoft.VSTS.StoryPoints	Double
Risco	Uma classificação subjetiva relativo incertezas sobre a conclusão bem-sucedida das histórias de usuários. Você pode especificar os seguintes valores: 1 - Alta 2 - Médio 3 - Baixo	Microsoft.VSTS.Common.Risk	String
Gravidade	Uma classificação subjetiva do efeito de um bug no projeto. Você pode especificar os seguintes valores: 1 - Crítica 2 - Alta 3 - Médio 4 - Baixo	Microsoft.VSTS.Common.severity	String
Data de vencimento	A data de previsão pelo qual um problema será concluído. Este campo é aplicável somente para emitir os itens de trabalho.	Microsoft.VSTS.Scheduling.DueDate	DateTime

Campos de medida

Nome do campo	Descrição	Nome de referência	Tipo de dados
Estimativa original	O número de horas necessárias para concluir uma tarefa.	Microsoft.VSTS.Scheduling.OriginalEstimate	Double
Restante	O número de horas que permanecem concluir uma tarefa.	Microsoft.VSTS.Scheduling.RemainingWork	Double
Completed	O número de horas que foram gastos trabalhando em uma tarefa.	Microsoft.VSTS.Scheduling.CompletedWork	Double

Consulte também

Compartilhar via