Command Summary

T-Plan Robotには、様々な目的にわたる多数のコマンドが含まれています。以下に、各コマンドの概要をアルファベット順に簡潔にまとめ、詳細情報へのリンクを掲載しています。

最も人気のある、または一般的に使用されるコマンドの一部は以下の通りです：

Report - それぞれの実行でレポートが生成され出力されることを保証します。
Click image/ocr/object - 画面上の項目を視覚的に検索し、見つかったらクリックします。
Browser open/find - Web自動化のためのオブジェクト認識。
Mobile find - モバイルデバイス自動化のための物体認識。
Screenshot - ライブ画面をキャプチャします
Type or Paste - 対象システムに入力するテキスト文字列を渡します。
If/else - 任意の条件に基づいて動的に動作を分岐させます。
For -任意の回数/値をループするか、条件が満たされるまで実行します。
Var/Varg - スクリプト実行全体で使用するカスタム変数を定義します。
Procedure - スクリプトの効率化に役立つ再利用可能なコードの断片を作成します。

T-Plan Robot Command Summary
	カテゴリー	コマンド		説明
A	管理および実行制御コマンド	Alert		ローカルマシンにアラートウィンドウが表示されます。このウィンドウは、カスタムボタンや編集可能なフィールドを含めるようにカスタマイズ可能です。また、指定したタイムアウト後に自動的に閉じられるように設定できます。
B	管理および実行制御コマンド	Break		最も内側の 'for' ループを直ちに終了し、ループを囲む右中括弧 '}' の直後の最初のコマンドを実行します。このコマンドが for ループの外で使用された場合、構文エラーが報告されます。'for' コマンドを中断せずに現在のループをスキップするには、continue コマンドを使用します。
	デスクトップコマンド	Browser		Seleniumドライバーを介して、ウェブ要素オブジェクトの識別（画像ベースではない）を用いてウェブブラウザを自動化する。
			Browser open	お好みのウェブブラウザを開き、指定されたウェブページを読み込みます。ブラウザはローカルブラウザでもリモートブラウザ（Selenium Grid 6.3以降でサポート）でも構いません。バージョン8以降では、このコマンドで新しいタブやウィンドウを開くことも可能です。
			Browser find	指定されたオブジェクト基準に従ってウェブページ上の要素を検索し、オプションのアクション（click, type, submit, clear）を適用します。コマンドがアクションを指定せず、かつ要素が見つからない場合、スクリプトは続行されます。検索結果（存在/非存在）は、コマンドの終了コードと要素属性を保持する_WEB変数の有無によってスクリプト内で示されます。アクションを指定したコマンドで要素が見つからない場合、スクリプトは終了する。この動作は'click'および'drag'コマンドと一貫しています。



			Browser switch	ブラウザのタブとウィンドウを切り替える。v8以降でサポートされています。
			Browser close	タブ、ウィンドウ、またはブラウザ全体を閉じ、最終的にSeleniumセッションを終了します。
C	管理および実行制御コマンド	Compareto		接続されたSUTに対して、利用可能な検索方法（画像、テキスト、オブジェクト、AIなど）のいずれかを用いて、直ちに単一検索を実行します。
	デスクトップコマンド	Connect		対象のSUA（自動化対象システム）に接続してください。多くの機能はライブ接続に依存しており、これには以下が含まれます：デスクトップ実行、記録と再生、検索デバッグなど。
	管理および実行制御コマンド	Continue		現在の最内側の for ループの反復をスキップします。このコマンドが 'for' ループの外で使用された場合、構文エラーが報告されます。'for' ループ全体を中断（終了）するには、break コマンドを使用してください。
	管理および実行制御コマンド	Click		アイテムが表示されるまで待機してからクリックしてください。画像、テキスト、オブジェクト、AIのいずれかの検索方法を利用し、指定されたタイムアウト時間（デフォルト30秒）内にオブジェクトが見つからない場合、スクリプトを終了します。
D	管理および実行制御コマンド	Date		日付の読み取り、書き込み、計算を行います。このコマンドでは、現在の日付を取得し、入力された日付を解析し、必要に応じて時間の増減操作を実行し、結果を指定された形式の_DATE変数または指定されたカスタム変数に保存できます。
	デスクトップコマンド	Disconnect		SUAから切断します。接続が閉じられると、事前定義された変数 _MACHINE と _DISPLAY はクリアされます。
	管理および実行制御コマンド	Drag		利用可能な検索方法のいずれか、または相対距離を通じて、マウスドラッグ操作の開始点と終了点を特定します。いずれかの検索が失敗した場合、スクリプトを終了します。
	管理および実行制御コマンド	Drag
