IA-Connect UI

IA-Connect は、クラウドからオンプレミスの仮想マシンに、または Citrix または Microsoft リモート デスクトップ 'RDS' 接続経由で RPA 機能を追加する、ロボット プロセス オートメーション 'RPA' プラットフォームです。 これは、Windows アプリケーション のユーザー インターフェイスオートメーション 'UIA' のモジュールです。

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	リージョン
コピロット スタジオ	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - Azure Government リージョン      - Azure China リージョン      - 米国国防総省 (DoD)
Power Apps	Premium	次を除くすべての Power Apps リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
Power Automate	Premium	次を除くすべての Power Automate リージョン :      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)

お問い合わせ
名前	Ultima Labs
URL	https://www.ultima.com/ultima-labs
Email	IAConnect@ultima.com

コネクタ メタデータ
Publisher	ウルティマビジネス
Website	https://www.ultima.com/ultima-labs
プライバシー ポリシー	https://www.ultima.com/privacy-policy
カテゴリ	IT 運用;生産性

IA-Connect は、Power Automate Cloud Flows からオンプレミスの仮想マシン、または Citrix または Microsoft Remote Desktop (RDS) 接続経由で RPA 機能を追加する、RPA (ロボティック プロセス オートメーション) プラットフォームです。 IA-Connect コネクタには 800 を超えるアクションが用意されており、Power Automate Cloud Flow から直接、あらゆる種類のオンプレミス アプリケーションを自動化できます。 すべての IA-Connect アクションは Power Automate Cloud Flow から直接利用でき、クラウド ベースとオンプレミスのアプリケーション間の統合が容易になり、既存の Power Automate 条件、ループ、動的コンテンツ、式、および例外処理を RPA プロセスで利用できます。 また、IA-Connect コネクタを利用すると、フロー実行履歴から完全な実行履歴と監査機能が提供される一方で、RPA プロセスを開発するために別のアプリケーション/コンソール/スタジオを用意する必要も排除されます。

[前提条件]

IA-Connect コネクタのいずれかを使用するには、IA-Connect ソフトウェアをインストールする必要があります。 これは 30 日間無料でテストできます。その後、IA-Connect ライセンスが必要になります。

IA-Connect ソフトウェアは、次の 2 つの主要なコンポーネントで構成されています。

• IA-Connect Orchestrator。これは、独自の Azure テナントでホストする Azure WebApp です。 これにより、1 つ以上のオンプレミスまたはクラウドベースの仮想マシンへの RPA フローのルーティングとセキュリティが処理されます。

• IA-Connect エージェントとディレクター。自動化するソフトウェアにアクセスできる仮想マシンにインストールされます。 さらに、IA-Connect エージェントは Citrix または Microsoft Remote Desktop Services (RDS) セッション内で実行できます。このセッションでは、RPA コマンドが仮想チャネルをリモート セッションに渡して実行されます。 IA-Connect エージェントはネットワーク共有から実行でき、インストールは必要ありません。

使用可能な IA-Connect コネクタ

使用可能な IA-Connect コネクタは次のとおりです。

• 動的コードの IA-Connect
• IA-Connect Java
• JML の IA-Connect
• メインフレームの IA-Connect
• IA-Connect Microsoft Office
• SAP GUI の IA-Connect
• IA-Connect セッション
• IA-Connect UI
• IA-Connect Web ブラウザー

資格情報を取得する方法

