Eggplant DAIでのSUT管理
Controller > SUTsから、Eggplant DAIでシステムアンダーテスト（SUT）の接続を管理し、リモートシステムでのテスト自動化を実現することができます。また、SUTと接続タイプの表示、追加、編集、削除もここで行うことができます。接続が追加、削除、または変更されると、SUTのリストは動的に更新されます。任意の時点で任意の数のSUTを接続することができます。
他のユーザーまたは進行中のテストランによって使用中のSUTはロックされていると表示されます。ロックされたSUTは、ロックが解除されるまで他の目的で使用することはできません。
以下の列が表示され、各SUT接続の詳細を一目で確認することができます：
- Name: SUTの表示名。
- Description: SUTの説明。
- Criteria Tags: 選択されたSUTに定義された基準タグ。SUTには複数の基準タグを持つことができます。
- Connection Types: SUT に定義された接続タイプ。次の接続タイプのうち 1 つ以上を持つことができます: VNC、RDP、WebDriver、Citrix、Sauce Labs ブラウザー、Sauce Labs デバイス、Android デバイス、iOS デバイス、単一システム。
- Status: SUTの可用性を示します。オプションは次の通り：Locked、Unlocked（利用可能）、Disabled。
Actionsメニュー
をクリックして、SUTとその関連接続タイプをEdit、Delete、またはUnlockします。
SUT名をクリックして、SUTの詳細を全て表示します。
Filter All をクリックして、All、Available、Locked、Disabled によってSUTの表示をフィルタリングします。
Eggplant DAIでSUTsを編集、削除、またはロック解除するためには、管理者権限が必要です。
SUT接続の追加
DAI Eggplant Cloud（以前はHosted DAIと呼ばれていました）を使用している場合、テスト実行中にCloud SUTsが自動的に割り当てられるので、手動でSUTを登録または追加する必要はありません。
Eggplant DAIでは、SUTに接続する方法を様々に定義することができます。Eggplant DAIは、デスクトップシステムとモバイルデバイス接続のテストにVirtual Network Computing（VNC）とRemote Desktop Protocol（RDP）接続を、Webブラウザ上のアプリ、Webアプリケーション、モバイルデバイスのオブジェクトベースのテストにWebDriverをサポートしています。また、Citrix StorefrontやSauce Labs BrowsersとSauce Labs Devicesへの接続もサポートしています。SUTに対して定義された接続は、SUTが**Controller > Runner**でテストを実行する際に自動的に確立されます。
新しいSUT接続を追加するには、以下の手順を実行します：
-
Controller > SUTs に移動します。
-
上部のメニューから、[+新しい SUT] をクリックします。
-
SUTの表示 Name と Description を入力して、既存のSUTリストで簡単に識別できるようにします。
-
タグ名を入力し、Enter を押すことで Criteria tags を追加します。テストで使用するSUTを選択するために、任意の数の基準タグを追加できます。
-
この SUT に使用する Execution Environment(s) をクリックしてリストから選択して追加します。実行環境名の特定の文字を入力することで、リストをフィルタリングできます。実行環境はいくつでも追加できます。このフィールドを空白のままにすると、テストの実行時に 使用可能な実行環境が SUT への接続に使用されます。Connection Type が Android Device、iOS Device、または Single System の場合、このフィールドは必須になります。フィールドが必須になると、1 つまたは複数の実行環境を選択できます。ただし、Connection Type が Single System の場合、選択できる実行環境は one だけです。
-
必要に応じて、Disable SUTのチェックボックスを選択します（オプション）。これにより、テストを実行する際にSUTが使用されるのを防ぎます。
-
Add Connection + をクリックして、SUTのための Connection Type を定義します。
-
次のオプションから Connection Type を選択します。
- RDP: RDP経由での接続を選択します。
- VNC: VNC経由での接続を選択します。
- WebDriver: Selenium WebDriverを使用した接続を選択します。
- Citrix: Citrixを使用した接続を選択します。
- Sauce Labs Browser: Sauce Labs Browserを使用した接続を選択します
- Sauce Labs Device: Sauce Labs Deviceを使用した接続を選択します。
- Android Device: Android Deviceを使用した接続を選択します。
- iOS デバイス: iOS デバイスを使用して接続する場合に選択します。
- シングルシステム: シングルシステムを使用した接続を選択します。
-
(任意) RDP、VNC、またはWebDriverを選択した場合、セカンダリ接続を追加するオプションが表示されます。
下記の参照セクションでは、各接続タイプを詳しく追加する方法を説明します。
注記SUTを作成するためには、プライマリ接続が必要です。 セカンダリ接続は任意です。 これらのルールに基づいて接続を定義できます。
- RDP がプライマリ接続の場合、セカンダリ接続は WebDriver のみになります。
- VNC がプライマリ接続の場合、セカンダリ接続は WebDriver のみになります。
- WebDriver がプライマリ接続の場合、セカンダリ接続は RDP または VNC のみになります。RDP または VNC が接続リストに追加されると、それがプライマリ接続になり、WebDriver がセカンダリ接続になります。
- Citrix、Sauce Labs Browser、Sauce Labs Device、Android Device、iOS Device、またはSingle System がプライマリ接続である場合、利用できるセカンダリ接続はありません。
-
Save and closeをクリックします。
新しく追加されたSUT接続は、SUTs タブに表示されます。
Step by Step: RDP接続詳細の入力
- Connection Type リストから
RDPを選択します。 - 接続したいSUTの IP address または Hostname を入力します。RDP接続はデフォルトでポート3389を使用しますが、必要に応じて変更できます。
- RDP接続の場合、Password および Username フィールドは、接続するWindowsユーザーアカウントを指します。この情報はRDP接続に常に必要です。
- RDPセッションウィンドウが開く Width および Height を指定します。
- Connection Types リストに接続詳細を保存するために Save connection をクリックします。
RDP接続を利用するためには、SUTが接続を受け入れるように設定されている必要があります。
RDP設定
| RDP設定 | 説明 |
|---|---|
| サーバー (IP アドレス、ホスト名) | SUT の IP アドレスまたはホスト名を入力します。 |
| ポート | SUT への接続に使用されるポート番号。 |
| ユーザー名 | Username: SUTに接続するRDP接続のユーザー名。 |
| パスワード | Password: SUTに接続するためのRDP接続のパスワード。 |
| 色深度 | (オプション) VNC セッションを開くときの色の深度。接続速度を上げるには、ドロップダウン リストで使用可能なオプションから低い深度を選択して色の深度を下げることができます。 - Default ネイティブ ディスプレイに表示されるのと同じ色深度で SUT を描画するには、これを選択します。 - Millions (32-bit): 人間の目には見えない数百万色で SUT の色深度を増やすには、これを選択します。 - 数千 (16 ビット): SUT の色深度を 65,536 色に減らすには、これを選択します。 - 256 (8 ビット): SUT の色深度を 256 色に減らすには、これを選択します。 - Width and Height: (Optional) は、RDP セッション ウィンドウを開く必要がある幅と高さです。 |
Step by Step: VNC接続詳細の入力
- Connection Type リストから
VNCを選択します。 - 接続したいSUTの IP address または Hostname を入力します。VNC接続はデフォルトでポート5900を使用しますが、必要に応じて変更できます。
- VNC接続の場合、Username および Password フィールドは、SUT上のVNCサーバーを指します。この情報がVNCサーバーに接続するために必要な場合は、ここに入力します。Windowsでは、Password フィールドにSSHキーを入力します。
- （任意）この接続に必要なSSH Settingsを追加します。
- Connection Types リストに接続詳細を保存するために Save connection をクリックします。
VNC設定
| VNC設定 | 説明 |
|---|---|
| サーバー (IP アドレス、ホスト名) | SUT の IP アドレスまたはホスト名を入力します。 |
| ポート | SUT への接続に使用されるポート番号。 |
| ユーザー名 | (オプション) SUT が接続する VNC 接続のユーザー名。 |
| (オプション) Sut が接続する Vnc 接続のユーザー名。 | (オプション) SUT が接続する VNC 接続のユーザー名。 |
| 色深度 | (オプション) SUT が接続する VNC 接続のユーザー名。 |
(オプション) SUT が接続する VNC 接続のユーザー名。
(オプション) Sut が接続する Vnc 接続のユーザー名
-
(オプション) Sut が接続する Vnc 接続のユーザー名。
-
接続する SUT の IP address または Hostname を入力します。WebDriver 接続のデフォルトはポート 4444 ですが、必要に応じて変更できます。
-
次のオプションから Browser を選択します：
- Chrome
- Firefox
- Safari
- Microsoft Edge
- Internet Explorer
- None
-
JSON形式を使用して、必要なWebDriver Capabilities をキーバリューペアとして追加します。
注記テストで上記の Browser ドロップダウンリストにリストされていないブラウザーを使用する場合は、None を選択し、Capabilities フィールドのキーバリューペアの1つとして
browserName: <your browser>を入力します。 -
Save connectionをクリックして、接続詳細をConnection Typesリストに保存します。
注記この SUT を使用するように設定された WebDriver デバイスは、テストの実行時に自 動的に接続されます。SenseTalk スニペットで WebDriver() 関数 を使用して、この接続にアクセスし、それに対してアクションを実行できます。
WebDriver設定
| WebDriver設定 | 説明 |
|---|---|
| サーバー (IP アドレス、ホスト名) | SUT の IP アドレスまたはホスト名を入力します。 |
| ポート | SUT への接続に使用されるポート番号。 |
| ブラウザ | (オプション) テスト用に SUT で起動するブラウザの種類。 |
| 性能 | (オプション) セッションでサポートされる機能を通信するために使用される有効な JSON ファイル。 |
Step by Step: Citrix接続詳細の入力
- Connection Type リストから
Citrixを選択します。 - Citrixアカウントの Username と Password を入力します。
- Storefront URL を入力します。例：
http://{server}/Citrix/{company name}。 - Application 名を入力します。
- (任意) Screenshot Interval を入力します。デフォルト値は
400ミリ秒です。 - ( 任意) 解像度の Width and Height を入力します。デフォルト値は
1600x900です。 - Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
セットアップの詳細については、Install Eggplant Functional and Citrix を参照してください。
Citrix接続のサポートは、Eggplant FunctionalのWindows版でのみ利用可能です。
Citrix設定
| Citrix 設定 | 説明 |
|---|---|
| ユーザー名 | Citrix SUT に接続するためのユーザー名。 |
| パスワード | Citrix SUT に接続するためのユーザー名のパスワード。 |
| ストアフロント URL | Citrix Storefront の URL。 |
| 応用 | Citrix で起動するアプリケーションまたはデスクトップの名前。 |
| スクリーンショット間隔 | (オプション) これは、Citrix フレーム バッファーの 2 つの後続のキャプチャ間の待機時間です。 |
| 幅と高さ | (オプション) Citrix ウィンドウを開く必要がある幅と高さ。 |
Step by Step: Sauce Labs Browser接続詳細の入力
- Connection Type リストから
Sauce Labs Browserを選択します。 - 使用する Sauce Labs アカウントの username と API キー を入力します。
- 利用可能なオプションから Data Center を選択します。
- Sauce Labsの資格情報と接続を検証するには、Check Connectionをクリックします。アカウントが正常に検証されると、より多くのSauce Labs設定が構成可能になります。
- Sauce LabsのSUTでテストするオペレーティングシステムのタイプを指定するには、利用可能なオプションからPlatform Nameを選択します。
- SUTで起動してテストするブラウザのタイプを指定するには、利用可能なオプションからBrowser Nameを選択します。
- （任意）SUTでテストする選択したブラウザのバージョンを指定するには、利用可能なオプションからVersionを選択します。バージョンが指定されていない場合、デフォルトでSauce Labsか ら利用可能な最新バージョンが使用されます。
- （オプション）テスト用に開きたいSUTウィンドウのサイズ（解像度）を指定するには、WidthとHeightを指定します。デフォルト値は
1024x768です。 - (任意) ブラウザーが起動する際にナビゲートしたい URL を入力します。
- （トンネルプロキシユーザー向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
- （トンネルプロキシユーザー向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Name名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Ownerを提供するまで、このフィールドは表示されません。
- Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
あなたのSauce Labs接続は3時間後に終了します。
サポートされているPlatform Name、Browser Name、およびVersionの詳細については、サポートされているブラウザ＆デバイスを参照してください。また、Tunnel OwnerおよびSauce Labsトンネルプロキシを使用したトンネルの詳細については、Sauce LabsのドキュメントのSauce Connect Proxiesを参照してください。
Sauce Labs Browser設定
| Sauce Labs ブラウザ設定 | 説明 |
|---|---|
| ユーザー名 | Sauce Labs アカウントのユーザー名。 |
| API キー | Sauce Labs アカウントの API キー。詳細については、Sauce Labs ユーザー設定 を参照してください。 |
| データセンター | テストが実行され、関連する成果物が保存される Sauce Labs サーバーの場所。 |
| 接続確認 | Sauce Labs アカウントと接続を検証し、より多くの Sauce Labs 構成オプションを有効にします。 |
| プラットフォーム名 | Sauce Labs SUT に使用するオペレーティング システム。 |
| ブラウザ名 | 起動してテストを実行するブラウザ (Chrome や Firefox など)。 |
| バージョン | (オプション) テストで使用するブラウザのバージョン。 |
| 幅と高さ | (オプション) Sauce Labs ブラウザーで開くウィンドウの解像度。サポートされている解像度の詳細については、Sauce Labs プラットフォーム構成 を参照してください。 |
| URL (オプション) | ブラウザの起動時に移動する Web サイトのアドレス。 |
| Tunnel Owner (トンネルプロキシユーザーに必須) | Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。Tunnel Owner を指定するまで、Tunnel Name フィールドは表示されません。 |
| Tunnel Name (トンネルプロキシユーザーに必須) | Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル名。Tunnel Owner を指定するまで、このフィールドは表示されません。 |
Step by Step: Sauce Labs Device接続詳細の入力
- Connection Type リストから
Sauce Labs Deviceを選択します。 - 使用する Sauce Labs アカウントの username と API キー を入力します。
- 利用可能なオプションから Data Center を選択します。
- Check Connection をクリックして、Sauce Labs アカウントと接続を検証します。Sauce Labs アカウントが正常に検証されると、構成のためにさらに多くの Sauce Labs 設定が表示されます。
- 利用可能なオプションから Platform Name を選択し、Sauce Labs SUT でテストするオペレーティング システムの種類を指定します。
- 使用可能なオプションから Device Name を選択し、テストするモバイル デバイスのタイプを指定します。
- (オプション) Sauce Labs デバイスで起動する App へのパスを入力します。指定しない場合、アプリは起動せずにデバイスが起動します。詳細については、Mobile App Storage.を参照してください。
- Tunnel Owner: (Tunnel proxy usersの場合は必須) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。 Tunnel Ownerを指定するまで、Tunnel Nameフィールドは表示されません。
- （tunnel proxy users向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
- Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
あなたのSauce Labsの接続は3時間後に終了します。
Sauce Labs Device設定
| Sauce Labsデバイス設定 | 説明 |
|---|---|
| ユーザー名 | Sauce Labs アカウントのユーザー名。 |
| API キー | Sauce Labs アカウントの API キー。詳細については、Sauce Labs ユーザー設定 を参照してください。 |
| Data Center: テストが実行され、関連するアーティファクトが保存される Sauce Lab サーバーの場所。 | |
| 接続確認 | Sauce Labs アカウントを検証し、さらに多くの Sauce Labs 構成フィールドを有効にします。 |
| プラットフォーム名 | デバイスのオペレーティング システムの名前。 |
| デバイス名 | モバイルデバイスの種類とバージョン。 |
| App | (オプション) テストするモバイル アプリを含む .ipa、.apk、.aab、または .zip ファイルへのパスを設定できます。 |
| Tunnel Owner (トンネルプロキシユーザーに必須) | Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。Tunnel Owner* を指定するまで、Tunnel Name フィールドは表示されません。DAI 接続でトンネル プロキシを使用するには、トンネル プロキシが実行されている必要があります。 |
| Tunnel Name (トンネルプロキシユーザーに必須) | Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル名。Tunnel Owner を指定するまで、このフィールドは表示されません。 |
サポートされている Platform name および Device name の詳細については、サポートされているブラウザーとデバイス を参照してください。 Tunnel Owner、Tunnel Owner、および Sauce Labs Tunnel ProxyでのTunnelの使用の詳細については、「Sauce Connect Proxy」を参照してください。 connect/) (Sauce Labs ドキュメント)。
Step by Step: Android Device接続詳細の入力
- Connection Type リストから
Android Deviceを選択します。 - Android Gateway UI にリストされている Android デバイスの Device ID を入力します。
- Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。
Androidデバイスへの接続についての詳細は、Connecting to Devices を参照してください。
Android Device設定
| Androidデバイス設定 | 説明 |
|---|---|
| デバイスID | シリアル番号、エミュレータ名。 |
Step by Step: iOS Device接続詳細の入力
- Connection Type リストから
iOS Deviceを選択します。 - iOS ゲートウェイ UI にリストされている iOS デバイスの UDID を入力します。
- (任意) Developer certificate name or thumbprint を入力します。
- Provisioning profile name or identifier を入力します。
- Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。
以前に選択したiOSデバイスに接続が設定されており、既存の開発者証明書がまだ有効である場合、Developer certificate name or thumbprint および Provisioning profile name or identifier に入力した値は無視されます。
iOSnbsp;ゲートウェイを使用した iOS デバイスへの接続の詳細については、 iOS Devices を参照してください。
iOS Device接続設定
| iOSデバイスの設定 | 説明 |
|---|---|
| UDID | iOS デバイスの一意の識別子。 |
| 開発者証明書の名前または拇印 | (オプション) 開発者証明書へのパス。 |
| プロビジョニング プロファイル名または識別子 | プロビジョニング プロファイルへのパス。 |
ステップバイステップ: 単一システム接続の詳細の入力
- Connection Type リストから、「単一システム」を選択します。
- (オプション) Windows アカウントの Username と Password を入力します。
- (オプション) Windows 解像度の 幅 と 高さ を入力します。
- Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。
シングル システム SUT は、シングル システム接続を行う Eggplant Functional が実行されるマシンの子プロセスとして実行されます。この Eggplant Functional は、DAI 実行環境の一部です。したがって、これはそのマシンにログインするために使用する Windows アカウントです。接続を追加する ときにユーザー名とパスワードに資格情報を指定しないと、EPF がシングル システム SUT に接続したときに、ビューア ウィンドウにログイン画面が表示されることがあります。(シングル システム接続タイプは Windows でのみ使用できます。) さらに、幅と高さの資格情報を指定しないと、デフォルトの解像度である 1920 x 1080 が使用されます。
単一システム接続は、Windows サービスとして実行されている DAI 実行エージェントでは使用できません。実行エージェントをホストしているマシンは、単一システム SUT を開始するために Windows 子セッションを生成する必要がありますが、Windows サービスは非対話型セッション (バックグラウンドで実行) であるため、これは不可能です。
サポートされている環境とサポートされていない環境での使用例:
ユースケース 1 (サポートされていません): DAI 実行エージェントが Windows サービス モード (非対話型セッション) で起動され、エラーが発生して接続が失敗します。
ユースケース 2 (サポートされています): DAI 実行エージェントはターミナル (対話型セッション) を使用して起動され、接続が確立されます。
クラウド実行環境では、単一システム接続はサポートされていません。
SUT接続の編集
既存のSUT接続を編集するには：
- Controller > SUTs に移動します。
- 更新に興味のあるSUT接続を見つけ、 Actions メニューから Edit を選択します。
- ここで、SUT情報または接続の詳細を更新できます。
SUT接続の表示
既存のSUTの詳細を表示するには：
- Controller > SUTs に移動します。
- 表示したいSUT接続を見つけ、接続名をクリックします。
SUTがロックされている場合は、Status 列の鍵アイコンをクリックして解除します。
パスワードとAPIキーについて
パスワードとAPIキーは書き込み専用です。接続詳細を保存した後でパスワードやAPIキーに再度アクセスするこ とはできませんので、将来アクセスする必要がある場合はパスワードやAPIキーを別の安全な場所に保存しておく必要があります。
パスワードまたはAPIキーを追加または編集する際には、
トグルアイコンをクリックして、保存前に新しく入力されたパスワードまたはAPIキーの値を表示できます。