Carregar relatórios em um projeto da equipe

Ao adicionar um servidor de relatórios à sua implantação do TFS (local), é possível acessar uma grande quantidade de dados sobre os projetos da sua equipe, como qualidade de compilação, tendências de bugs, burndown e andamento do teste. Os relatórios de SSRS (SQL Server Reporting Services) ajudam as equipes, com aprofundamentos, a gerenciar o trabalho e a melhorar os processos.

Adicionar um servidor de relatório

Permitir que os usuários exibam ou criem relatórios

Analisar relatórios e tarefas obrigatórias da equipe

Depois de adicionado um servidor de relatório, você desejará adicionar relatórios ao seu projeto de equipe. Você pode carregar relatórios ao se conectar a uma implantação local do TFS 2010, TFS 2012 ou TFS 2013.

Se a página Relatórios no Team Explorer aparecer vazia, você talvez vai desejar carregar relatórios.

Se a página Relatórios não aparecer de forma alguma, você poderá adicionar um servidor de relatório.

Carregar relatórios para o seu projeto de equipe

Use a ferramenta de linha de comandos tfpt que o TFS Power Tools fornece.

1. Verifique se você possui as ferramentas, configurações e permissões a seguir.

   • Se você ainda não instalou o TFS Power Tools, instale-o agora.

   • Se você ainda não instalou o Visual Studio ou o Team Explorer, instale um deles agora. É possível baixar o Team Explorer gratuitamente. O Team Explorer deve estar presente na mesma máquina em que você executar a ferramenta de linha de comandos tfpt.

   • Se você não for um administrador do projeto de equipe, peça para ser adicionado agora.

   • Se você não foi adicionado ao Gerenciador de Conteúdo ou à função de Gerenciador de Conteúdo do Team Foundation para o SQL Server Reporting Services, peça para ser adicionado agora.

   • Se você ainda não instalou o Microsoft Visual Studio Team Foundation Server 2013, instale-o agora. Essa é a única maneira de obter a versão mais recente dos modelos de processo padrão, que contém a versão mais recente dos relatórios.

2. No Team Explorer, baixe o modelo de processo mais recente que é compatível com o usado para criar seu projeto de equipe.

   

   Para determinar o tipo de modelo de processo usado para criar seu projeto de equipe, analise os tipos de itens de trabalho que aparecem no menu Novo Item de Trabalho para Team Explorer e compare-os aos tipos de itens do quadro a seguir. Se seus tipos de item de trabalho são diferentes dos tipos exibidos, um modelo de processo personalizado pode ter sido usado.

   Visual Studio Scrum	MSF para Agile	MSF para CMMI

   Dica

   • Em geral, você pode usar a versão mais recente do modelo de processo que foi usado para criar seu projeto de equipe.Por exemplo, você pode carregar relatórios da versão do Microsoft Visual Studio Scrum 2013, mesmo se seu projeto de equipe foi criado no Microsoft Visual Studio Scrum 2.0.

   • Para baixar um modelo de processo, você precisa ser um administrador da coleção de projetos de equipe e deverá se conectar ao TFS usando a mesma versão do Visual Studio ou Team Explorer.Por exemplo, conecte-se ao TFS 2013 a partir do Team Explorer 2013.

   • Para aprender mais sobre modelos de processo e tipos de itens de trabalho, clique aqui.

3. Abra um Prompt de Comando no modo administrativo e vá para o diretório em que instalou as ferramentas avançadas.

   cd %programfiles%\Microsoft Team Foundation Server 2013 Power Tools
   

   Em uma edição de 64 bits do Windows, substitua %programfiles% por %programfiles(x86)%.

4. Carregue os relatórios. O modelo de processo especificado deve ser compatível com aquele usado para criar o projeto de equipe. E ele deve ter sido carregado na coleção de projetos de equipe que hospeda seu projeto de equipe.

   tfpt addprojectreports /collection:"http://MyServer:8080/tfs/DefaultCollection" /teamproject:MyProject /processtemplate:"TemplateName" 
   

   Esses são os nomes dos modelos de processo carregados com o TFS 2013:

   • Microsoft Visual Studio Scrum 2013

   • MSF para Agile Software Development 2013

   • MSF para CMMI Process Improvement 2013

   Para substituir relatórios que foram carregados anteriormente, especifique a opção /force.