ライセンスを受け取り、30日間の無料試用版を開始するには、当社のウェブサイト(https://www.ultima.com/IA-Connect/Power-Automate)でリクエストを送信してください。

試用版の要求を受け取ったら、IA-Connect ソフトウェアの設定を支援し、試用版ライセンスを提供するために提供された電子メール アドレスを介して、お客様に連絡します。 これは完全な機能を備えた試用版であり、試用期間中に、ご自身の環境内の 9 つの IA-Connect コネクタすべてに対して 800 個のアクションのいずれかをテストできます。

コネクタの概要

IA-Connect の試用版要求を送信すると、インストールとセットアップに関する IA-Connect ソフトウェアとドキュメントを含む ZIP ファイルをダウンロードできるようになります。 また、必要に応じてインストールプロセスを通じてサポートとガイダンスを提供するために、お客様に連絡します。

Support

試用期間中は、Ultima Labs (IAConnect@ultima.com) に問い合わせてサポートとサポートを受けることができます。

IA-Connect ライセンスを購入すると、Ultimaの英国ベースのテクニカルサービスセンター(TSC)から、特注のトレーニングまたはサポートに利用できるサポートトークンを受け取ります。

既知の問題、一般的なエラー、FAQ

ナレッジ ベースには、既知の問題、IA-Connect コネクタの使用時に発生する可能性がある一般的なエラー、よく寄せられる質問に関する記事が多数含まれています。 これは https://support.ultima.com/ultimalabs でアクセスでき、これらのリソースにアクセスするためのアカウントは、IA-Connect 試用版中および IA-Connect ライセンスの購入時に提供されます。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	Description	必須
API キー	securestring	この API の API キー	正しい
IA-Connect Orchestrator アドレス	文字列	HTTP(S) コンポーネントを使用せずに IA-Connect Orchestrator アドレスを指定する	正しい

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

[UIA list element item by index]\(UIA リスト要素項目をインデックス別にクリックする\)	指定したインデックスに一致するリスト要素をクリックします。 これは通常、ドロップダウン/メニュー項目の項目を選択するために使用されます。
[最大化 UIA] ウィンドウ	指定した UIA ハンドルを使用してウィンドウを最大化します。
UIA ウィンドウを標準に設定する	指定した UIA ハンドルを使用してウィンドウを正規化します (つまり、最小化または最大化するのではなく、通常のサイズのウィンドウに設定します)。
UIA デスクトップ要素が存在しないのを待つ	デスクトップ要素 (通常はウィンドウ) が存在しなくなるまで待機します。
UIA デスクトップ要素は存在しますか	デスクトップ要素が存在するかどうかを報告し、いくつかの基本的な要素プロパティを提供します。
UIA デスクトップ要素を取得する	デスクトップ上のすべてのウィンドウとダイアログの一覧を返します。
UIA デスクトップ要素を待機する	デスクトップ要素 (通常はウィンドウ) が存在するまで待機します。
UIA データ グリッド要素のプロパティを取得する	DataGrid 要素のテーブル プロパティを返します。 これは、行、列、ヘッダー、セル (つまりテーブル) を持つ要素です。
UIA データ グリッド要素の内容を取得する	datagrid 要素の内容を返します。 これは、行、列、ヘッダー、セル (つまりテーブル) を持つ要素です。 このアクションを使用して、このアクションの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。
UIA トランザクションタイムアウトの設定	アプリケーションが要素に関する情報を返すのを UIA API が待機する時間を制御します。 通常、このトランザクション タイムアウトに達するのは、アプリケーションが応答しない場合のみです。
UIA プロセス ID のメイン ウィンドウを待機する	プロセスのメイン ウィンドウ (プロセス ID で指定) が存在するのを待機し、ハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。
UIA プロセスのメイン ウィンドウを待機する	ハンドルを返す前に、プロセスのメイン ウィンドウ (名前で指定) が存在するまで、指定された時間待機する単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。
UIA リスト要素項目を取得する	指定した要素 (通常はドロップダウン/メニュー項目) の下にある子要素項目の一覧を返します。
UIA 最上位レベルの Win32 ウィンドウを待機する	UIA ハンドルを返す前に最上位の Win32 ウィンドウが存在するまで、指定した時間待機する高速 Win32 アクション。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 クラス名またはウィンドウ タイトルで検索することも、ワイルドカードを含むより高度な検索フィルターを指定することもできます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 より強力な UIA アクション 'Wait for desktop element' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。
UIA 要素がチェックされています	このアクションは、要素 (通常はチェックボックスまたはラジオ ボックス) がチェックされているかどうかを示す true または false を返します。
UIA 要素が存在しないのを待つ	要素 (通常、ボタンやテキスト入力領域など、ウィンドウ内の個々の要素) が存在しなくなったのを待ちます。
UIA 要素でのグローバルな左マウス のダブルクリック	UIA 要素を基準にして、マウスを中央または選択したエッジ、コーナー、オフセットに移動し、マウスの左ボタンをダブルクリックします。
UIA 要素にテキストを入力する	既存のテキストを置き換えるか、新しい値を特定の位置に挿入するか、要素 (通常はテキスト入力フィールド) にテキストを入力する UIA アクション。
UIA 要素にパスワードを入力する	既存のテキストを置き換えて、要素 (通常はパスワード入力フィールド) にパスワードを入力する UIA アクション。
UIA 要素のグローバル マウス の中央クリック	UIA 要素を基準にしてマウスを中央に移動するか、選択したエッジ、コーナー、オフセットに移動し、マウスの中央ボタンをクリックします。
UIA 要素のグローバル右クリック	UIA 要素を基準にして、マウスを中心または選択したエッジ、コーナー、オフセットに移動し、マウスの右ボタンをクリックします。
UIA 要素のサイズ変更	UIA 要素のサイズを変更します。 このアクションは通常、(変換パターンを持つ) Window 要素でのみ機能します。
UIA 要素のスクロール率を設定する	その要素でスクロールがサポートされている場合は、指定した要素の水平方向および/または垂直方向のスクロール率を設定します。 要素が 'scroll' パターンをサポートしている場合は、このアクションを要素に直接適用し、水平方向または垂直方向のスクロール量 (またはその両方) を指定できます。 要素が 'scroll' パターンをサポートしていない場合、このアクションは 'range value' または 'value' パターンにフォールバックしますが、要素自体ではなく、スクロール バー コントロールに直接適用する必要があります。
UIA 要素のテキスト値を取得する	要素のテキスト値を返します。 通常、テキスト値はラベルに関連付けられますが、多くの要素でこのプロパティを持つことができます。
UIA 要素のプロパティをリストとして取得する	要素のプロパティを、個々の項目ではなく単一行リスト (単一行コレクション/データ テーブル) として返します。これは、データの使用方法に応じて役立つ場合があります。
UIA 要素のプロパティを取得する	要素のすべてのプロパティを返します。 これは、必要なプロパティ値を保持するフィールドが不明な場合に役立ちます。
UIA 要素のラベル値を取得する	要素のラベルの値を返します。
UIA 要素の値を取得する	要素の値を返します。 通常、値はテキスト入力領域に関連付けられますが、多くの要素でこのプロパティを持つことができます。
UIA 要素の切り替え	要素 (通常はチェックボックスまたはラジオ ボックス) を切り替えます。 これにより、要素は現在の状態とは反対の状態になります (たとえば、checked がオフになり、その逆になります)。 特定の状態を設定する場合は、代わりにアクション 'Check 要素' を使用します。
UIA 要素の周囲に四角形を描画する	見つかった要素が必要であることを識別するのに役立つ、要素の周囲に四角形を描画します。 四角形は、5 秒後に自動的に削除されます。
UIA 要素の場所のスクリーンショットを撮る	要素の場所のスクリーンショットを取得し、画像を返します。 スクリーンショットが要素の場所で画面のコピーを取得するため、最初に要素を前面に移動する必要があります。
UIA 要素の展開	要素 (通常はメニュー/ドロップダウン 項目) を展開します。 項目が既に展開されている場合、何も起こりません。
UIA 要素の折りたたみ	要素 (通常はメニュー/ドロップダウン 項目) を折りたたみます。 アイテムが既に折りたたまれている場合、何も起こりません。
UIA 要素の検索モードを設定する	UIA アクションを実行するときに、IA-Connect エージェントで使用する UIA 要素検索モードを選択します。 通常、このアクションは、既定のモード (すべて検索) で問題が発生している場合にのみ使用されます。
UIA 要素の移動	UIA 要素を画面上の指定した位置に移動します。 このアクションは通常、(変換パターンを持つ) Window 要素でのみ機能します。
UIA 要素の選択	要素 (通常はリストまたはドロップダウン内の項目) を選択します。
UIA 要素は存在しますか	要素が存在するかどうかを報告し、いくつかの基本的な要素プロパティを返します。
UIA 要素へのグローバル入力テキスト	マウスを要素の中心に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ UIA 入力メソッドを受け入れられないテキスト入力で使用されます。
UIA 要素へのグローバル入力パスワード	マウスを要素の中心に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ UIA 入力メソッドを受け入れられないパスワード入力で使用されます。
UIA 要素への入力の戻り値	既存のテキストを置き換えるか、または特定の位置に戻り値を挿入して、要素 (通常はテキスト入力フィールド) に Windows の戻り値または改行を入力します。
UIA 要素をマウスでグローバルに左クリックする	UIA 要素を基準にして、マウスを中心または選択したエッジ、コーナー、オフセットに移動し、マウスの左ボタンをクリックします。
UIA 要素を待機する	要素 (通常、ボタンやテキスト入力領域など、ウィンドウ内の個々の要素) が存在するまで待機します。
UIA 要素を押す	要素 (通常はボタン) を押します。
UIA 要素を数値に設定する	テキスト フィールドやスクロール バーなど、数値入力を持つ要素の値を設定します。
UIA 要素を数値範囲の値に設定する	スクロール バーなど、数値範囲を持つ要素の値を設定します。
UIA 要素を確認する	要素の状態 (通常はチェックボックスまたはラジオ ボックス) をオンまたはオフに設定します。
UIA 要素ウィンドウを閉じる	要素ウィンドウを閉じます。 通常、ウィンドウまたはダイアログでのみ機能します。
UIA 要素パターンを取得する	UIA 要素で使用できる UIA パターンを取得します。そのため、どの UIA アクション IA-Connect が要素に影響を与える可能性があります。
UIA 要素内で表示されている検索イメージを見つける	このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に表示されているかどうかを返します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。
UIA 要素内で表示される検索イメージを待機する	このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に見える形で配置されるか、指定された時間が経過するまで待機します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。 UIA 要素は最初から存在する必要があります。 このアクションは、イメージが見つからればすぐに完了します。
UIA 要素検索の色領域を取得する	指定した色条件を満たす UIA 要素内のピクセル領域の詳細を返します。 エージェントは要素の座標でスクリーンショットを撮って色を見つけるので、最初に要素を前面に移動する必要があります。
UIA 要素検索モードを取得する	IA-Connect エージェントが UIA アクションに使用している UIA 要素検索モードを取得します。
UIA 親要素ハンドルを取得する	指定した要素の親要素のハンドルを返します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。
Win32 ウィンドウを取得する	任意で指定したクラス名またはウィンドウ タイトルを持つすべての Win32 ウィンドウの一覧を返す高速 Win32 アクション。または、ワイルドカードを含むより高度な検索フィルターを指定できます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 Win32 Windows には、タスク バー、デスクトップ、スタート メニュー、透明なオーバーレイ、画面外のウィンドウ、非表示のウィンドウなど、予期しない項目が含まれている可能性があるため、返される一覧に予想以上の結果が含まれている可能性があります。
すべての UIA 要素ハンドルをリセットする	IA-Connect によって現在格納されているすべての UIA 要素ハンドルをリセットします。これは、多数の要素を識別していて、多数の要素ハンドルが格納されている場合に便利です。 要素ハンドルの数が非常に多いシナリオ (100,000 以上) では、このアクションを使用して RAM 使用率を解放することもできます。
グローバル マウス クリック UIA 要素検索の色領域	指定した色条件を満たす UIA 要素内のピクセル領域の上にマウスを移動し、マウス クリックを実行します。 スクリーンショットが要素の場所で画面のコピーを取得するため、最初に要素を前面に移動する必要があります。
デスクトップ用の UIA ハンドルを取得する	デスクトップのハンドルを返します。 これは、ハンドル '-2' を使用してデスクトップ要素を参照できるだけでなく、デスクトップに対して検索できるアクションが多数あるためです (例: "デスクトップ要素を待機")。
フォアグラウンド UIA ウィンドウを設定する	ウィンドウを前景に移動します。
フォーカス UIA 要素	キーボード フォーカスのアクティブな要素にする要素にフォーカスを設定します。アプリケーションによっては、要素ウィンドウがフォアグラウンドに移動する場合があります。
フォーカスされた要素の UIA ハンドルを取得する	現在フォーカスされている UIA 要素のハンドルを返します。
フォーカスされた要素のメイン ウィンドウの UIA ハンドルを取得する	現在フォーカスされている UIA 要素のメイン ウィンドウのハンドルを返します。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。
プロセス ID のメイン ウィンドウの UIA ハンドルを取得する	プロセスのメイン ウィンドウ (プロセス ID で指定) のハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。
プロセス メイン ウィンドウの UIA ハンドルを取得する	プロセスのメイン ウィンドウ (名前で指定) のハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。
プロセスに Win32 ウィンドウがありますか	プロセス (名前で指定) に表示されるウィンドウがあるかどうかを報告する、シンプルで高速な Win32 アクション。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。
名前で UIA リスト要素項目をクリックする	指定した名前のリスト要素をクリックします。 これは通常、ドロップダウン/メニュー項目の項目を選択するために使用されます。
最上位レベルの Win32 ウィンドウが存在しますか	最上位の Win32 ウィンドウが存在するかどうかを報告する高速 Win32 アクション。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 クラス名またはウィンドウ タイトルで検索することも、ワイルドカードを含むより高度な検索フィルターを指定することもできます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力な UIA アクション 'Does UIA desktop element exist' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。
最上位レベルの Win32 ウィンドウの UIA ハンドルを取得する	指定したクラス名またはウィンドウ タイトルを持つ最上位の Win32 ウィンドウの UIA ハンドルを返す高速 Win32 アクション。または、ワイルドカードを含むより高度な検索フィルターを指定できます。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力な UIA アクション 'Does UIA desktop element exist' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。
最初の UIA 親要素を検索する	検索条件に一致する最初の親要素を UIA ツリー階層で検索します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。
最小化 UIA ウィンドウ	指定した UIA ハンドルを使用してウィンドウを最小化します。
画面座標で UIA 要素を取得する	指定された画面座標にある UIA 要素を返します。
表示されている検索イメージが UIA 要素内に存在しないのを待つ	このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に見えて見つからない (または見つからない) か、指定された時間が経過し、画像がまだ存在するまで待機します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。 UIA 要素は最初から存在する必要があります。 イメージが存在しなくなったら、すぐにアクションが完了します。
複数の UIA 要素にテキストを入力する	既存のテキストを置き換えるか、新しい値を特定の位置に挿入するか、複数の要素 (通常はテキスト入力フィールド) にさまざまなテキストを入力する UIA アクション。
複数の UIA 要素をテーブルとして取得する	指定した親要素の子要素の値を列挙し、テーブル形式で返します。 これは、技術的にはテーブルではなく、テーブル構造にまとめて配置されている要素からデータの行と列を返すために使用できます。 このアクションを使用して、このアクションの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。
複数の UIA 要素を確認する	複数の要素 (通常はチェックボックスまたはラジオ ボックス) の状態をオンまたはオフに設定します。
複数の UIA 要素プロパティを取得する	複数の要素のプロパティを返します。 これは、必要なプロパティ値を保持しているフィールドがわからない場合に便利です。
複数の UIA 親要素プロパティを取得する	デスクトップ (ルート レベル) まで、指定した要素の親要素の階層ツリーを返します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。

[UIA list element item by index]\(UIA リスト要素項目をインデックス別にクリックする\)

操作 ID:

UIAClickListElementItemByIndex

指定したインデックスに一致するリスト要素をクリックします。 これは通常、ドロップダウン/メニュー項目の項目を選択するために使用されます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初に展開	ExpandFirst		boolean	true に設定すると、IA-Connect はリスト アイテム要素を検索する前にリストの展開を試みます。 リストアイテム要素はリストが展開されるまで作成されない可能性があるため、これは動的リストに役立ちます。
次の後に折りたたむ	CollapseAfter		boolean	true に設定すると、検索の実行後にリストが折りたたまれます。
項目インデックス	ItemIndex		integer	クリックする項目の一覧内のインデックス。
展開と折りたたみの間の秒数	SecondsBetweenExpandCollapse		double	展開アクションと折りたたみアクションが true に設定されている場合に待機する秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

[最大化 UIA] ウィンドウ

操作 ID:

UIAMaximiseWindow

指定した UIA ハンドルを使用してウィンドウを最大化します。

パラメーター

名前	キー	必須	型	説明
ウィンドウ ハンドル	WindowHandle	True	integer	ウィンドウを最大化するための UIA ハンドル。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA ウィンドウを標準に設定する

操作 ID:

UIASetWindowToNormal

指定した UIA ハンドルを使用してウィンドウを正規化します (つまり、最小化または最大化するのではなく、通常のサイズのウィンドウに設定します)。

パラメーター

名前	キー	必須	型	説明
ウィンドウ ハンドル	WindowHandle	True	integer	正規化するウィンドウの UIA ハンドル。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA デスクトップ要素が存在しないのを待つ

操作 ID:

UIAWaitForDesktopElementToNotExist

デスクトップ要素 (通常はウィンドウ) が存在しなくなるまで待機します。

パラメーター

名前	キー	必須	型	説明
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
待機する秒数	SecondsToWait	True	integer	要素が存在しないまで待機する最大秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
要素がまだ存在する場合は例外を発生させる	RaiseExceptionIfElementStillExists		boolean	待機期間 IA-Connect 後も UIA 要素がまだ存在する場合は、例外を発生させる必要がありますか?
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
待機前に要素が存在する	ElementExistsBeforeWait	boolean	待機する前に要素が存在していた場合は true を返し、存在しない場合は false を返します。
待機後に要素が存在する	ElementExistsAfterWait	boolean	待機後に要素が存在した場合は true、存在しない場合は false を返します。

UIA デスクトップ要素は存在しますか

操作 ID:

UIADoesDesktopElementExist

デスクトップ要素が存在するかどうかを報告し、いくつかの基本的な要素プロパティを提供します。

パラメーター

名前	キー	必須	型	説明
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が存在する	ElementExists	boolean	要素が存在する場合は true、存在しない場合は false を返します。
要素ハンドル	ElementHandle	integer	要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

UIA デスクトップ要素を取得する

操作 ID:

UIAGetDesktopElements

デスクトップ上のすべてのウィンドウとダイアログの一覧を返します。

パラメーター

名前	キー	必須	型	説明
検索要素のローカライズされたコントロールの種類	SearchElementLocalizedControlType		string	要素のローカライズされたコントロール型で結果をフィルター処理します。
検索プロセス ID	SearchProcessID		integer	指定した場合、検索では、このプロセス ID (PID) を持つプロセスによって所有される要素のみが考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白のままにします。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
返される最初の項目	FirstItemToReturn		integer	1 から始まる、返される最初の項目の要素インデックス。 (UIA ツリーの下部から) 逆の順序で要素を返す場合は、-1 から始まる負のインデックスを指定することもできます。
返されるアイテムの最大数	MaxItemsToReturn		integer	返す要素の最大数、またはすべての項目を返す場合は 0。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
検出された要素の数	NumberOfElementsFound	integer	検索条件に一致するデスクトップ要素の数。
返される要素の数	NumberOfElementsReturned	integer	返されるデスクトップ要素の数 (返される項目の最大数を指定する場合は、見つかった要素の数より小さい場合があります)。
要素のプロパティ	ElementProperties	array of object	検索条件に一致するデスクトップ要素の要素プロパティ。
items	ElementProperties	object

UIA デスクトップ要素を待機する

操作 ID:

UIAWaitForDesktopElement

デスクトップ要素 (通常はウィンドウ) が存在するまで待機します。

パラメーター

名前	キー	必須	型	説明
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
待機する秒数	SecondsToWait	True	integer	要素が存在するまで待機する最大秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
要素が見つからない場合は例外を発生させる	RaiseExceptionIfElementNotFound		boolean	待機期間 IA-Connect 後に UIA 要素が存在しない場合は、例外を発生させる必要がありますか?
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が存在する	ElementExists	boolean	要素が存在する場合は true、存在しない場合は false を返します。
要素ハンドル	ElementHandle	integer	要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

UIA データ グリッド要素のプロパティを取得する

操作 ID:

UIAGetDataGridElementProperties

DataGrid 要素のテーブル プロパティを返します。 これは、行、列、ヘッダー、セル (つまりテーブル) を持つ要素です。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
代替ヘッダー行名	AlternativeHeaderRowName		string	既定では、DataGrid のヘッダー行には UIA 名 'Top Row' があります。 ヘッダー行の名前が異なる場合は、ここでその名前を指定します。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
列の数	NumberOfColumns	integer	データ グリッド内の列の数。
表示される列の数	NumberOfVisibleColumns	integer	データ グリッド内の表示列の数。
行数	NumberOfRows	integer	データ グリッド内の行数。
表示される行の数	NumberOfVisibleRows	integer	データ グリッド内の表示される行の数。
最初に表示される行	FirstVisibleRow	integer	データ グリッド内の最初に表示される行のインデックス。
最後に表示される行	LastVisibleRow	integer	データ グリッド内の最後に表示される行のインデックス。
スクロール バーの数	NumberOfScrollbars	integer	データ グリッドに含まれるスクロール バーの数。
スクロール バーの名前	ScrollbarNames	string	スクロール バーの名前のコンマ区切りのリスト (水平、垂直など)。

UIA データ グリッド要素の内容を取得する

操作 ID:

UIAGetDataGridElementContents

datagrid 要素の内容を返します。 これは、行、列、ヘッダー、セル (つまりテーブル) を持つ要素です。 このアクションを使用して、このアクションの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle		integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
画面上の列のみを取得する	OnScreenColumnsOnly		boolean	true に設定すると、画面上の列のみが返されます。
画面上の行のみを取得する	OnScreenRowsOnly		boolean	true に設定すると、画面上の行のみが返されます。
null 値を空白として返す	ReturnNullValuesAsBlank		boolean	true に設定すると、null 値は '' (つまり空白) として返されます。 false に設定すると、通常、null 値は '(null)' として返されます。
代替ヘッダー行名	AlternativeHeaderRowName		string	既定では、DataGrid のヘッダー行には UIA 要素名 'Top Row' があります。 ヘッダー行の名前が異なる場合は、ここでその名前を指定します。
行 UIA 名を返す	ReturnRowUIAName		boolean	この入力が設定されている場合、行 UIA 名は出力コレクション内の列に格納されます。 列の名前は、「行 UIA 名を格納する列の名前」という入力によって定義されます。
行 UIA 名を格納する列の名前	NameOfColumnToStoreRowUIAName		string	入力 'Return row UIA name' が true に設定されている場合、この入力は行 UIA 名を保持する出力コレクション内の列の名前を指定します。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
返される最初の項目	FirstItemToReturn		integer	1 から始まる、返す最初の項目 (行) の要素インデックス。
返されるアイテムの最大数	MaxItemsToReturn		integer	返す項目 (行) の最大数。すべての項目 (行) を返す場合は 0 です。
空の行の最初の N 行をスキャンする	ScanFirstNRowsForEmptyRows		integer	一部のデータグリッドには、UIA ツリー (通常は上部) に空または null の行要素がいくつか含まれており、IA-Connect は、UI に表示されるテーブル内の何も表していないため、これらの行要素を自動的にスキップします。 この入力が 0 (既定値) に設定されている場合、IA-Connect エージェントは常に、テーブル内のより深い行を取得するように '返す最初の項目' が設定されている場合でも、最初の行以降の行要素をスキャンします。 これにより、行インデックス番号との整合性が確保されますが、最初の行から要求された行までのすべての行をスキャンする必要があるため、パフォーマンスに影響します。 テーブル内の空の行要素または null 行要素のみが最初の N (例: 10) 行内にあると確信している場合は、これを N (例: 10) に設定すると、パフォーマンスが向上する可能性があります。 何を行っているか分からない限り、0 以外の値に設定しないでください。
スレッドとしてテーブルを読み取る	ReadTableAsThread		boolean	false (既定値) に設定すると、IA-Connect エージェントはすぐにテーブルを読み取り、その内容をディレクターに返します。 大きなテーブルを読み取る場合、このアクションはタイムアウトになる可能性があります。true に設定すると、IA-Connect エージェントはテーブルをエージェント スレッドとして読み取り、IA-Connect Director (または Orchestrator、PowerShell モジュール、Blue Prism) は、このエージェント スレッドの状態を監視して、完了を待機できます。 これにより、大きなテーブルをタイムアウトなしで読み取ることができます。 IA-Connect Agents 9.3 以前では、エージェント スレッドとしてではなく、テーブルをすぐに読み取るだけでした。
スレッド ID の出力データを取得する	RetrieveOutputDataFromThreadId		integer	以前にエージェント スレッドとしてこのアクションを実行し、"スレッドを待機する秒数" を 0 に設定した場合は、エージェント スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションに対する以前の呼び出しによって提供されます。 データ グリッドを読み取る場合 (したがって、エージェント スレッドとして以前のクエリ実行の結果を取得しない) 場合は、0 (既定値) に設定します。
スレッドを待機する秒数	SecondsToWaitForThread		integer	[スレッドとしてテーブルを読み取る] が true に設定されている場合、エージェント スレッドが完了するまで待機する秒数。 この時点でテーブルを読み取るエージェント スレッドが完了していない場合は、例外が発生します。 待機をバイパスするには 0 に設定します。エージェントは引き続きデータ グリッドを読み取りますが、次のアクションにも使用できます。 その後、"エージェント スレッドが正常に完了するまで待機する" アクションを使用してエージェント スレッドが完了するのを待機し、入力 'スレッド ID の出力データを取得する' をエージェント スレッド ID に設定して、この 'UIA datagrid 要素の内容の取得' アクションを再実行することで、後で結果 (データ グリッドの内容) を取得できます。
N% ごとにデータ グリッドを垂直方向にスクロールする	ScrollDataGridVerticallyEveryNPercent		integer	一部の大きなデータ グリッド (たとえば、数千行) を読み取るパフォーマンスは、データ グリッドをスクロールする場所に定期的にスクロールする (または近い) 場合に改善されています。 0 (既定値) に設定すると、内容の読み取り中にデータ グリッドはスクロールされません。 1 ~ 100 の値に設定すると、データ グリッドは定期的にスクロールされ (行の合計数の N% ごと)、内容が読み取られます。 たとえば、20 に設定すると、データ グリッドは 0、20、40、60、80% でスクロールされます。 または、"Scroll datagrid vertically every N rows" を使用して、N% ごとではなく N 行ごとにスクロールします。
N 行ごとにデータ グリッドを垂直方向にスクロールする	ScrollDataGridVerticallyEveryNRows		integer	一部の大きなデータ グリッド (たとえば、数千行) を読み取るパフォーマンスは、データ グリッドをスクロールする場所に定期的にスクロールする (または近い) 場合に改善されています。 0 (既定値) に設定すると、内容の読み取り中にデータ グリッドはスクロールされません。 値 1 以上に設定すると、データ グリッドは内容の読み取り中に N 行ごとにスクロールされます。 たとえば、5 に設定すると、データ グリッドは 5 行ごとにスクロールされます。 または、"データ グリッドを N% ごとに垂直方向にスクロールする" を使用して、すべての N 行ではなく、N% ごとに行をスクロールします。
データ グリッドの垂直方向の要素ハンドルのスクロール	ScrollDataGridVerticallyElementHandle		integer	コンテンツの読み取り中にデータ グリッドを垂直方向にスクロールする場合、この入力は垂直スクロール バー IA-Connect 検索する方法を定義します。 0 に設定 IA-Connect は、"scroll" パターンを使用するか (データ グリッドでサポートされている場合)、またはデータ グリッド内に含まれる垂直スクロール バーを検索して、データ グリッドを直接スクロールしようとします。 または、1 以上の値である垂直スクロール バー要素 (ボタンではなく、スクロール バー要素自体) の IA-Connect UIA ハンドルを指定することもできます。
スクロール用の最小データ グリッド行	MinimumDataGridRowsForScrolling		integer	コンテンツの読み取り中にデータ グリッドを垂直方向にスクロールする場合、この入力は、スクロールを実行 IA-Connect 前にテーブルに必要な行の最小数を指定します。 0 に設定すると、IA-Connect は行数に関係なくスクロールします。 正の数に設定した場合、IA-Connect は、データ グリッドにその数以上の行がある場合にのみスクロールを実行します。
スクロールできない場合は例外を発生させる	RaiseExceptionIfCannotScroll		boolean	コンテンツの読み取り中にデータ グリッドを垂直方向にスクロールする場合: スクロールできない場合は true に設定し、スクロールの失敗を無視する必要がある場合は false (既定値) に設定します。 スクロールの一般的な失敗には、スクロール バーを見つけられなかったり、スクロール バーにスクロールに適した UIA パターンがない ('scroll'、'rangevalue'、'value') などがあります。
別の垂直スクロール バー名	AlternativeVerticalScrollbarName		string	既定では、データ グリッドの垂直スクロール バー 'row' には UIA 要素名 'Vertical Scroll Bar' があります。 垂直スクロール バーの名前が異なる場合は、ここでその名前を指定します。 これは、コンテンツの読み取り中にデータ グリッドを定期的にスクロール IA-Connect、入力 'Scroll datagrid vertically element handle' フィールドが 0 に設定されている (IA-Connect がデータ グリッドを直接スクロールすることを指定する) 場合に使用されますが、データ グリッドは 'scroll' パターンを実装しません。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
Datagrid コンテンツ JSON	DataGridContentsJSON	string	JSON 形式の datagrid 要素の内容。
テーブル内の行数	NumberOfRowsInTable	integer	テーブルがすぐに読み取られた場合の出力テーブル内の行数。
テーブル内の列の数	NumberOfColumnsInTable	integer	テーブルがすぐに読み取られた場合の出力テーブル内の列の数。
スレッド ID	ThreadId	integer	このアクションがエージェント スレッドとして実行されている場合、この出力にはエージェント スレッド ID が保持されます。この ID は、アクションのプロセスを監視し、スレッドが完了したときにデータ グリッドの内容を取得するために使用できます。

UIA トランザクションタイムアウトの設定

操作 ID:

UIASetTransactionTimeout

アプリケーションが要素に関する情報を返すのを UIA API が待機する時間を制御します。 通常、このトランザクション タイムアウトに達するのは、アプリケーションが応答しない場合のみです。

パラメーター

名前	キー	必須	型	説明
タイムアウト (秒)	TimeoutInSeconds	True	double	アプリケーションが要素に関する情報を返すのを UIA API が待機する最大時間。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA プロセス ID のメイン ウィンドウを待機する

操作 ID:

UIAWaitForProcessIdMainWindow

プロセスのメイン ウィンドウ (プロセス ID で指定) が存在するのを待機し、ハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。

パラメーター

名前	キー	必須	型	説明
検索プロセス ID	ProcessId	True	integer	待機するプロセスの ID (IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます)。
待機する秒数	SecondsToWait	True	integer	プロセスのメイン ウィンドウを待機する最大秒数。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が存在する	ElementExists	boolean	要素が存在する場合は true、存在しない場合は false を返します。
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。

UIA プロセスのメイン ウィンドウを待機する

操作 ID:

UIAWaitForProcessMainWindow

ハンドルを返す前に、プロセスのメイン ウィンドウ (名前で指定) が存在するまで、指定された時間待機する単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。

パラメーター

名前	キー	必須	型	説明
検索プロセス名	SearchProcessName	True	string	検索するプロセスの名前 (メモ帳など)。
待機する秒数	SecondsToWait	True	integer	プロセスのメイン ウィンドウを待機する最大秒数。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。
要素が存在する	ElementExists	boolean	ウィンドウが存在する場合は true、存在しない場合は false を返します。

UIA リスト要素項目を取得する

操作 ID:

UIAGetListElementItems

指定した要素 (通常はドロップダウン/メニュー項目) の下にある子要素項目の一覧を返します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初に展開	ExpandFirst		boolean	true に設定すると、IA-Connect はリスト アイテム要素を検索する前にリストの展開を試みます。 リストアイテム要素はリストが展開されるまで作成されない可能性があるため、これは動的リストに役立ちます。
次の後に折りたたむ	CollapseAfter		boolean	true に設定すると、検索の実行後にリストが折りたたまれます。
選択した項目を確認する	CheckForSelectedItems		boolean	true に設定すると、出力コレクションには、リスト アイテムが現在選択されているかどうかを示す追加のプロパティが含まれます。
展開と折りたたみの間の秒数	SecondsBetweenExpandCollapse		double	展開アクションと折りたたみアクションが true に設定されている場合に待機する秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
リスト アイテムの数	NumberOfListItems	integer	リスト内の項目の数。
リスト アイテムの JSON	ListItemsJSON	string	リスト内の項目のプロパティ (JSON 形式)。
選択した項目の数	NumberOfSelectedItems	integer	リスト内で選択した項目の数。
最初に選択した項目のインデックス	IndexOfFirstSelectedItem	integer	最初に選択した項目のリスト内のインデックス。
選択したアイテム名	SelectedItemName	string	選択した項目の名前。

UIA 最上位レベルの Win32 ウィンドウを待機する

操作 ID:

UIAWaitForTopLevelWindow

UIA ハンドルを返す前に最上位の Win32 ウィンドウが存在するまで、指定した時間待機する高速 Win32 アクション。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 クラス名またはウィンドウ タイトルで検索することも、ワイルドカードを含むより高度な検索フィルターを指定することもできます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 より強力な UIA アクション 'Wait for desktop element' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。

パラメーター

名前	キー	必須	型	説明
検索クラス名	SearchClassName		string	検索する最上位ウィンドウの要素クラス名 (例: "メモ帳")。
検索ウィンドウのタイトル	SearchWindowTitle		string	検索する最上位ウィンドウのタイトル。
待機する秒数	SecondsToWait	True	integer	ウィンドウが存在するまで待機する最大秒数。
検索プロセス ID	SearchProcessId		integer	ウィンドウを所有するプロセスの省略可能なプロセス ID (たとえば、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションの出力によって提供されます)。 プロセス ID で検索しない場合は、0 に設定します。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子を使用して使用可能なウィンドウ プロパティに対して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数のウィンドウが検索と一致する場合は、並べ替えるウィンドウ プロパティを指定できます。 これは、必要なウィンドウを選択するために'インデックスの一致'と組み合わせて使用されます。 例: [列名で並べ替え] が [TopEdge] で 、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致するウィンドウが返されます。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数のウィンドウが検索と一致する場合は、並べ替えられたリストの上部または並べ替えられたリストの一番下 (false) から 'インデックスの照合' が一致する必要があります。
ウィンドウが見つからない場合は例外を発生させる	RaiseExceptionIfWindowNotFound		boolean	待機期間 IA-Connect 後に検索 Win32 ウィンドウが存在しない場合は、例外を発生させる必要がありますか?
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。
要素が存在する	ElementExists	boolean	ウィンドウが存在する場合は true、存在しない場合は false を返します。

UIA 要素がチェックされています

操作 ID:

UIAIsElementChecked

このアクションは、要素 (通常はチェックボックスまたはラジオ ボックス) がチェックされているかどうかを示す true または false を返します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素がチェックされている	ElementIsChecked	boolean	要素がチェックされている場合は true、そうでない場合は false を返します。

UIA 要素が存在しないのを待つ

操作 ID:

UIAWaitForElementToNotExist

要素 (通常、ボタンやテキスト入力領域など、ウィンドウ内の個々の要素) が存在しなくなったのを待ちます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
待機する秒数	SecondsToWait	True	integer	要素が存在しないまで待機する最大秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
要素がまだ存在する場合は例外を発生させる	RaiseExceptionIfElementStillExists		boolean	待機期間 IA-Connect 後も UIA 要素がまだ存在する場合は、例外を発生させる必要がありますか?
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
待機前に要素が存在する	ElementExistsBeforeWait	boolean	待機する前に要素が存在していた場合は true を返し、存在しない場合は false を返します。
待機後に要素が存在する	ElementExistsAfterWait	boolean	待機後に要素が存在した場合は true、存在しない場合は false を返します。

UIA 要素でのグローバルな左マウス のダブルクリック

操作 ID:

UIAGlobalDoubleLeftMouseClickOnElement

UIA 要素を基準にして、マウスを中央または選択したエッジ、コーナー、オフセットに移動し、マウスの左ボタンをダブルクリックします。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
ミリ秒単位の遅延	DelayInMilliseconds		integer	各クリックの間の遅延 (ミリ秒)。
最初にフォーカス要素	FocusElementFirst		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
[オフセット X] をクリックします	ClickOffsetX		integer	クリック アクションをオフセットする X ピクセルの数。 このパラメーターは、正 (右) オフセット値と負 (左) オフセット値の両方をサポートします。
オフセット Y をクリックする	ClickOffsetY		integer	クリック アクションをオフセットする Y ピクセルの数。 このパラメーターは、正 (下) オフセット値と負 (上) オフセット値の両方をサポートします。
相対オフセット	OffsetRelativeTo		string	オフセットする要素の相対位置 (中央/中央/中央、左、右、上、下、左上、右上、左下、右下)。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素にテキストを入力する

操作 ID:

UIAInputTextIntoElement

既存のテキストを置き換えるか、新しい値を特定の位置に挿入するか、要素 (通常はテキスト入力フィールド) にテキストを入力する UIA アクション。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
入力するテキスト	TextToInput		string	入力するテキスト値。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
既存の値を置き換える	ReplaceExistingValue		boolean	要素に既存のテキストがある場合は、これを置き換える必要がありますか?
挿入位置	InsertPosition		integer	テキストの挿入を開始する位置 (インデックス)。 既存のテキストがある場合は、挿入位置を使用して、既存のテキスト内の特定の位置に挿入できます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
入力の検証が失敗した場合に例外を発生させる	RaiseExceptionIfInputValidationFails		boolean	有効にすると、IA-Connect エージェントは、要求されたテキストを入力した後、要素の新しい値を確認します。 新しい値が予期された値と一致しない場合は、例外が発生します。 この入力が false (既定値) の場合、警告がログに入力されますが、例外は発生しません。
値パターンを試す	TryValuePattern		boolean	true (既定値) に設定すると、IA-Connect エージェントは UIA 値パターンを使用してテキスト入力アクションを実行しようとします。 選択した要素で UIA 値パターンが使用できない場合、IA-Connect エージェントは他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。
従来のパターンを試す	TryLegacyPattern		boolean	true に設定すると、IA-Connect エージェントは、UIA レガシ パターンを使用して、値パターンが使用できない場合 (要素に存在しないか、その使用が無効にされたため) にテキスト入力アクションを実行しようとします。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素にパスワードを入力する

操作 ID:

UIAInputPasswordIntoElement

既存のテキストを置き換えて、要素 (通常はパスワード入力フィールド) にパスワードを入力する UIA アクション。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
入力するパスワード	PasswordToInput	True	password	入力するパスワード値。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
パスワードに保存されたパスワードが含まれている	PasswordContainsStoredPassword		boolean	パスワードに {IAConnectPassword:StoredPasswordIdentifier} 形式または IA-Connect Orchestrator 汎用資格情報 ({OrchestratorCredential:FriendlyName} 形式) の IA-Connect に格納されているパスワード識別子が含まれている (または完全に) 場合は true に設定します。 この保存されたパスワードは、たとえば、"パスワードの生成" アクションによって生成されたか、IA-Connect Orchestrator によって保持されている可能性があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
値パターンを試す	TryValuePattern		boolean	true (既定値) に設定すると、IA-Connect エージェントは UIA 値パターンを使用してテキスト入力アクションを実行しようとします。 選択した要素で UIA 値パターンが使用できない場合、IA-Connect エージェントは他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。
従来のパターンを試す	TryLegacyPattern		boolean	true に設定すると、IA-Connect エージェントは、UIA レガシ パターンを使用して、値パターンが使用できない場合 (要素に存在しないか、その使用が無効にされたため) にテキスト入力アクションを実行しようとします。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素のグローバル マウス の中央クリック

操作 ID:

UIAGlobalMiddleMouseClickOnElement

UIA 要素を基準にしてマウスを中央に移動するか、選択したエッジ、コーナー、オフセットに移動し、マウスの中央ボタンをクリックします。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初にフォーカス要素	FocusElementFirst		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
[オフセット X] をクリックします	ClickOffsetX		integer	クリック アクションをオフセットする X ピクセルの数。 このパラメーターは、正 (右) オフセット値と負 (左) オフセット値の両方をサポートします。
オフセット Y をクリックする	ClickOffsetY		integer	クリック アクションをオフセットする Y ピクセルの数。 このパラメーターは、正 (下) オフセット値と負 (上) オフセット値の両方をサポートします。
相対オフセット	OffsetRelativeTo		string	オフセットする要素の相対位置 (中央/中央/中央、左、右、上、下、左上、右上、左下、右下)。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素のグローバル右クリック

操作 ID:

UIAGlobalRightMouseClickOnElement

UIA 要素を基準にして、マウスを中心または選択したエッジ、コーナー、オフセットに移動し、マウスの右ボタンをクリックします。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初にフォーカス要素	FocusElementFirst		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
[オフセット X] をクリックします	ClickOffsetX		integer	クリック アクションをオフセットする X ピクセルの数。 このパラメーターは、正 (右) オフセット値と負 (左) オフセット値の両方をサポートします。
オフセット Y をクリックする	ClickOffsetY		integer	クリック アクションをオフセットする Y ピクセルの数。 このパラメーターは、正 (下) オフセット値と負 (上) オフセット値の両方をサポートします。
相対オフセット	OffsetRelativeTo		string	オフセットする要素の相対位置 (中央/中央/中央、左、右、上、下、左上、右上、左下、右下)。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素のサイズ変更

操作 ID:

UIAResizeElement

UIA 要素のサイズを変更します。 このアクションは通常、(変換パターンを持つ) Window 要素でのみ機能します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
幅の種類のサイズ変更	ResizeWidthType		string	幅のサイズ変更の種類: 絶対または相対。
新しい幅	NewWidth	True	integer	要素の新しい幅。 サイズ変更の種類 (絶対または相対など) は、"幅のサイズ変更の種類" という入力によって定義されます。 幅を変更しない場合は、値 0 を選択し、[幅のサイズ変更の種類] を [相対] に設定します。
高さの種類のサイズを変更する	ResizeHeightType		string	高さのサイズ変更の種類: 絶対または相対。
新しい高さ	NewHeight	True	integer	要素の新しい高さ。 サイズ変更の種類 (絶対または相対など) は、"高さの種類のサイズ変更" という入力によって定義されます。 高さを変更しない場合は、値 0 を選択し、[高さの種類のサイズ変更] を [相対] に設定します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
コマンドの結果	UIAResizeElementResult	boolean	コマンドの結果 (成功または失敗)。
エラーメッセージ	ErrorMessage	string	コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。

UIA 要素のスクロール率を設定する

操作 ID:

UIASetElementScrollPercentage

その要素でスクロールがサポートされている場合は、指定した要素の水平方向および/または垂直方向のスクロール率を設定します。 要素が 'scroll' パターンをサポートしている場合は、このアクションを要素に直接適用し、水平方向または垂直方向のスクロール量 (またはその両方) を指定できます。 要素が 'scroll' パターンをサポートしていない場合、このアクションは 'range value' または 'value' パターンにフォールバックしますが、要素自体ではなく、スクロール バー コントロールに直接適用する必要があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
水平スクロールの割合	HorizontalScrollPercentage		double	要素を水平方向にスクロールする位置 (0 ~ 100 を含む、サポートされている 10 進数) または水平スクロール位置を変更しない -1。
垂直スクロールの割合	VerticalScrollPercentage		double	要素を垂直方向にスクロールする位置 (0 から 100 を含む、サポートされている小数) または垂直スクロール位置を変更しない -1。
スクロール パターンを試す	TryScrollPattern		boolean	true に設定すると、IA-Connect エージェントは UIA スクロール パターンを使用してスクロール アクションを実行しようとします。 選択した要素で UIA スクロール パターンが使用できない場合、IA-Connect エージェントは他の選択されたパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントはスクロール パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲の値、および値です。
範囲値パターンを試す	TryRangeValuePattern		boolean	true に設定すると、IA-Connect エージェントは UIA 範囲値パターンを使用してスクロール アクションを実行しようとします。 選択した要素で UIA 範囲値パターンが使用できない場合、IA-Connect エージェントは、選択した他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは範囲値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲の値、および値です。
値パターンを試す	TryValuePattern		boolean	true に設定すると、IA-Connect エージェントは UIA 値パターンを使用してスクロール アクションを実行しようとします。 選択した要素で UIA 値パターンが使用できない場合、IA-Connect エージェントは選択した他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲の値、および値です。 警告: 編集要素に値パターンを使用すると、その値が編集要素に入力されます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
コマンドの結果	UIASetElementScrollPercentageResult	boolean	コマンドの結果 (成功または失敗)。
エラーメッセージ	ErrorMessage	string	コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。

UIA 要素のテキスト値を取得する

操作 ID:

UIAGetElementTextValue

要素のテキスト値を返します。 通常、テキスト値はラベルに関連付けられますが、多くの要素でこのプロパティを持つことができます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素のテキスト値	ElementTextValue	string	要素のテキスト値。

UIA 要素のプロパティをリストとして取得する

操作 ID:

UIAGetElementPropertiesAsList

要素のプロパティを、個々の項目ではなく単一行リスト (単一行コレクション/データ テーブル) として返します。これは、データの使用方法に応じて役立つ場合があります。

パラメーター

名前	キー	必須	型	説明
要素ハンドル	ElementHandle	True	integer	ターゲット要素の UIA ハンドル。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
検出された要素の数	NumberOfElementsFound	integer	検出された要素の数。
返される要素の数	NumberOfElementsReturned	integer	返される要素の数。
UIA 要素のプロパティ JSON	UIAElementPropertiesJSON	string	JSON 形式の要素の UIA プロパティ。

UIA 要素のプロパティを取得する

操作 ID:

UIAGetElementProperties

要素のすべてのプロパティを返します。 これは、必要なプロパティ値を保持するフィールドが不明な場合に役立ちます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
戻り値要素の値	ReturnElementValue		boolean	true に設定すると、配置された要素の値が返されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素フレームワーク ID	ElementFrameworkId	string	要素の UIA フレームワーク ID。
要素コントロールの種類	ElementControlType	string	UIA コントロールの型を数値として指定します。 これはローカライズされたコントロールの種類に似ていますが、言語固有ではありません。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。
要素が有効になっている	ElementIsEnabled	boolean	要素が有効かどうかを返します。
要素がオフスクリーンである	ElementIsOffscreen	boolean	要素がオフスクリーンかどうかを返します。
要素がキーボードフォーカス可能である	ElementIsKeyboardFocusable	boolean	キーボードで要素にフォーカスを合わせることができるかどうかを返します。
要素にキーボード フォーカスがある	ElementHasKeyboardFocus	boolean	要素に現在キーボード フォーカスがあるかどうかを返します。
要素は password フィールドです	ElementIsPasswordField	boolean	要素がパスワード入力フィールドかどうかを返します。
要素アクセラレータ キー	ElementAcceleratorKey	string	要素をアクティブにするために押されたホットキーを返します。
要素アクセス キー	ElementAccessKey	string	押してメニュー要素をアクティブ化できるホットキーを返します。
要素の左端	ElementLeftEdge	integer	要素またはウィンドウの左端とディスプレイの左端との間の距離 (ピクセル単位)。
要素の右端	ElementRightEdge	integer	要素またはウィンドウの右端とディスプレイの左端との間の距離 (ピクセル単位)。
要素の上端	ElementTopEdge	integer	要素またはウィンドウの上端とディスプレイの上端との間の距離 (ピクセル単位)。
要素の下端	ElementBottomEdge	integer	要素またはウィンドウの下端とディスプレイの上端との間の距離 (ピクセル単位)。
要素のクリック可能なポイント X	ElementClickablePointX	integer	基になるアプリケーションによって返されるディスプレイの左端を基準とした、要素内の中央クリック可能なポイントのピクセル単位の X 座標。
要素クリック可能ポイント Y	ElementClickablePointY	integer	基になるアプリケーションによって返されるディスプレイの上端を基準とした、要素内の中央クリック可能なポイントの Y 座標 (ピクセル単位)。
要素プロセス ID	ElementProcessId	integer	この要素を所有するプロセスのプロセス ID (PID)。
要素ハンドル	ElementHandle	integer	入力 'Return 要素ハンドル' が true に設定されている場合、これは数値要素ハンドルを保持します。このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
要素の値	ElementValue	string	入力 'Return element value' が true に設定され、要素に値パターンがある場合は、その値が保持されます。
要素のテキスト値	ElementTextValue	string	入力 'Return element value' が true に設定され、要素にテキスト値パターンがある場合は、そのテキスト値が保持されます。

UIA 要素のラベル値を取得する

操作 ID:

UIAGetElementLabelValue

要素のラベルの値を返します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素ラベルの値	ElementLabelValue	string	要素のラベルの値。

UIA 要素の値を取得する

操作 ID:

UIAGetElementValue

要素の値を返します。 通常、値はテキスト入力領域に関連付けられますが、多くの要素でこのプロパティを持つことができます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素の値	ElementValue	string	要素の値。

UIA 要素の切り替え

操作 ID:

UIAToggleElement

要素 (通常はチェックボックスまたはラジオ ボックス) を切り替えます。 これにより、要素は現在の状態とは反対の状態になります (たとえば、checked がオフになり、その逆になります)。 特定の状態を設定する場合は、代わりにアクション 'Check 要素' を使用します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素の周囲に四角形を描画する

操作 ID:

UIADrawRectangleAroundElement

見つかった要素が必要であることを識別するのに役立つ、要素の周囲に四角形を描画します。 四角形は、5 秒後に自動的に削除されます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
ペンの色	PenColour		string	描画する四角形の色 (赤、緑、青、黄、紫、オレンジなど) または文字列の 16 進コード (例: #FF0000)。
ペンの太さピクセル	PenThicknessPixels		integer	強調表示四角形の境界線の太さ (ピクセル単位)。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素の場所のスクリーンショットを撮る

操作 ID:

UIATakeScreenShotOfElementLocation

要素の場所のスクリーンショットを取得し、画像を返します。 スクリーンショットが要素の場所で画面のコピーを取得するため、最初に要素を前面に移動する必要があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
イメージ形式	ImageFormat		string	スクリーンショットに使用する画像形式。 これは、返されるデータの品質とサイズに影響する可能性があります。 サポートされている形式は、PNG (既定)、JPG、BMP、GIF です。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、スクリーンショットを隠さない場合は true に設定します。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
Base64 としての画面イメージ	ScreenBitmapBase64	string	Base64 でエンコードされた文字列としての画面イメージ。

UIA 要素の展開

操作 ID:

UIAExpandElement

要素 (通常はメニュー/ドロップダウン 項目) を展開します。 項目が既に展開されている場合、何も起こりません。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素の折りたたみ

操作 ID:

UIACollapseElement

要素 (通常はメニュー/ドロップダウン 項目) を折りたたみます。 アイテムが既に折りたたまれている場合、何も起こりません。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素の検索モードを設定する

操作 ID:

SetUIAElementSearchMode

UIA アクションを実行するときに、IA-Connect エージェントで使用する UIA 要素検索モードを選択します。 通常、このアクションは、既定のモード (すべて検索) で問題が発生している場合にのみ使用されます。

パラメーター

名前	キー	必須	型	説明
UIA 要素検索モード	UIAElementSearchMode	True	string	使用する UIA 要素検索モード。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
コマンドの結果	SetUIAElementSearchModeResult	boolean	コマンドの結果 (成功または失敗)。
エラーメッセージ	ErrorMessage	string	コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。

UIA 要素の移動

操作 ID:

UIAMoveElement

UIA 要素を画面上の指定した位置に移動します。 このアクションは通常、(変換パターンを持つ) Window 要素でのみ機能します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
水平移動の種類	HorizontalMovementType		string	移動の種類: 絶対または相対。
水平方向の位置	HorizontalPosition	True	integer	要素の新しい水平位置。 移動の種類 (絶対移動や相対移動など) は、入力 "水平移動の種類" によって定義されます。 水平方向の位置を変更せずに残すには、0 の値を選択し、[水平移動の種類] を [相対] に設定します。
垂直移動タイプ	VerticalMovementType		string	移動の種類: 絶対または相対。
垂直方向の位置	VerticalPosition	True	integer	要素の新しい垂直方向の位置。 移動の種類 (絶対移動や相対移動など) は、入力 "垂直移動の種類" によって定義されます。 垂直方向の位置を変更せずに残すには、値 0 を選択し、[垂直移動の種類] を [相対] に設定します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
コマンドの結果	UIAMoveElementResult	boolean	コマンドの結果 (成功または失敗)。
エラーメッセージ	ErrorMessage	string	コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。

UIA 要素の選択

操作 ID:

UIASelectElement

要素 (通常はリストまたはドロップダウン内の項目) を選択します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素は存在しますか

操作 ID:

UIADoesElementExist

要素が存在するかどうかを報告し、いくつかの基本的な要素プロパティを返します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが検索されます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が存在する	ElementExists	boolean	要素が存在する場合は true、存在しない場合は false を返します。
要素ハンドル	ElementHandle	integer	要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

UIA 要素へのグローバル入力テキスト

操作 ID:

UIAGlobalTextInputIntoElement

マウスを要素の中心に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ UIA 入力メソッドを受け入れられないテキスト入力で使用されます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
最初にフォーカス要素	FocusElement		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
要素をマウスでグローバルに左クリック	GlobalMouseClickOnElement		boolean	テキストを入力する前に、(要素にフォーカスを合わせるために) グローバル マウス クリックを要素座標で実行する必要がありますか?
マウスのダブルクリック削除を使用して既存の値を置き換える	ReplaceExistingValueUsingDoubleClickDelete		boolean	マウスをダブルクリックして (強調表示するには) 既存の値を置き換えてから削除する必要がありますか?
CTRL-A delete を使用して既存の値を置き換える	ReplaceExistingValueUsingCTRLADelete		boolean	既存の値は、Ctrl-A (すべて強調表示) を押してから削除することで置き換える必要がありますか? 一部の要素では、Ctrl-A での強調表示がサポートされていない場合があります。その場合は、代替オプションの "マウスのダブルクリック削除を使用して既存の値を置換する" を試してください。
入力するテキスト	TextToInput		string	キーボードを使用したグローバル入力のテキスト値。
キーの送信イベントを使用する	SendKeyEvents		boolean	true に設定すると、キー イベント (シミュレートされたキーストロークをオペレーティング システムに送信する下位レベルの API) が使用されます。 false に設定すると、キー (フォーカスされた要素にキーストロークを送信する上位レベルの API) が代わりに使用されます。
間隔 (ミリ秒)	Interval		integer	各キーが押されるまでのミリ秒数。
シンボルを解釈しない	DontInterpretSymbols		boolean	"入力するテキスト" の記号は、特殊なキーとして解釈しないでください (たとえば、Shift キーの場合は +、Ctrl の場合は ^)。 実際のシンボルを入力する場合は、この値を true に設定する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素へのグローバル入力パスワード

操作 ID:

UIAGlobalPasswordInputIntoElement

マウスを要素の中心に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ UIA 入力メソッドを受け入れられないパスワード入力で使用されます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
最初にフォーカス要素	FocusElement		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
要素をマウスでグローバルに左クリック	GlobalMouseClickOnElement		boolean	テキストを入力する前に、(要素にフォーカスを合わせるために) グローバル マウス クリックを要素座標で実行する必要がありますか?
マウスのダブルクリック削除を使用して既存の値を置き換える	ReplaceExistingValueUsingDoubleClickDelete		boolean	マウスをダブルクリックして (強調表示するには) 既存の値を置き換えてから削除する必要がありますか?
CTRL-A delete を使用して既存の値を置き換える	ReplaceExistingValueUsingCTRLADelete		boolean	既存の値は、Ctrl-A (すべて強調表示) を押してから削除することで置き換える必要がありますか? 一部の要素では、Ctrl-A での強調表示がサポートされていない場合があります。その場合は、代替オプションの "マウスのダブルクリック削除を使用して既存の値を置換する" を試してください。
入力するパスワード	PasswordToInput	True	password	キーボードを使用したグローバル入力のパスワード値。
キーの送信イベントを使用する	SendKeyEvents		boolean	true に設定すると、キー イベント (シミュレートされたキーストロークをオペレーティング システムに送信する下位レベルの API) が使用されます。 false に設定すると、キー (フォーカスされた要素にキーストロークを送信する上位レベルの API) が代わりに使用されます。
間隔 (ミリ秒)	Interval		integer	各キーが押されるまでのミリ秒数。
シンボルを解釈しない	DontInterpretSymbols		boolean	'Password to input' の記号は、特殊なキーとして解釈しないでください (例: + for Shift、^ for Ctrl)。 実際のシンボルを入力する場合は、この値を true に設定する必要があります。
パスワードに保存されたパスワードが含まれている	PasswordContainsStoredPassword		boolean	パスワードに {IAConnectPassword:StoredPasswordIdentifier} 形式または IA-Connect Orchestrator 汎用資格情報 ({OrchestratorCredential:FriendlyName} 形式) の IA-Connect に格納されているパスワード識別子が含まれている (または完全に) 場合は true に設定します。 この保存されたパスワードは、たとえば、"パスワードの生成" アクションによって生成されたか、IA-Connect Orchestrator によって保持されている可能性があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素への入力の戻り値

操作 ID:

UIAInputReturnIntoElement

既存のテキストを置き換えるか、または特定の位置に戻り値を挿入して、要素 (通常はテキスト入力フィールド) に Windows の戻り値または改行を入力します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
既存の値を置き換える	ReplaceExistingValue		boolean	要素に既存のテキストがある場合は、これを置き換える必要がありますか?
挿入位置	InsertPosition		integer	テキストの挿入を開始する位置 (インデックス)。 既存のテキストがある場合は、挿入位置を使用して、既存のテキスト内の特定の位置に挿入できます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
入力の検証が失敗した場合に例外を発生させる	RaiseExceptionIfInputValidationFails		boolean	有効にすると、IA-Connect エージェントは、要求されたテキストを入力した後、要素の新しい値を確認します。 新しい値が予期された値と一致しない場合は、例外が発生します。 この入力が false (既定値) の場合、警告がログに入力されますが、例外は発生しません。
値パターンを試す	TryValuePattern		boolean	true (既定値) に設定すると、IA-Connect エージェントは UIA 値パターンを使用してテキスト入力アクションを実行しようとします。 選択した要素で UIA 値パターンが使用できない場合、IA-Connect エージェントは他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。
従来のパターンを試す	TryLegacyPattern		boolean	true に設定すると、IA-Connect エージェントは、UIA レガシ パターンを使用して、値パターンが使用できない場合 (要素に存在しないか、その使用が無効にされたため) にテキスト入力アクションを実行しようとします。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素をマウスでグローバルに左クリックする

操作 ID:

UIAGlobalMouseClickOnElement

UIA 要素を基準にして、マウスを中心または選択したエッジ、コーナー、オフセットに移動し、マウスの左ボタンをクリックします。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初にフォーカス要素	FocusElementFirst		boolean	グローバルクリック IA-Connect 前に要素にフォーカスを設定する必要がありますか?
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
[オフセット X] をクリックします	ClickOffsetX		integer	クリック アクションをオフセットする X ピクセルの数。 このパラメーターは、正 (右) オフセット値と負 (左) オフセット値の両方をサポートします。
オフセット Y をクリックする	ClickOffsetY		integer	クリック アクションをオフセットする Y ピクセルの数。 このパラメーターは、正 (下) オフセット値と負 (上) オフセット値の両方をサポートします。
相対オフセット	OffsetRelativeTo		string	オフセットする要素の相対位置 (中央/中央/中央、左、右、上、下、左上、右上、左下、右下)。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
要素境界内のクリック可能なポイントを検証する	ValidateClickablePointWithinElementBoundary		boolean	一部の要素では、UIA は要素内のクリック可能なポイントを認識せず、要素の中心ではなく無効な座標 (0,0 など) を返します。 この入力が true に設定されている場合、IA-Connect は UIA によって提供される座標の有効性を確認し、要素の境界内にない場合は UIA によって提供される値を無視し、代わりに要素の中心を使用します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素を待機する

操作 ID:

UIAWaitForElement

要素 (通常、ボタンやテキスト入力領域など、ウィンドウ内の個々の要素) が存在するまで待機します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索プロセス ID	SearchProcessId		integer	指定した場合 (値 1 以上)、このプロセス ID (PID) を持つプロセスが所有する要素のみが検索で考慮されます。 プロセス IA-Connect 起動した場合、PID は、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます。 PID がわからない場合は、このフィールドを空白 (または 0) のままにします。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
待機する秒数	SecondsToWait	True	integer	要素が存在するまで待機する最大秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
子プロセスを含める	IncludeChildProcesses		boolean	true に設定され、"Search process Id" が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、正確な '検索プロセス ID' と一致するプロセスのみが返されます。
要素が見つからない場合は例外を発生させる	RaiseExceptionIfElementNotFound		boolean	待機期間 IA-Connect 後に UIA 要素が存在しない場合は、例外を発生させる必要がありますか?
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が存在する	ElementExists	boolean	要素が存在する場合は true、存在しない場合は false を返します。
要素ハンドル	ElementHandle	integer	要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

UIA 要素を押す

操作 ID:

UIAPressElement

要素 (通常はボタン) を押します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
ボタン イベントが完了するまで待つ	Wait		boolean	続行する前に、オートメーションがボタン イベントの完了を待つ必要があります。 true に設定すると、ボタンがモーダル ダイアログを開くとタイムアウトが発生する可能性があります。
Win32 のクリック ボタン	Win32ClickButton		boolean	true に設定すると、UIA を使用する代わりに Win32 クリック イベントが使用されます。 これは、クリック後に表示されるモーダル ダイアログ、または UIA 呼び出しパターンを持たない要素を処理する場合に便利な"起動と忘れ" のクリック イベントです。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
呼び出しパターンを試す	TryInvokePattern		boolean	true (既定値) に設定すると、IA-Connect エージェントは UIA 呼び出しパターンを使用して押すアクションを実行しようとします ('Win32 クリック ボタン' が true に設定されていない場合)。 選択した要素で UIA 呼び出しパターンが使用できない場合、IA-Connect エージェントは他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは呼び出しパターンの使用を試みず、すぐに他の選択されたパターンにフォールバックします。
従来のパターンを試す	TryLegacyPattern		boolean	true に設定すると、IA-Connect エージェントは、呼び出しパターンが使用できない場合 (要素に存在しないか、または使用が無効になっているため) と、'Win32 クリック ボタン' が false の場合に、UIA レガシ パターンを使用してプレス アクションを実行しようとします。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素を数値に設定する

操作 ID:

UIASetElementToNumericValue

テキスト フィールドやスクロール バーなど、数値入力を持つ要素の値を設定します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
新しい値	NewValue	True	integer	要素を設定する数値。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
入力の検証が失敗した場合に例外を発生させる	RaiseExceptionIfInputValidationFails		boolean	有効にすると、IA-Connect エージェントは、要求されたテキストを入力した後、要素の新しい値を確認します。 新しい値が予期された値と一致しない場合は、例外が発生します。 この入力が false (既定値) の場合、警告がログに入力されますが、例外は発生しません。
値パターンを試す	TryValuePattern		boolean	true (既定値) に設定すると、IA-Connect エージェントは UIA 値パターンを使用してテキスト入力アクションを実行しようとします。 選択した要素で UIA 値パターンが使用できない場合、IA-Connect エージェントは他のパターンにフォールバックします (このアクションへの他の入力によって有効または無効になります)。 false に設定すると、IA-Connect エージェントは値パターンの使用を試みず、すぐに他の選択したパターンにフォールバックします。
従来のパターンを試す	TryLegacyPattern		boolean	true に設定すると、IA-Connect エージェントは、UIA レガシ パターンを使用して、値パターンが使用できない場合 (要素に存在しないか、その使用が無効にされたため) にテキスト入力アクションを実行しようとします。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素を数値範囲の値に設定する

操作 ID:

UIASetElementToNumericRangeValue

スクロール バーなど、数値範囲を持つ要素の値を設定します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
新しい値	NewValue	True	double	要素を設定する数値範囲の値。
新しい値はパーセンテージです	NewValueIsPercentage		boolean	新しい値はパーセンテージですか?
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素を確認する

操作 ID:

UIACheckElement

要素の状態 (通常はチェックボックスまたはラジオ ボックス) をオンまたはオフに設定します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Check 要素	CheckElement		boolean	要素をチェックする必要がありますか (true) またはオフ (false)?
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素ウィンドウを閉じる

操作 ID:

UIACloseElementWindow

要素ウィンドウを閉じます。 通常、ウィンドウまたはダイアログでのみ機能します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

UIA 要素パターンを取得する

操作 ID:

UIAGetElementPatterns

UIA 要素で使用できる UIA パターンを取得します。そのため、どの UIA アクション IA-Connect が要素に影響を与える可能性があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
使用できる展開折りたたみパターン	ExpandCollapsePatternAvailable	boolean	UIA 展開折りたたみパターンを使用できるため、要素 (ドロップダウン メニューなど) を展開または折りたたむアクションが機能する可能性があります。
使用可能な呼び出しパターン	InvokePatternAvailable	boolean	UIA 呼び出しパターンを使用できるため、要素を押すかリスト要素項目をクリックするアクションが機能する可能性があります。
使用可能な範囲値パターン	RangeValuePatternAvailable	boolean	UIA 範囲値パターンが使用可能であるため、要素またはスライダーをスクロールするアクションが機能する可能性があります。
使用可能なスクロール パターン	ScrollPatternAvailable	boolean	UIA スクロール パターンを使用できるため、要素をスクロールするアクションが機能する可能性があります。
選択可能な選択項目パターン	SelectionItemPatternAvailable	boolean	UIA 選択項目パターンが使用可能であるため、要素を選択するアクションが機能する可能性があります。
使用可能なテキスト パターン	TextPatternAvailable	boolean	UIA テキスト パターンが使用可能であるため、要素テキスト値を読み取るアクションが機能する可能性があります。
使用可能なトグル パターン	TogglePatternAvailable	boolean	UIA トグル パターンが使用可能であるため、要素をチェック、オフ、または切り替えるアクションが機能する可能性があります。
使用可能な値パターン	ValuePatternAvailable	boolean	UIA 値パターンを使用できるため、要素にテキストを入力したり、要素値を読み取ったりするアクションが機能する可能性があります。 スクロール バーは、値パターンに反応する場合もあります。
使用可能なウィンドウ パターン	WindowPatternAvailable	boolean	UIA ウィンドウ パターンを使用できるため、要素を閉じる、最大化する、または最小限に抑えるアクションが機能する可能性があります。
使用可能なグリッド パターン	GridPatternAvailable	boolean	UIA グリッド パターンを使用できます。 このパターンは、IA-Connect では使用されません。
利用可能なグリッド項目パターン	GridItemPatternAvailable	boolean	UIA グリッド項目パターンを使用できます。 このパターンは、IA-Connect では使用されません。
使用可能な従来の IAccessible パターン	LegacyIAccessiblePatternAvailable	boolean	UIA レガシ IAccessible パターンを使用できます。 このパターンは、IA-Connect では使用されません。
選択可能な選択パターン	SelectionPatternAvailable	boolean	UIA 選択パターンを使用できます。 このパターンは、IA-Connect では使用されません。
利用できるスプレッドシート パターン	SpreadsheetPatternAvailable	boolean	UIA スプレッドシート パターンを使用できます。 このパターンは、IA-Connect では使用されません。
利用可能なスプレッドシートアイテムパターン	SpreadsheetItemPatternAvailable	boolean	UIA スプレッドシート項目パターンを使用できます。 このパターンは、IA-Connect では使用されません。
使用可能なテーブル パターン	TablePatternAvailable	boolean	UIA テーブル パターンを使用できます。 このパターンは、IA-Connect では使用されません。
テーブル項目のパターンを使用できます	TableItemPatternAvailable	boolean	UIA テーブル項目パターンを使用できます。 このパターンは、IA-Connect では使用されません。
テキスト パターン 2 が使用可能	TextPattern2Available	boolean	UIA テキスト パターン 2 を使用できます。 このパターンは、IA-Connect では使用されません。
使用可能なテキスト編集パターン	TextEditPatternAvailable	boolean	UIA テキスト編集パターンを使用できます。 このパターンは、IA-Connect では使用されません。
使用可能な変換パターン	TransformPatternAvailable	boolean	UIA 変換パターンを使用できます。 このパターンは、IA-Connect では使用されません。

UIA 要素内で表示されている検索イメージを見つける

操作 ID:

UIALocateVisibleSearchImageWithinElement

このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に表示されているかどうかを返します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
画像の種類を検索する	SearchImageType		string	[Search image]\(検索イメージ\) 入力が表す内容を定義します。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
検索画像	SearchImage		string	指定した UIA 要素内で検索する検索イメージ。 指定した '検索イメージの種類' に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。
代替検索画像の種類	AltSearchImageType		string	"代替検索イメージ" 入力が表す内容を定義します。 [なし] または [空白] に設定した場合、代替の検索イメージはありません。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
代替検索画像	AltSearchImage		string	指定した UIA 要素内で検索するオプションの代替検索イメージ。 指定した "代替検索イメージの種類" に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。 代替検索イメージを指定した場合、エージェントは検索イメージまたは代替検索イメージを検索し、検索された画像を報告します。
最大色偏差	MaxColourDeviation		integer	要素のピクセルカラーの最大値は、一致と見なされない前に検索画像のピクセルカラーから逸脱する可能性があります。 偏差がない場合は 0。 偏差は RGB 値で測定されます。 たとえば、#FF0000 は #FE0102 とは 4 異なります。 これにより、わずかな色の違いを無視できます。
最大ピクセル差	MaxPixelDifferences		integer	画像が一致しないと見なされる前に、検索画像全体で異なる可能性がある最大ピクセル数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"連続する最大ピクセル差" も設定する必要があります。
連続する最大ピクセル差	MaxConsecutivePixelDifferences		integer	画像が一致しないと見なされる前に、任意の行で異なる可能性がある連続するピクセルの最大数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"最大ピクセル差" も設定する必要があります。
左ピクセル X オフセット	LeftPixelXOffset		integer	検索領域の左端の省略可能な X オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
右ピクセル X オフセット	RightPixelXOffset		integer	検索領域の右端の省略可能な X オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
トップ ピクセル Y オフセット	TopPixelYOffset		integer	検索領域の上端のオプションの Y オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
下ピクセル Y オフセット	BottomPixelYOffset		integer	検索領域の下端のオプションの Y オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
ピクセル X オフセット単位	PixelXOffsetsUnit		string	左右のピクセル X オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 左右のピクセル X オフセットが要素の幅に対する割合として測定される場合は、"Percent" に設定されます。
ピクセル Y オフセット単位	PixelYOffsetsUnit		string	上と下のピクセルの Y オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 上と下のピクセル Y オフセットが要素の高さに対するパーセンテージとして測定される場合は、"Percent" に設定されます。
画像インデックスの検索	SearchImageIndex		integer	UIA 要素内で検索イメージの最初のインスタンス (検索の方向) を検索するには、1 に設定します。 2 番目のインスタンスの場合は 2、N 番目のインスタンスの場合は N に設定します。 代替イメージも検索している場合、UIA 要素は最初に検索イメージをスキャンし、次に代替イメージを検索し、その特定のイメージの要求されたインスタンスを検索します (つまり、エージェントは両方のイメージを混在させるのではなく、どちらか一方を想定しています)。
画像検索の方向	ImageSearchDirection		string	検索の方向。 "上から" では、上から行で検索され、各行内で左から右にスキャンされます。 "下から" では、下から行で検索され、各行内で左から右にスキャンされます。 "From left" では、左側の列で検索され、各列内で上から下にスキャンされます。 '右から' は右から列で検索し、各列内で上から下にスキャンします。 これは、'Search image index' と組み合わせて使用して、N 番目の画像を上、下、左、または右から見つけることができます。 パフォーマンスを向上させるには、画像の検索速度が速いと思われる検索方向を選択します。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、分析対象の要素が隠されないようにするには、true に設定します。
画面座標を物理として返す	ReturnPhysicalCoordinates		boolean	物理座標として返される画面座標の場合は true に設定します。 仮想座標として返される画面座標の場合は false に設定します。 基になるディスプレイのスケーリングが 100%の場合、物理座標と仮想座標の両方が同じです。 要素座標は常に仮想座標として返されます。
強調表示の四角形を表示する	ShowHighlightRectangle		boolean	true に設定すると、IA-Connect エージェントによって画面上に配置されたイメージが強調表示されます。 これは、開発中に、正しい画像が検出されていることを視覚化するのに役立ちます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
検索対象の画像	SearchImageLocated	boolean	検索イメージが見つかった場合は true に設定します。 検索イメージが見つからない場合は false に設定します。
どの検索画像が見つかりませんか	WhichSearchImageLocated	integer	検索画像が見つからない場合は、0 に設定します。 検索イメージが見つかった場合は 1 に設定します。 代替検索イメージが見られた場合は、2 に設定します。
画像の一致境界ボックス要素の左ピクセル	SearchImageBoundingBoxElementLeftPixelXCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する左端のピクセルの仮想 X 座標。
画像の一致境界ボックス要素の右ピクセル	SearchImageBoundingBoxElementRightPixelXCoord	integer	要素の仮想左上を基準とした、指定された画像に一致する右端のピクセルの仮想 X 座標。
画像の一致境界ボックス要素の上のピクセル	SearchImageBoundingBoxElementTopPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する最上位ピクセルの仮想 Y 座標。
画像の一致境界ボックス要素の下のピクセル	SearchImageBoundingBoxElementBottomPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する最下位ピクセルの仮想 Y 座標。
画像一致境界ボックス要素の中心 X ピクセル	SearchImageBoundingBoxElementCenterPixelXCoord	integer	要素の仮想左上を基準とした、指定したイメージに一致するピクセルを含む境界ボックスの中心の仮想 X 座標。
画像の一致境界ボックス要素の中心 Y ピクセル	SearchImageBoundingBoxElementCenterPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致するピクセルを含む境界ボックスの中心の仮想 Y 座標。
画像の一致境界ボックスの画面の左ピクセル	SearchImageBoundingBoxScreenLeftPixelXCoord	integer	指定した画像に一致する左端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックス画面の右ピクセル	SearchImageBoundingBoxScreenRightPixelXCoord	integer	指定した画像に一致する右端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックスの画面の上のピクセル	SearchImageBoundingBoxScreenTopPixelYCoord	integer	指定した画像に一致する最上位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像一致境界ボックスの画面下部ピクセル	SearchImageBoundingBoxScreenBottomPixelYCoord	integer	指定した画像に一致する最下位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックス画面の中心 X ピクセル	SearchImageBoundingBoxScreenCenterPixelXCoord	integer	指定した画像に一致するピクセルを含む境界ボックスの中心の画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像一致境界ボックス画面中央 Y ピクセル	SearchImageBoundingBoxScreenCenterPixelYCoord	integer	指定した画像に一致するピクセルを含む境界ボックスの中心の画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。

UIA 要素内で表示される検索イメージを待機する

操作 ID:

UIAWaitForVisibleSearchImageWithinElement

このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に見える形で配置されるか、指定された時間が経過するまで待機します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。 UIA 要素は最初から存在する必要があります。 このアクションは、イメージが見つからればすぐに完了します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle		integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
画像の種類を検索する	SearchImageType		string	[Search image]\(検索イメージ\) 入力が表す内容を定義します。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
検索画像	SearchImage		string	指定した UIA 要素内で検索する検索イメージ。 指定した '検索イメージの種類' に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。
代替検索画像の種類	AltSearchImageType		string	"代替検索イメージ" 入力が表す内容を定義します。 [なし] または [空白] に設定した場合、代替の検索イメージはありません。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
代替検索画像	AltSearchImage		string	指定した UIA 要素内で検索するオプションの代替検索イメージ。 指定した "代替検索イメージの種類" に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。 代替検索イメージを指定した場合、エージェントは検索イメージまたは代替検索イメージを検索し、検索された画像を報告します。
最大色偏差	MaxColourDeviation		integer	要素のピクセルカラーの最大値は、一致と見なされない前に検索画像のピクセルカラーから逸脱する可能性があります。 偏差がない場合は 0。 偏差は RGB 値で測定されます。 たとえば、#FF0000 は #FE0102 とは 4 異なります。 これにより、わずかな色の違いを無視できます。
最大ピクセル差	MaxPixelDifferences		integer	画像が一致しないと見なされる前に、検索画像全体で異なる可能性がある最大ピクセル数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"連続する最大ピクセル差" も設定する必要があります。
連続する最大ピクセル差	MaxConsecutivePixelDifferences		integer	画像が一致しないと見なされる前に、任意の行で異なる可能性がある最大ピクセル数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"最大ピクセル差" も設定する必要があります。
左ピクセル X オフセット	LeftPixelXOffset		integer	検索領域の左端の省略可能な X オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
右ピクセル X オフセット	RightPixelXOffset		integer	検索領域の右端の省略可能な X オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
トップ ピクセル Y オフセット	TopPixelYOffset		integer	検索領域の上端のオプションの Y オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
下ピクセル Y オフセット	BottomPixelYOffset		integer	検索領域の下端のオプションの Y オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
ピクセル X オフセット単位	PixelXOffsetsUnit		string	左右のピクセル X オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 左右のピクセル X オフセットが要素の幅に対する割合として測定される場合は、"Percent" に設定されます。
ピクセル Y オフセット単位	PixelYOffsetsUnit		string	上と下のピクセルの Y オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 上と下のピクセル Y オフセットが要素の高さに対するパーセンテージとして測定される場合は、"Percent" に設定されます。
画像インデックスの検索	SearchImageIndex		integer	UIA 要素内で検索イメージの最初のインスタンス (検索の方向) を検索するには、1 に設定します。 2 番目のインスタンスの場合は 2、N 番目のインスタンスの場合は N に設定します。 代替イメージも検索している場合、UIA 要素は最初に検索イメージをスキャンし、次に代替イメージを検索し、その特定のイメージの要求されたインスタンスを検索します (つまり、エージェントは両方のイメージを混在させるのではなく、どちらか一方を想定しています)。
画像検索の方向	ImageSearchDirection		string	検索の方向。 "上から" では、上から行で検索され、各行内で左から右にスキャンされます。 "下から" では、下から行で検索され、各行内で左から右にスキャンされます。 "From left" では、左側の列で検索され、各列内で上から下にスキャンされます。 '右から' は右から列で検索し、各列内で上から下にスキャンします。 これは、'Search image index' と組み合わせて使用して、N 番目の画像を上、下、左、または右から見つけることができます。 パフォーマンスを向上させるには、画像の検索速度が速いと思われる検索方向を選択します。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、分析対象の要素が隠されないようにするには、true に設定します。
画面座標を物理として返す	ReturnPhysicalCoordinates		boolean	物理座標として返される画面座標の場合は true に設定します。 仮想座標として返される画面座標の場合は false に設定します。 基になるディスプレイのスケーリングが 100%の場合、物理座標と仮想座標の両方が同じです。 要素座標は常に仮想座標として返されます。
強調表示の四角形を表示する	ShowHighlightRectangle		boolean	true に設定すると、IA-Connect エージェントによって画面上に配置されたイメージが強調表示されます。 これは、開発中に、正しい画像が検出されていることを視覚化するのに役立ちます。
検索イメージを待機する秒数	SecondsToWait		integer	検索イメージが UIA 要素内に配置されるまで待機する秒数。 イメージが見つからない場合は、'Raise exception if image not found' が true に設定されている場合に例外が発生し、それ以外の場合、アクションはイメージが見つからなかったことを報告します。
検索の間隔 (ミリ秒)	MillisecondsBetweenSearches		integer	画面上の各 UIA 要素の間で待機するミリ秒数。 画像認識は CPU コストがかかる可能性があるため、遅延は CPU 使用率の低下と分散の両方に役立ちます。 たとえば、画像が表示されるまでに最大 1 分かかると予想される場合、スキャンの間に 5000 ミリ秒 (5 秒) の一時停止を追加すると、CPU 使用率が大幅に低下します (スキャンの数が大幅に減ります)。ただし、応答時間に与える影響はごくわずかです。 最小値は 100 ミリ秒 (1/10 秒) です。
イメージが見つからない場合は例外を発生させる	RaiseExceptionIfImageNotFound		boolean	待機期間の後にイメージが見つからない場合 IA-Connect 例外を発生させる必要がある場合は true に設定します。
スレッド ID の出力データを取得する	RetrieveOutputDataFromThreadId		integer	以前に 'スレッドの待機' を false に設定した場合 (エージェントがバックグラウンド スレッドで待機を実行する原因となります)、結果を取得するエージェント スレッド ID を指定します。 このエージェント スレッド ID は、このアクションに対する以前の呼び出しによって提供されます。 それ以外の場合は、0 (既定値) に設定します。
スレッドを待つ	WaitForThread		boolean	エージェント スレッドが完了するまで待機するには true に設定します。エージェントは、"検索イメージを待機する秒数" で指定されている限り待機します。 待機をバイパスするには false に設定します。エージェントは引き続きバックグラウンドで待機を実行しますが、次のアクションにも使用できます。 その後、"エージェント スレッドが正常に完了するのを待機する" アクションを使用してエージェント スレッドが完了するのを待ってから、"スレッド ID の出力データを取得する" という入力をエージェント スレッド ID に設定して、この "UIA 要素内の表示される検索イメージを待機する" アクションを再実行することで、後で結果を取得できます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
検索対象の画像	SearchImageLocated	boolean	検索イメージが見つかった場合、この出力は true に設定されます。 検索イメージが見つからない場合、この出力は false に設定されます。
どの検索画像が見つかりませんか	WhichSearchImageLocated	integer	検索画像が見つからない場合、この出力は 0 に設定されます。 検索イメージが見つかった場合は、1 に設定します。 代替検索イメージが見られた場合は、2 に設定します。
画像の一致境界ボックス要素の左ピクセル	SearchImageBoundingBoxElementLeftPixelXCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する左端のピクセルの仮想 X 座標。
画像の一致境界ボックス要素の右ピクセル	SearchImageBoundingBoxElementRightPixelXCoord	integer	要素の仮想左上を基準とした、指定された画像に一致する右端のピクセルの仮想 X 座標。
画像の一致境界ボックス要素の上のピクセル	SearchImageBoundingBoxElementTopPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する最上位ピクセルの仮想 Y 座標。
画像の一致境界ボックス要素の下のピクセル	SearchImageBoundingBoxElementBottomPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致する最下位ピクセルの仮想 Y 座標。
画像一致境界ボックス要素の中心 X ピクセル	SearchImageBoundingBoxElementCenterPixelXCoord	integer	要素の仮想左上を基準とした、指定したイメージに一致するピクセルを含む境界ボックスの中心の仮想 X 座標。
画像の一致境界ボックス要素の中心 Y ピクセル	SearchImageBoundingBoxElementCenterPixelYCoord	integer	要素の仮想左上を基準とした、指定した画像に一致するピクセルを含む境界ボックスの中心の仮想 Y 座標。
画像の一致境界ボックスの画面の左ピクセル	SearchImageBoundingBoxScreenLeftPixelXCoord	integer	指定した画像に一致する左端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックス画面の右ピクセル	SearchImageBoundingBoxScreenRightPixelXCoord	integer	指定した画像に一致する右端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックスの画面の上のピクセル	SearchImageBoundingBoxScreenTopPixelYCoord	integer	指定した画像に一致する最上位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像一致境界ボックスの画面下部ピクセル	SearchImageBoundingBoxScreenBottomPixelYCoord	integer	指定した画像に一致する最下位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像の一致境界ボックス画面の中心 X ピクセル	SearchImageBoundingBoxScreenCenterPixelXCoord	integer	指定した画像に一致するピクセルを含む境界ボックスの中心の画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
画像一致境界ボックス画面中央 Y ピクセル	SearchImageBoundingBoxScreenCenterPixelYCoord	integer	指定した画像に一致するピクセルを含む境界ボックスの中心の画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
スレッド ID	ThreadId	integer	"スレッドの待機" を false に設定した場合 (エージェントがバックグラウンド スレッドで待機を実行する原因となります)、この出力にはエージェント スレッド ID が保持されます。この ID は、アクションのプロセスを監視し、後でスレッドが完了したときに結果を取得するために使用できます。

UIA 要素検索の色領域を取得する

操作 ID:

UIAGetElementSearchColourRegion

指定した色条件を満たす UIA 要素内のピクセル領域の詳細を返します。 エージェントは要素の座標でスクリーンショットを撮って色を見つけるので、最初に要素を前面に移動する必要があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索色	SearchColour	True	string	0xAARRGGBB、#AARRGGBB、0xRRGGBB、または各カラー チャネルが 16 進形式のバイトである #RRGGBB 形式で色を検索します (00 は完全にオフ、FF は完全にオン)。 例: #FF0000 は赤、#00FF00 は青、#000000 は黒、#FFFFFF は白です。
最大色偏差	MaxColourDeviation	True	integer	要素の色の最大値は、一致と見なされない前に検索色から逸脱する可能性があります。 偏差がない場合は 0。 偏差は RGB 値で測定されます。 たとえば、#FF0000 は #FE0102 とは 4 異なります。 15 の偏差は、出発点として適しています。
左ピクセル X オフセット	LeftPixelXOffset		integer	検索領域の左端の省略可能な X オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
右ピクセル X オフセット	RightPixelXOffset		integer	検索領域の右端の省略可能な X オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
トップ ピクセル Y オフセット	TopPixelYOffset		integer	検索領域の上端のオプションの Y オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
下ピクセル Y オフセット	BottomPixelYOffset		integer	検索領域の下端のオプションの Y オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、分析対象の要素が隠されないようにするには、true に設定します。
画面座標を物理として返す	ReturnPhysicalCoordinates		boolean	物理座標として返される画面座標の場合は true に設定します。 仮想座標として返される画面座標の場合は false に設定します。 基になるディスプレイのスケーリングが 100%の場合、物理座標と仮想座標の両方が同じです。 要素座標は常に仮想座標として返されます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
色に一致するピクセル数	NumberOfPixelsMatchingColour	integer	指定した色に一致するピクセル数。
色の一致境界ボックス要素の左ピクセル	ColourMatchBoundingBoxElementLeftPixelXCoord	integer	要素の仮想左上を基準とした、指定した色に一致する左端のピクセルの仮想 X 座標。
色の一致境界ボックス要素の右ピクセル	ColourMatchBoundingBoxElementRightPixelXCoord	integer	要素の仮想左上を基準とした、指定した色に一致する右端のピクセルの仮想 X 座標。
色の一致境界ボックス要素の上のピクセル	ColourMatchBoundingBoxElementTopPixelYCoord	integer	要素の仮想左上を基準とした、指定した色に一致する最上位ピクセルの仮想 Y 座標。
色の一致境界ボックス要素の下のピクセル	ColourMatchBoundingBoxElementBottomPixelYCoord	integer	要素の仮想左上を基準とした、指定した色に一致する最下位ピクセルの仮想 Y 座標。
色の一致境界ボックス要素の中心 X ピクセル	ColourMatchBoundingBoxElementCenterPixelXCoord	integer	要素の仮想左上を基準とした、指定した色に一致するピクセルを含む境界ボックスの中心の仮想 X 座標。
色の一致境界ボックス要素の中心 Y ピクセル	ColourMatchBoundingBoxElementCenterPixelYCoord	integer	要素の仮想左上を基準に、指定した色に一致するピクセルを含む境界ボックスの中心の仮想 Y 座標。
色の一致境界ボックスの画面の左ピクセル	ColourMatchBoundingBoxScreenLeftPixelXCoord	integer	指定した色に一致する左端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
色の一致境界ボックスの画面の右ピクセル	ColourMatchBoundingBoxScreenRightPixelXCoord	integer	指定した色に一致する右端のピクセルの画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
色の一致境界ボックスの画面の上のピクセル	ColourMatchBoundingBoxScreenTopPixelYCoord	integer	指定した色に一致する最上位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
色の一致境界ボックスの画面下部ピクセル	ColourMatchBoundingBoxScreenBottomPixelYCoord	integer	指定した色に一致する最下位ピクセルの画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
色の一致境界ボックスの画面の中心 X ピクセル	ColourMatchBoundingBoxScreenCenterPixelXCoord	integer	指定した色に一致するピクセルを含む境界ボックスの中心の画面ピクセル X 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。
色の一致境界ボックスの画面中央 Y ピクセル	ColourMatchBoundingBoxScreenCenterPixelYCoord	integer	指定した色に一致するピクセルを含む境界ボックスの中心の画面ピクセル Y 座標。 これは、入力 'Return physical coordinates' に応じて物理座標または仮想座標です。

UIA 要素検索モードを取得する

操作 ID:

GetUIAElementSearchMode

IA-Connect エージェントが UIA アクションに使用している UIA 要素検索モードを取得します。

パラメーター

名前	キー	必須	型	説明
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
UIA 要素検索モード	UIAElementSearchMode	string	IA-Connect エージェントによって現在使用されている UIA 要素検索モード。

UIA 親要素ハンドルを取得する

操作 ID:

UIAGetParentElementHandle

指定した要素の親要素のハンドルを返します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。

パラメーター

名前	キー	必須	型	説明
要素ハンドル	ElementHandle	True	integer	ターゲット要素の UIA ハンドル。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
親要素ハンドル	ParentElementHandle	integer	親要素の UIA ハンドル。

Win32 ウィンドウを取得する

操作 ID:

UIAGetWin32Windows

任意で指定したクラス名またはウィンドウ タイトルを持つすべての Win32 ウィンドウの一覧を返す高速 Win32 アクション。または、ワイルドカードを含むより高度な検索フィルターを指定できます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 Win32 Windows には、タスク バー、デスクトップ、スタート メニュー、透明なオーバーレイ、画面外のウィンドウ、非表示のウィンドウなど、予期しない項目が含まれている可能性があるため、返される一覧に予想以上の結果が含まれている可能性があります。

パラメーター

名前	キー	必須	型	説明
検索クラス名	SearchClassName		string	検索する最上位ウィンドウの省略可能なクラス名 (例: 'Chrome_WidgetWin_1')。
検索ウィンドウのタイトル	SearchWindowTitle		string	検索する最上位ウィンドウの省略可能なタイトル。
最上位レベルのウィンドウのみを取得する	TopLevelWindowsOnly		boolean	OS が最上位と見なす Win32 ウィンドウのみを取得する場合は true に設定します。 すべての Win32 ウィンドウを取得するには false に設定します。 ウィンドウの Win32 定義には、ウィンドウとして認識できない可能性がある項目が含まれるため、多くのダイアログボックスとメッセージ ボックスは親ウィンドウの子であっても最上位レベルとしてマークされることに注意してください。
表示されているウィンドウのみを取得する	VisibleWindowsOnly		boolean	OS が表示されると見なす Win32 ウィンドウのみを取得するには、true に設定します。 表示されている Win32 ウィンドウと非表示の Win32 ウィンドウの両方を取得するには、false に設定します。 オフスクリーン ウィンドウまたは透明ウィンドウは表示済みとしてマークされている可能性がありますが、表示できないことに注意してください。
タイトル バーがあるウィンドウのみを取得する	WindowsWithTitlebarOnly		boolean	タイトル バーを持つ Win32 ウィンドウのみを取得する場合は true に設定します。 タイトル バーがあるかどうかに関係なく、Win32 ウィンドウを取得するには false に設定します。 一部の透明なウィンドウにはタイトル バーがありますが、表示できません。
タイトルを持つウィンドウのみを取得する	WindowsWithTitleOnly		boolean	True に設定すると、タイトルを含む Win32 ウィンドウ (つまり、テキストを含むタイトル バー) のみが取得されます。 タイトルがあるかどうかに関係なく、Win32 ウィンドウを取得するには false に設定します。 タイトル バーはウィンドウの上部にあるストリップですが、タイトルはウィンドウ内のテキストであることに注意してください。
透明なウィンドウを無視する	IgnoreTransparentWindows		boolean	透過性のない Win32 ウィンドウのみを取得する場合は true に設定します。 透過性が設定されているかどうかに関係なく、Win32 ウィンドウを取得するには false に設定します。
検索プロセス ID	SearchProcessId		integer	ウィンドウを所有するプロセスのオプションのプロセス ID (たとえば、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションの出力によって提供されます)。 プロセス ID で検索しない場合は、0 に設定します。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数のウィンドウが検索と一致する場合は、並べ替えるウィンドウ プロパティを指定できます。 例: [列名で並べ替え] が [TopEdge] の場合、ウィンドウの一覧は上端順に返されます。 このフィールドを空白のままにすると、ウィンドウは検出された順序で返されます。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数のウィンドウが検索と一致し、並べ替え列が指定されている場合は、昇順で並べ替えるには true (既定値) に設定し、降順で並べ替えるには false に設定します。
UIA 要素ハンドルを返す	ReturnElementHandle		boolean	true に設定すると、各 Win32 ウィンドウへの UIA ハンドルが出力コレクション ("UIAHandle" 列) に返されます。 このハンドルは、UIA アクションで "親" ハンドルとして機能 IA-Connect アクションで使用できます。
返される最初の項目	FirstItemToReturn		integer	1 から始まる、返す最初のウィンドウ (行) のインデックス。
返されるアイテムの最大数	MaxItemsToReturn		integer	返すウィンドウの最大数、またはすべての項目を返す場合は 0。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
Win32 windows JSON	Win32WindowsJSON	string	検索条件に一致する Win32 ウィンドウの一覧 (JSON 形式)。
Win32 ウィンドウの数	NumberOfWin32Windows	integer	返される Win32 ウィンドウの数。

すべての UIA 要素ハンドルをリセットする

操作 ID:

UIAResetAllElementHandles

IA-Connect によって現在格納されているすべての UIA 要素ハンドルをリセットします。これは、多数の要素を識別していて、多数の要素ハンドルが格納されている場合に便利です。 要素ハンドルの数が非常に多いシナリオ (100,000 以上) では、このアクションを使用して RAM 使用率を解放することもできます。

パラメーター

名前	キー	必須	型	説明
Workflow	Workflow	True	string	workflow() に次の式を追加します。

グローバル マウス クリック UIA 要素検索の色領域

操作 ID:

UIAGlobalMouseClickElementSearchColourRegion

指定した色条件を満たす UIA 要素内のピクセル領域の上にマウスを移動し、マウス クリックを実行します。 スクリーンショットが要素の場所で画面のコピーを取得するため、最初に要素を前面に移動する必要があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索色	SearchColour	True	string	0xAARRGGBB、#AARRGGBB、0xRRGGBB、または各カラー チャネルが 16 進形式のバイトである #RRGGBB 形式で色を検索します (00 は完全にオフ、FF は完全にオン)。 例: #FF0000 は赤、#00FF00 は青、#000000 は黒、#FFFFFF は白です。
最大色偏差	MaxColourDeviation	True	integer	要素の色の最大値は、一致と見なされない前に検索色から逸脱する可能性があります。 偏差がない場合は 0。 偏差は RGB 値で測定されます。 たとえば、#FF0000 は #FE0102 とは 4 異なります。 15 の偏差は、出発点として適しています。
左ピクセル X オフセット	LeftPixelXOffset		integer	検索領域の左端の省略可能な X オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
右ピクセル X オフセット	RightPixelXOffset		integer	検索領域の右端の省略可能な X オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
トップ ピクセル Y オフセット	TopPixelYOffset		integer	検索領域の上端のオプションの Y オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
下ピクセル Y オフセット	BottomPixelYOffset		integer	検索領域の下端のオプションの Y オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
マウス ボタン	MouseButton		string	押すマウス ボタン (左、右、中央、二重左)。
[オフセット X] をクリックします	ClickOffsetX		integer	クリック アクションをオフセットする X ピクセルの数。 このパラメーターは、正 (右) オフセット値と負 (左) オフセット値の両方をサポートします。
オフセット Y をクリックする	ClickOffsetY		integer	クリック アクションをオフセットする Y ピクセルの数。 このパラメーターは、正 (下) オフセット値と負 (上) オフセット値の両方をサポートします。
相対オフセット	OffsetRelativeTo		string	オフセットする色領域の相対位置 (中央/中央/中央、左、右、上、下、左上、右上、左下、右下)。
ミリ秒単位の遅延	DelayInMilliseconds		integer	ダブルクリックを実行する場合、各クリック間の遅延 (ミリ秒単位)。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、分析対象の要素が隠されないようにするには、true に設定します。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
コマンドの結果	UIAGlobalMouseClickElementSearchColourRegionResult	boolean	コマンドの結果 (成功または失敗)。
エラーメッセージ	ErrorMessage	string	コマンドが成功しなかった場合は、返されたエラー メッセージが含まれます。

デスクトップ用の UIA ハンドルを取得する

操作 ID:

UIAGetHandleForDesktop

デスクトップのハンドルを返します。 これは、ハンドル '-2' を使用してデスクトップ要素を参照できるだけでなく、デスクトップに対して検索できるアクションが多数あるためです (例: "デスクトップ要素を待機")。

パラメーター

名前	キー	必須	型	説明
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	デスクトップの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	デスクトップ要素の UIA 名。
要素クラス名	ElementClassName	string	デスクトップ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	デスクトップ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	デスクトップ要素の UIA ローカライズされたコントロール型。

フォアグラウンド UIA ウィンドウを設定する

操作 ID:

UIASetForegroundWindow

ウィンドウを前景に移動します。

パラメーター

名前	キー	必須	型	説明
ウィンドウ ハンドル	WindowHandle	True	integer	フォアグラウンド ウィンドウとして設定する必要があるウィンドウの UIA ハンドル。
ウィンドウの切り替え	ToggleWindow		boolean	フォーカスを合わせるかクリックしてウィンドウを切り替える必要がありますか? これにより、ウィンドウが確実にフォアグラウンドに移動されます。
トグルでは、マウスのグローバル左クリック エージェントが使用されます	ToggleUsesGlobalLeftMouseClickAgent		boolean	ウィンドウを切り替える場合は、グローバル マウス クリックを使用して最初に IA-Connect エージェントにフォーカスを設定するかどうかを指定します。
遅延を秒単位で切り替える	ToggleDelay		double	ウィンドウを切り替える場合は、切り替えた後の一時停止を指定します。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

フォーカス UIA 要素

操作 ID:

UIAFocusElement

キーボード フォーカスのアクティブな要素にする要素にフォーカスを設定します。アプリケーションによっては、要素ウィンドウがフォアグラウンドに移動する場合があります。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

フォーカスされた要素の UIA ハンドルを取得する

操作 ID:

UIAGetHandleForFocussedElement

現在フォーカスされている UIA 要素のハンドルを返します。

パラメーター

名前	キー	必須	型	説明
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

フォーカスされた要素のメイン ウィンドウの UIA ハンドルを取得する

操作 ID:

UIAGetHandleForMainWindowOfFocussedElement

現在フォーカスされている UIA 要素のメイン ウィンドウのハンドルを返します。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。

パラメーター

名前	キー	必須	型	説明
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。

プロセス ID のメイン ウィンドウの UIA ハンドルを取得する

操作 ID:

UIAGetHandleForProcessIdMainWindow

プロセスのメイン ウィンドウ (プロセス ID で指定) のハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。

パラメーター

名前	キー	必須	型	説明
検索プロセス ID	ProcessId	True	integer	待機するプロセスの ID (IA-Connect 環境/セッション アクションの "プロセスの実行" アクションによって提供されます)。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。

プロセス メイン ウィンドウの UIA ハンドルを取得する

操作 ID:

UIAGetHandleForProcessMainWindow

プロセスのメイン ウィンドウ (名前で指定) のハンドルを返す単純で高速な Win32 アクション。 通常、"メイン" ウィンドウはメイン アプリケーション ウィンドウです。ログイン ダイアログまたはサブウィンドウは、通常、"メイン" ウィンドウではありません。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。

パラメーター

名前	キー	必須	型	説明
検索プロセス名	SearchProcessName	True	string	検索するプロセスの名前 (メモ帳など)。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。

プロセスに Win32 ウィンドウがありますか

操作 ID:

UIADoesProcessHaveWindow

プロセス (名前で指定) に表示されるウィンドウがあるかどうかを報告する、シンプルで高速な Win32 アクション。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力なアクション "デスクトップ要素を待機する" を使用することをお勧めします。

パラメーター

名前	キー	必須	型	説明
検索プロセス名	SearchProcessName	True	string	検索するプロセスの名前 (メモ帳など)。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
プロセスにウィンドウがある	ProcessHasWindow	boolean	プロセスに表示されるウィンドウがある場合は true、表示されていない場合は false を返します。

名前で UIA リスト要素項目をクリックする

操作 ID:

UIAClickListElementItemByName

指定した名前のリスト要素をクリックします。 これは通常、ドロップダウン/メニュー項目の項目を選択するために使用されます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
最初に展開	ExpandFirst		boolean	true に設定すると、IA-Connect はリスト アイテム要素を検索する前にリストの展開を試みます。 リストアイテム要素はリストが展開されるまで作成されない可能性があるため、これは動的リストに役立ちます。
次の後に折りたたむ	CollapseAfter		boolean	true に設定すると、検索の実行後にリストが折りたたまれます。
項目名	ItemName		string	クリックする要素項目の名前。
展開と折りたたみの間の秒数	SecondsBetweenExpandCollapse		double	展開アクションと折りたたみアクションが true に設定されている場合に待機する秒数。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

最上位レベルの Win32 ウィンドウが存在しますか

操作 ID:

UIADoesTopLevelWindowExist

最上位の Win32 ウィンドウが存在するかどうかを報告する高速 Win32 アクション。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 クラス名またはウィンドウ タイトルで検索することも、ワイルドカードを含むより高度な検索フィルターを指定することもできます。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力な UIA アクション 'Does UIA desktop element exist' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。

パラメーター

名前	キー	必須	型	説明
検索クラス名	SearchClassName		string	検索する最上位ウィンドウの要素クラス名 (例: "メモ帳")。
検索ウィンドウのタイトル	SearchWindowTitle		string	検索する最上位ウィンドウのタイトル。
検索プロセス ID	SearchProcessId		integer	ウィンドウを所有するプロセスの省略可能なプロセス ID (たとえば、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションの出力によって提供されます)。 プロセス ID で検索しない場合は、0 に設定します。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子を使用して使用可能なウィンドウ プロパティに対して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウが存在する	WindowExists	boolean	ウィンドウが存在する場合は true、存在しない場合は false を返します。

最上位レベルの Win32 ウィンドウの UIA ハンドルを取得する

操作 ID:

UIAGetHandleForTopLevelWindow

指定したクラス名またはウィンドウ タイトルを持つ最上位の Win32 ウィンドウの UIA ハンドルを返す高速 Win32 アクション。または、ワイルドカードを含むより高度な検索フィルターを指定できます。 最上位のウィンドウは、デスクトップに接続されているウィンドウです。 このアクションでは Win32 API を使用しますが、Windows、Java、ModernUI、Web ウィンドウを検出できます。 ウィンドウが存在する必要があります。IA-Connect は待機しません。 より強力な UIA アクション 'Does UIA desktop element exist' を使用する方が一般的ですが、この Win32 アクションは通常、より高速に実行されます。

パラメーター

名前	キー	必須	型	説明
検索クラス名	SearchClassName		string	検索する最上位ウィンドウの要素クラス名 (例: "メモ帳")。
検索ウィンドウのタイトル	SearchWindowTitle		string	検索する最上位ウィンドウのタイトル。
検索プロセス ID	SearchProcessId		integer	ウィンドウを所有するプロセスの省略可能なプロセス ID (たとえば、IA-Connect 環境/セッション アクションの "プロセスの実行" アクションの出力によって提供されます)。 プロセス ID で検索しない場合は、0 に設定します。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子を使用して使用可能なウィンドウ プロパティに対して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数のウィンドウが検索と一致する場合は、並べ替えるウィンドウ プロパティを指定できます。 これは、必要なウィンドウを選択するために'インデックスの一致'と組み合わせて使用されます。 例: [列名で並べ替え] が [TopEdge] で 、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致するウィンドウが返されます。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数のウィンドウが検索と一致する場合は、並べ替えられたリストの上部または並べ替えられたリストの一番下 (false) から 'インデックスの照合' が一致する必要があります。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
ウィンドウ ハンドル	WindowHandle	integer	ウィンドウの UIA ハンドル。 これは、このウィンドウ内の追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	ウィンドウ要素の UIA 名。
要素クラス名	ElementClassName	string	ウィンドウ要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	ウィンドウ要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	ウィンドウ要素の UIA ローカライズされたコントロール型。

最初の UIA 親要素を検索する

操作 ID:

UIASearchForFirstParentElement

検索条件に一致する最初の親要素を UIA ツリー階層で検索します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。

パラメーター

名前	キー	必須	型	説明
要素ハンドル	ElementHandle	True	integer	ターゲット要素の UIA ハンドル。
親要素のローカライズされたコントロール型を検索する	SearchParentLocalizedControlType		string	検索対象のローカライズされたコントロール型の親 UIA 要素。 これは、検査を使用して検出できます。
親要素コントロールの種類を検索する	SearchParentControlType		integer	検索する親 UIA 要素コントロール型 (ローカライズされていない整数)。 これは、異なる言語間で同じ値です。
処理する親の最大数	MaxParentsToProcess		integer	処理する親要素の最大数。 既定では、これは 50 に設定されています。
親要素が見つからない場合は例外を発生させる	RaiseExceptionIfParentElementNotFound		boolean	検索 UIA 要素 IA-Connect 見つからない場合は、例外を発生させる必要がありますか?
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
親要素が見つかりました	ParentElementFound	boolean	検索の親 UIA 要素が見つかった場合は true を返します。
親要素ハンドル	ParentElementHandle	integer	配置された親要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
親要素名	ParentElementName	string	配置されている親要素の UIA 名。
親要素クラス名	ParentElementClassName	string	配置されている親要素の UIA クラス名。
親要素のオートメーション ID	ParentElementAutomationId	string	配置されている親要素の UIA オートメーション ID。
親要素のローカライズされたコントロール型	ParentElementLocalizedControlType	string	配置された親要素の UIA ローカライズされたコントロール型。

最小化 UIA ウィンドウ

操作 ID:

UIAMinimiseWindow

指定した UIA ハンドルを使用してウィンドウを最小化します。

パラメーター

名前	キー	必須	型	説明
ウィンドウ ハンドル	WindowHandle	True	integer	最小化するウィンドウの UIA ハンドル。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

画面座標で UIA 要素を取得する

操作 ID:

UIAGetElementAtCoordinates

指定された画面座標にある UIA 要素を返します。

パラメーター

名前	キー	必須	型	説明
X 座標	XCoord		integer	UIA 要素を検索する画面 X 座標値 (ピクセル単位)。
Y 座標	YCoord		integer	UIA 要素を検索する画面 Y 座標値 (ピクセル単位)。
要素が見つからない場合は例外を発生させる	RaiseExceptionIfElementNotFound		boolean	UIA 要素 IA-Connect 指定した場所に配置されていない場合は、例外を発生させる必要がありますか?
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
要素が見つかりました	ElementFound	boolean	指定した場所で UIA 要素が見つかった場合は true を返します。
要素ハンドル	ElementHandle	integer	要素の UIA ハンドル。 これは、この要素に対して動作する追加の UIA アクションへの入力として使用できます。
要素名	ElementName	string	要素の UIA 名。
要素クラス名	ElementClassName	string	要素の UIA クラス名。
要素のオートメーション ID	ElementAutomationId	string	要素の UIA オートメーション ID。
要素のローカライズされたコントロール型	ElementLocalizedControlType	string	要素の UIA ローカライズされたコントロール型。

表示されている検索イメージが UIA 要素内に存在しないのを待つ

操作 ID:

UIAWaitForVisibleSearchImageToNotExistWithinElement

このアクションへの入力として提供される検索イメージが、画面上の UIA 要素内に見えて見つからない (または見つからない) か、指定された時間が経過し、画像がまだ存在するまで待機します。 エージェントは要素の座標でスクリーンショットを受け取り、スクリーンショット内で指定された検索画像を検索するため、最初に要素を前面に移動する必要があります。 UIA 要素は最初から存在する必要があります。 イメージが存在しなくなったら、すぐにアクションが完了します。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle		integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
画像の種類を検索する	SearchImageType		string	[Search image]\(検索イメージ\) 入力が表す内容を定義します。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
検索画像	SearchImage		string	指定した UIA 要素内で検索する検索イメージ。 指定した '検索イメージの種類' に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。
代替検索画像の種類	AltSearchImageType		string	"代替検索イメージ" 入力が表す内容を定義します。 [なし] または [空白] に設定した場合、代替の検索イメージはありません。 [Director image file]\(ディレクター イメージ ファイル\) に設定されている場合、検索イメージはディレクターからアクセスできるファイルへのパスです。 "エージェント イメージ ファイル" に設定されている場合、検索イメージはエージェントからアクセスできるファイルへのパスです。 'Base64' に設定すると、検索イメージはイメージの base64 表現になります。
代替検索画像	AltSearchImage		string	指定した UIA 要素内で検索するオプションの代替検索イメージ。 指定した "代替検索イメージの種類" に応じて、イメージ ファイル (ディレクターまたはエージェントの末尾) へのパスを保持したり、検索するイメージの base64 (テキスト表現) を格納したりできます。 代替検索イメージを指定した場合、エージェントは検索イメージまたは代替検索イメージを検索し、検索された画像を報告します。
最大色偏差	MaxColourDeviation		integer	要素のピクセルカラーの最大値は、一致と見なされない前に検索画像のピクセルカラーから逸脱する可能性があります。 偏差がない場合は 0。 偏差は RGB 値で測定されます。 たとえば、#FF0000 は #FE0102 とは 4 異なります。 これにより、わずかな色の違いを無視できます。
最大ピクセル差	MaxPixelDifferences		integer	画像が一致しないと見なされる前に、検索画像全体で異なる可能性がある最大ピクセル数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"連続する最大ピクセル差" も設定する必要があります。
連続する最大ピクセル差	MaxConsecutivePixelDifferences		integer	画像が一致しないと見なされる前に、任意の行で異なる可能性がある最大ピクセル数 (最大色偏差を超えています)。 これにより、イメージ間のわずかな違いを無視できますが、値を大きくすると、イメージを見つけるのに必要な時間が長くなる可能性があります。 0 に設定し、必要に応じて少量ずつ増やすことをお勧めします。 0 より大きな値に設定する場合は、"最大ピクセル差" も設定する必要があります。
左ピクセル X オフセット	LeftPixelXOffset		integer	検索領域の左端の省略可能な X オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
右ピクセル X オフセット	RightPixelXOffset		integer	検索領域の右端の省略可能な X オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
トップ ピクセル Y オフセット	TopPixelYOffset		integer	検索領域の上端のオプションの Y オフセット。 これにより、検索領域を増加 (負の値) または減少 (正の値) することができます。
下ピクセル Y オフセット	BottomPixelYOffset		integer	検索領域の下端のオプションの Y オフセット。 これにより、検索領域を増加 (正の値) または減少 (負の値) することができます。
ピクセル X オフセット単位	PixelXOffsetsUnit		string	左右のピクセル X オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 左右のピクセル X オフセットが要素の幅に対する割合として測定される場合は、"Percent" に設定されます。
ピクセル Y オフセット単位	PixelYOffsetsUnit		string	上と下のピクセルの Y オフセットをピクセル単位で測定する場合は、"ピクセル" (既定値) に設定します。 上と下のピクセル Y オフセットが要素の高さに対するパーセンテージとして測定される場合は、"Percent" に設定されます。
画像インデックスの検索	SearchImageIndex		integer	UIA 要素内で検索イメージの最初のインスタンス (検索の方向) を検索するには、1 に設定します。 2 番目のインスタンスの場合は 2、N 番目のインスタンスの場合は N に設定します。 代替イメージも検索している場合、UIA 要素は最初に検索イメージをスキャンし、次に代替イメージを検索し、その特定のイメージの要求されたインスタンスを検索します (つまり、エージェントは両方のイメージを混在させるのではなく、どちらか一方を想定しています)。
画像検索の方向	ImageSearchDirection		string	検索の方向。 "上から" では、上から行で検索され、各行内で左から右にスキャンされます。 "下から" では、下から行で検索され、各行内で左から右にスキャンされます。 "From left" では、左側の列で検索され、各列内で上から下にスキャンされます。 '右から' は右から列で検索し、各列内で上から下にスキャンします。 これは、'Search image index' と組み合わせて使用して、N 番目の画像を上、下、左、または右から見つけることができます。 パフォーマンスを向上させるには、画像の検索速度が速いと思われる検索方向を選択します。
エージェントを非表示にする	HideAgent		boolean	エージェントを自動的に非表示にして (表示されている場合)、分析対象の要素が隠されないようにするには、true に設定します。
強調表示の四角形を表示する	ShowHighlightRectangle		boolean	true に設定すると、IA-Connect エージェントによって画面上に配置されたイメージが強調表示されます。 これは、開発中に、正しい画像が検出されていることを視覚化するのに役立ちます。
検索イメージが存在しないのを待機する秒数	SecondsToWait		integer	検索イメージが UIA 要素内に目に見えて配置されないのを待機する秒数。 この時間が経過してもイメージが存在する場合は、"イメージがまだ存在する場合は例外を発生させる" が true に設定されている場合は例外が発生し、それ以外の場合、アクションはイメージがまだ存在することを報告します。
検索の間隔 (ミリ秒)	MillisecondsBetweenSearches		integer	画面上の各 UIA 要素の間で待機するミリ秒数。 画像認識は CPU コストがかかる可能性があるため、遅延は CPU 使用率の低下と分散の両方に役立ちます。 たとえば、画像が表示されるまでに最大 1 分かかると予想される場合、スキャンの間に 5000 ミリ秒 (5 秒) の一時停止を追加すると、CPU 使用率が大幅に低下します (スキャンの数が大幅に減ります)。ただし、応答時間に与える影響はごくわずかです。 最小値は 100 ミリ秒 (1/10 秒) です。
イメージがまだ存在する場合は例外を発生させる	RaiseExceptionIfImageStillPresent		boolean	待機期間の後にイメージがまだ存在する場合、IA-Connect が例外を発生させる必要がある場合は true に設定します。
スレッド ID の出力データを取得する	RetrieveOutputDataFromThreadId		integer	以前に 'スレッドの待機' を false に設定した場合 (エージェントがバックグラウンド スレッドで待機を実行する原因となります)、結果を取得するエージェント スレッド ID を指定します。 このエージェント スレッド ID は、このアクションに対する以前の呼び出しによって提供されます。 それ以外の場合は、0 (既定値) に設定します。
スレッドを待つ	WaitForThread		boolean	エージェント スレッドが完了するまで待機するには true に設定します。エージェントは、'Seconds to wait for search image to exist' (検索イメージが存在しないのを待機する秒数) で指定されている限り待機します。 待機をバイパスするには false に設定します。エージェントはバックグラウンド スレッドで待機を引き続き実行しますが、次のアクションでも使用できます。 その後、"エージェント スレッドが正常に完了するまで待機する" アクションを使用して、エージェント スレッドが完了するのを待ってから、"スレッド ID の出力データを取得する" という入力をエージェント スレッド ID に設定して、この "UIA 要素内に表示される検索イメージが存在しないのを待つ" アクションを再実行することで、後で結果を取得できます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
待機前に存在する画像を検索する	SearchImagePresentBeforeWait	boolean	待機期間の開始時に検索イメージが存在していた場合、この出力は true に設定されます。 検索イメージが最初から存在しなかった場合、この出力は false に設定されます。
待機後も検索画像がまだ存在する	SearchImageStillPresentAfterWait	boolean	この出力は、検索イメージがまだ存在する場合は、待機期間の後に true に設定されます。 この出力は、検索イメージが存在しなくなった場合、待機期間中に false に設定されます (イメージが存在しなくなったらすぐにアクションが完了します)。
まだ存在する検索画像	WhichSearchImageStillPresent	integer	この出力は、待機期間の後に検索画像がまだ存在しない場合は 0 に設定されます。 検索イメージがまだ存在する場合は、待機期間の後に 1 に設定します。 代替検索イメージがまだ存在する場合は、待機期間の後に 2 に設定します。
スレッド ID	ThreadId	integer	"スレッドの待機" を false に設定した場合 (エージェントがバックグラウンド スレッドで待機を実行する原因となります)、この出力にはエージェント スレッド ID が保持されます。この ID は、アクションのプロセスを監視し、後でスレッドが完了したときに結果を取得するために使用できます。

複数の UIA 要素にテキストを入力する

操作 ID:

UIAInputTextIntoMultipleElements

既存のテキストを置き換えるか、新しい値を特定の位置に挿入するか、複数の要素 (通常はテキスト入力フィールド) にさまざまなテキストを入力する UIA アクション。

パラメーター

名前	キー	必須	型	説明
入力要素	InputElementsJSON	True	string	JSON 形式でテキストを入力する UIA 要素の配列。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

複数の UIA 要素をテーブルとして取得する

操作 ID:

UIAGetMultipleElementsAsTable

指定した親要素の子要素の値を列挙し、テーブル形式で返します。 これは、技術的にはテーブルではなく、テーブル構造にまとめて配置されている要素からデータの行と列を返すために使用できます。 このアクションを使用して、このアクションの前回の実行から結果を取得し、エージェント スレッドとして実行することもできます。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle		integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素名	SearchElementName		string	(親ウィンドウ ハンドルから始まる) 検索する省略可能な UIA 要素名。 これは、検査を使用して検出できます。
検索要素クラス名	SearchElementClassName		string	検索する省略可能な UIA 要素クラス名 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のオートメーション ID	SearchElementAutomationId		string	検索する省略可能な UIA 要素のオートメーション ID (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
UIA サブツリーの検索	SearchSubTree		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
インデックスの照合	MatchIndex		integer	複数の要素が検索に一致する場合は、どの要素 (1 から始まる) を照合する必要があります。 [列で並べ替え] と組み合わせて使用して、一致する並べ替え順序を選択できます。
検索フィルター	SearchFilter		string	条件付き演算子と任意の要素フィールドを使用して検索をさらに制限するオプションの高度なフィルター。 例 1: [幅] < 200。 例 2: 'Document*' のような [Name] と 'Label*' のような [ClassName] です。 その他の例については、ドキュメントを参照してください。
列名で並べ替え	SortByColumn		string	複数の要素が検索に一致する場合は、並べ替えの基準となる要素プロパティを指定できます。 これは、'Match index' と組み合わせて使用して、必要な要素を選択します。 例: [列名で並べ替え] が [TopEdge] で、[インデックスの一致] が 1 の場合、画面の上部に最も近い一致する要素が一致します。
一致インデックスが昇順である	MatchIndexAscending		boolean	複数の要素が検索と一致する場合は、並べ替えられたリストの先頭から (true) または並べ替えられたリストの下部 (false) の 'インデックスの一致' が一致する必要があります。
検索セル ヘッダーサブ要素のローカライズされたコントロールの種類	SearchCellHeaderSubElementLocalizedControlType		string	検索するセル ヘッダー サブ要素のローカライズされたコントロール型。 セル ヘッダーを検索しない場合は空白のままにします。
セル ヘッダーサブ要素コントロールの種類を検索する	SearchCellHeaderSubElementControlType		integer	検索するセル ヘッダーサブ要素コントロール型 (ローカライズされていない整数)。 これは、異なる言語間で同じ値です。 セル ヘッダーを検索しない場合は、0 のままにします。
検索セルサブ要素のローカライズされたコントロールの種類	SearchCellSubElementLocalizedControlType		string	検索するセルサブ要素のローカライズされたコントロール型。
セルサブ要素コントロールの種類を検索する	SearchCellSubElementControlType		integer	検索するセルサブ要素コントロール型 (ローカライズされていない整数)。 これは、異なる言語間で同じ値です。
セルサブ要素の子孫を検索する	SearchDescendantsForCellSubElements		boolean	true に設定すると、配置された要素の下にある UIA ツリーで、セルとセル ヘッダーのサブ要素 (つまり、出力テーブル内のセルを設定する要素値) が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 要素のすぐ下にある要素にのみ関心がある場合は、これを false に設定できます。
返される最初のセル ヘッダーサブ要素	FirstCellHeaderSubElementToReturn		integer	1 から始まる、返す最初のセル ヘッダーサブ要素のインデックス。 (UIA ツリーの下部から) 逆の順序で要素を返す場合は、-1 から始まる負のインデックスを指定することもできます。
返される最大セル ヘッダーサブ要素	MaxCellHeaderSubElementsToReturn		integer	返すセル ヘッダーサブ要素の最大数。またはすべてのサブ要素を返す場合は 0。
返す最初のセルサブ要素	FirstCellSubElementToReturn		integer	1 から始まる、返す最初のセルサブ要素のインデックス。 (UIA ツリーの下部から) 逆の順序で要素を返す場合は、-1 から始まる負のインデックスを指定することもできます。
返されるセルサブ要素の最大数	MaxCellSubElementsToReturn		integer	返すセルサブ要素の最大数、またはすべてのサブ要素を返す場合は 0。
要求された列数	RequestedNumberOfColumns		integer	出力テーブルに必要な列の数。 この値は、読み取られる要素に対して正しい必要があります。または、予期しない結果が表示されます。
セルサブ要素の値の優先順位	CellSubElementValuePriority		integer	セルサブ要素の値を出力テーブルで使用する値として使用する優先順位。 1 が最も高い優先順位です。 2 は 2 番目の優先順位です。 3 は 3 番目の優先順位です。 0 は使用しません。
セルサブ要素のテキスト値の優先度	CellSubElementTextValuePriority		integer	セルサブ要素テキスト値を出力テーブルで使用する値として使用する優先順位。 1 が最も高い優先順位です。 2 は 2 番目の優先順位です。 3 は 3 番目の優先順位です。 0 は使用しません。
セルサブ要素名の値の優先順位	CellSubElementNameValuePriority		integer	出力テーブルで使用する値としてセルサブ要素名 (ラベルに共通) を使用する場合の優先順位。 1 が最も高い優先順位です。 2 は 2 番目の優先順位です。 3 は 3 番目の優先順位です。 0 は使用しません。
セルサブ要素の最小幅	MinimumCellSubElementWidth		integer	表に含めるセルサブ要素の最小幅 (ピクセル単位)。
セルサブ要素の最小高さ	MinimumCellSubElementHeight		integer	表に含めるセルサブ要素の最小高さ (ピクセル単位)。
セルサブ要素の境界ボックスを左に検索する	SearchCellSubElementBoundingBoxLeft		integer	境界ボックス内に完全に含まれるセルサブ要素のみを含めます。 既定では、境界ボックスはすべての要素を含めるために巨大です。
セルサブ要素の境界ボックスを右に検索する	SearchCellSubElementBoundingBoxRight		integer	境界ボックス内に完全に含まれるセルサブ要素のみを含めます。 既定では、境界ボックスはすべての要素を含めるために巨大です。
セルサブ要素境界ボックスの上部を検索する	SearchCellSubElementBoundingBoxTop		integer	境界ボックス内に完全に含まれるセルサブ要素のみを含めます。 既定では、境界ボックスはすべての要素を含めるために巨大です。
セルサブ要素境界ボックスの下部を検索する	SearchCellSubElementBoundingBoxBottom		integer	境界ボックス内に完全に含まれるセルサブ要素のみを含めます。 既定では、境界ボックスはすべての要素を含めるために巨大です。
スレッドとしてテーブルを読み取る	ReadTableAsThread		boolean	false (既定値) に設定すると、IA-Connect エージェントはすぐにテーブルを読み取り、その内容をディレクターに返します。 大きなテーブルを読み取る場合、このアクションはタイムアウトになる可能性があります。true に設定すると、IA-Connect エージェントはテーブルをエージェント スレッドとして読み取り、IA-Connect Director (または Orchestrator、PowerShell モジュール、Blue Prism) は、このエージェント スレッドの状態を監視して、完了を待機できます。 これにより、大きなテーブルをタイムアウトなしで読み取ることができます。 IA-Connect Agents 9.3 以前では、エージェント スレッドとしてではなく、テーブルをすぐに読み取るだけでした。
スレッド ID の出力データを取得する	RetrieveOutputDataFromThreadId		integer	以前にエージェント スレッドとしてこのアクションを実行し、"スレッドを待機する秒数" を 0 に設定した場合は、エージェント スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションに対する以前の呼び出しによって提供されます。 テーブルを読み取る場合 (したがって、エージェント スレッドとして以前のクエリ実行の結果を取得しない) 場合は、0 (既定値) に設定します。
スレッドを待機する秒数	SecondsToWaitForThread		integer	[スレッドとしてテーブルを読み取る] が true に設定されている場合、エージェント スレッドが完了するまで待機する秒数。 この時点でテーブルを読み取るエージェント スレッドが完了していない場合は、例外が発生します。 待機をバイパスするには 0 に設定します。エージェントは引き続きテーブルを読み取りますが、次のアクションにも使用できます。 その後、"エージェント スレッドが正常に完了するまで待機する" アクションを使用してエージェント スレッドが完了するのを待機し、入力 "スレッド ID の出力データを取得する" をエージェント スレッド ID に設定して、この "複数の UIA 要素をテーブルとして取得する" アクションを再実行することで、後で結果 (テーブルの内容) を取得できます。
検索する最大要素数	MaxElementsToSearch		integer	UIA ツリーでターゲット要素を検索するときに検索する要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
最大相対検索の深さ	MaxRelativeSearchDepth		integer	親要素の下にある子要素を検索する相対ツリーの最大深さ。 直接子要素の深さの値は 1 になります。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 検索深度を無制限にするには、0 に設定します。 この入力は通常、要素の検索を最適化するために使用されます。
ノードごとに検索する子要素の最大数	MaxChildElementsToSearchPerNode		integer	UIA ツリーでターゲット要素を検索するときに各要素の下で検索する子要素の最大数。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 既定では、これは 0 (無制限) に設定されています。 この入力は通常、要素の検索を最適化するために使用されます。
走査しない要素のローカライズされたコントロール型	ElementLocalizedControlTypesNotToTraverse		string	UIA ツリーでターゲット要素を検索するときに走査しない (ステップインする) UIA 要素のローカライズされたコントロール型のコンマ区切りのリスト。 検索では、個々の要素が検索条件と一致するかどうかを確認しますが、ローカライズされたコントロールの種類がこの除外リストにある場合、その要素の子要素は検索されません。 この入力は、UIA 要素の検索モードが "ツリー ウォーク" の場合にのみ機能します (インスペクターの設定ページで有効にすることができます)。 この入力は通常、要素の検索を最適化するために使用されます。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
見つかったセルサブ要素の数	NumberOfCellSubElementsFound	integer	検索条件に一致する (ヘッダーではない) セルサブ要素の数。
返されるセルサブ要素の数	NumberOfCellSubElementsReturned	integer	返されるセルサブ要素 (ヘッダーではない) の数 (これは、返される項目の先頭または最大数を指定する場合に見つかった要素の数よりも少ない場合があります)。
テーブル の内容 JSON	TableContentsJSON	string	JSON 形式で複数の要素の内容から作成されたテーブル。
テーブル内の行数	NumberOfRowsInTable	integer	出力テーブル内の行数。
テーブル内の列の数	NumberOfColumnsInTable	integer	出力テーブル内の列の数。
スレッド ID	ThreadId	integer	このアクションがエージェント スレッドとして実行されている場合、この出力にはエージェント スレッド ID が保持されます。この ID は、アクションのプロセスを監視し、スレッドが完了したときにテーブルの内容を取得するために使用できます。

複数の UIA 要素を確認する

操作 ID:

UIACheckMultipleElements

複数の要素 (通常はチェックボックスまたはラジオ ボックス) の状態をオンまたはオフに設定します。

パラメーター

名前	キー	必須	型	説明
入力要素	InputElementsJSON	True	string	チェックする UIA 要素の配列 (JSON 形式)。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

複数の UIA 要素プロパティを取得する

操作 ID:

UIAGetMultipleElementProperties

複数の要素のプロパティを返します。 これは、必要なプロパティ値を保持しているフィールドがわからない場合に便利です。

パラメーター

名前	キー	必須	型	説明
親ウィンドウ ハンドル	ParentWindowHandle	True	integer	検索の開始点として機能する親 UIA ウィンドウ ハンドル (値が 1 以上)。 これは、"デスクトップ要素を待機する" や "要素を待機する" などのアクションを使用して、検査を使用して検出できます。
検索要素のローカライズされたコントロールの種類	SearchElementLocalizedControlType		string	検索対象の UIA 要素のローカライズされた省略可能なコントロール型 (親ウィンドウ ハンドルから開始)。 これは、検査を使用して検出できます。
子孫を検索する	SearchDescendants		boolean	true に設定すると、親ウィンドウ ハンドルの下にある UIA ツリー全体が検索されます。 これはより徹底的ですが、時間がかかる可能性があります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルのすぐ下にある要素のみが検索されます。
Return 要素ハンドル	ReturnElementHandle		boolean	true に設定すると、配置された要素へのハンドルが返されます。 このハンドルは、それ以降のアクションで "親" ハンドルとして機能するために使用できます。
戻り値要素の値	ReturnElementValue		boolean	true に設定すると、配置された要素の値が返されます。
返される最初の項目	FirstItemToReturn		integer	1 から始まる、返される最初の項目の要素インデックス。 (UIA ツリーの下部から) 逆の順序で要素を返す場合は、-1 から始まる負のインデックスを指定することもできます。
返されるアイテムの最大数	MaxItemsToReturn		integer	返す要素の最大数、またはすべての項目を返す場合は 0。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
検出された要素の数	NumberOfElementsFound	integer	検索条件に一致する要素の数。
返される要素の数	NumberOfElementsReturned	integer	返される要素の数 (返される項目の最大数を指定する場合は、見つかった要素の数より小さくすることができます)。
要素のプロパティ	ElementProperties	array of object	検索条件に一致する検出された要素の要素プロパティ。
items	ElementProperties	object

複数の UIA 親要素プロパティを取得する

操作 ID:

UIAGetMultipleParentElementProperties

デスクトップ (ルート レベル) まで、指定した要素の親要素の階層ツリーを返します。 親要素は、UIA 'tree' の次のレベルにある要素として定義され、ほぼ常に包含要素です。

パラメーター

名前	キー	必須	型	説明
要素ハンドル	ElementHandle	True	integer	ターゲット要素の UIA ハンドル。
処理する親の最大数	MaxParentsToProcess		integer	処理する親要素の最大数。 既定では、これは 50 に設定されています。
Workflow	Workflow	True	string	workflow() に次の式を追加します。

戻り値

名前	パス	型	説明
UIA 親要素	UIAParentElements	array of object	配置されているすべての親要素 (およびそのプロパティ) の一覧。 返されるプロパティは、'複数の要素プロパティの取得' アクションによって返されるものと同じです。
items	UIAParentElements	object
返される親要素の数	NumberOfParentElementsReturned	integer	検索から返される親要素の数。