選択した TestRail ダッシュボードおよびメトリクスを Confluence などのアプリケーションに直接統合できます。統合の詳細、利用可能なページおよびパラメーター参照については、ダッシュボードとの統合の概要をご覧ください。このセクションでは、Confluence にダッシュボードを統合する方法を説明します。
Confluence インスタンスに HTTPS を使用している場合は、TestRail も HTTPS を使用する必要があり、参照先の URL は https:// で始まる必要があります。そうでなければ、ブラウザーは参照フレームをロードしません。
Confluence Cloud にダッシュボードを追加する
TestRail のいずれかのダッシュボードを Confluence に統合するには、Confluence の Iframe マクロを使用します。Iframe マクロを使用すると、TestRail が提供するページを簡単に Confluence に追加し、Confluence のネイティブな統計値と同様に表示できます。Confluence にマクロを追加するには、[追加] >[その他のマクロ] > [形式設定] > [Iframe] を選択します。
Confluence に TestRail のダッシュボード ページを最適な条件で統合するには、Iframe マクロのオプションを次のように設定することをお勧めします。
| オプション | 値 |
|---|---|
| URL | 統合アドレス (以下を参照) |
| Width | 100% |
| Height | 例： 1000 |
| Border | 0 |
利用可能な統合ページ
TestRail は、メトリクスとダッシュボードを Confluence に統合するためのページを提供します。追加のパラメーターおよびオプションについては、ダッシュボードとの統合の概要を参照してください。
| ダッシュボード | URL |
|---|---|
| メイン概要 | https://example.testrail.com/index.php?/ext/common/dashboard |
| プロジェクト概要 | https://example.testrail.com/index.php?/ext/common/projects/{project_id} |
Confluence Server にダッシュボードを追加する
残念ながら、Confluence Server には、外部ページを簡単に埋め込むための上記の Iframe マクロがありません。これは外部リソースを追加する最善で安全な方法であるため、Atlassian が Confluence Server にもこの機能を追加してくれることを望みます。よくお勧めされる回避策である HTML インクルードマクロは動作しません。HTML インクルードマクロは Iframe の代わりにサーバー側のインクルードを使用しますが、これは認証情報を TestRail に転送しないためです。
しかし、Confluence Server には、Iframe やその他の HTML スニペットを含めることができる代替物として HTML マクロがあり、これを有効化して利用できます。HTML マクロを有効にする方法については、マクロに関する Confluence のドキュメントを参照してください。ページに記載されているセキュリティ情報に注意してください。次のように Iframe マクロを追加することができます。
次の例のように、上記の統合 URL のいずれかを使用して Conframe に iframe を埋め込むことができます。
<iframe src=".." frameborder="0" width="100%" height="1000" scrolling="yes" seamless></iframe>
