Definio de Escopo

Manual do Administrador

MantisGrupo RBS

TI Sistemas Online1. Ficha tcnica1.1. Dados do projeto

ProjetoMantis

URLhttp://www.bugtracker.rbs.com.br/

CoordenadorMarlon Bifano

ResponsvelMichele Costa joris

2. Histrico de alteraes

DataResponsvelDescrio

14/06/2011Michele Costa JorisCriao do documento

3. ndice

21.Ficha tcnica

21.1.Dados do projeto

32.Histrico de alteraes

43.ndice

54.Gerenciar Usurios

54.1.Criando uma nova conta

64.2.Adicionando a conta ao grupo de usurios

84.3.Adicionando o usurio ao projeto

105.Gerenciar Projetos

105.1.Criando um Projeto

115.2.Criando um Subprojeto

115.3.Criar novo Subprojeto

115.4.Editando um Subprojeto

156.Gerenciar Campos Personalizados

156.1.Campos Personalizados

176.2.Vinculando o campo personalizado ao projeto

187.Gerenciar Perfis Globais

187.1.Adicionando um Perfil

187.2.Alterando ou Apagando um Perfil

198.Gerenciar Configurao

4. Gerenciar UsuriosNesta seo do poderemos gerenciar todos os usurios do sistema, bem como criar novos e excluir usurios que no possuem mais acesso aos projetos.

Esta tela apresenta basicamente trs subsees de controle de usurios.

Contas Novas: Usurios criados recentemente

Nunca Entraram: Usurios criados e que nunca acessaram o sistema.

Gerenciar Contas: Aqui aparecem todos os usurios ativos no sistema. Atravs do link de seu nome, pode-se acessar as telas de edio da conta.4.1. Criando uma nova conta

Nesta tela de gerenciamento, logo abaixo em Gerenciar Contas, estar habilitado o boto Criar Nova Conta.

Nome do Usurio: Nome da conta do usurio.

Nome Verdadeiro: Pode-se definir o primeiro nome do usurio. Por padro, ser apresentado o Nome do Usurio nas telas do sistema.

E-Mail: Correio eletrnico do usurio.

Nvel de Acesso: Define o nvel de acesso do usurio cadastrado no sistema.

Habilitado: Ativa ou desativa a conta do usurio.

Protegido: Protege a conta do usurio contra excluses indevidas. Na criao da conta, esta opo dever estar desmarcada, caso contrrio o usurio no conseguir o acesso para cadastrar uma senha.

Aps clicar no boto Criar Usurio um aviso de confirmao ser enviado para o e-mail do usurio cadastrado. Este e-mail conter um link que remeter o usurio a tela de edio do seu contato para que possa ser definida uma senha de acesso ao sistema, mas por causa da vinculao dos usurios do Mantis com o Active Directory (AD) da rede de usurios do Grupo RBS, a senha usada ser a mesma da rede.

Nveis de Acesso

Visualizador: Pode apenas visualizar os casos registrados em todos os projetos

Relator: Pode visualizar, relatar e monitorar casos. No pode atribuir um caso a algum.

Atualizador: Alm das permisses do Relator, pode atualizar diversas informaes do caso, mas no pode atribuir o caso a algum ou mudar o status do caso.

Desenvolvedor: Alm das permisses do Atualizador, pode trocar o usurio atribudo e mudar o status do caso, alm de poder mover e apagar o caso (no recomendado).

Gerente: Possui as permisses do desenvolvedor, mais o acesso ao link resumo (relatrios de gerenciamento dos casos), atualizar informaes de projetos, incluir perfis e gerenciamentos de configuraes.

