Integração JIRA e TestLink via SOAP

Fala galera!

Semana passada tive a tarefa de integrar o TestLink recém instalado na empresa (Efetuei a sua instalação há 2 semanas) com o JIRA, responsável por controlar todos os incidentes internos, desde bugs em projetos de softwares, até reparos nas mesas e banheiros.

O ambiente a ser integrado possui uma particularidade muito interessante: O TestLink está na "nuvem", instalado em um domínio contratado pela área de Qualidade e hospeadado na Locaweb, enquanto o JIRA está instalado internamente, mas possui uma saída externa, para quem não está fisicamente no ambiente coorporativo.

Devido a restrições da área de infra-estrutura, não foi possível obter em qual servidor o JIRA está instalado, e por ventura as suas demais informações necessárias (nome do banco de dados, usuário e senha).

Neste momento descobri que a integração com o JIRA também é possível via SOAP (Web service) e por sinal é a única integração via SOAP disponível pelo TestLink (pelo menos nos arquivos encontrados na pasta testlink\cfg).

O arquivo responsável por esta integração é o jirasoap.cfg.php, composto pelos seguintes parâmetros (apenas aqueles que devem ser modificados):

/** The Username being used by JIRA logon */
define('BUG_TRACK_USERNAME', 'test');

/** The Password being used by JIRA logon*/
define('BUG_TRACK_PASSWORD', 'test');

/** link of the web server for JIRA*/
define('BUG_TRACK_HREF',"http://localhost:8080/");

/** path of JIRA WSDL */
define('BUG_TRACK_SOAP_HREF', "rpc/soap/jirasoapservice-v2?wsdl");

/** link of the web server for jira ticket*/
define('BUG_TRACK_SHOW_BUG_HREF', "browse/");

/** link of the web server for creating new jira ticket*/
define('BUG_TRACK_ENTER_BUG_HREF',"secure/Dashboard.jspa?os_destination=%2Fsecure%2FCreateIssue%21default.jspa");

Em uma rápida definição, cada campo deve ser preenchido com os seguintes dados:

BUG_TRACK_USERNAME - Usuário criado na base do JIRA e que possua permissão de leitura em todos os projetos. Aconselho a criação de um usuário genérico chamado 'Testlink' ou até mesmo 'guest';

BUG_TRACK_PASSWORD - Senha do usuário acima;

BUG_TRACK_HREF - Endereço de acesso ao Web service (ou de acesso ao JIRA, que no caso pode ser o endereço de IP por onde este é acessado);

BUG_TRACK_SOAP_HREF - Link específico de acesso ao SOAP - Dificilmente modificado;

BUG_TRACK_SHOW_BUG_HREF - Link para acesso aos projetos - Dificilmente modificado;

BUG_TRACK_ENTER_BUG_HREF - Link da página referente a abertura de bugs (Nova pendência).

Com o preenchimento destes campos e a substituição deste arquivo na pasta \cfg, foi necessário alterar o arquivo config.inc.php, na linha 299 (detalhe, estou utilizando a versão 1.9.2 do TestLink), para apontar qual bugtracker seria integrado ao TestLink.

No parâmetro $g_interface_bugs foi incluída a sintaxe 'JIRASOAP'. O arquivo foi salvo e substituído na raiz do Testlink do servidor.

Após isto, a integração TestLink e JIRA foi realizada com sucesso, bastando executar um rápido teste para ver se tudo estava dentro dos conformes.

1. Selecionar um caso de teste para ser executado e marcá-lo como "Com Falha:

Caso de Teste executado como "Com Falha" e o ícone para a inserção do Bug

2. Clicar no Botão "Gerenciamento de Casos":

Popup para a inserção do número do bug cadastrado no JIRA. Também é possível acessar o JIRA através do texto "Acesso ao Bugtracker"

A integração com o JIRA via SOAP foi estabelecida com sucesso e aprendemos mais um pouco de TestLink!

Aguardem novas postagens sobre o TestLink!

abraços!