Mostraremos neste artigo um exemplo de como realizar o cadastro de uma Issue em um projeto existente no portal Java.net.

Transcrição

1 Introdução Página 1 de 7 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 ( 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. 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.

2 Página 2 de 7 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;

3 Página 3 de 7 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 ; Summary: Um título para a tarefa, uma descrição para identificar a utilidade da tarefa. Vou indicar neste campo sobre cadastro de issues java.net ;

4 Página 4 de 7 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:

5 Página 5 de 7 Figura 3Tela de Cadastro de Issue

6 Página 6 de 7 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. s sobre o java.net ou sobre tecnologias de interesse da nossa comunidade. Bibliografia Portal java.net, disponível em Documento sobre criação e modificação de Issues do portal java.net, disponível em

7 Página 7 de 7 Documento com o ciclo de vida de uma Issue do portal java.net, disponível em Portal de artigos do RSJUG, disponível em Sobre autor Daniel Wildt (daniel.wildt@bluestar.inf.br) 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 ( com consultoria e treinamentos oficiais em produtos Borland. É coordenador do Grupo de Usuários Java do RS, o RSJUG ( cuidando da área de parcerias e comunidade.