E	管理および実行制御コマンド	Eval		数値式として評価される値を持つスクリプト変数を定義します。詳細については、数値式に関する章を参照してください。その他の動作は var コマンドと全く同じです。
		Exec		ローカルシステム（T-Plan Robotを実行しているマシン）上でOSコマンドを実行します。引数は単一のコマンドである必要があります（例：Unix/Linux では 'ls -l'）。Java と基盤となる OS 間のインターフェースの制限により、コマンドではパイプや出力のリダイレクトは使用できません。出力をファイルに保存する必要がある場合は、outfile パラメータを使用してください。パイプやリダイレクトを使用する必要がある場合は、コマンドをシェルスクリプトまたはバッチファイルに記述し、代わりに Exec コマンドで呼び出してください。
		Exit		スクリプト、プロシージャ、または構造化されたコードブロックを終了し、終了コードを返します。
	I/O コマンド	Excel		Microsoft Excelファイル（.xls、.xlsx、xlsm）の読み取り、書き込み、検索が可能です。このコマンドを使用すると、プログラム経由（UIを介さず）でローカルシステム上で利用可能なスプレッドシートを操作できます。このコマンドはライブのSUA接続に依存しません。
		Excel
			Open	既存のExcel文書を読み書きモードで開きます。
			Create	新しいExcel文書を作成する、および／またはシートを作成します。
			Select	シートを選択する、および／またはセルを選択し、その値と書式を取得します。
			Find	選択したシート内で、値または正規表現によってセルを検索します。
			Set	シート名またはセルの値（書式）を設定する。
			Copy	コピーするセルを選択します。
			Paste	「コピー」とマークされたセルをExcel文書に貼り付けます。
			Close	Excel文書を閉じて保存します。
F	I/O コマンド	File		テキストファイルからの読み取りおよび/または書き込み。このコマンドを使用して、プレーンテキストファイルを開いたり作成したり、テキストの読み書き、文字列/正規表現の検索、カンマ区切り値（CSV）形式または正規表現を使用した個々のテキスト行からの値の解析を行うことができます。
F	言語構造	For		値の範囲を反復処理する、または指定された条件に基づいて反復処理するループを設計します。
G	デスクトップコマンド	Gesture		タッチスクリーンのジェスチャーを設計および実行します。以下のモバイルデバイス接続でのみサポートされます：- Android（ADB経由）- iOS（Xcode経由）
			Gesture press	指定された位置での指の押下をジェスチャーバッファに記録すします。
			Gesture move	指定した指の動き（ドラッグ）を新しい位置に記録します。
			Gesture release	指定された指の離しを記録します。
			Gesture save	指定された名前でジェスチャーを保存し、ジェスチャーバッファをクリアします。
			Gesture execute	接続されたデバイスでジェスチャーを実行して、ジェスチャーバッファをクリアします。
			Gesture clear	ジェスチャーバッファをクリアし、新しいジェスチャーを設計する準備を整える
I	言語構造	If/else		if/else コマンドを使用して、指定された値に基づいて実行フローを動的に分岐させます。
	管理および実行制御コマンド	Image doctor		イメージドクターウィザードは、実行済みスクリプトにおける画像比較の失敗を特定し解決するのに役立ちます。これは、アプリケーションや自動化対象システム（SUA）が変更され、画像比較コードやテンプレート画像の更新が必要な場合に特に有用です。ウィザードは以下の3つの要素で構成されています： Image Doctorの警告ポップアップウィンドウでは、画像比較を対話的に解決できます。Image Doctor Records機能は、自動（無人）モードで失敗した画像比較を記録し、後で解決できるようにします。 ImageDoctorコマンドは、スクリプトから直接この機能の動作を制御します。



		Include		別のスクリプトまたはコンパイル済みJavaコードを含めます。引数が本ドキュメントで説明されている言語のTPRスクリプトである場合、このコマンドはスクリプトからプロシージャと変数のみを実行コンテキストにロードし、呼び出し元スクリプトで利用可能にします。この原理により、グローバルに使用される変数やプロシージャで構成されるライブラリを構築し、スクリプトにリンクすることが可能です。
		Include
