JUnit Report Macro

Confluence 서버가 액세스할 수 있는 디렉토리의 JUnit 테스트 결과 요약을 표시한다. 

 JUnit 은 프로그래머가 Java 소스 코드의 개별 단위가 올바르게 작동하도록 하는 단위 테스트 프레임 워크이다.

보안상의 이유로 JUnit 테스트 결과 파일은 Confluence 서버의 파일 시스템에서 지정된 위치에서만 가져올 수 있다. 

관리자가 Confluence 홈 디렉토리에 폴더를 생성하여, confluence.junit.report.directory 시스템 특성을 추가하고 가져올 JUnit 테스트 결과 파일의 위치를 지정할 것을 권장한다. 

JUnit 테스트 결과 파일은 이 시스템 특성이 설정 될 때까지 서버에서 가져올 수 없다.

JUnit Report 매크로는 아래의 스크린 샷과 같이 보여진다.

 

스크린 샷 : Confluence의 JUnit Report 매크로

참고 : JUnit Report 매크로에서 보고서를 생성 할 때 Apache Ant 포맷터를 'XML'로 설정

 

JUnit Report Macro 사용

JUnit Report Macro를 페이지에 추가하려면 :

  1. Confluence 편집기에서 삽입 > 다른 매크로 선택
  2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.

기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.

 

매개변수

매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션. 

Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example) 로 표시된다 .

 

매개변수

필수

기본값

설명

테스트 결과

XML 파일

URL 

(url

디렉토리 또는

url 매개 변수 포함

없음

특정 테스트 결과 XML 파일의 URL. 둘 다 사용하면 테스트 결과 파일 디렉토리 (URL) 매개변수로 대체된다.

Confluence 인스턴스의 예 : http://yourConfluenceInstance.com/download/attachments/<pageid>/file.xml

익명 사용자 권한이 없는 Confluence 설치의 경우, 로그온 매개변수를 URL 매개변수 형태로써 이 매개변수의 일부로 지정할 수 있다 :

  • os_username - JUnit 테스트 결과에 대한 접근 권한이 있는 Confluence 사용자의 사용자 이름
  • os_password- os_username 매개변수에 지정된 Confluence 사용자의 암호

테스트 결과 파일

디렉토리 (URL)

(directory

디렉토리 또는

url 매개 변수 포함

없음

테스트 결과 파일이 들어있는 디렉토리의 URL. 이 이름은 XML 파일 자체가 아닌 디렉토리 이름이어야 한다. 

둘 다 사용하면 테스트 결과 XML 파일 URL 매개변수를 무시한다.

파일의 예 : ///C:/TEMP/

네트워크 드라이브의 예 : http://*host*/*path*

보고서 세부 정보 
(reportdetail

No

all

보고서에 대한 세부 정보. allfixturesummary 또는 failures only 가능하다.

디버그(debugNo

없음

오류 메시지뿐만 아니라 오류의 내용도 표시

 

위키 마크 업 예제

이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용

매크로 이름 : junitreport

매크로 본문 :  없음

로컬 드라이브에서 JUnit 보고서 로드 :

{junitreport:directory=file:///C:/TEMP/}

네트워크 드라이브에서 JUnit 보고서 로드 :

{junitreport:url=http://*host*/*path*}

Confluence 사이트에서 JUnit 보고서 로드 :

{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml}

인증이 필요한 JUnit 보고서를 Confluence 사이트에서로드 :

익명 사용자가 Confluence 사이트에 접근할 수 없는 경우, (매크로의 url 매개변수의 일부로) os_username 및 os_password URL 매개변수를 사용하여 로그인 자격 증명을 지정. 

이 경우 사용자 이름은 'admin'이고 비밀번호는 'secret'로 지정된다.

{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml?os_username=admin&os_password=secret}