Connect (JA)

3.1.2 コネクト

説明

Connect - デスクトップに接続する。プロトコル、ホスト名または IP アドレス、オプションのポートが引数 URL に指定されます。接続が確立されると、暗黙の変数_MACHINE と_DISPLAY の暗黙の変数が更新されます。

接続が確立されると DisconnectFallback Fallback Procedures を参照してください。

SYNOPSIS

connect <URL> [user=<user>] [password=<password>] [force=<false|true>] [onpass=<command>] [onfail=<command>] [params=<parameters>] [paramseparator=<delimeter>]

* 赤は必須パラメータを示す。

オプション

URL

-引数は既知の connectionmanager (v4.2以降)、または <protocol>://<host_or_IP>[:<port>] の形式で有効なURLでなければなりません。プロトコルは、サポートされているプロトコルコードのいずれかと等しくなければなりません。T-Plan Robotはデフォルトで7つのクライアント (プロトコル) をサポートしています：

RFB (Remote Frame Buffer) v3.3クライアント (プロトコルコード "rfb")。これはVirtual Network ComputingまたはVNCとしてよく知られています。このクライアントは互換性があり、TightVNC、RealVNC、UltraVNCなどのRFB v3.3準拠のVNCサーバーに接続できます。テスト環境は Release Notes#vnc ドキュメントを参照してください。クライアントの実装の詳細は vnc.
Static Image (プロトコルコード "file"; v2.2以降) では、ファイルから画像を読み込み、ライブデスクトップと同じようにテストすることができます。クライアントは、PNG、BMP、WBMP、GIFなど、Javaに準拠したすべてのロスレス画像フォーマットをサポートしています。ファイルが更新されるとクライアントが画像を再読み込みするメカニズムがあるので、ファイルシステム内の画像にグラフィカルな出力を生成するアプリケーションのテストにも使用できます。接続URLは "file://%26lt;image_path%26gt;"という標準的な形式で、相対パスやZIPファイルやJARファイルにバンドルされた画像を特別に扱います。詳細は staticimage.
Android over ADB（プロトコルコード "adb"、3.1以降）により、Android Debug Bridge（ADB）経由でAndroidデバイスを自動化できます。詳細は android.
ローカルデスクトップ（プロトコルコード「java」、3.2以降）では、ローカルデスクトップ上に表示されるアプリケーションやシステムコンポーネントを自動化できます。詳細はlocal.
iOS Mirror（プロトコルコード "apple"、3.3以降）では、AirPlayスクリーンミラーリングとVNCサーバーを組み合わせて、iOSデバイス（iPhone、iPad）を自動化できます。プレーンなVNC接続と比較して、このソリューションは画面パフォーマンスが非常に速く、ゲームやグラフィックプログラムなどのOpenGLコンテンツをサポートしています。詳細はios.
iOS Over Xcode （プロトコルコード "xcode"、4.3.1以降）は、WiFiネットワークとLightning USBケーブルを介してMac OS Xマシンの両方に接続されたiOSデバイスの自動化を可能にします。詳細はxcode.
RDP Server （プロトコルコード "rdp"、4.3以降）は、Microsoft Terminal Servicesとしても知られるRDPプロトコルによる自動化をサポートします。詳細はrdp.

ポートが明示的に指定されていない場合、デフォルトはプロトコル固有のウェルノウンポートになります。例えば、RFB/VNCサーバーはデフォルトで5900番ポート、Java RMIは1099番ポート、RDP（Windows Terminal Services）は 3389 番ポートで起動します。Linux/Unix上で動作するVNCに接続したい場合、デフォルトのRFBポートはX-Windowsサーバーによって占有されているため、通常は5901以上のポートを指定する必要がある。

URL にプロトコルが省略されている場合、スクリプトのデフォルトはRFB（VNC）である。この場合、ポート番号は、ポート番号から5900を引いた表示番号として扱われる。直接ポートを指定する場合は、ダブルコロンで指定します。例えば、"localhost:1 "と "localhost::5901" の両方は、ポート5901 で動作する同じローカルVNCサーバーを参照します。標準的なURL形式の同じアドレスは、"rfb://localhost:5901" です。

user=<ユーザー名>
デスクトップを認証するためのユーザー名(ID)。このパラメータは将来の使用やサードパーティの拡張のために予約されており、現在サポートされているプロトコルでは使用されません。

password=<password>
デスクトップサーバーを認証するためのパスワード。サーバーがパスワードを必要としないように構成されている場合、このパラメータは無視されます。