J	言語構造	Java		TPRスクリプト内で直接ネイティブJavaコードブロックを作成し、Javaの機能を最大限に活用してください。
L	レポートコマンド	Log		メッセージをスクリプト実行ログファイルに記録します。
M	管理および実行制御コマンド	Moveto		Waitfor一致とMouse Moveコマンドの組み合わせです。デスクトップ上でコンポーネント画像、単色オブジェクト、またはテキストを検索し、その上にマウスポインタをホバーさせます。オブジェクトが見つからない場合、スクリプトを終了します。
	I/O コマンド	Mail		IMAPまたはPOP3サーバーから受信メールを取得します。SMTPサーバー経由でメールを送信するには、Sendmailコマンドを使用します。
			Mail get	サーバーからメールをダウンロードします。メッセージは属性でフィルタリングすることもできます。
			Mail set	メッセージのSEENフラグを設定します。
			Mail delete	サーバー上の1つ以上のメッセージを削除します。
	デスクトップコマンド	Mouse		マウスイベントを実行します。このコマンドは、マウスポインタの移動、クリック、押下、離し、ドラッグ、マウスホイールイベントなど、様々なマウス操作を自動化できます。また、マウス押下、マウス移動、マウス離しのイベントシーケンスで構成されるカスタムドラッグもサポートします（バージョン2.0.2以降）。設定されたイベント（クリック、ドラッグ）が失敗する場合は、マウスコマンド設定の調整パラメータを確認してください。現在のマウスポインタの座標は、スクリプト内で _MOUSE_X および _MOUSE_Y ダイナミック変数を通じて利用可能です（バージョン 2.1 以降）。
		Mouse
			Mouse click	指定されたマウスボタンを使用して、ターゲットポイントで1回以上クリックを実行します。
			Mouse drag	指定されたマウスボタンを使用して、任意の起点から目的の終点までマウスをドラッグします。
			Mouse move	任意の起点から目標点までマウスポインタを移動させます。
			Mouse pinch	ピンチ操作とは、タッチスクリーン上で2本の指を共通の中心点に向かって動かす1つ以上のピンチイベントを指します（「ピンチクローズ」とも呼ばれます）。このイベントは、iOSミラー接続タイプで接続されたT-Plan Serverを実行するApple iOSデバイスなど、特定の環境でのみサポートされます。
			Mouse press	マウスボタンを（離さずに）押したままにします。
			Mouse release	マウスボタンの離し（論理的には先行する「押し」イベントが必要）
			Mouse swipe	タッチディスプレイ搭載デバイス（AndroidやiOSデバイスなど）向けにタイミングを調整したマウスドラッグ
			Mouse wheeldown	マウスホイールを少なくとも1回転分上方向に回転させる（ホイールがユーザーから離れる方向に回転する）
			Mouse wheelup	マウスホイールを下方向に少なくとも1回回転させる（ホイールをユーザー側に向けて回転させる）
			Mouse zoom	画面を拡大表示します。現在の接続環境がピンチ操作に対応している場合は、現在のアプリケーションを拡大表示します。このコマンドはカスタムの中心点と開始距離・終了距離を使用します。
		Mobile		Android Over ADBおよびiOS Over Xcode接続により、モバイル端末専用の機能を提供します。
			Mobile alert	アラート処理
			Mobile app	現在のアプリIDを取得
			Mobile find	オブジェクト認識を通じてUI要素を検出し操作
			Mobile install	デバイスにアプリをインストール
			Mobile keyboard	キーボード操作
			Mobile kill	デバイス上のアプリを強制終了
			Mobile orientation	画面の向き処理
			Mobile pull	デバイスからファイルをダウンロード
			Mobile push	ファイルをデバイスにアップロード
			Mobile shell	デバイスに対してシェルコマンドを実行
			Mobile start	デバイスでアプリを起動
			Mobile uninstall	デバイスからアプリをアンインストール
P	デスクトップコマンド	Paste		システムクリップボードを使用してテキストを貼り付け（挿入）します。キーボードで文字を1文字ずつ入力する代わりに、このコマンドはテキストをクリップボードにコピーし、Ctrl+V（Mac OS XではCommand+V）を押してシステムの貼り付け操作を実行する動作をシミュレートします。これはType/Typelineでテキストを入力するよりもはるかに高速です。
	管理および実行制御コマンド	Pause		スクリプトの実行を一時停止します。T-Plan RobotがGUIモードで実行中の場合、一時停止ボタン/メニュー項目が選択され、ユーザーはボタンまたはメニュー項目の選択を解除することで実行を再開できます。スクリプトがCLIモードで実行中の場合、コンソールにメッセージが表示され、ユーザーはキーを押すことで実行を再開できます。
	管理および実行制御コマンド	Pause
	デスクトップコマンド	Press		キーをデスクトップに送信します。キーボードのキーを押すのと同じです。
	言語構造	Procedure		スクリプトを効率化するために再利用可能なコードを作成します。プロシージャは、プロシージャ呼び出しの一部として定義された番号付き変数入力を受け取ることができます。
R	報告コマンド	Report		実行済みスクリプト用のレポートプロバイダーを作成し起動します。これは、結果、スクリーンショット、警告などのスクリプト実行データからレポートを生成するオブジェクトです。
	管理および実行制御コマンド	Run		別のローカルTPRスクリプト、Javaスクリプト、またはJavaクラスを実行します。実行されたスクリプトによって生成されたデータ、変数、およびレポートは、呼び出し元のスクリプトでも利用可能になります。


