TestLink plugin for Redmine

1. はじめに

これは、RedmineでTestLinkの機能を利用するためのプラグインです。

2. 前提条件

本プラグインを使用するには、Redmineと同じWebサーバ（もしくはJavaScriptのAjax通信が可能なサーバ）に TestLinkを事前にインストールしておく必要があります。また、Redmineのプロジェクト名と同一のTestLinkのプロジェクトをあらかじめ作成しておく必要があります。

RedmineとTestLink共にCAS対応に設定しておくことを推奨します。 CASを使用しない場合は事前にTestLinkにログインしておく必要があります。

3. インストール

以下の手順でプラグインをインストールします。

本プラグインをRedmineの'vendor/plugins'フォルダにコピーします。
Redmineを再起動します。
Redmineの'Administration'の'Plugins'の画面にて、 'TestLink plugin for Redmine'の'Configure'を選択し、 'TestLink base path'に適切な値を設定します。
Redmineの'Administration'の'Roles and permissions'の画面にて、 'Testlink'の機能を利用するRoleを選択し、 'TestLink'にチェックを付けます。
Redmineの各プロジェクトの'Settings'のModulesにて'Testlink'にチェックを付けます。

4. ライセンス

GPL v2

5. 作者のテスト環境

Redmine 1.0.3 + Apache + Mongrel + CASプラグイン
TestLink 1.9 + CASパッチ
Windows XP SP3

注意：RedmineのCASプラグインはMongreでは動作しますが、FastCGIでは動作しないようです。

6. 機能

6.1 TestLinkタブ

Redmineのプロジェクト名と同一のTestLinkのプロジェクトの画面を表示します。

6.2 WiKi - linkto_testlinkマクロ

TestLinkタブの画面へのリンクを設定するマクロです。

    {{linkto_testlink(arg)}}

    Examples:
    {{linkto_testlink}} -- TestLink home
    {{linkto_testlink(reqSpecMgmt)}} -- requrement
    {{linkto_testlink(editTc)}} -- edit testcase
    {{linkto_testlink(editTc&edit=testcase&id=4)}}
    {{linkto_testlink(editTc&edit=testsuite&id=1)}}
    {{linkto_testlink(editTc&edit=testproject&id=1)}}
    {{linkto_testlink(executeTest)}} -- execute test
    {{linkto_testlink(executeTest&id=4&build_id=5)}}
    {{linkto_testlink(showMetrics)}} -- show metrics
    {{linkto_testlink(testplan&format=0&tplan_id=10)}} -- Test Plan Report
    {{linkto_testlink(testreport&format=0&tplan_id=10)}} -- Test Report
    {{linkto_testlink(resultsGeneral&format=0&tplan_id=10)}} -- General Test Plan Metrics
    {{linkto_testlink(resultsByTesterPerBuild&format=0&tplan_id=10)}} -- Results by Tester per Build
    {{linkto_testlink(tcAssignedToUser&format=0&tplan_id=10)}} -- Test Case Assignment Overview
    {{linkto_testlink(resultsMoreBuildsGUI&format=0&tplan_id=10)}} -- Query Metrics
    {{linkto_testlink(resultsTC&format=0&tplan_id=10)}} -- Test result matrix
    {{linkto_testlink(f&format=0&tplan_id=10)}} -- Failed Test Cases
    {{linkto_testlink(b&format=0&tplan_id=10)}} -- Blocked Test Cases
    {{linkto_testlink(n&format=0&tplan_id=10)}} -- Not run Test Cases
    {{linkto_testlink(testCasesWithoutTester&format=0&tplan_id=10)}} -- Test Cases without Tester Assignment
    {{linkto_testlink(charts&format=0&tplan_id=10)}} -- Charts
    {{linkto_testlink(resultsReqs&format=0&tplan_id=10)}} -- Requirements based Report
    {{linkto_testlink(uncoveredTestCases&format=0&tplan_id=10)}} -- Test Cases without Requirements Assignment
    {{linkto_testlink(testCasesWithCF&format=0&tplan_id=10)}} -- Test Cases with Custom Fields info
    {{linkto_testlink(testPlanWithCF&format=0&tplan_id=10)}} -- Test Plan with Custom Field info
    {{linkto_testlink(freeTestCases&format=0&tplan_id=10)}} -- Test Cases not assigned to Any Test Plan

6.3 WiKi - include_testlinkマクロ

TestLinkの画面をインラインフレームとして表示するマクロです。

TestLinkの'workframe'（右下のフレーム）を指定した場合は'workframe'を、そのほかの場合は'mainframe'（下のフレーム）の画面を表示します。

'height'を指定しない場合は、表示内容に高さを合わせます。

    {{include_testlink(arg[,height[,width]])}}

    Examples:
    {{include_testlink(editTc&edit=testcase&id=4)}} -- edit testcase
    {{include_testlink(editTc&edit=testsuite&id=1)}}
    {{include_testlink(editTc&edit=testproject&id=1)}}
    {{include_testlink(executeTest&id=4&build_id=5)}} -- execute test
    {{include_testlink(testplan&format=0&tplan_id=10)}} -- Test Plan Report
    {{include_testlink(testreport&format=0&tplan_id=10)}} -- Test Report
    {{include_testlink(resultsGeneral&format=0&tplan_id=10)}} -- General Test Plan Metrics
    {{include_testlink(resultsByTesterPerBuild&format=0&tplan_id=10)}} -- Results by Tester per Build
    {{include_testlink(tcAssignedToUser&format=0&tplan_id=10)}} -- Test Case Assignment Overview
    {{include_testlink(resultsMoreBuildsGUI&format=0&tplan_id=10)}} -- Query Metrics
    {{include_testlink(resultsTC&format=0&tplan_id=10)}} -- Test result matrix
    {{include_testlink(f&format=0&tplan_id=10)}} -- Failed Test Cases
    {{include_testlink(b&format=0&tplan_id=10)}} -- Blocked Test Cases
    {{include_testlink(n&format=0&tplan_id=10)}} -- Not run Test Cases
    {{include_testlink(testCasesWithoutTester&format=0&tplan_id=10)}} -- Test Cases without Tester Assignment
    {{include_testlink(charts&format=0&tplan_id=10)}} -- Charts
    {{include_testlink(resultsReqs&format=0&tplan_id=10)}} -- Requirements based Report
    {{include_testlink(uncoveredTestCases&format=0&tplan_id=10)}} -- Test Cases without Requirements Assignment
    {{include_testlink(testCasesWithCF&format=0&tplan_id=10)}} -- Test Cases with Custom Fields info
    {{include_testlink(testPlanWithCF&format=0&tplan_id=10)}} -- Test Plan with Custom Field info
    {{include_testlink(freeTestCases&format=0&tplan_id=10)}} -- Test Cases not assigned to Any Test Plan

6.4 WiKi - iframe_testlinkマクロ