インポート/エクスポートと同期
ここでは、インポート/エクスポート、および、同期について説明します。
はじめに、以下の図で、インポート/エクスポートによって、Ranorex Studio と TestRail 間の要素がどのようにマッピングされるかを確認してください。
| Ranorex Studio | Direction | TestRail |
|---|---|---|
| Solution | 🡘 | Project |
| Project with test suite | 🡘 | Test suite |
| Test case | 🡘 | Case |
| Smart folder outside a test case | 🡘 | Section |
| Smart folder inside a test case | 🡒 | Step |
| Module | 🡒 | Step |
インポート
インポートによって、TestRail プロジェクトのテスト スイートを、Ranorex Studio のソリューションにインポートできます。
Ranorex Studio の TestRail 連携ウィザードでインポートを選択し続行をクリックすると、以下のような画面が表示されます。
テスト スイートをインポートするには:
インポートする TestRail プロジェクトを選択します。
すべてのテスト スイートをインポート、または、選択したテスト スイートをインポートを選択します。後者の場合には、対象のテスト スイートを選択します。
Ranorex Studio プロジェクトで使用するプログラミング言語を選択します。
インポートをクリックします。
メモ
- すべてのタイプの TestRail プロジェクトがインポートできます。
- Ranorex Studio は、Automation Type が Ranorex に設定されている TestRail のテスト ケースのみをインポートします。その他のテスト ケースは無視されます。
- Ranorex Studio は、TestRail プロジェクトおよびテスト ケースの構造を、初回のインポート時にのみ作成します。以降は、⇢ 特定の変更のみが同期 されます。
- Step はインポートされません。
エクスポート
エクスポートによって、Ranorex ソリューションのテスト スイートを、TestRail のプロジェクトにエクスポートできます。
Ranorex Studio の TestRail 連携ウィザードでエクスポートを選択し続行をクリックすると、以下のような画面が表示されます。
テスト スイートをエクスポートするには:
エクスポート先の TestRail プロジェクトを選択します。新規または既存のプロジェクトを選択できます。新規プロジェクトの場合、Ranorex Studio は、Ranoerx ソリューションの名前を使用して、TestRail 上に新規のプロジェクトを自動的に作成します。
すべてのテスト スイートをインポート、または、選択したテスト スイートをインポートを選択します。後者の場合には、対象のテスト スイートを選択します。
エクスポートをクリックします。
メモ
- 複数の Ranorex テスト スイートを、単一の TestRail テスト スイート プロジェクト (Single repository および Single repository with baseline) にエクスポートすることはできません。TestRail プロジェクトを、複数のテスト スイート (multiple test suites) に変更するか、単一のテスト スイートのみで構成される Ranorex ソリューションを作成しなおす必要があります。
- Ranorex ソリューション、TestRail で複数のテスト スイートとして作成されます。Ranorex の各テスト スイートは、TestRail のテスト スイートとして再作成されます。
- Ranorex Studio は、Ranorex ソリューションおよびテスト ケースの構造を、初回のエクスポート時にのみ作成します。以降は、⇢ 特定の変更のみが同期 されます。
- モジュールは、Step としてエクスポートされます。
インポート/エクスポート後
TestRail プロジェクトのインポート/エクスポートが完了すると、Ranorex ソリューションが TestRail と接続されます。
- ソリューション内の接続済みの要素 (テスト スイート、テスト スイート内のテスト ケース/スマート フォルダー) には、TestRail アイコンが表示されます。テスト ケース/スマート フォルダーの説明の部分にもアイコンが表示され、ダブルクリックすることで、TestRail の該当ケースに移動します。
- Ranorex ソリューションに、TestRail 同期ファイルが作成されます。
- 同期機能が使用可能になります。
- 他の TestRail プロジェクトへのインポート/エクスポートはできません。新しい Ranorex ソリューションを作成するか、⇢ 現在のソリューションと TestRail との接続情報を削除 する必要があります。
TestRail 同期ファイル – TestRail.trsd
TestRail 同期ファイルには、Ranorex ソリューションと TestRail プロジェクト間の接続に関するすべての情報が記載されています。インポート/エクスポート後に作成され、ソリューションの Solution Items フォルダーに格納されます。
必須カスタム フィールド
TestRail に必須カスタム フィールドがある場合、Ranorex Studio はこれを認識し、結果をエクスポートまたはレポートする際に、デフォルト値を入力します。カスタム フィールドとそのデフォルト値は、TestRail.tsrd の “CaseFields” セクションに格納されます。これを編集することで、デフォルト値を変更できます。ただし、このセクション以外は変更しないでください。また、編集する前に対象のソリューションを閉じてください。開いたままの場合、変更が適用されません。
同期
テストをインポート/エクスポートすると、Ranorex Studio のツールバーに、同期ボタンが表示されます。
クリックすると同期が開始されます。現在接続中のテスト スイートのインポート/エクスポートを実行して、Ranorex および TestRail でおこなわれた変更を適用します。
同期される変更
- 新しいアイテムの追加
- スマート フォルダーとテスト ケースの変換 (TestRail に新しいケースが追加されます)
同期されない変更
- アイテムの削除 (ただし、Ranorex、TestRail いずれかでテスト ケースを削除すると、同期によってそれらの接続が解除され、TestRail では Automation Type が空に設定されます)
- アイテムの移動
- アイテムの名前の変更
Ranorex と TestRail は、異なる目的を達成するために異なる構造が必要とされるため、これらの変更を同期させないことで、作業やコラボレーションをより容易にします。
インポート/エクスポート、同期を使用するタイミング
インポート/エクスポートを使用するとき
- Ranorex/TestRail のいずれかからもう一方へ、初めてデータを転送したいとき
- 同じ TestRail プロジェクトまたはRanorex ソリューションから、テスト スイートを追加したいとき
同期を使用するとき
- Ranorex/TestRail のいずれかでおこなわれた変更にともない、インポート/エクスポート済みのテスト スイートを更新したいとき
TestRail との接続情報の削除
TestRail との接続情報は、以下のような方法で削除できます。
- ツール > TestRail 連携 > TestRail との接続の解除
- プロジェクト ビューで、TestRail.trsd を削除
- Windows エクスプローラーで、ソリューション フォルダーにある TestRail.trsd を削除