Java コネクタのメソッド

コネクタレベルのメソッド

開始

Java アプリケーションをその場所から起動し、フォーカスします。

注:

最初にこのメソッドを実行する必要があります。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 1. Start メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
パス	ローカルドライブ内の Java アプリケーションへのパスです。	データ入力	文字列	なし	あり
引数	パスの引数です。	データ入力	文字列	なし	いいえ

GetMainWindowHandle

Start メソッドによって起動された Java アプリケーションのウィンドウハンドルを返します。

表 : 2. GetMainWindowHandle メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	アプリケーションのウィンドウハンドルを返します。	データ出力	整数	なし	適用外

GetMainWindowTitle

Java アプリケーションウィンドウのタイトルを返します。

表 : 3. GetMainWindowTitle メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	アプリケーションウィンドウのタイトルを返します。	データ出力	文字列	なし	適用外

CloseMainWindow

メインの Java アプリケーションウィンドウを閉じます。

終了

メインの Java アプリケーションウィンドウを終了します。

画面レベルのメソッド

クローズ

アクティブな Java アプリケーションウィンドウを閉じます。

重点

Java アプリケーションウィンドウが最小化されているか、バックグラウンドで実行されている場合、このメソッドはフォーカスを復元します。

GetFields

Java アプリケーションのテキストフィールドからデータを取得します。最初にテキストフィールドを設定する必要があります。設定するには、次の手順を実行します。

Java コネクタの設定を行い、1 つまたは複数のテキストフィールドをキャプチャします。
画面レベルのメソッドを公開します。「コネクタメソッドを使用する」を参照してください。
[オブジェクトエクスプローラー (Object Explorer)] ペインから、GetFields メソッドを [デザイン面 (Design surface)] にドラッグします。
メソッド設定アイコン () をクリックします。
1 つまたは複数のテキストフィールドを選択します。
テキストフィールドのデータタイプを更新します。
[フォーム要素を選択 (CHOOSE FORM ELEMENTS)] ウィンドウを閉じるには、[OK] をクリックします。
選択したテキストフィールドごとに、データ出力ポートが作成されます。

これで、GetFields メソッドはテキストフィールドに含まれるデータを返すことができます。

GetInstanceCount

開いている Java アプリケーションのインスタンスの合計数を返します。

表 : 4. GetInstanceCount メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	開いている Java アプリケーションのインスタンスの合計数を返します。	データ出力	整数	なし	適用外

GetScreenShot

Java アプリケーション画面のスクリーンショットをキャプチャして返します。

表 : 5. GetInstanceCount メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	Java アプリケーション画面のスクリーンショットを返します。	データ出力	ビットマップ	なし	適用外

GetWindowHandle

Java アプリケーション画面ウィンドウの Windows ハンドル番号を返します。

表 : 6. GetInstanceCount メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	Java アプリケーション画面ウィンドウの Windows ハンドル番号を返します。	データ出力	整数	なし	適用外

IsCreated

設定されたウィンドウのルールが一致するかどうかを示すブール応答を返します。Java アプリケーション画面を設定すると、[Java コネクタ (Java Connector)] ウィンドウの [一致ルール (MATCH RULES)] セクションに、設定された画面と照合する特定のルールが表示されます。メソッドは同じルールを照合します。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 7. IsCreated メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
MatchAllChildren	画面の要素のルールを照合した後のブール応答を返します。	データ入力	ブール	なし	いいえ	このパラメーターは、1 つまたは複数の要素をキャプチャする場合に関連しています。
戻る	設定した Java アプリケーション画面のルールが一致したかどうかを示すブール応答を返します。	データ出力	ブール	Null	適用外

最大化

Java アプリケーションウィンドウを最大化します。

最小化

Java アプリケーションウィンドウを最小化します。

MouseAction

左クリック、右クリック、中央クリックなど、Java アプリケーションに対するさまざまなマウスデバイスアクションを実行します。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 8. MouseAction メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
アクション	マウスデバイスアクションを指定します。	データ入力	マウスデバイス入力	なし	あり
ClickMiddle	中央クリックを実行するかどうかを指定します。	データ入力	ブール	なし	いいえ

サイズを変更

Java アプリケーションウィンドウの幅、高さ、および位置を X 軸方向および Y 軸方向で変更します。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 9. Resize メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？
xPos	画面上のウィンドウの X 軸方向の位置です。	データ入力	整数	なし	いいえ
yPos	画面上のウィンドウの Y 軸方向の位置です。	データ入力	整数	なし	いいえ
幅	ウィンドウの幅です。	データ入力	整数	なし	いいえ
高さ	ウィンドウの高さです。	データ入力	整数	なし	いいえ

復元

Java アプリケーションウィンドウを元の寸法に戻します。Maximize メソッドや Minimize メソッドを実行した後に、このメソッドを使用できます。

