Page tree
Skip to end of metadata
Go to start of metadata

O 3layer Agile Plugin está sendo remodelado, e provavelmente vai ser incorporado ao projeto 3layer Moro.

Resumo

3layer Agile Plugin é uma extensão para o Atlassian Jira, que objetiva disponibilizar um tratador de eventos genérico para ações no Jira (como criação de tarefas, comentários, registros de trabalho, etc.), que possui capacidades de hotdeployment (adição, reconfiguração e alteração de tratadores de eventos) em runtime, isto é, sem precisar reiniciar o Jira para isso.

O 3layer Agile Plugin é um projeto de código aberto, e necessita de sua ajuda para crescer e melhorar.

Instalação

Para instalar o 3layer Agile Plugin, faça:

1. Baixe o último pacote Zip do projeto, em TODO.

2. Descompacte o arquivo, e coloque seu conteúdo conforme:

2.1 Arquivo treelayer-jira-plugin-xx.jar, no diretório de plugins externos do Jira, geralmente em JIRA_HOME/data/plugins/installed-plugins

2.2 Arquivo mammon-utils-xx.jar, no diretório padrão de bibliotecas do Jira, geralmente em JIRA_HOME/atlassian-jira/WEB-INF/lib

2.3 Arquivo agile.properties, no diretório de inicialização do Jira, geralmente em JIRA_HOME/bin

3. Reinicie o Jira (esta é a única vez, não se preocupe!)

4. Acesse o painel de administração do Jira, e verifique se o plugin 3layer Agile Plugin está habilitado. Esperamos que sim (wink)

5. Acesse o painel de administração do Jira, e no menu Listeners, adicione as seguintes informações e depois clique em OK:

5.1. Nome: 3layer Agile Plugin

5.2. Classe: br.org.treelayer.jira.plugin.AgileListener

6. Pronto, o plugin está instalado e pronto para uso.

Uso

O 3layer Agile Listenter é um tratador genérico de eventos do Jira, configurável em tempo de execução pelo arquivo agile.properties.

Ele é um arquivo de texto simples, com entradas que definem o tipo de evento a ser tratado no Jira, e uma lista separada por vírgula das ações a serem executadas. São as chamadas Actions.

Por padrão, o 3layer Agile Listener traz algumas ações padrões, listadas aqui TODO.

Porém, o real uso do 3layer Agile Listener é na criação de novas ações, conforme sua necessidade.

Por exemplo, supondo que você queria enviar um SMS para alguém toda vez que uma tarefa é criada no Jira, você poderia:

1. Criar uma nova ação como:

public class EnviarSmsAction extends br.org.treelayer.jira.plugin.AbstractAction {

  @Override
  protected Object executeImpl(JiraEvent event, Object... params) {
	MinhaClasseUtilitariaDeSms.enviarSMSPara("joao@compania.com.br", ((JiraEvent)event).getUser().getFullName() + " criou uma tarefa agora.");
  }
  
}

2. Empacotar essa ação em um arquivo .jar com o sufixo "Actions" (por exemplo, minhasActions.jar)

3. Colocar o arquivo .jar no diretório JIRA_HOME/bin.

4. Editar o arquivo agile.properties, habilitando a entrada que trata os eventos de criação de tarefas, como:

#Nao precisa ser o nome completo da action, mas garanta que não existem duas de mesmo nome no sistema!
event.issueCreated=EnviarSmsAction

5. Criar um arquivo com o mesmo nome da sua ação, mas com a extensão .properties (por exemplo, EnviarSmsAction.properties) e colocá-lo no diretório JIRA_HOME/bin. (Estamos trabalhando para retirar esse passo, mas por hora é necessário).

6. Criar uma nova tarefa no Jira e esperar seu SMS chegar (wink)

Status

O 3layer Agile Plugin está sendo remodelado, e provavelmente vai ser incorporado ao projeto Mizura.

Mais informações

Essa é uma visão básica do plugin 3layer Agile Listener.

Para informações avançadas e exemplos de integrações que ele possibilita, veja o Guia Do Usuário TODO.