Xray 統合

Xray とは？

Xray は、テストの計画、設計、実行、およびテストレポートの生成を可能にします。Xray はこのプロセスに特定の Jira 課題タイプを使用します。

Xray 統合が必要な理由

Xray 統合により、Testim のテストを Xray のテストケースにリンクできます。Testim でテストを実行すると、テスト結果が自動的に Xray の実行結果に表示され、Testim と Xray で実行されたテストを一元的に表示できます。

Xray 統合の設定

Xray 統合を使用する前に、Testim を Xray プロジェクトに接続する必要があります。このプロセスは一度だけ必要です。統合を実行するには、以下が必要です：

• Jira API トークン - Jira API トークンを取得するには、https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/の手順に従ってください。
• Xray クライアント ID と Xray クライアントシークレット - Xray クライアント ID とクライアントシークレットを取得するには、https://docs.getxray.app/display/XRAYCLOUD/Global+Settings%3A+API+Keysの手順に従ってください。

→ Testim を Xray に接続するには:

1. Settings（設定） > Integrations（統合） タブに移動します。Test Management の下に様々な統合

モジュールがあります。

2. Xray 統合モジュールで、login（ログイン） をクリックします。

3. Jira API トークン、Xray クライアント ID、Xray クライアントシークレット フィールドに、取得した認証情報を貼り付けます（上記の導入部分を参照）。
4. Jira ユーザー名 と Jira URL を追加します。

5. Connect（接続） をクリックします。
   この時点で、Testim は Xray のプロジェクトに関連付けられましたが、特定のテストにはマッピングされていません。

6. Testim で、関連付けたい Xray プロジェクトをリストから選択します。

Testim のテストを Xray テストケースにマッピングする

Testim と Xray の統合を設定した後、Testim の特定のテストを Xray のテストにマッピングする準備が整います。 Testim のテストを Xray のテストにマッピングするには:

1. Testim で、マッピングしたいテストを開きます。
2. Testim のテスト内で、Setup ステップ（最初のステップ）の Properties（プロパティ） アイコンをクリックします。

3. Setup ステップの Properties（プロパティ） パネルで、Test in Xray の下で、最初のドロップダウンメニューから Xray プロジェクトを選択し、次に 2 番目のドロップダウンメニューから特定のテストを選択します。複数のテストケースをマッピングできます。

4. Save（保存） をクリックします。

テストの実行と Xray での Testim テスト結果の表示

Xray でテスト実行の結果を表示するには、リモートグリッドのみを使用して Testim でマッピングされたテストを実行する必要があります。Testim でマッピングされたテストを実行すると、テスト結果が関連する Xray プロジェクトのプロジェクトボードの「To Do」列の適切なテスト実行の下に表示されます。
実行の名前は “<Testim execution name><UTC time>” です。

関連する実行をクリックして、実行の詳細を取得します。

以下の詳細が Testim から Xray にプッシュされます：

• Name - Testim のテスト名
• Testim のテスト実行へのリンク
• Testim のテスト実行のコンソールログの URL（Web のみ）
• Testim のテスト実行のネットワークログの URL（Web のみ）
• Status - 実行のステータス。表示されるステータスは Xray ステータスで、Testim ステータスから以下のように変換されます（Testim > Xray）：

Xray でこれらのステータスを変更すると、統合が中断される可能性があります。