S	報告コマンド	Screenshot		現在のリモートデスクトップのスクリーンショットを撮り、ファイルに保存。
		Script		スクリプト（テストケース）の開始または終了を定義します。このコマンドはT-Plan Professionalとの統合の一環として導入されましたが、QA業界で一般的なスクリプト構造を定義するために汎用的に使用できます。スクリプトマッピングはエンタープライズレポートプロバイダーによって認識され、出力XMLデータ（またはHTMLレポート）をQA文書（テストケース仕様書など）にマッピングするために使用できます。
		Sendmail		メールを送信します。このコマンドはSMTPクライアントとして機能し、SMTPサーバー経由で添付ファイル付きのメールを送信します。メールを受信するには、Mailコマンドを使用してください。
		Step		テストステップの結果を定義します。ステップはテストケース（スクリプト）内の単一の原子的な指示を表します。ステップはスクリプトブロック内に配置する必要があります。
	管理および実行制御コマンド	String		1つ以上の文字列操作を使用して複雑なテキスト文字列を解析または処理します。 (基本的な文字列検証には、if/else文内で"contains", "startswith", "endswith" , "matches"のブール式を使用してください)
			String indexof	「string=」パラメータで指定された値に対する最初の一致位置を特定します。
			String length	テキストの長さ（文字数）を返します。例えば、「文字列の長さ "Demo"」は _STRING 変数を 4 に設定します。
			String matches	'pattern' パラメータで指定された java.util.regex.Pattern 準拠の正規表現とテキストを照合し、ブール値の結果（'true' または 'false'）を生成します。
			String replace	'string' パラメータで指定された値がテキスト中に出現する箇所をすべて、'replacement' パラメータで指定された文字列に置き換えた新しいテキストを返します。
			String split	テキストを、指定された文字列（'string' パラメータ）または java.util.regex.Pattern 正規表現（'pattern'）に一致する一連の文字列に分割します。
			String substring	入力された「開始」および／または「終了」インデックス番号で定義されたテキストの部分文字列を返します。
			String tostring	セミコロンで区切られた1つ以上の数値ASCIIまたはUnicode値から新しいテキストを作成します。
			String trim	先頭と末尾のスペース（スペース、改行文字など）をすべて削除します。
T	報告コマンド	Timer		タイマーとタイマーグループを管理します。タイマーを使用すると、コマンド、コマンドブロック、またはスクリプトの経過時間を測定できます。これは通常、パフォーマンステストを目的としています。
T	デスクトップコマンド	Type/Typeline		デスクトップにテキストを入力します。Typelineコマンドは便利なコマンドで、単にテキストを入力してEnterキーを押すだけです。これは'Type <text>' と'Press Enter'.の組み合わせと同じ効果があります。
V	管理および実行制御コマンド	Var		スクリプト全体で使用する標準変数を定義します。
		Varf		改行、タブ、または特殊なUnicode文字を値に挿入できるJavaエスケープシーケンスを含むことができる、フォーマット済み変数を定義します。
		Varg		グローバル変数を定義（"Varg set"）または削除（"Varg delete"）し、指定された可視性スコープを設定することで、スクリプトや作業項目間でデータを共有できるようにします。
			Varg set	Varg set name="S" value="Hello" scope="session" - セッション変数 "S" を作成または設定します。
			Varg delete	Varg delete name="S" scope="session" - 前の例で作成されたセッション変数を削除します。ローカルまたはスクリプトスコープ内に存在する同じ名前の他の変数はすべて残します。
W	管理および実行制御コマンド	Wait		指定された時間待機します。このコマンドは、スクリプトの実行を指定された時間だけ一時停止するために使用します。
	報告コマンド	Warning		レポートに警告を挿入します。警告は画像パラメータを通じて特定のスクリーンショットに関連付けることができます。このような警告はレポート内の画像説明文の下に表示されます。関連付けられた画像がない場合、警告はレポート内で単一のコンポーネントとして表示されます。
		Waitfor Command		スクリプトの実行を一時停止し、RFBイベントまたはリモートデスクトップ画像の状態を待機します。
			Waitfor bell	サーバーがビープ音を鳴らしたことを示します。これはアプリケーションがベル文字（ASCII 0x07）を出力したことを示します。
			Waitfor clipboard	リモートサーバーのクリップボードコンテンツが配信されるまで待機し、その後"_SERVER_CLIPBOARD_CONTENT"変数を通じて利用可能になります。
			Waitfor match	このイベントは、選択された比較方法が肯定的な結果を生成するまで（デスクトップが一致するまで）、コマンドを待機させます。
			Waitfor mismatch	画面上の項目に一致するものが検索できなくなるまで待ちます。
			Waitfor update	リモートシステムの表示が更新/変更されるまでお待ちください。