Project

General

Profile

Actions

English

使用法

リンク対象の種別と ID を Wiki マクロで書くことによって TestLink の対象ページへのリンクを張ります。
(注) TestLink 側は自動ログインできる状態でないと上手く表示できません。

testlink(testcase) マクロ

Wiki 編集画面で次のように記述します。

    {{testlink(リンク対象, ID)}}
    {{testcase(ID)}}

リンク対象には対象を特定する識別名を記述します。
testcase マクロは case の識別名を省略したものです。

ID には対象の ID 番号を指定します。
記述する ID はテストケース以外のものはすこし分かりづらいので、テストケース以外の ID の取得法 を参考にしてください。

テスト結果を除いた使用できるリンク対象は以下のものです。テスト結果関連のものは次節を見てください。

識別名 リンク対象 備考
case テストケース
suite テストスウィート
project テストプロジェクト TestLink 1.8 以上
plan テスト計画
milestone マイルストーン
build ビルド情報
cfield カスタムフィールド
keyword キーワード情報
user ユーザ情報

  {{testcase(sample-1)}}
  {{testlink(case, sample-1)}}
  {{testlink(suite, 2)}}
  {{testlink(project, 1)}}
  {{testlink(plan, 5)}}
  {{testlink(milestone, 1)}}
  {{testlink(build, 1)}}
  {{testlink(cfield, 1)}}
  {{testlink(user, 1)}}

テスト結果へのリンク

TestLink の 1.8 以降ではテスト結果へのリンクが張れます。
テスト結果へのリンクは前節 testlink マクロでリンク対象にテスト結果の識別名を指定します。

    {{testlink(リンク対象, ID [, ...])}}
    {{testreport(ID, PlanID [, 出力項目, ...])}}

testreport マクロは report の識別名を省略したものです。

ID 以降の引数は識別名によって変わります。

テスト結果用のリンク対象は以下のものです。

識別名 リンク対象 備考
report テストレポート ID が 2 つ必要。引数にレポートの出力項目を指定可能。
planreport テスト計画レポート ID が 2 つ必要。引数にレポートの出力項目を指定可能。
metrics メトリクス
result テスト結果の表示 引数にステータスを指定可能
graph 結果のグラフ表示

report, planreport の場合、引数として ID を二つ(ID, PlanID)指定する必要があります。
また、その後にテスト結果の出力項目を指定することが出来ます。

指定可能な出力項目は以下のものです。

出力項目 説明 report planreport
toc 目次
header テストスイートの説明
summary テストケースの要約
body 本文
author テストケース作者
keyword テストケースに関連するキーワード
cfields テストケースに関連するカスタムフィールド
passfail 成功/失敗と備考
metrics メトリクス
testplan テスト計画の説明

出力項目を省略した場合には設定画面で設定した項目を出力します。

:

  {{testreport(2,6)}}
  {{testlink(report, 2, 6)}}
  {{testreport(2,6, header, summary, toc, body, cfields, passfail, metrics, author, keyword)}}
  {{testlink(planreport, 2, 6)}} 
  {{testlink(planreport, 2, 6, header, summary, toc, body, cfields, author, testplan, keyword)}}
  {{testlink(metrics, 6)}} 
  {{testlink(graph, 6)}}

result の引数

result の場合、 ID の後にテストケースのステータスを指定することでフィルタリングした出力が出来ます。
省略時にはすべて表示します。

ステータス 説明
f 失敗したテストケース
b ブロックされたテストケース
n 未実行のテストケース

:

  {{testlink(result, 6)}}
  {{testlink(result, 6, f)}}

ファイルダウンロード用リンクマクロ(testfile)

testfile マクロは MS Word 形式などでの出力ファイルへのリンクです。
(TestLink 1.8 以上)

Wiki 編集画面で次のように記述します。

{{testfile(フォーマット名, リンク対象, ID [, ...])}}

このマクロは引数の先頭にフォーマット名を指定することを除き、 testlink マクロと同一です。

フォーマットにより、指定可能な識別名が変わります。

フォーマット フォーマット名 指定可能なリンク対象の識別名
OpenOffice Writer odt report, planreport
OpenOffice Calc ods metrics, result
MS Word doc report, planreport
MS Excel xls metrics, result

:

  {{testfile(doc, report, 2,6)}}
  {{testfile(odt, planreport, 2, 6, header, summary, toc, body)}} 
  {{testfile(xls, metrics, 6)}} 
  {{testfile(ods, result, 6)}}
  {{testfile(ods, result, 6, n)}}

Updated by Mitsuyoshi Yoshida over 8 years ago · 7 revisions