TestLink日本語化

こんにちは、SundayWalkerです。

TestLink1.9が公開されて、不具合の対応もかなり進んでいるようです。

以前からTestLinkとRedmineは、非常に良いツールと思っており、２つのツールの連携がより強化できると良いと考えておりました。

両者の連携強化の第1弾として、先に公開したTestLink1.9beta6用のCASのパッチは、TestLink1.9でも利用できると思います。

両者の連携強化の第2弾として、RedmineでTestLinkの機能を利用するためのプラグインを作成してみました。 RubyとJavaScriptの初心者が作成しましたので、あまりできは良くありませんが何かの参考になれば幸いです。

以下に概要を示します。以下の内容はプラグインの中のReadme-jp.htmlファイルとほぼ同じです。

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マクロ

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

TestLinkの'mainframe'の画面を表示します。 'workframe'がある場合は、'treeframe'（左下のフレーム）と'workframe'（右下のフレーム）を表示します。

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

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

7. 既知の問題点等

* 本プラグインの問題ではなく、CASプラグインとCASパッチの問題として、 RedmineにCASを使用してログインした場合、 CASセッションがタイムアウトすると TestLinkがRedmineより先に検知し、ログアウトの状態になることがある。 この場合、一旦Redmineにてログアウトし、 Redmineにてログインを実施する必要がある。 Single Sign Outなどに対応すると良いのではないかと思われるが、 具体的な変更方法がわかっていない。

* TestLinkを直接使用する場合に比べ、本プラグインでTestLinkの画面を表示する場合、 TestLinkの3つのフレームがコンカレントではなくシリアルに読み込まれるため、 表示が完了するまでに時間がかかる。