インポート/エクスポートと同期

ここでは、インポート/エクスポート、および、同期について説明します。

はじめに、以下の図で、インポート/エクスポートによって、Ranorex Studio と TestRail 間の要素がどのようにマッピングされるかを確認してください。

インポート

インポートによって、TestRail プロジェクトのテスト スイートを、Ranorex Studio のソリューションにインポートできます。

Ranorex Studio の TestRail 連携ウィザードでインポートを選択し続行をクリックすると、以下のような画面が表示されます。

テスト スイートをインポートするには:

インポートする TestRail プロジェクトを選択します。
すべてのテスト スイートをインポート、または、選択したテスト スイートをインポートを選択します。後者の場合には、対象のテスト スイートを選択します。
Ranorex Studio プロジェクトで使用するプログラミング言語を選択します。
インポートをクリックします。

エクスポート

エクスポートによって、Ranorex ソリューションのテスト スイートを、TestRail のプロジェクトにエクスポートできます。

Ranorex Studio の TestRail 連携ウィザードでエクスポートを選択し続行をクリックすると、以下のような画面が表示されます。

テスト スイートをエクスポートするには:

エクスポート先の TestRail プロジェクトを選択します。新規または既存のプロジェクトを選択できます。新規プロジェクトの場合、Ranorex Studio は、Ranoerx ソリューションの名前を使用して、TestRail 上に新規のプロジェクトを自動的に作成します。
すべてのテスト スイートをインポート、または、選択したテスト スイートをインポートを選択します。後者の場合には、対象のテスト スイートを選択します。
エクスポートをクリックします。

インポート/エクスポート後

TestRail プロジェクトのインポート/エクスポートが完了すると、Ranorex ソリューションが TestRail と接続されます。

• ソリューション内の接続済みの要素 (テスト スイート、テスト スイート内のテスト ケース/スマート フォルダー) には、TestRail アイコンが表示されます。テスト ケース/スマート フォルダーの説明の部分にもアイコンが表示され、ダブルクリックすることで、TestRail の該当ケースに移動します。
• Ranorex ソリューションに、TestRail 同期ファイルが作成されます。
• 同期機能が使用可能になります。
• 他の TestRail プロジェクトへのインポート/エクスポートはできません。新しい Ranorex ソリューションを作成するか、⇢ 現在のソリューションと TestRail との接続情報を削除 する必要があります。

TestRail 同期ファイル – TestRail.trsd

TestRail 同期ファイルには、Ranorex ソリューションと TestRail プロジェクト間の接続に関するすべての情報が記載されています。インポート/エクスポート後に作成され、ソリューションの Solution Items フォルダーに格納されます。

同期

テストをインポート/エクスポートすると、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 を削除

TestRail communication error – invalid option

このエラーは、TestRail の必須カスタム フィールドにデフォルト値が設定されていない状態で、エクスポートまたは同期を実行した場合に発生します。

このエラーへの対応方法は2つあります。

方法 1: TestRail でカスタム フィールドを編集する

この方法は、この TestRail インスタンスと連携するすべてのユーザーで発生するエラーを解決します。しかしながら、カスタム フィールドを編集するための権限が必要です。

TestRail で対象のフィールドを探し、適切なデフォルト値を設定します。
Ranorex Studio でエクスポート/同期を実行します。

方法 2: TestRail同期ファイルを編集する

カスタム フィールドが編集できない、あるいは編集したくない場合には、別の方法として、TestRail.trsd 同期ファイルの、該当フィールドの値を編集する方法があります。この方法は、当該マシンで発生するエラーのみを解決します。他のマシンでは依然としてエラーが発生します。

プロジェクト ビューの Solution Items フォルダーにある、TestRail.trsd ファイルをダブルクリックします。
エラー メッセージが示しているカスタム フィールドを探します。
該当カスタム フィールドの Value パラメーターを適切な値に変更します。
ソリューションを保存し、エクスポート/同期を実行します。