force=<false|true>
- sk.connect.force。同じサーバーとポート(ディスプレイ)がすでに接続されている場合、再接続は行われません(force=false)。現在の接続を強制的に終了してサーバーに再接続するには、このパラメータをtrueに設定します。デフォルト値は false です。

onpass=<コマンド>
。サーバーへの接続に成功したときに実行するコマンド。単一のコマンドでなければなりません。一連のコマンドを呼び出すには、プロシージャまたは後続のIf/Else Statementコマンドの終了コードをテストします。

onfail=<command>
-Connectが接続に失敗したときに実行するコマンド。単一のコマンドでなければなりません。一連のコマンドを呼び出すには、プロシージャまたは後続のIf/Else Statementコマンドの終了コードをテストする。

params=<param_name_and_value_pairs>
-カスタムクライアントパラメータのリスト。このオプションは、paramseparator オプションと一緒に、現在サポートされているプロトコルでは使用されておらず、将来の使用やカスタム拡張のために予約されています。これらは、サードパーティのクライアントプラグインへの汎用的なログインデータの転送をサポートするためのものです。リストには、カンマ(',')またはparamseparator引数で指定されたカスタムセパレータで区切られた、任意の数のパラメータ名と値のペアを含めることができます。

例えば、2つのパラメータ PARAM_A=value_A と PARAM_B=value_B を指定する場合、引数は "PARAM_A,value_A,PARAM_B,value_B" のようになります。
paramseparator=<delimeter>
-params 引数で指定されたパラメータ名と値のリストのためのオプションのセパレータ。指定しない場合、デフォルトはカンマ(",")。

戻り値

コマンドは、成功すると 0 (ゼロ) を返し、指定されていない理由で接続に失敗すると 1 を返します。UltraVNCサーバがMSログオンを要求するなど、サポートされていない認証方法で失敗した場合、コマンドは値10を返します。

例

Connect rfb://localhost:5901 password=テスト
Connect localhost:1 password=テスト
Connect localhost::5901 password=テスト

3つの例はすべて等しく、ローカルマシンのディスプレイ番号1（ポート5901）で動作するVNCサーバーに接続する。パスワード認証が期待される。これは、ポート5900が通常X-Windowsサーバーによって占有され、VNCサーバーが通常ポート5901以上で実行されるLinux/Unixシステムの典型的な例である。

Connect "Local VNC"

- で登録された "Local VNC "接続に接続する。connectionmanager. サーバーのURLとパスワードは接続記録から読み込まれます。

Connect rfb://mywindows.companyxy.com:5902 password=mypassword force=true onfail="exit 2"

-mywindows.companyxy.com というサーバー上で動作しているRFB（VNC）サーバーに接続する。ツールがすでにこのサーバーに接続されている場合は、セッションを終了して再接続する。接続に失敗した場合は、終了コード 2 でスクリプトの実行を終了します。

Connect File://C:￤Screen.png

- 指定された画像を読み込み、デスクトップの代わりに表示する。

Connect file://C:￤testdata￤mages￤images.jar!/data/screen.png

- 指定したJARファイル(ZIPも可)内の/data/screen.pngとしてzip圧縮された画像を読み込み、デスクトップの代わりに表示する。

Connect file://screen.png

- 指定された画像を読み込み、デスクトップの代わりに表示する。URLは相対URLのため、画像は製品のインストールパスから読み込まれます。

Connect file://{_SCRIPT_DIR}/screen.png

- このコマンドを呼び出しているスクリプトと同じフォルダにある画像を読み込んで、デスクトップの代わりに表示します。

Connect rfb://mywindows.companyxy.com:5902 password=mypassword force=true onfail="exit 2"

-mywindows.companyxy.comというサーバー上で動いているRFB（VNC）サーバーに接続する。ツールがすでにこのサーバーに接続されている場合は、セッションを終了して再接続する。接続に失敗した場合は、終了コード 2 でスクリプトの実行を終了します。

Connect adb://default

- USBケーブルでローカルPCに接続された最初のAndroidデバイスに接続する。

Connect adb://MB104PY14322

- 指定したシリアル番号のAndroid端末にUSBケーブルで接続する。

Connect java://localhost

- ローカルのデスクトップに接続します。

Connect apple://192.168.1.2:5901

-iOSデバイスにios接続する。この例では、デバイスがネットワークに接続され、指定されたIPアドレスを持ち、5901番ポートでVNCサーバーを実行していると仮定しています。