quarta-feira, 21 de maio de 2008

Visualizando gráficos de sumário no Mantis

No Mantis BugTracket temos o Summary, ou Resumos a tradução do português da ferramenta. Este resumo é composto por algumas tabelas de nos exibem diversas informações do tipo:
  • Issues abertas, resolvidas e testadas na perspectiva de
  • Projeto
  • Status
  • Gravidade
  • Categoria
  • Por dia
  • Por resolução
  • Por prioridade

Além de trazer alguns dados estatísticos como:
  • Tempo para casos resolvidos
  • Estatísticas de relatores
  • Estatísticas de Desenvolvedores
  • Eficiência do relator
  • Mais ativos
  • Aberto a x tempo

Isso nos traz uma base para criar novas métricas, atacar algum ponto que necessitamos e gerar gráficos....
Mas porque não fazer com que o próprio Mantis gere os gráficos?

Podemos inserir dentro do Mantis a aplicação JPGraph que é um conjunto de bibliotecas para a criação de gráficos para o PHP.

Para que o Mantis possa gerar estes gráficos faremos basicamente três passos:
  1. Baixar e submeter o JPGrath a pasta de instalação do Mantis
  2. Configurar o arquivo confir_inc_defaults.php do Mantis
  3. Testar a solução

Para atacarmos o item 1 vamos até a página do JPGraph , clicar no link Download. Teremos que clicar sobre o link jpgraph-1.22.1.tar.gz. Baixe este arquivo e descompacte ele numa pasta de sua escolha.

Atenção: note que existirão dois arquivos para download. O jpgraph-1.22.1.tar.gz é referente ao PHP4 e jpgraph-2.3.tar.gz é referente ao ao PHP5. No caso deste tutorial estamos utilizando a versão 1.22.1 pelo servidor que estou utilizando é PHP4.
Para verificar qual versão o Mantis deverá usar do PHP consulte este link: http://www.mantisbt.org/requirements.php

Quando descompactamos o arquivo veremos a pasta jpgraph-1.22.1 e dentro dela alguns arquivos de informação do jpgraph e duas pastas: doc e src. A pasta doc não é necessária para a cópia que faremos logo mais, mas fica a critério de cada um transportar esta pasta.

Copie a pasta jpgraph-1.22.1 para o diretório raiz do Mantis.

Agora iremos alterar o arquivo de configuração do Mantis.
Abra o arquivo config_defaults_inc.php e procure pelo atributo $g_use_jpgraph (esta na linha 569 do arquivo).
Estamos no grupo de configurações especificas do gráfico no Mantis.
O atributo $g_use_jpgraph diz se teremos a visualização dos gráficos no Mantis, o valor default é OFF. Mude este valor para ON.
O atributo $g_jpgraph_path monta o caminho para o jpgraph. Se você não renomeou a pasta do jpgraph (jpgraph-2.3) altere o valor deste atributo ficando como mostra abaixo:
$g_jpgraph_path = '.' . DIRECTORY_SEPARATOR . 'jpgraph-1.22.1' . DIRECTORY_SEPARATOR . 'src' . DIRECTORY_SEPARATOR;

Agora basta acessar o Mantis e clicar sobre o link Summary.
Note que a tela terá as seguintes alterações:
Novo link Advanced Summary
Novos links na pagina Summary:
  • Syntesys
  • Per State
  • Per Pryority
  • Per Severity
  • Per Category
  • Per Solution



Na página Advanced summary temos os gráficos:
  • Cumulative By Date
  • By Developer
  • By Reporter
  • By Severity
  • By Status
  • By Resolution
  • By Category
  • By Priority



Bom, não vou mostrar as demais opções aqui pelo foco ser colocar a visualização de gráficos no Mantis.

Espero que este mini-tutorial tenha ajudado.
Abraços!

Um comentário:

  1. e ai elias, muito boa essa ferramenta. porem utulizei ela local para fazer uns testes e quando coloquei para o servidor me aparece o seguinte erro:


    JpGraph Error Your PHP installation does not seem to have the required GD 2.x library enabled. Please see the PHP documentation, "Image" section. Make sure that "php_gd2.dll" statement is uncomment in the [modules] section in the php.ini file.

    tu saberia me dizer o que poderia esta causando esse erro??

    abração e parabens pelos posts.

    ResponderExcluir