domingo, 3 de julho de 2011

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!

10 comentários:

  1. Mario, vc trabalha com o Jira faz tempo, gostaria de algumas dicas para implantação e uso.

    ResponderExcluir
    Respostas
    1. Olá, Estou trabalhando com o Jira desde junho. Nunca fiz a sua implementação, apenas baixei o demo e instalei na máquina, não sei dizer se a instalação full é complicada ou não. O seu uso é tranquilo, se assemelha as demais ferramentas de bugtracker. Tenho conhecimentos mais profundos com o Mantis e posso dizer que ele é bem fácil de ser instalado e utilizado. Abraços!

      Excluir
  2. Bom dia, gostaria de saber como integrar o TestLink 1.9.6 com o Jira via SOAP.

    Na versão 1.9.6 não existe o arquivo jirasoap.cfg.php.

    Agradeceria muito quem pudesse me ajudar.

    Abraço!

    ResponderExcluir
    Respostas
    1. Boa tarde Anderson,

      Infelizmente ainda não tive tempo de instalar a última versão...Vou ficar te devendo desta vez!

      Sei que desde a versão 1.9.5 o TestLink alterou a configuração dos bugtrackers.

      Abraços.

      Excluir
  3. Há a possibilidade de integrar o Testlink na nuvem com o JIRA também na nuvem?

    ResponderExcluir
    Respostas
    1. Valdir, quando escrevi esta postagem, ambos os sistemas estavam na nuvem. O Testlink na localweb e o Jira no ambiente da empresa. E funcionou corretamente.

      Excluir
  4. Boa tarde, instalei a versão 1.9.3 do testlink, consigo integra-la com o JIRA?

    ResponderExcluir
  5. Mario, existe alguma integração do Mantis com o Jira?

    ResponderExcluir
    Respostas
    1. Até onde eu sei não, não uso o JIRA e o Mantis há mais de 4 anos...

      Excluir