RSJUG.ORG
Artigo
Versão 1.0
Página 1 de 7
Cadastro de Issues no java.net
Introdução
Mostraremos neste artigo um exemplo de como realizar o cadastro de uma Issue em um
projeto existente no portal Java.net.
Para iniciar este trabalho, estou considerando que você está logado no java.net e está na
página do seu projeto. No caso estarei utilizando o projeto RSJUG
(https://rsjug.dev.java.net/) como apoio. Vemos a página inicial do projeto na Figura 1.
Para informação, existe um help em inglês disponível no Help do Java.net. Este artigo não
é uma tradução deste trabalho. O objetivo aqui é apenas mostrar de forma rápida como
cadastrar uma issue tendo uma referência em português sobre o processo.
https://rsjug.dev.java.net/scdocs/ddIssues_EnterModify.html.
Figura 1Tela inicial do projeto no Java.net
1. Tela inicial - Manutenção de Issues
Iremos entrar no link “Issue tracker”, para realizarmos o controle de demandas do projeto.
Na Figura 2 verificamos a tela que se abre. Podemos entrar com o Id de uma demanda e
clicar no botão “Find” para ver o status de uma determinada Issue.
RSJUG.ORG
Artigo
Versão 1.0
Página 2 de 7
Cadastro de Issues no java.net
Logo abaixo, podemos rapidamente cadastrar uma issue de um determinado tipo. Os
disponíveis são: Defect, Patch, Task, Feature e Enhancement. Fora isto nesta tela
podemos emitir alguns relatórios e consultar nossas preferências.
Para o nosso exemplo iremos clicar no link “Task”, para cadastrar uma nova tarefa para o
projeto RSJUG.
2. Cadastrando uma issue (Task)
Iremos cadastrar uma issue do Tipo Task. Na Figura 3 verificamos a tela existente para
cadastro. No topo da tela temos alguns links para cadastrar uma nova issue, consultas,
relatórios, consultar tarefas direcionadas ao seu usuário (My Issues), e links para edição
de opções de configuração.
Iremos incluir uma tarefa para a criação de um artigo sobre cadastro de Issues. Da tela de
cadastro, temos os seguintes campos visíveis:
– Reporter: usuário que está cadastrando a tarefa;
RSJUG.ORG
Artigo
Versão 1.0
Página 3 de 7
Cadastro de Issues no java.net
–
Component: em que componente do projeto está sendo cadastrada a tarefa. No caso o
projeto tem apenas um componente, “rsjug”;
–
Found in version: se o projeto possuir controle de versão (isto vai ser melhor visto em
projetos de software) podemos selecionar a versão em que encontramos o bug ou a
versão em que deve ser implementada a tarefa. No caso iremos utilizar “current”;
–
SubComponent: podemos pensar nesta seleção como sendo módulos de uma
aplicação ou de um projeto. No caso do RSJUG, temos subcomponentes como: artigos,
comunicação, eventos, marketing, ong, parcerias, projetos, reuniões e www. Irei
selecionar “artigos” para esta tarefa.
–
Platform: Considerando um projeto de software que executa em diversas arquiteturas,
podemos aqui indicar em qual destas arquiteturas o problema está relacionado.
Deixamos marcado aqui o “other”, já que a nossa tarefa não está relacionada a uma
arquitetura.
–
OS: Seleção do sistema operacional relacionado a nossa tarefa. Vamos selecionar
“other” para esta seleção.
–
Priority: Muito importante esta opção. Podemos aqui identificar um valor entre P1 e P5,
onde P1 indica uma tarefa muito importante e P5 uma menos importante. Vamos
colocar “P1” para indicar a importância da Issue.
–
Issue Type: são os tipos disponíveis para uma determinada tarefa, que pode ser um
processo (task) ou então uma tarefa de defeito (defect), uma correção (patch), uma
nova característica (feature) ou uma melhora em alguma tarefa (enhancement).
–
Assigned to: que usuário do java.net deve resolver este problema? Existe um link,
“lookup users” que abre uma tela com o nome dos usuários do projeto em questão, no
caso o projeto RSJUG. A forma mais automatizada para associar um usuário é dar um
duplo clique no nome do usuário e arrastar a seleção para dentro da caixa de texto
Assigned to. Irei selecionar “dwildt” para esta tarefa;
–
CC: que outros usuários estão envolvidos com esta tarefa? É possível indicar mais de
um usuário colocando uma virgula separando os nomes de usuários do java.net. Irei
selecionar outros nomes de usuários do projeto, envolvidos com a parte de
comunicação (que vai divulgar a existência deste artigo) e web (que vai publicar o
mesmo no site do RSJUG). Vou escrever na caixa “atechio, franklin_samir”.
–
URL: possibiliade de indicar um endereço internet para auxiliar no trabalho a ser
realizado. No caso de um erro e no caso de ser um sistema web, se pode indicar a URL
onde o erro foi detectado por exemplo. No nosso estudo de caso, iremos colocar o
caminho do site do RSJUG, na sua parte dedicada a artigos, com o valor
“http://www.rsjug.org/artigos.do”;
–
Summary: Um título para a tarefa, uma descrição para identificar a utilidade da tarefa.
Vou indicar neste campo “Artigo sobre cadastro de issues java.net”;
RSJUG.ORG
Artigo
Versão 1.0
Página 4 de 7
Cadastro de Issues no java.net
–
Description: A descrição da nossa tarefa. Vou indicar o seguinte: “Criar um artigo rápido
sobre o cadastro de tarefas do java.net indicando em que opção entrar e a utilidade de
cada campo a ser informado”.
Feito o cadastro destes campos, selecionamos o botão “Submit Issue”, para submeter a
tarefa. Os outros botões disponíveis são “reset” para limpar os valores dos campos (não
recomendo o teste depois de ter preenchido todos os campos :-)), e “Remember Values as
bookmarkable template”, para que os valores preenchidos sejam gravados em cookies.
Desta forma, quando entrarmos uma nova issue, os valores preenchidos agora já serão
inicializados nos campos.
Pressionado o botão “Submit Issue”, é retornada a Figura 4, que indica que a issue 45 do
projeto RSJUG foi criada. Agora sempre que quisermos atualizar um status para esta
tarefa, vamos poder procurar a mesma pelo código 45 ou através de filtros com os valores
que preenchemos (sumário, descrição, etc.).
3. Atualizando o Status de uma Issue
Vamos entrar no link que é mostrado na Figura 4, “Go back to issue # 45”, para podermos
editar a Issue recém criada.
Na tela que vai se abrir é assunto para outro artigo, mas vou citar aqui apenas o trabalho
de edição de três recursos desta tela:
–
Create a new attachment: É a possibilidade de criar um anexo para a tarefa. Pode ser
um screenshot de tela, ou no nosso caso, pode ser um pacote com o artigo pronto para
ser publicado. Importante: antes de usar este link disponibilizado, submeta a tarefa,
caso tenha preenchido algum comentário ou tenha modificado alguma informação da
task;
–
Additional Comments: É um campo onde podemos indicar um parecer para a tarefa.
Exemplo, “artigo criado com as seguintes seções...”, ou um status indicando que “o
artigo está terminado e está sendo anexado em seguida a tarefa”;
–
Status da tarefa: Abaixo do controle para adição de comentários para a tarefa, temos a
possibilidade de trocar o status de uma tarefa. Ela foi criada e estava como “NEW”, e
então podemos passar ela para “STARTED”. Ou então caso a tarefa esteja resolvida,
podemos colocar um status de resolvida para ela como “FIXED”. Depois de “FIXED” ela
pode ser trocada para “CLOSED”, por exemplo. Para ter uma relação completa sobre
isto, acesse o link em inglês até que algum colaborador traduza o link ou monte um
artigo para auxiliar outros usuários brasileiros do java.net. Link:
https://rsjug.dev.java.net/nonav/scdocs/issue_lifecycle.html;
RSJUG.ORG
Artigo
Cadastro de Issues no java.net
Figura 3Tela de Cadastro de Issue
Versão 1.0
Página 5 de 7
RSJUG.ORG
Artigo
Versão 1.0
Página 6 de 7
Cadastro de Issues no java.net
Figura 4Após o cadastro da Issue
Conclusões
O objetivo do nosso artigo foi mostrar de forma rápida como fazer o cadastro de uma issue
em um projeto java.net. Como foi dito existem alguns documentos em inglês do próprio
java.net com informações similares ou até mais completas que as inseridas neste artigo.
O que eu espero é que outros colaboradores do RSJUG procurem o grupo para a criação
de outros artigos para apoiar a nossa comunidade. Artigos sobre o java.net ou sobre
tecnologias de interesse da nossa comunidade.
Bibliografia
–
–
Portal java.net, disponível em http://www.java.net
Documento sobre criação e modificação de Issues do portal java.net, disponível em
https://rsjug.dev.java.net/scdocs/ddIssues_EnterModify.html
RSJUG.ORG
Artigo
Versão 1.0
Página 7 de 7
Cadastro de Issues no java.net
–
–
Documento com o ciclo de vida de uma Issue do portal java.net, disponível em
https://rsjug.dev.java.net/nonav/scdocs/issue_lifecycle.html
Portal de artigos do RSJUG, disponível em http://www.rsjug.org/
Sobre autor
Daniel Wildt ([email protected]) detém os títulos de JBuilder Certified
Instructor e JBuilder Certified Developer pela Borland. Atua pela Bluestar Technology,
parceira Borland nos estados do RS e DF (http://www.bluestar.inf.br) com consultoria e
treinamentos oficiais em produtos Borland. É coordenador do Grupo de Usuários Java do
RS, o RSJUG (www.rsjug.org), cuidando da área de parcerias e comunidade.