| Nota |
|---|
O 3layer Agile Plugin está sendo remodelado, e provavelmente vai ser incorporado ao projeto 3layer Moro. |
Resumo
| Extrair |
|---|
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 
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:
| Bloco de código |
|---|
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
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.