メインコンテンツまでスキップ
バージョン: DAI 25.2

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メニューActions menu iconをクリックして、SUTとその関連接続タイプをEdit、Delete、またはUnlockします。

SUT名をクリックして、SUTの詳細を全て表示します。

Filter All をクリックして、All、Available、Locked、Disabled によってSUTの表示をフィルタリングします。

注記

Eggplant DAIでSUTsを編集、削除、またはロック解除するためには、管理者権限が必要です。

SUT接続の追加​

注記

DAI Eggplant Cloud（旧称Hosted DAI）を使用している場合は、テスト実行中にCloud SUTが自動的に割り当てられるため、SUTを手動で登録または追加する必要はありません。

Eggplant DAIでは、SUTへの接続方法を様々な方法で定義できます。Eggplant DAIは、デスクトップシステムやモバイルデバイス接続のテストにVNC（仮想ネットワークコンピューティング）とRDP（リモートデスクトッププロトコル）接続、そしてWebブラウザ、Webアプリケーション、モバイルデバイス上のアプリのオブジェクトベーステストにWebDriverをサポートしています。また、Citrix Storefront、Sauce Labsブラウザ、Sauce Labsデバイスへの接続もサポートしています。SUTに対して定義された接続は、**Controller > Runner**でSUTを使用してテストを実行すると自動的に確立されます。

新しいSUT接続を追加するには、以下の手順を実行します：

  1. Controller > SUTs に移動します。

  2. 上部のメニューから、+New SUT をクリックします。

  3. SUTの表示 Name と Description を入力して、既存のSUTリストで簡単に識別できるようにします。

  4. タグ名を入力し、Enter を押すことで Criteria tags を追加します。テストで使用するSUTを選択するために、任意の数の基準タグを追加できます。

  5. この SUT に使用する Execution Environment(s) をクリックしてリストから選択して追加します。実行環境名の特定の文字を入力することで、リストをフィルタリングできます。実行環境はいくつでも追加できます。このフィールドを空白のままにすると、テストの実行時 利用可能な実行環境が SUT への接続に使用されます。Connection Type が Android Device、iOS Device、または Single System の場合、このフィールドは必須になります。フィールドが必須になると、1 つまたは複数の実行環境を選択できます。ただし、Connection Type が Single System の場合、選択できる実行環境は one だけです。 実行環境一覧

  6. 必要に応じて、Disable SUTのチェックボックスを選択します（オプション）。これにより、テストを実行する際にSUTが使用されるのを防ぎます。

  7. Add Connection + をクリックして、SUTのための Connection Type を定義します。

  8. 次のオプションから 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 デバイスを使用して接続する場合に選択します。
    • シングルシステム: シングルシステムを使用した接続を選択します。

  9. (任意) 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 がプライマリ接続である場合、利用できるセカンダリ接続はありません。

  10. Save and closeをクリックします。

新しく追加されたSUT接続は、SUTs タブに表示されます。

Step by Step: RDP接続詳細の入力​

  1. Connection Type リストから RDP を選択します。
  2. 接続したいSUTの IP address または Hostname を入力します。RDP接続はデフォルトでポート3389を使用しますが、必要に応じて変更できます。
  3. RDP接続の場合、Password および Username フィールドは、接続するWindowsユーザーアカウントを指します。この情報はRDP接続に常に必要です。
  4. RDPセッションウィンドウが開く Width および Height を指定します。
  5. Connection Types リストに接続詳細を保存するために Save connection をクリックします。
注記

RDP接続を利用するためには、SUTが接続を受け入れるように設定されている必要があります。

RDP設定​

RDP設定説明
サーバー (IP アドレス、ホスト名)SUT の IP アドレスまたはホスト名を入力します。
ポートSUT への接続に使用されるポート番号。
ユーザー名SUT が接続するための RDP 接続のユーザー名。
パスワードSUT が接続するための RDP 接続のパスワード。
色深度(オプション) VNC セッションを開くときの色の深度。接続速度を上げるには、ドロップダウン リストで低い深度オプションを選択して色の深度を下げることができます。
- デフォルト: SUT をネイティブ ディスプレイに表示されるのと同じ色深度で描画するには、これを選択します。
- 数百万 (32 ビット): これを選択すると、人間の目には見えない数百万色分、SUT の色深度を増やします。
- 数千 (16 ビット): これを選択すると、SUT の色深度が 65,536 色に減ります。
- 256 (8 ビット): これを選択すると、SUT の色深度が 256 色に減ります。
幅と高さ: (オプション)これは、RDP セッション ウィンドウを開く必要がある幅と高さです。

Step by Step: VNC接続詳細の入力​

  1. Connection Type リストから VNC を選択します。
  2. 接続したいSUTの IP address または Hostname を入力します。VNC接続はデフォルトでポート5900を使用しますが、必要に応じて変更できます。
  3. VNC接続の場合、Username および Password フィールドは、SUT上のVNCサーバーを指します。この情報がVNCサーバーに接続するために必要な場合は、ここに入力します。Windowsでは、Password フィールドにSSHキーを入力します。
  4. （任意）この接続に必要なSSH Settingsを追加します。
  5. Connection Types リストに接続詳細を保存するために Save connection をクリックします。