SendKeys

Java アプリケーションのアクティブなフィールドにデータまたはキーボード入力を送ります。たとえば、文字列データ「RPA」またはキーボード入力 [Space] を送って、チェックボックスをオフにすることができます。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 10. WaitForCreate メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？
キー	アクティブなフィールドにデータまたはキーボード入力を送ります。	データ入力	文字列	なし	あり
ClearExistingValue	データまたはキーボード入力を送る前に、アクティブなフィールドの既存の値をクリアします。	データ入力	ブール	なし	いいえ
TypeDelay	アクティブなフィールドにデータまたはキーボード入力を送るまでの遅延時間を設定します。	データ入力	整数	なし	いいえ

SetFields

Java アプリケーション画面からキャプチャされたテキストフィールドの要素にカスタムテキストを設定します。

メソッドを使用するには、次の手順を実行します。

[オブジェクトエクスプローラー (Object Explorer)] ペインから、SetFields メソッドを [デザイン面 (Design surface)] にドラッグします。
メソッド設定アイコン () をクリックします。
1 つまたは複数のテキストフィールドを選択します。
テキストフィールドのデータタイプを更新します。
[OK] をクリックします。
選択したテキストフィールドごとに、データ入力ポートが作成されます。文字列を渡して、Java アプリケーションのフィールドに設定できます。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

WaitForCreate

Java コネクタで設定する各画面は、[Java コネクタ (Java Connector)] ウィンドウの [一致ルール (MATCH RULES)] セクションに表示されるいくつかのルールによって識別されます。このメソッドは、設定した画面のルールが一致するどうかを示すブール応答を返します。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 11. WaitForCreate メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？
timeoutinSeconds	メソッドの処理がタイムアウトするまでの時間です。	データ入力	整数	なし	いいえ
MatchAllChildren	画面の要素のルールを照合した後のブール応答を返します。	データ入力	ブール	なし	いいえ
戻る	設定した Java アプリケーション画面のルールが一致したかどうかを示すブール応答を返します。	データ出力	ブール	なし	いいえ

要素レベルのメソッド

GetAccessibleActions

要素に対して実行できるアクションのリストを返します。たとえば、ボタンの場合は Click を返します。

表 : 12. GetText メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	要素に対して実行できるアクションのリストを返します。	データ出力	リスト	なし	適用外

GetInstanceCount

Java アプリケーションの要素タイプの合計数を返します。たとえば、アプリケーションにテキストボックスが 3 つある場合、インスタンス数は 3 です。

表 : 13. GetText メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	アプリケーションの要素タイプのインスタンス数を返します。	データ出力	整数	なし	適用外

GetText

Java アプリケーションのキャプチャされたテキストボックスの要素からテキストを返します。複数のテキストボックスから複数のテキストをキャプチャするには、複数のテキストボックス要素を設定する必要があります。

表 : 14. GetText メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
テキスト	Java アプリケーションのテキストボックスに含まれるテキストを返します。	データ出力	文字列	なし	適用外

IsCreated

設定した要素のルールが一致するかどうかを示すブール応答を返します。

表 : 15. IsCreated メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
戻る	設定した要素のルールが一致するかどうかを示すブール応答を返します。	データ出力	ブール	null	適用外

MouseClick

キャプチャされた要素に対して左クリックを実行します。

PerformAction

要素に対して指定されたアクションを実行します。たとえば、ボタンをクリックします。各要素は、GetAccessibleActions メソッドを実行して取得できる一連のアクションを実行することができます。

パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

表 : 16. IsCreated メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
アクション	要素に対して実行するアクションを受け取ります。	データ入力	文字列	なし	あり	アクションは、GetAccessibleActions メソッドで指定された形式で正確に指定する必要があります。
戻る	アクションが実行された場合は True を返し、それ以外の場合は False を返します。	データ出力	ブール	なし	適用外

SetPassword

Java アプリケーションのパスワードフィールドへのパスワードの安全な入力を自動化します。

フィールドに入力するには、「ポートのプロパティを設定する」を参照してください。

表 : 17. SetPassword メソッドのパラメーター
パラメーター	説明	データポートタイプ	データタイプ	デフォルト値	必須？	メモ
パスワード	パスワードをセキュリティで保護された文字列として受け入れます。	データ入力	保護された文字列	なし	はい	パスワードはセキュリティで保護された文字列として受け入れられるため、パラメーターを右クリックして [ データのプレビュー] をクリックしたときにのみ文字列の長さが表示されます。
UseSendKeys	SendKeys は、文字、数字、記号などのキーボード入力をアプリケーション内のテキストボックスに送信するために使用されるメソッドです。	データ入力	ブール	False	はい	ヒント: SetPassword メソッドがパスワードフィールドにパスワードを入力できなかった場合は、値を True に設定し、メソッドを再度実行します。