5. Abra o site do relatório a partir da página  Relatórios no Team Explorer. Talvez você precise atualizar a página para ver os relatórios recém-carregados.

   

   E aqui está uma exibição de relatórios carregados para um projeto do Scrum no Gerenciador de Relatórios.

   

   Dependendo da quantidade de dados coletada para o seu projeto de equipe, pode levar de vários minutos até várias horas para que o depósito de dados e o cubo sejam compilados. Depois da compilação, no entanto, você poderá exibir o andamento do projeto de equipe, desde que o TFS tenha sido implantado primeiro.

Tentar o próximo

Conceder permissões para exibir ou criar relatórios.

Perguntas e respostas

P: Como posso determinar se meu relatório está atualizado?

R: Para ver quando o relatório foi atualizado pela última vez, marque o carimbo de data/hora Data da Última Atualização, que aparece no canto inferior direito de cada relatório.

P: Com que frequência os relatórios são atualizados?

R: Os relatórios acessam dados a partir do depósito de dados relacional (Tfs_Warehouse), que é atualizado a cada dois minutos, e o cubo (Tfs_Analysis), que é atualizado a cada duas horas.

P: Como resolvo problemas que fazem com que os relatórios fiquem desatualizados?

R: Os relatórios ficarão desatualizados quando alguns ou todos os dados pararem de fluir para o depósito de dados. Para verificar o fluxo de dados, execute o GetProcessStatus do serviço Web de Controle de Depósito. Além disso, corrija quaisquer conflitos de esquema que possam estar ocorrendo.

P: Quais tarefas tfpt addprojectreports executa?

R: O comando tfpt addprojectreports executa as instruções contidas no arquivo ReportTasks do modelo de processo. Esse arquivo está localizado na pasta Relatórios do modelo de processo. As tarefas incluem a criação de pastas de relatórios, a definição de parâmetros do relatório e fontes de dados para cada relatório, além do carregamento de relatórios no servidor de relatório.

P: E se eu desejar carregar apenas um único relatório?

R: Você pode carregar um único relatório usando Carregar arquivo no Gerenciador de Relatórios. Você precisará definir a fonte de dados do relatório e possivelmente outros parâmetros.

P: Quais são os nomes das fontes de dados?

R: Os nomes das fontes de dados de serviços de relatório são Tfs2010ReportsDS e Tfs2010OlapReportsDS. Mesmo que você tenha instalado ou atualizado para o TFS 2012, esses nomes, os quais foram atribuídos às fontes de dados para uma instalação do TFS 2010, estão em uso.

Você pode sempre verificar os nomes abrindo o menu de contexto de qualquer relatório, escolher Gerenciar e Fontes de Dados.

P: Posso atualizar os relatórios de outro modelo de processo?

R: A maioria dos relatórios é personalizada com base nos tipos de itens de trabalho e nos estados do fluxo de trabalho usados em cada modelo de processo. Talvez seja necessário personalizar os relatórios copiados de outro modelo de processo para adequar as definições de tipo ao seu projeto de equipe.

Para saber sobre quais relatórios são fornecidos com os modelos de processo, consulte Revisar atividades de equipe para dar suporte a relatórios úteis.

R: E carregar relatórios do Excel?

R: Você pode usar o comando tfpt addprojectportal para adicionar um portal do projeto e relatórios do Excel desde que tenha adicionado um aplicativo Web do SharePoint à sua coleção de projetos de equipe.

P: Posso obter os mesmos relatórios usando o Visual Studio Online?

R: Isso não é possível no momento. O carregamento de relatórios é suportado apenas para implantações locais do TFS. Você pode, no entanto, gerar um gráfico dos resultados de uma consulta de lista plana.

Como personalizo um relatório?

R: Você pode personalizar os relatórios carregados usando o SQL Server Report Builder 2012. Para saber mais, consulte Criando relatórios para o Team Foundation Server 2010 e Personalizando relatórios para o Team Foundation Server 2010. Embora esses artigos sejam baseados no TFS 2010, eles são válidos para o TFS 2013.

Como posso saber mais sobre o cubo do TFS?

R: Consulte Perspectivas e grupos de medição fornecidos no cubo do Analysis Services para o Visual Studio.

Onde posso obter ajuda se tiver mais dúvidas?

R: Procure por uma resposta ou publique uma pergunta no Fórum do Team Foundation Server – Relatórios e Depósito.