VNC設定​

VNC設定説明
サーバー (IP アドレス、ホスト名)SUT の IP アドレスまたはホスト名を入力します。
ポートSUT への接続に使用されるポート番号。
ユーザー名(オプション) SUT が接続する VNC 接続のユーザー名。
パスワード(オプション) SUT が接続するための VNC 接続のパスワード。
色深度(オプション) VNC セッションを開くときの色の深度。接続速度を上げるには、ドロップダウン リストで低いオプションを選択して色の深度を下げることができます。
- デフォルト: ネイティブ ディスプレイに表示されるのと同じ色深度で SUT を描画するには、これを選択します。
- 数百万 (32 ビット): 人間の目には見えない数百万色分、SUT の色深度を増やすには、これを選択します。
- 数千 (16 ビット): SUT の色深度を 65,536 色に減らすには、これを選択します。
- 256 (8 ビット): SUT の色深度を 256 色に減らすには、これを選択します。
- スケール比: VNC サーバーを各次元で 50 パーセント拡大するには、オプションを選択します。このオプションを選択すると、大画面または高解像度のモバイル デバイスを使用しているときにパフォーマンスが向上します。
- SSH 設定: (オプション) Secure Shell (SSH) は、データ暗号化を使用して情報を安全に転送するネットワーク プロトコルです。
- ホスト: SUT の安全な接続用の SSH トンネルをホストするコンピューターのホスト名または IP アドレス。
- ユーザー名: SUT ユーザーが SSH ホストにログインするときに使用するアカウント名。
- パスワード: SUT ユーザーが SSH ホストにログインするときに使用する パスワード。
注記

(オプション) SUT が接続する VNC 接続のユーザー名。

(オプション) Sut が接続する Vnc 接続のユーザー名​

  1. 接続タイプ リストから、WebDriver を選択します。

  2. 接続する SUT の IP address または Hostname を入力します。WebDriver 接続のデフォルトはポート 4444 ですが、必要に応じて変更できます。

  3. 次のオプションから Browser を選択します：

    • Chrome
    • Firefox
    • Safari
    • Microsoft Edge
    • Internet Explorer
    • None

  4. JSON形式を使用して、必要なWebDriver Capabilities をキーバリューペアとして追加します。

    注記

    テストで上記の Browser ドロップダウンリストにリストされていないブラウザーを使用する場合は、None を選択し、Capabilities フィールドのキーバリューペアの1つとして browserName: <your browser> を入力します。

  5. Save connectionをクリックして、接続詳細をConnection Typesリストに保存します。

    注記

    この SUT を使用するように設定された WebDriver デバイスは、テストの実行時に自動的に接続されます。SenseTalk スニペットで WebDriver() 関数 を使用して、この接続にアクセスし、それに対してアクションを実行できます。

WebDriver設定​

WebDriver設定説明
サーバー (IP アドレス、ホスト名)SUT の IP アドレスまたはホスト名を入力します。
ポートSUT への接続に使用されるポート番号。
ブラウザ(オプション) テスト用に SUT で起動するブラウザの種類。
性能(オプション) セッションでサポートされる機能を通信するために使用される有効な JSON ファイル。

Step by Step: Citrix接続詳細の入力​

  1. Connection Type リストから Citrix を選択します。
  2. Citrixアカウントの Username と Password を入力します。
  3. Storefront URL を入力します。例：http://{server}/Citrix/{company name}。
  4. Application 名を入力します。
  5. (任意) Screenshot Interval を入力します。デフォルト値は 400 ミリ秒です。
  6. (任意) 解像度の Width and Height を入力します。デフォルト値は 1600x900 です。
  7. Connection Types リストに接続詳細を保存するために Save Connection をクリックします。

セットアップの詳細については、Install Eggplant Functional and Citrix を参照してください。

注記

Citrix接続のサポートは、Eggplant FunctionalのWindows版でのみ利用可能です。

Citrix設定​

Citrix 設定説明
ユーザー名Citrix SUT に接続するためのユーザー名。
パスワードCitrix SUT に接続するためのユーザー名のパスワード。
ストアフロント URLCitrix Storefront の URL。
応用Citrix で起動するアプリケーションまたはデスクトップの名前。
スクリーンショット間隔(オプション) これは、Citrix フレーム バッファーの 2 つの後続のキャプチャ間の待機時間です。
幅と高さ(オプション) Citrix ウィンドウを開く必要がある幅と高さ。

