JUnit レポート マクロを挿入する

このマクロは新しいエディターから意図的に除外されており、従来のエディターから近日中に廃止されます。お知らせの詳細をご確認ください。

JUnit レポート マクロでは、Confluence Cloud サーバーでアクセス可能なディレクトリから JUnit テスト結果の要約を表示します。JUnit はユニット テスト フレームワークで、プログラマーが Java ソース コードの個々のユニットが正常に機能していることを確認できます。JUnit レポート マクロは、以下のスクリーンショットのように表示されます。

JUnit レポート マクロからレポートを生成する際は、Apache Ant フォーマッターを「XML」に設定します。

JUnit レポート マクロを使用する

JUnit レポート マクロを追加するには、次の手順に従います。

  1. 編集時には、ツールバーから を選択します。

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

既存のマクロを編集する方法

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

  3. パラメーターを設定します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (example)。

パラメーター

必須

既定

説明

テスト結果 XML ファイルの URL
(url

directory または url パラメータを含める必要があります

なし

特定のテスト結果 XML ファイルの URL。両方を使用している場合は、テスト結果 XML ファイルのディレクトリ (URL) が上書きされます。

Confluence インスタンスからの例: http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml

匿名ユーザー アクセスのない Confluence インストールの場合、URL パラメーター形式でこのパラメーターの一部としてログイン資格情報を指定できます。

  • os_username — JUnit テスト結果へのアクセス権限を持つ Confluence ユーザーのユーザー名。

  • os_passwordos_username パラメータで指定した Confluence ユーザーのパスワード。

テスト結果ファイルのディレクトリ (URL)
(directory

directory または url パラメータを含める必要があります

なし

テスト結果ファイルを含むディレクトリの URL。XML ファイル自体ではなく、ディレクトリ名にする必要があります。両方を使用している場合は、テスト結果 XML ファイルの URL が上書きされます。

例: file:///C:/TEMP/

ネットワーク ドライブでの例: http://*host*/*path*

レポートの詳細
(reportdetail

いいえ

すべて

レポートの詳細すべて固定概要 または failuresonly を使用できます。

デバッグ
(debug

いいえ

なし

障害の内容とともに、エラー メッセージを表示します。

Wiki マークアップ例

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名: junitreport

マクロ本文: なし。

ローカル ドライブから JUnit レポートをロードする:

1 2 3 4 {junitreport:directory=file:///C:/TEMP/}


ネットワーク ドライブから JUnit レポートをロードする:

1 2 3 4 {junitreport:url=http://*host*/*path*}


Confluence インスタンスから JUnit レポートをロードする:

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


認証が必要な Confluence Cloud インスタンスから JUnit レポートをロードする:

お使いの Confluence インスタンスが匿名ユーザーによるアクセスを許可していない場合、ログイン認証情報である os_username および os_password URL パラメーターを、マクロの url パラメーターの一部として指定します。ここでは、ユーザー名 "admin"、パスワード "secret" を指定しています。

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

 

その他のヘルプ