mantis manual do administrador
DESCRIPTION
Mantis manual de administradorTRANSCRIPT
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