Step by Step: Sauce Labs Browser接続詳細の入力​

  1. Connection Type リストから Sauce Labs Browser を選択します。
  2. 使用する Sauce Labs アカウントの username と API Key を入力します。
  3. 利用可能なオプションから Data Center を選択します。
  4. Sauce Labsの資格情報と接続を検証するには、Check Connectionをクリックします。アカウントが正常に検証されると、より多くのSauce Labs設定が構成可能になります。
  5. Sauce LabsのSUTでテストするオペレーティングシステムのタイプを指定するには、利用可能なオプションからPlatform Nameを選択します。
  6. SUTで起動してテストするブラウザのタイプを指定するには、利用可能なオプションからBrowser Nameを選択します。
  7. （任意）SUTでテストする選択したブラウザのバージョンを指定するには、利用可能なオプションからVersionを選択します。バージョンが指定されていない場合、デフォルトでSauce Labsから利用可能な最新バージョンが使用されます。
  8. （オプション）テスト用に開きたいSUTウィンドウのサイズ（解像度）を指定するには、WidthとHeightを指定します。デフォルト値は 1024x768 です。
  9. (任意) ブラウザーが起動する際にナビゲートしたい URL を入力します。
  10. （トンネルプロキシユーザー向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
  11. （トンネルプロキシユーザー向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Name名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Ownerを提供するまで、このフィールドは表示されません。
  12. 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接続詳細の入力​

  1. Connection Type リストから Sauce Labs Device を選択します。
  2. 使用する Sauce Labs アカウントの username と API Key を入力します。
  3. 利用可能なオプションから Data Center を選択します。
  4. Check Connection をクリックして、Sauce Labs アカウントと接続を検証します。Sauce Labs アカウントが正常に検証されると、構成のためにさらに多くの Sauce Labs 設定が表示されます。
  5. 利用可能なオプションから Platform Name を選択し、Sauce Labs SUT でテストするオペレーティング システムの種類を指定します。
  6. 使用可能なオプションから Device Name を選択し、テストするモバイル デバイスのタイプを指定します。
  7. (オプション) Sauce Labs デバイスで起動する App へのパスを入力します。指定しない場合、アプリは起動せずにデバイスが起動します。詳細については、Mobile App Storage.を参照してください。
  8. Tunnel Owner: (Tunnel proxy usersの場合は必須) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。 Tunnel Ownerを指定するまで、Tunnel Nameフィールドは表示されません。
  9. （tunnel proxy users向け必須）Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
  10. 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 Name、およびSauce Labsトンネル プロキシでのトンネルの使用の詳細については、Sauce LabsドキュメントのSauce Connect プロキシを参照してください。

Step by Step: Android Device接続詳細の入力​

  1. Connection Type リストから Android Device を選択します。
  2. Android Gateway UI にリストされている Android デバイスの Device ID を入力します。
  3. Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。

Androidデバイスへの接続についての詳細は、Connecting to Devices を参照してください。

Android Device設定​

Androidデバイス設定説明
デバイスIDシリアル番号、エミュレータ名。

Step by Step: iOS Device接続詳細の入力​

  1. Connection Type リストから iOS Device を選択します。
  2. iOS モバイルの固有デバイス ID (UDID) の取得 の説明に従って、リストされている iOS デバイスの UDID を入力します。
  3. (任意) Developer certificate name or thumbprint を入力します。
  4. Provisioning profile name or identifier を入力します。
  5. Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。
注記

以前に選択したiOSデバイスに接続が設定されており、既存の開発者証明書がまだ有効である場合、Developer certificate name or thumbprint および Provisioning profile name or identifier に入力した値は無視されます。

iOSデバイスへの接続の詳細については、 iOS モバイルデバイスを自動化用に設定するを参照してください。

iOS Device接続設定​

iOSデバイスの設定説明
UDIDiOS デバイスの一意の識別子。
開発者証明書の名前または拇印(オプション) 開発者証明書へのパス。
プロビジョニング プロファイル名または識別子プロビジョニング プロファイルへのパス。

ステップバイステップ: 単一システム接続の詳細の入力​

  1. Connection Type リストから、単一システムを選択します。
  2. (オプション) Windows アカウントの Username と Password を入力します。
  3. (オプション) Windows 解像度の Width と Height を入力します。
  4. 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接続を編集するには：

  1. Controller > SUTs に移動します。
  2. 更新に興味のあるSUT接続を見つけ、Actions menu icon Actions メニューから Edit を選択します。
  3. ここで、SUT情報または接続の詳細を更新できます。

SUT接続の表示​

既存のSUTの詳細を表示するには：

  1. Controller > SUTs に移動します。
  2. 表示したいSUT接続を見つけ、接続名をクリックします。
注記

SUTがロックされている場合は、Status 列の鍵アイコンをクリックして解除します。

パスワードとAPIキーについて​

パスワードと API キーは書き込み専用です。接続の詳細を保存すると、後でパスワードや API キーに再度アクセスできなくなります。そのため、将来アクセスする必要がある場合は、パスワードや API キーを別の安全な場所に保存する必要があります。

パスワードまたは API キーを追加または編集するときに、トグル アイコン トグル アイコンをクリックすると、保存する前に新しく入力したパスワードまたは API キーの値が表示されます。

に最終更新