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

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 Browser、Sauce Labs Device、Android Device、iOS Device。
  • 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 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接続を追加するには、以下の手順を実行します：

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

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

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

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

  5. リストからクリックして選択することで、このSUTに使用される Execution Environment(s) を追加します。実行環境の特定の文字を入力することでリストをフィルタリングできます。任意の数の実行環境を追加できます。このフィールドを空白のままにすると、テストが実行される際に利用可能な実行環境が使用されます。Connection Type が Android Device または iOS Device の場合、このフィールドは必須になります。

    Execution Environment list

  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 Device: iOS Deviceを使用した接続を選択します。

  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 がプライマリ接続の場合、セカンダリ接続は利用できません。

  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設定​

  • Server (IP Address, Hostname):* SUTのIPアドレスまたはホスト名を入力します。
  • Port: SUTに接続するためのポート番号。
  • Username: SUTに接続するRDP接続のユーザー名。
  • Password: SUTに接続するRDP接続のパスワード。
  • Color Depth: (Optional)* VNCセッションが開く色の深さ。接続の速度を上げるために、ドロップダウンリストから利用可能な低い深さを選択して、色の深さを減らすことができます。
    • Default: SUTのネイティブ表示と同じ色の深さでSUTを描画するために選択します。
    • Millions (32-bit): SUTの色の深さを人間の目には見えない数百万色に増やすために選択します。
    • Thousands (16-bit): SUTの色の深さを65,536色に減らすために選択します。
    • 256（8ビット）： これを選択して、SUTの色深度を256色に減らします。256 (8-bit): SUTの色の深さを256色に減らすために選択します。
  • Width and Height: (Optional) 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設定​

  • Server (IP Address, Hostname): SUTのIPアドレスまたはホスト名を入力します。

  • Port: SUTに接続するためのポート番号。

  • Username: (Optional) SUTに接続するVNC接続のユーザー名。

  • Password: (Optional) SUTに接続するVNC接続のパスワード。

  • Color Depth: (Optional) VNCセッションが開く色の深さ。接続の速度を上げるために、ドロップダウンリストから利用可能な低い深さを選択して、色の深さを減らすことができます。

    • Default: SUTのネイティブ表示と同じ色の深さでSUTを描画するために選択します。
    • Millions (32-bit): SUTの色の深さを人間の目には見えない数百万色に増やすために選択します。
    • Thousands (16-bit): SUTの色の深さを65,536色に減らすために選択します。
    • 256 (8-bit): SUTの色の深さを256色に減らすために選択します。

  • Scale Ratio: モバイルデバイスの大画面や高解像度を使用している場合にパフォーマンスを向上させるために、VNCサーバーを各次元で50パーセント縮小するオプションを選択します。

  • SSH Settings: (Optional) Secure Shell（SSH）は、データ暗号化を使用して情報を安全に転送するネットワークプロトコルです。

    • Host: SUTの安全な接続のためのSSHトンネルをホストするコンピューターのホスト名またはIPアドレス。
    • Username: SUTユーザーがSSHホストにログインする際のアカウント名。
    • Password: SUTユーザーがSSHホストにログインする際のパスワード。
    ノート

    RDP または VNC をプライマリ接続として、WebDriver をセカンダリ接続として追加すると、WebDriver のサーバーフィールドはデフォルトで無効になっていることがわかります。これを変更するには、RDP または VNC フィールドからサーバーフィールドを変更する必要があります。

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

  1. Connection Type リストから 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. Connection Types リストに接続詳細を保存するために Save connection をクリックします。

    ノート

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

