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

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.

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:

1. 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].

2. (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.

3. 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:

• Trabalhando com campos de Item de trabalho

• Adicionar um campo para ou remover um campo de um tipo de Item de trabalho

• Elemento FIELD (definição)

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.

1. Processar o data warehouse relacional sob demanda usando o ProcessWarehouse WarehouseControlWebService.

2. Processar o cubo sob demanda usando o ProcessAnalysisDatabase WarehouseControlWebService.

3. 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:

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").

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

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

Campos de dimensão

Campos de medida

Consulte também

Referência

Gerenciando os campos de Item de trabalho [witadmin]

Conceitos

Trabalhando com campos de Item de trabalho

Criação, personalização e gerenciamento de relatórios para ALM de Visual Studio

Outros recursos

Processar manualmente o cubo do Analysis Services e Data Warehouse de Team Foundation Server

Resolvendo conflitos de esquema que estão ocorrendo no Data Warehouse

A definição de campos de Item de trabalho