Adicionar e modificar campos de item de trabalho para dar suporte a relatórios

Artigo
02/25/2013

Você usar campos de item de trabalho para acompanhar dados para um tipo de item de trabalho, para definir os critérios de filtragem para consultas, e para usar nos relatórios.Alguns campo, exceto campos do sistema, que você deseja aparecer em um relatório deve ser definido no arquivo de definição para os tipos de itens de trabalho que o campo rastreará.Os campos do sistema são definidas automaticamente para cada tipo de item de trabalho.No entanto, devem ser incluídos no formulário de item de trabalho para oferecer suporte a entrada de dados.

Para oferecer suporte ao relatório, você pode adicionar campos ou alterar os atributos de campos existentes.Quando você adicionar ou alterar campos, você deve aplicar convenções de nomenclatura sistemáticas para certificar-se que os dados são agrupados logicamente em pastas no cubo de analysis services SQL Server .

Neste tópico

Práticas recomendadas
Use um campo existente
Listar os campos que são definidos para uma coleção de Projeto de equipe
Atributos de campo reportáveis
Alterar um atributo reportável para um campo
Adicione campos para o relatório de suporte
Verificar as alterações feitas aos atributos de campo reportáveis
Práticas recomendadas ao atribuir nomes de referência de relatório

Para obter uma lista de campos reportáveis definidos nos modelos padrão de processo, consulte Referência a campos Reportable para ALM de Visual Studio.

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á definida na coleção de projeto de equipe que contém o projeto de equipe.O uso de um campo existente suporta relatar entre de projeto.
Determine se você pode usar um campo que já está definida em outra coleção de projeto na implantação de Visual Studio Team Foundation Server. O uso de um campo existente suporta relatar entre de projeto.
Você não pode ter mais de 1.024 campos em cada coleção de projeto e não mais de 1.024 campos reportáveis exclusivos em todos projeto coleções em todo uma implantação de Team Foundation Server.Os campos mesclados contam como um campo reportável.
Institua um procedimento padrão e examinar o processo para adicionar e modificar campos em modelos de processo, em projetos de equipe, ou em coleções de projeto.

Use convenções de nomenclatura sistemáticas quando você campos de rótulo para o relatório.Quando você atribui nomes de referência em uma maneira sistemática através de qualquer equipe coleções em uma implantação de Team Foundation Server, você garante um esquema mais consistente e mais útil de armazenamento e do cubo, e você evitar conflitos de esquema no depósito.Para obter mais informações, consulte Resolver conflitos de esquema que estão ocorrendo no data warehouse.

Você pode atribuir até quatro atributos label a um campo de item de trabalho:

Observação
Os campos que são definidos nos modelos de processo para soluções Framework da Microsoft não recebem um nome de relatório ou nome da referência de relatório.Por padrão, o nome da referência e atributos de nome são usados.

name.O nome amigável de campo que aparece nos menus suspensos de item de trabalho consulta.O nome amigável deve ser exclusivo por todos os campos que são definidos em um projeto de equipe.Além disso, o nome amigável pode ser diferente do rótulo exibida que é atribuído 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 o distingue de todos os campos restantes que são definidos na coleção de projeto de equipe.O valor que é atribuído a refname não pode ser alterado.

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

Observação

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

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

Use um campo existente

Você deve usar um campo que já está definida se o campo coincide com as informações que você deseja controlar sobre e relatórios.Para usar um campo existente, execute as seguintes etapas:

Identifica o campo que você deseja usar.Use o comando de witadmin listfields identificar os campos e seus atributos que são definidos para todas as coleções de projeto.Para obter mais informações, consulte Listar os campos que são definidos para uma coleção de Projeto de equipe posteriormente neste tópico.
Determine se o campo é reportável e se os atributos reportáveis atendam suas necessidades de relatório.
Se não é reportável, use witadmin changefield para alterar o atributo reportável para coleções de projeto em que 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 é definido, adicione-o a arquivos de definição de XML para os tipos de itens de trabalho que você deseja usar para controlar dados.Para obter mais informações, consulte Adicione campos para o relatório de suporte posteriormente neste tópico.

Listar os campos que são definidos para uma coleção de Projeto de equipe

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

witadmin listfields /collection:CollectionURL /n:RefName

Para obter mais informações, consulte Gerenciar campos de item de trabalho [witadmin].

Atributos de campo reportáveis

Os campos reportáveis têm um valor de atributo de reportable de Detail, de Dimension, ou de Measure.Os seguintes atributos determinam como os campos de item de trabalho são exportados e processadas para bancos de dados de data warehouse:

reportingtype.Para incluir um campo nos relatórios, você deve atribuir um dos seguintes valores para o atributo de reportable :
- Atribuir Detail para exportar o campo para o banco de dados relacional de depósito mas não o cubo.Como mostra o exemplo a seguir, use o tipo de Detail somente para o inteiro, dobre-o cadeia de caracteres, campos, ou DateTime:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Atribuir Dimension para exportar o campo para o banco de dados relacional de armazenamento e o cubo.Como mostra o exemplo a seguir, use Dimension somente para o inteiro, dobre-o cadeia de caracteres, campos, ou DateTime.Esse valor é útil incluir os campos que são usados para filtrar relatórios (por exemplo, os campos que possuem listas de valores válidos).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Atribuir Measure para oferecer suporte ao processamento de valores precalculated no cubo.Use o tipo de Measure somente para o inteiro e double campos.
  
  Quando você atribui a medida como reportingtype, você deve atribuir sum como 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 diferente de referência a um campo que está marcado como reportável.Se nenhum valor for especificado, o valor que é atribuído ao atributo de refname é usado.

Você pode usar este atributo a mesclagem ou divergir os campos que são incluídos nos relatórios.Para mesclar dois campos que têm nomes distintos de referência e que são definidos em coleções diferentes do projeto, você atribui mesmo reportingrefname em ambos.Para divergir dois campos que têm o mesmo nome de referência mas que é definido em coleções diferentes do projeto, você atribui reportingrefname diferente para cada campo.

Você deve mesclar campos sempre que possível minimizar o número de campos no depósito e manter no limite máximo de 1024 campos reportáveis.Você pode gerar relatórios de grupo cruzado com campos mesclados.

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

Importante
Você deve usar práticas recomendadas rotular campos de relatório de modo que sejam agrupados nos relatórios de tabela dinâmica.Para obter mais informações, consulte Práticas recomendadas ao atribuir nomes de referência de relatório.

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 de campo que são definidas para uma coleção de projeto.Um campo existente é definido em uma ou mais definições de tipo de item de trabalho.Além disso, você pode alterar quaisquer atributos que determinam como um campo é processado nas datas warehouses.

Você pode usar a seguinte sequência das etapas para alterar a atribuição de atributo de um campo:

Você pode usar o comando de witadmin changefield alterar uma atribuição de atributo a um campo.Você exercita 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 fazer o campo de AW.Common.TeamPriority disponível para filtrar os relatórios, atribua o valor de dimensão:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Para obter mais informações, consulte Gerenciar campos de item de trabalho [witadmin].
(Opcional) se você tiver mais de uma coleção de projeto, você pode querer fazer alterações semelhante ao campo de item de trabalho que é definido nessa coleção.Para evitar conflitos de esquema quando você exportar e processa dados para bancos de dados de data warehouse, você deve atribuir os mesmos valores a esses atributos por todas as coleções:
- Tipo de campo (o valor para este campo não pode ser alterado para um campo existente).
- Reportando o tipo.
- Nome de relatório.
Para obter mais informações, consulte Resolver conflitos de esquema que estão ocorrendo no data warehouse.
Depois que você fez todas as alterações nos campos de item de trabalho que você deseja usar para relatórios, você deve processar os bancos de dados de data warehouse.Você pode usar os serviços Web de ProcessWarehouse e de ProcessAnalysis , que estão disponíveis com WarehouseControlWebService.

Esta etapa certifique-se de que pessoas que usam relatórios não consulte um erro quando você altera os atributos de campo.

Para obter mais informações, consulte Gerenciar campos de item de trabalho [witadmin].

Adicione campos para o relatório de suporte

Você pode adicionar campos a definição de um tipo de item ou de tipos de trabalho.Quando você adiciona o campo, você deve adicionar a mesma definição de elemento do campo para todos os tipos de itens de trabalho para o campo suportará o relatório.Se você desejar que o campo para suportar entre o reporting, o campo deve ser adicionado a todos os tipos de itens de trabalho em todos os projetos de equipe que serão relatadas sobre.

Para obter mais informações, consulte Trabalhando com campos de Item de trabalho.

Verificar as alterações feitas aos atributos de campo reportáveis

Você pode verificar as alterações feitas aos atributos de campo reportáveis processando as datas warehouses sob demanda e então verificando os relatórios para verificar que eles fiquem atualizados.Ou você pode esperar até a execução de trabalho do adaptador de depósito.Por padrão, o banco de dados relacional é processado cada poucos minutos.No entanto, o cubo é processado cada duas horas por padrão.

Observação
Para obter mais informações sobre a WarehouseControlWebService, consulte Processar manualmente o cubo serviços de data warehouse e análise para o Team Foundation Server.