Administrador: Alm das permisses j descritas, pode criar e deletar usurios e projetos.4.2. Adicionando a conta ao grupo de usuriosAps o cadastro no Mantis, necessrio abrir um chamado no Qualitor (http://suporteti.rbs.com.br/qualitor4/) solicitando que o usurio seja includo no grupo de rede G-WWW-BUGTRACKER, conforme abaixo:

Aba Abertura: Cliente: Grupo RBS

Contato: Usurio que est abrindo o chamado

Tipo: Solicitao

Localidade: clicRBS

Severidade: Normal

Categoria 1: Acesso(s)

Categoria 2: Redes RBS.NET

Categoria 3: Criao/Alterao Grupos de Usurios Ttulo: Liberao de acesso ao sistema www.bugtracker.rbs.com.br Descrio:Incluir os usurios abaixo no grupo de usurios do Bugtracker (Mantis): grupo G-WWW-BUGTRACKER

- lucas_nunes

- mariana_romais

Todos os usurios acima j esto cadastrados na ferramenta.

Obrigada

Aba Inf.: Nome do Grupo de Rede: G-WWW-BUGTRACKERAps a criao do chamado, aguardar o retorno com a concluso do mesmo. Em seguida enviar um e-mail ao usurio informando que o cadastro j foi realizado e solicitando um teste no acesso, para verificar se o chamado foi atendido corretamente.4.3. Adicionando o usurio ao projeto

Uma vez que o usurio esteja criado, possvel adiciona-lo a um ou mais projetos (caso o projeto seja privado). Para este procedimento, dentro da seo de gerenciamento, clique sobre o nome do usurio. Logo ser apresentada a tela de edio das informaes do usurio. Abaixo das informaes principais teremos a seguinte tela:

Projetos Atribudos: Aqui estaro listados os projetos que o usurio j possui acesso.

Projetos No Atribudos: Lista dos projetos cadastrados no sistema. Aqui podemos escolher um ou mais projetos que o usurio ter acesso.

Nvel de Acesso: Independente do nvel de acesso cadastrado para o usurio.

Podemos definir um nvel de acesso especfico para um ou mais projetos.

5. Gerenciar Projetos

5.1. Criando um Projeto

Na tela inicial do sistema, clicando no link Gerenciar na barra principal de funcionalidades, ser exibida a subtela de gerncia, contendo diversos links, incluindo o Gerenciar Projeto. Nele ser apresentada a tela abaixo.

Nesta pgina podero ser visualizados todos os projetos e subprojetos cadastrados anteriormente no sistema, e atravs do boto Criar Novo Projeto pode-se criar um novo, seguindo inicialmente pela tela que se apresenta a seguir.

Lembrando que para uma melhor visualizao dos projetos, cada ttulo de coluna um link que organiza os projetos conforme a coluna que for clicada.

O projeto ento ser criado e includo na lista de projetos da primeira imagem. Neste momento ele ainda no est completamente definido, apenas as suas caractersticas bsica foram criadas at o momento. Clicando no link do projeto, na lista de projetos, ser possvel editar as informaes j cadastradas e adicionar novos dados que sero importantes para o relato de casos de erros no decorrer dos testes.

Nome do Projeto: Nome do Projeto a ser editado.

Status: Define a posio atual do projeto, se est em desenvolvimento, estvel, etc.

Visibilidade: Se pblico, todos os usurios tem acesso ao projeto, se privado, apenas os usurios cadastrados no projeto podero ter acesso a ele.

Caminhos para Carregamento de Arquivos: Informa o caminho at os arquivos ou documentos pertinentes ao projeto para uma consulta.

Descrio: Sntese do Projeto.

5.2. Criando um Subprojeto

Para criar um subprojeto devemos primeiramente clicar sobre o link de um projeto na listagem geral apresentada na tela inicial.

Logo abaixo dos campos de informaes do projeto, teremos uma pequena rea para o cadastramento de subprojetos, onde ser apresentado dois botes de criao

Criar novo Subprojeto: Ir criar um novo subprojeto. Ex: Projeto Canal Rural, Subprojeto Aftosa.

Adicionar como Subprojeto: Ir alterar o status atual de um projeto para subprojeto do projeto em edio.

5.3. Criar novo Subprojeto

Aps clicar no boto Criar novo Subprojeto a seguinte tela ser apresentada.

Nome do Projeto: Nome do Subprojeto a ser cadastrado.

Status: Define a posio atual do projeto, se est em desenvolvimento, estvel, etc.

Visibilidade: Se pblico, todos os usurios tem acesso ao projeto, se privado, apenas os usurios cadastrados no projeto podero ter acesso a ele.

Caminhos para Carregamento de Arquivos: Informa o caminho at os arquivos ou documentos pertinentes ao projeto para uma consulta.

Descrio: Sntese do subprojeto.

5.4. Editando um Subprojeto

Aps adicionar um subprojeto ele passar a ser visvel na listagem geral de projetos acrescido de um smbolo frente do seu nome.

Podemos agora editar as informaes do projeto clicando sobre o seu link. Na tela abaixo, alm das informaes cadastradas na incluso do subprojeto, teremos um novo item de marcao Habilitado que torna possvel ou no a sua visualizao por parte dos usurios.

Categorias

Logo em seguida, criaremos as categorias deste projeto, como o exemplo do Projeto Canal Rural, podemos criar as categorias Enquete, Mural, Pesquisa, etc. Desta forma, no momento do registro de um erro, estas categorias estaro listadas em uma combo box no relatrio de erros.

Alterar: Atravs deste boto, podemos editar o nome da categoria, bem como atribuir ela a um desenvolvedor do projeto, conforme a imagem acima.

Adicionar Categoria: Adiciona uma nova categoria ao projeto.

Copiar Categorias De: Copia as categorias de um determinado projeto para o projeto atual.

Copiar Categorias Para: Remete as categorias do projeto atual para outro projeto escolhido.

Verses

Em seguida, podemos cadastrar uma verso para o projeto. No exemplo abaixo, foi definida uma verso 1.0, que est com seu status Liberada o que quer dizer que na hora de relatar um erro, esta opo estar disponvel na combo Box da verso do projeto.

Aps cadastrar a verso, clicando no boto Alterar, pode-se editar ou definir mais informaes como a Data, Descrio e Liberao da verso. Por padro, uma verso criada com seu status de liberada.

Adicionar e Alterar Verso: Cria a verso e abre a tela de edio para alterar ou adicionar informaes.

Copiar Verses De: Copia as verses de um determinado projeto para o projeto atual.

Copiar Verses Para: Remete as verses do projeto atual para outro projeto escolhido.

Campos Personalizados

Seguindo a seqncia, veremos a rea destinada ao gerenciamento de Campos Personalizados, aqui poderemos alterar alguns parmetros nos campos personalizados j criados no sistema.

Seqncia: Define a ordem em que o campo ir aparecer no relatrio de erros.

Aes: Remove o campo personalizado somente deste projeto.

Adicionar Este Campo Personalizado: Adiciona um campo personalizado que no esteja vinculado a este projeto.

Copiar De: Copia os campos personalizados j existentes em outro projeto.

Copiar Para: Remete os campos personalizados do projeto atual para o projeto escolhido.

Adicionar usurios ao projeto

Por padro, todo o projeto criado pblico. Se necessrio, pode-se definir um projeto como privado. Desta forma, somente administradores e os usurios adicionados manualmente podero visualizar e acessar o projeto.

Nvel de Acesso: Define qual o nvel de acesso que o usurio ter ao projeto em questo, independente do nvel de acesso cadastrado para o seu usurio.

Adicionar Usurio: Adiciona o usurio selecionado na lista.

Copiar Usurios De: Copia os usurios de outro projeto.

Copiar Usurios Para: Remete os usurios do projeto atual para o projeto selecionado.

Gerenciar Contas

Nesta tabela possvel visualizar todos os integrantes de um projeto que foram previamente cadastrados.

Aqui poderemos remover um ou mais usurios, bem como todos de uma s vez.

Remover: Remove o usurio associado a mesma linha da tabela.

Remover Todos: Remove todos os usurios do projeto. Apenas os administradores permanecero.

6. Gerenciar Campos Personalizados

6.1. Campos Personalizados

Esta pgina ir listar os campos personalizados definidos no sistema. Incluindo um boto para criar um novo campo.

Novo Campo Personalizado: Define o nome do novo campo personalizado, depois de clicado, ser apresentada a pagina de edio do novo campo.

Nome: Nome do projeto.

Tipo:

String: Habilita um campo de texto de at 255 caracteres.

Numrico: Habilita um campo de entrada numrica.

Ponto Flutuante: Define um campo com entrada de nmeros fracionados.

Enumerao: Mostra um drop list de nica escolha. Para inserir as opes da lista, necessrio separar os itens pelo smbolo "|" (pipe caractere).

E-Mail: Caixa de texto. Quando definida, o valor tambm ser encapsulado nas referncias de mailto:.

Caixa de Marcao (V/F): Check Box. Para inserir as opes, necessrio separar os itens pelo smbolo "|" (pipe caractere).

Lista: Exibe uma lista de nica escolha. Para inserir as opes, necessrio separar os itens pelo smbolo "|" (pipe caractere).

Lista de Seleo Mltipla: Habilita uma lista de mltipla escolha. Para inserir as opes, necessrio separar os itens pelo smbolo "|" (pipe caractere).

Data: Habilita trs drop list contendo respectivamente dia, ms e ano.

Valores Possveis: Define os valores possveis para os campos de mltipla escolha. Lembrando as opes devem ser separadas pelo smbolo | (pipe caractere).

Valor Padro: Dentre as opes definidas no campo anterior, pode-se escolher qual delas dever ser apresentada como default. Para este procedimento, deve-se reproduzir exatamente o valor digitado no campo Valores Possveis.

Expresso Regular: Define um valor que ser comparado com o valor digitado pelo usurio. Caso o valor definido no esteja no contexto do valor inserido pelo usurio, ocorrer um Erro. Ex: Colocando o smbolo @ como expresso regular, valida se o usurio digitou um endereo de e-mail.

Acesso de Leitura: Define quais tipos de usurios podero ver o campo.

Acesso de Escrita: Define quais tipos de usurios podero escrever no campo.

Comprimento Mnimo: Limite mnimo de caracteres.

Comprimento Mximo: Limite mximo de caracteres.

Mostrar somente na pgina avanada: Exibe o campo personalizado somente na pgina avanada.

Mostrar ao reportar casos: Exibe o campo personalizado na tela de reporte de casos (Padro ON).

Mostrar ao atualizar casos: Exibe o campo na tela de atualizao de casos (Padro ON).

Mostrar ao resolver casos: Exibe o campo na tela de solucionar caso.

Mostrar ao fechar casos: Exibe o campo na tela de fechamento do caso.

Requerido no relato: Marca o campo como obrigatrio no relato (*).

Requerido na atualizao: Marca o campo como obrigatrio na atualizao (*).

Requerido na resoluo: Marca o campo como obrigatrio na resoluo (*).

Requerido no fechamento: Marca o campo como obrigatrio no fechamento do caso (*).

6.2. Vinculando o campo personalizado ao projeto

Logo abaixo da tela de edio do campo personalizado, podemos escolher a quais projetos o campo personalizado ser vinculado.

Projetos Vinculados: Exibe a quais projetos o campo personalizado est vinculado.

Projetos: Lista dos projetos cadastrados no sistema. Aqui podemos escolher um ou mais projetos que o campo ser vinculado.

Seqncia: Ordem de exibio dos campos personalizados.

7. Gerenciar Perfis Globais

7.1. Adicionando um Perfil

Estes campos so destinados a registrar o perfil das mquinas que acessam o sistema em desenvolvimento e em fase de teste.

Este perfil ir aparecer em um campo drop list no relatrio de casos. importante para uma avaliao detalhada da origem do erro.

Plataforma: Caminho fsico da mquina. Ex: \\RBST1234 Sistema Operacional: SO rodando na mquina.

Verso: Verso do SO

Descrio Adicional: Caractersticas particulares da mquina pertinentes ao comportamento do sistema. Ex: Apache Instalado.

7.2. Alterando ou Apagando um Perfil

Nesta seo poderemos escolher um perfil para alterao ou deleo. Para este procedimento, basta selecionar a opo desejada, Alterar ou Apagar Perfil, selecionar o perfil desejado e clicar em Enviar.

8. Gerenciar Configurao

Este link prov um grupo de pginas de configuraes que controlam o comportamento do Mantis BugTracking System. Os itens de configurao disponveis so referentes as bases de um projeto no sistema.

Estas sees servem a dois propsitos. Primeiramente elas exibiro as configuraes das particularidades do sistema. Se autorizadas, elas permitiro a um usurio mudar estes parmetros de gerenciamento. Elas tambm possuem configuraes para os nveis de acesso necessrios para mudar as configuraes de base em um projeto. Em geral, esta parte no ser usada, mas administradores podem querer delegar algumas destas configuraes para gerentes.

Relatrio de Configurao: No Aplicvel.

Relatrio de Permisses: Nesta tela sero apresentados os nveis de acesso atuais para as configuraes das principais funcionalidades do sistema.

Limiares do Fluxo de Trabalho

Nesta pgina poderemos ajustar muitas das principais caractersticas do fluxo de trabalho. Para a maioria delas, os campos so auto explicveis e so facilmente relacionadas com o nome dos parmetros no arquivo de configuraes.

Na direita de cala linha existe um seletor que permite ao administrador diminuir o nvel de acesso requerido para mudar certos parmetros no sistema.

Transies de Fluxo de Trabalho

Nesta pgina poderemos configurar os status no fluxo de trabalho. Para a maioria delas, os campos so auto explicveis e so facilmente relacionadas com o nome dos parmetros no arquivo de configuraes.

Na direita de cala linha existe um seletor que permite ao administrador diminuir o nvel de acesso requerido para mudar os parmetros no de configurao.

Notificaes por E-mail

Nesta pgina ser possvel definir os padres para o envio de e-mails nos eventos de relacionados aos reportes de erros.

O Mantis usa marcaes e restries de sistema para gerar e-mails ou eventos. Para cada novo evento um e-mail enviado para:

O reprter;

O responsvel pelo erro;

Todos que estiverem monitorando o erro;

Todos os que adicionaram anotaes ao erro reportado;

Todos os designados ao projeto qual o nvel de acesso atinge o mnimo requerido.

Esta pgina seleciona quem ir receber mensagens para cada evento listado abaixo na coluna da esquerda. As primeiras quatro colunas correspondem aos quatro primeiros pontos listados acima. As colunas restantes correspondem ao nvel de acesso definido.

Configuraes Avanadas

Outras configuraes podero ser realizadas diretamente no arquivo config_defaults_inc.php localizado no diretrio principal do Mantis (mantis-1.1.0).

Para alteraes neste nvel, solicite ajuda do administrador do sistema.

PAGE 2