Modelo de tarefas - Issue Template¶

Com esse plugin é possível definir uma série de modelos para cada tipo de tarefa existente num projeto, além de modelos para notas. Esses modelos podem ser configurados de forma independente em cada projeto dando flexibilidade para os usuários.

A documentação completa do puglin (disponível apenas em inglês) pode ser encontrada no link https://github.com/akiko-pusu/redmine_issue_templates/wiki.

Como usar um modelo?¶

Os modelos podem ser usados tanto para tarefas quanto para notas.

Em tarefas¶

Ao criar uma nova tarefa, uma caixa de seleção com os modelos disponíveis é apresentada assim que o tipo de tarefa é selecionado (dede que esse tipo de tarefa tenha modelos já configurados).

É possível selecionar qual (ou quais) modelos se deseja utilizar naquela tarefa. Ao selecionar um modelo, seu conteúdo é incluído no corpo da tarefa, por tanto, ele não substituirá o conteúdo já existente no campo descrição o mesmo vale para o assunto caso ele tenha sido configurado.

Uma vez com o(s) modelo(s) selecionado(s) basta preencher o resto da descrição caso seja necessário.

Em notas¶

Ao editar uma tarefa você pode incluir notas. Se, para o tipo de tarefa em edição, existir modelos disponíveis, uma opção acima do campo de texto é apresentada como na imagem a seguir:

Clicando em Preview Template Contents (Pré-visualizar conteúdo dos modelos) uma caixa de diálogo é apresentada listando todas as opções disponíveis, como na imagem a seguir:

IMPORTANTE
Na tela anterior são apresentadas 3 colunas, no entanto uma delas está vazia. Acreditamos que isso aconteça por um problema no plugin que deve ser resolvido em alguma atualização futura, mas até que isso aconteça, é possível verifiar o conteúdo daquele modelo, bem como a nota (comentário) dele passando o mouse sobre a região vazia (esse processo pode ser tedioso, uma vez que o local a ser examinado não é claro, mas tente navegar o mouse devagar sobre aquela região) e uma tela como a seguinte deve ser apresentada:

Para usar o modelo escolhido basta clicar no ícone de seta da coluna aplicar que a caixa de diálogo será fechada e o modelo será aplicado à nota.

Quem pode criar ou editar modelos?¶

O gerenciamento de modelos é feito pelos papéis que tem essa permissão definida pela administração do sistema. No momento que esse material é escrito os papéis com essa permissão são todos os Institucionais (Diretor(a), Coordenador(a) e Gerente) e o Líder. Para mais informações consulte as permissões em Tipos de Papéis e Permissões.

Os papéis Membro, Relator e Desenvolvedor tem a permissão de visualizar os modelos o que os permite utilizá-los.

O plugin não aparece pra mim. O que fazer?¶

Esse plugin precisa ser ativado (ou desativado) em cada projeto individualmente. Para isso realize o seguinte:

1. Abra o projeto para o qual deseja criar modelos.
2. Siga para a opção de Configurações na barra superior do redmine.
3. Na aba Projetos, o segundo grupo de informações é a caixa de módulos do projeto. Dentro dela procure pelo módulo Modelos de Tarefas.
4. Marque a caixa de seleção do módulo (ou desmarque caso queira desativar) e clique no botão Guardar. Assim que as novas configurações foram salvas uma nova opção na barra superior é apresentada: Modelos de tarefas.

Pronto, o plugin está disponível para uso.

Como criar modelos?¶

Como já mencionado, é possível usar modelos para tarefas e para notas. As listas de modelos bem como o link de inclusão de novos modelos podem ser acessadas pela barra superior a partir de Modelos de tarefas ou na barra lateral nas telas de Tarefas e Nova tarefa. Sigas os passos abaixo conforme necessidade:

Modelos para tarefas¶

1. No projeto no qual você quer criar os modelos, acesse o menu Modelos de Tarefas. Uma tela parecida com a seguinte deve ser apresentada: Essa tela listará todos os modelos existentes para aquele projeto organizados por tipos de tarefas.
2. Na caixa com nome Modelo de tarefas clique no link Incluir modelo. Uma tela parecida com a seguinte deve ser apresentada: .

3. O formulário que é apresentado tem os seguintes campos:

   Campo	Descrição
   Nome do modelo	Obrigatório. Texto que será apresentado na caixa de seleção na criação de uma tarefa
   Tipo	Obrigatório. Tipo de tarefa para o qual o modelo está sendo criado
   Título da tarefa	Opcional. Quando preenchido, definirá o título da tarefa quando o modelo for selecionado
   Corpo da tarefa	Obrigatório. Todo o conteúdo que comporá o modelo da sua tarefa. Todas as possibilidades existes na criação de uma tarefa comum estão disponíveis aqui
   Notas	Espaço descritivo sobre o modelo (Visível apenas para quem pode gerenciar os modelos)
   Related Link	Opcional. Link para uma página de exemplo sobre o modelo. Uma wiki, por exemplo
   Related Linl Title	Opcional. Título personalizado para o campo anterior (caso ele seja preenchido).
   Versão por omissão	Opcional. Define esse modelo como o padrão para esse tipo de tarefa caso nenhum outro tenha sido selecionado
   Habilitado	Opcional. Ativa o modelo. Caso não seja marcado, o modelo fica apenas como rascunho sem a possibilidade de ser utilizado.
   Habilitar compartilhamento com a árvore de projetos.	Opcional. Permite que projetos herdeiros do projeto atual herdem esse modelo.

4. Preencha os campos e clique em Criar

Pronto, o modelo está criado.

Modelos para notas¶

1. No projeto no qual você quer criar os modelos, acesse o menu Modelos de Tarefas. Uma tela parecida com a seguinte deve ser apresentada: Essa tela listará todos os modelos existentes para aquele projeto organizados por tipos de tarefas.
2. Na caixa com nome Template for note clique no link Incluir modelo. Uma tela parecida com a seguinte deve ser apresentada: .

3. O formulário que é apresentado tem os seguintes campos:

   Campo	Descrição
   Nome do modelo	Obrigatório. Texto que será apresentado na caixa de diálogo de modelos para notas
   Tipo	Obrigatório. Tipo de tarefa para o qual o modelo está sendo criado
   Comentário	Obrigatório. Todo o conteúdo que comporá o modelo da sua nota. Todas as possibilidades existes na criação de uma nota comum estão disponíveis aqui
   Templates visibility (visibilidade do modelo)	Obrigatório. Define quais são os papéis que podem ver aquele modelo em específico
   Notas	Espaço descritivo sobre o modelo (Visível apenas para quem pode gerenciar os modelos)
   Habilitado	Opcional. Ativa o modelo. Caso não seja marcado, o modelo fica apenas como rascunho sem a possibilidade de ser utilizado.

4. Preencha os campos e clique em Criar

Pronto, o modelo está criado.

Saiba mais¶

Para mais informações acesse a documentação oficial do puglin (disponível apenas em inglês) em https://github.com/akiko-pusu/redmine_issue_templates/wiki.

---

Essa página foi acessada 13 vezes.
Em caso de dúvida, entre em contato com [email protected].