Processar a data warehouse relacional sob demanda usando ProcessWarehouse WarehouseControlWebService.
Processar o cubo sob demanda usando ProcessAnalysisDatabase WarehouseControlWebService.
Verifique se os relatórios estão sendo atualizados.Exibir um relatório através do painel relatórios ou o gerenciador.Para obter mais informações, consulte Painéis (ágeis) ou Relatórios (ágeis).

Práticas recomendadas ao atribuir nomes de referência de relatório

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

Aplicar uma convenção de nomenclatura sistemática fica cada vez mais importante porque todos os dados reportáveis de todos os projetos de equipe que são definidos em todas as coleções de projeto são gravados em uma única data warehouse relacional.Os dados do depósito em são processados e gravados no cubo.Como os campos de item de trabalho são gerenciados distintamente para cada coleção de projeto, rótulos diferentes podem ser aplicadas e podem resultar em um conjunto de campos que não é bom organizado relatórios de criação de suporte.

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

Os campos que têm o prefixo “sistema” são intrínsecos e listados diretamente sob a dimensão de item de trabalho, com o item de trabalho” prepended.
Outros campos são colocados nas pastas cujos nomes correspondem aos prefixos em seus nomes de referência.Por exemplo, os campos que têm o prefixo “Microsoft.VSTS.Common” são listados na pasta que é rotulada de “comum Microsoft VSTS”.

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

Estrutura de pastas no cubo de dados OLAP

A tabela a seguir lista os campos cujos nomes de referência começam com “sistema” e que é listado 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 campos restantes são colocados nas pastas cujos nomes correspondem aos prefixos em seus nomes de referência.

Observação
As implantações que não usam a versão de analysis services SQL Server não têm acesso aos recursos de conversão que são fornecidos por aquela versão.Nessas distribuições, os campos são identificados por seu nome completo de referência no cubo, com “.” substituído por “_” (por exemplo, “System_Id” e “System_Title”).

Nome no relatório de tabela dinâmica e o cubo	Referenciar o nome	Tipo de dados
Caminho de trabalho Item.Area	System.AreaPath	TreeType
A Item.Assigned trabalho	System.AssignedTo	Cadeia de caracteres
Por Item.Changed trabalho	System.ChangedBy	Cadeia de caracteres
Data de trabalho Item.Changed	System.ChangedDate	DateTime
Por Item.Created trabalho	Por System.Created	Cadeia de caracteres
Data de trabalho Item.Created	System.CreatedDate	DateTime
Item.ID trabalho	System.Id	Integer
Caminho de trabalho Item.Iteration	System.IterationPath	TreeType
Estado de trabalho Item.Previous	System.PreviousState	Cadeia de caracteres
Item.Reason trabalho	System.Reason	Cadeia de caracteres
Item.Rev trabalho	System.Rev	Integer
Item.State trabalho	System.State	Cadeia de caracteres
Item.Title trabalho	System.Title	Cadeia de caracteres
Tipo de item de trabalho Item.Work	System.WorkItemType	Cadeia de caracteres

A tabela a seguir lista os campos que aparecem no relatório de tabela dinâmica na pasta que é rotulada “Microsoft.VSTS.Common” na 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 o cubo	Referenciar o nome	Tipo de dados
Por Item.Activated trabalho	Microsoft.VSTS.Common.ActivatedBy	Cadeia de caracteres
Data de trabalho Item.Activated	Microsoft.VSTS.Common.ActivatedDate	DateTime
Por Item.Closed trabalho	Microsoft.VSTS.Common.ClosedBy	Cadeia de caracteres
Data de trabalho Item.Closed	Microsoft.VSTS.Common.ClosedDate	DateTime
Por Item.Created trabalho	Microsoft.VSTS.Common.CreatedBy	Cadeia de caracteres
Data de trabalho Item.Created	Microsoft.VSTS.Common.CreatedDate	DateTime
Por Item.Resolved trabalho	Microsoft.VSTS.Common.ResolvedBy	Cadeia de caracteres
Data de trabalho Item.Resolved	Microsoft.VSTS.Common.ResolvedDate	DateTime
Razão de trabalho Item.Resolved	Microsoft.VSTS.Common.ResolvedReason	Cadeia de caracteres
Item.Priority trabalho	Microsoft.VSTS.Common.Priority	Integer
Item.Severity trabalho	Microsoft.VSTS.Common.Severity	Cadeia de caracteres
Classificação de trabalho Item.Stack	Microsoft.VSTS.Common.StackRank	Double

Consulte também

Compartilhar via