Issue Tracking Mantis + Eclipse Mylyn

Mantis + Eclipse 3.3 Mylyn

참고 :

http://djhyun.springnote.com/pages/374939

http://www.mantisbt.org/

Mantis 를 설치한다.(설치는 생략)

Eclipse Mylyn 은 기본적으로 Bugzilla Connector 만 있으므로 Mantis Connector 을 설치해준다.
 

Mantis 서버쪽 설치.

우선 Mantis 서버쪽에 WebService API 가 존재해야 한다. Mantis 최신버전에서는 자동으로 설치될지 모르겠지만,
기존 Mantis 에서는 설치해줘야한다.

우선 Mantis 설치디렉토리로 가서 mc/mantisconnect.php 라는 파일이 있는지 살펴본다. 경로는 조금 틀릴 수도 있다.
없다면, 다운로드 받아서 설치한다.
http://sourceforge.net/project/showfiles.php?group_id=189858
참고로 Mantis Connector 은 Mantis 1.0.5 이상의 버전에서 작동이 확인되었다.

mantisconnect_SNAPSHOT-2007-03-08.zip 을 다운로드 받아서 압축을 풀면
webservice 라는 폴더하나가 있다. 그안에 doc, mc 라는 두개의 폴더가 있다.
mc 폴더만 Mantis 설치 디렉토리로 옮긴다.(이상 설치끝)
확인하기 위해
http://your.domain.com/mc/mantisconnect.php
를 호출해 본다.

한글을 설정하기 위해 추가적으로 mc/mantisconnect.php 파일을 연다.
http://www.futureware.biz/mantis/view.php?id=337 (참고)

1. 
   $l_oServer->xml_encoding = "UTF-8";
   $l_oServer->soap_defencoding = "UTF-8";
   $l_oServer->decode_utf8 = false;

코드를

1. 
   # create server
   $l_oServer = new soap_server();

부분 아래에 추가한다. 저장한다.

이클립스 플러그인 설치.

Eclipse 에서 Help->software updates->Find and Install...
을 눌러 창이 뜨면,
Search for new features to install 선택하고 다음
New Remote Site 을 눌러
다음 URL 을 입력한다.
http://mylyn-mantis.sourceforge.net/eclipse/update

다음을 눌르고

업데이트가 되고 설치가 완료되면 이클립스를 재구동한다.

Windows->Show view->Other
선택창에서
+Mylyn 의 Task Repositories를 선택해서 뷰가 보이게 한다.

마우스 오른쪽을 눌러 팝업메뉴에서 Add Task Repository

Mantis (supports connector 0.0.5 or 1.1.0a4 or greater only) 를 선택하고 Next
Server: http://your.domain.com/mc/mantisconnect.php
Label : Mantis Connector (아무이름이나...)
User ID: 맨티스 아이디 입력
Password : 맨티스 암호 입력

Validate Settings 을 눌러 체크.(이것이 성공여부는 아이디 암호 인증 여부와 상관이 없다.)

추가하면 자동으로 Query 를 추가하겠느냐고 물어보는데,
Yes 를 선택

경우에 따라서는 에러가 나서 진행이 안될 수 있다.
이때는 아이디/암호 및 서버 주소를 다시 확인한다.
그래도 안될때에는

http://sourceforge.net/forum/forum.php?thread_id=1812130&forum_id=667505 (참고)

PHP 에러 리포팅 설정을 조정한다.

php.ini 파일의 error_reporting 을 조정해서 warning 은 표시되지 않게 한다.

1. 
   error_reporting =E_ALL & ~E_NOTICE

에러가 나지 않고 진행이 된다면

이렇게 세가지 입력 항목이 생겨야 하며, 아래 두가지 입력필드에서는 반드시 선택할 목록이 나타나야한다.

세가지가 다 나타난다면, 타이틀을 입력하고
프로젝트를 선택한다.(프로젝트가 나타나지 않는다면 뭔가 문제가 있는 것이다.)
프로젝트를 선택하면 그 아래 Filter 선택부분에 필터들이 채워지게 되고 필터를 선택할 수 있게 된다.
(필터에 아무목록이 없다면 Next 로 진행이 안된다.)

1. 프로젝트가 나타나지 않을 경우, 나의 경우 사용자 암호가 틀려서 프로젝트 목록을 가져오지 못했다.
   원인을 좀더 쉽게 분석하기 위해 SOAP UI 라는 툴을 사용해서 직접 SOAP 호출을 해볼 수 있다.
   http://www.soapui.org/ 에서 무료버전을 JNLP 버전으로 바로 실행할 수도 있다.
   
   실행하다음 File->New WSDL Project 를 선택해서
   Project Name : 아무거나
   initial WSDL : http://your.domain.com/mc/mantisconnect.php?wsdl
   
   을 입력하면 모든 요청을 테스트 할 수 있게 된다.
   
   mc_projects_get_user_accessible 을 호출해 보라(이것은 프로젝트 목록을 가져올때 사용된다.)
   의 하위 노드를 열어
   request1 을 더블클릭하면 다음과 같이 나온다.
   
   <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:man="http://futureware.biz/mantisconnect">
      <soapenv:Header/>
      <soapenv:Body>
         <man:mc_projects_get_user_accessible soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <username xsi:type="xsd:string">?</username>
            <password xsi:type="xsd:string">?</password>
         </man:mc_projects_get_user_accessible>
      </soapenv:Body>
   </soapenv:Envelope>
   
   username, password 부분에 mantis 계정 정보를 입력하고 화면 좌상단의 |> 아이콘을 눌러 요청을 보내본다.
   결과가 제대로 나온다면 문제가 SOAP 요청에는 문제가 없다. 아니라면 뭔가 문제가 있다. 암호가 틀렸거나 아이디가 틀렸거나 권한이 없던가...등등.

    

2. 프로젝트 목록은 나오나 필터목록이 안나올 경우, 우선 SOAP 로 다음을 호출해본다.
   
   다음 mc_filter_get 을 호출해보라. project_id 는 mc_projects_get_user_accessible 에서 얻은 값 중 하나를 넣어 호출한다.
   
   <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:man="http://futureware.biz/mantisconnect">
      <soapenv:Header/>
      <soapenv:Body>
         <man:mc_filter_get soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <username xsi:type="xsd:string">?</username>
            <password xsi:type="xsd:string">?</password>
            <project_id xsi:type="xsd:integer">?</project_id>
         </man:mc_filter_get>
      </soapenv:Body>
   </soapenv:Envelope>
   
   필터가 하나라도 나오면 된다.
   
   안나온다면, 필터를 하나 만들어 준다. 관리자 계정으로 Mantis 에 들어가거나 자신의 계정으로 들어가거나. "버그보기" 메뉴로 가서 "현재 필터 저장"
   을 해서 필터를 하나 만든다.
   
   다시 SOAP API 를 호출해본다. 방금 저장한 필터가 나와야 한다.
   
   필터가 나온다면 Eclipse 에서 다시 Add New Query 를 해서 필터목록에 나오는지 확인 (안나온다면 이클립스를 재구동해본다.)
   나온다면 필터를 선택하고 Finish 를 누름.
   
   이제 Task List 에 추가한 쿼리로 이슈목록을 가져올 것이다.