WebDriver設定​

  • Server (IP Address, Hostname): SUTのIPアドレスまたはホスト名を入力します。
  • Port: SUTに接続するためのポート番号。
  • Browser: (Optional) テスト中にSUTによって起動されるブラウザーのタイプ。
  • Capabilities: (Optional) セッションでサポートされている機能を伝達するために使用される有効な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設定​

  • Username: SUTに接続するCitrixのユーザー名。
  • Password: SUTに接続するCitrixのパスワード。
  • Storefront URL: Citrix StorefrontのURL。
  • Application: Citrixで起動するアプリケーションまたはデスクトップの名前。
  • Screenshot Interval: (Optional) 2つの連続したCitrixフレームバッファのキャプチャ間の待機時間。
  • Width and Height: (Optional) Citrixウィンドウが開く幅と高さ。

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

  1. Connection Type リストから Sauce Labs Browser を選択します。
  2. 接続したいSauce Labsのアカウントの Username と API Key を入力します。
  3. 利用可能なオプションから Data Center を選択します。
  4. Check Connection をクリックして、Sauce Labs接続を検証します。Sauce Labsアカウントが正常に検証されると、より多くのSauce Labs設定が表示され、設定できます。
  5. 利用可能なオプションから Platform name を選択して、テストを実行するSUTのオペレーティングシステムを指定します。
  6. 利用可能なオプションから Browser name を選択して、SUTがテストのために起動するブラウザーのタイプを指定します。
  7. (任意) 利用可能なオプションから Version を選択して、選択したブラウザータイプのブラウザーバージョンを指定します。バージョンが指定されていない場合、デフォルトでSauce Labsから提供される最新のバージョンが使用されます。
  8. (任意) セッションウィンドウが開く Width と Height を指定します。デフォルト値は 1024x768 です。
  9. (任意) ブラウザーが起動する際にナビゲートしたい URL を入力します。
  10. Connection Types リストに接続詳細を保存するために Save connection をクリックします。
ノート

あなたのSauce Labs接続は3時間後に終了します。

サポートされている Platform name、Browser name、および Version についての詳細は、Supported Browsers & Devices を参照してください。

Sauce Labs Browser設定​

  • Username: SUTに接続するSauce Labsのユーザー名。
  • API Key: SUTに接続するSauce LabsのAPIキー。詳細については、Sauce Labsユーザー設定 を参照してください。
  • Data Center: テストが実行されるサーバーの場所と関連するアーティファクトが保存される場所。
  • Check Connection: Sauce Labsアカウントを検証し、より多くのSauce Labs設定を有効にします。
  • Platform name: Sauce LabsがSUTとして使用するオペレーティングシステム。
  • Browser name: テスト実行のためにSUTが起動するブラウザータイプ。
  • Version: (Optional)* テストで使用するブラウザーのバージョン。
  • Width and Height: (Optional) Sauce Labsブラウザーウィンドウが開く幅と高さ。サポートされる解像度についての詳細は、Sauce Labsプラットフォーム設定 を参照してください。
  • URL: (Optional) ブラウザーが起動する際にナビゲートするウェブサイトアドレス。

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 を選択して、テストを実行するSUTのオペレーティングシステムを指定します。
  6. 利用可能なオプションから Device name を選択して、テストに使用するモバイルデバイスのタイプを指定します。
  7. (任意) SUTで起動したい App のパスを入力します。値を指定しない場合、SUTはアプリを起動せずに起動します。詳細については、Mobile App Storage を参照してください。
  8. Connection Types リストに接続詳細を保存するために Save connection をクリックします。
ノート

あなたのSauce Labsの接続は3時間後に終了します。

サポートされている Platform name および Device name についての詳細は、Supported Browsers & Devices を参照してください。

Sauce Labs Device設定​

  • Username: SUTに接続するSauce Labsのユーザー名。
  • API Key: SUTに接続するSauce LabsのAPIキー。詳細については、Sauce Labsユーザー設定 を参照してください。
  • Data Center: テストが実行されるサーバーの場所と関連するアーティファクトが保存される場所。
  • Check Connection: Sauce Labsアカウントを検証し、より多くのSauce Labs設定を有効にします。
  • Platform name: Sauce LabsがSUTとして使用するオペレーティングシステム。
  • Device name: テストに使用するモバイルデバイスのタイプおよびバージョン。
  • App: (Optional) テストしたいモバイルアプリが含まれる.ipa、.apk、.aab、または.zipファイルへのパスを設定することができます。

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

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

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

Android Device設定​

  • Device ID: シリアル番号、エミュレーター名。

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

  1. Connection Type リストから iOS Device を選択します。
  2. iOS Gateway UIにリストされているiOSデバイスの UDID を入力します。
  3. (任意) Developer certificate name or thumbprint を入力します。
  4. Provisioning profile name or identifier を入力します。
  5. Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
ノート

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

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

iOS Device接続設定​

  • UDID: iOSデバイスのユニークな識別子。
  • Developer certificate name or thumbprint: (Optional) 開発者証明書へのパス。
  • Provisioning profile name or identifier: プロビジョニングプロファイルへのパス。

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キーを追加または編集する際には、Toggle icon トグルアイコンをクリックして、保存前に新しく入力されたパスワードまたはAPIキーの値を表示できます。

に最終更新