IA-Connect UI

IA-Connect はロボティック プロセス オートメーション (RPA) プラットフォームで、クラウドからオンプレミスの仮想マシン、Citrix や Microsoft リモート デスクトップ (RDS) の接続により、RPA 機能を追加します。 このモジュールは Windows アプリケーションのユーザー インターフェイス自動化 (UIA) に使用します。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Ultima Labs
[URL] https://www.ultima.com/ultima-labs
メール IAConnect@ultima.com
Connector Metadata
発行者 Ultima Labs
Web サイト https://www.ultima.com/ultima-labs
プライバシー ポリシー https://www.ultima.com/privacy-policy
カテゴリー IT Operations;生産性

IA-Connect はロボティック プロセス オートメーション (RPA) プラットフォームで、Power Automate クラウド フローからオンプレミスの仮想マシン、Citrix や Microsoft リモート デスクトップ (RDS) の接続により、RPA 機能を追加します。 IA-Connect コネクタは 650 を超えるアクションを提供しており、Power Automate クラウド フローから直接さまざまなタイプのオンプレミス アプリケーションを自動化できるようにします。 すべての IA-Connect アクションは、Power Automate クラウド フローから直接利用でき、クラウドベース アプリケーションとオンプレミス アプリケーション間の簡単な統合ができます。また、既存の Power Automate 条件、ループ、動的コンテンツ、式、および例外処理を RPA プロセスで活用できます。 また、IA-Connect コネクタを利用することで、フローの実行履歴から完全な実行履歴と監査性が提供されると同時に、RPA プロセスを開発するための個別のアプリケーション/コンソール/スタジオが不要になります。

前提条件

任意の IA-Connect コネクタを使用するには、IA-Connect ソフトウェアをインストールする必要があります。 30 日間は無料でお試しいただけますが、その後は IA-Connect ライセンスが必要になります。

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

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

  • 自動化したいソフトウェアにアクセスできる仮想マシンにインストールされる IA-Connect Agent および Director。 さらに、IA-Connect Agent は Citrix または Microsoft リモート デスクトップ サービス (RDS) セッション内で実行でき、RPA コマンドは仮想チャネルを介してリモート セッションに渡されて実行されます。 IA-Connect Agent はネットワーク共有から実行でき、インストールする必要はありません。

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

次の IA-Connect コネクタを使用できます。

  • IA-Connect Dynamic Code
  • IA-Connect Java
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect SAP GUI
  • IA-Connect Session
  • IA-Connect UI
  • IA-Connect Web Browser

資格情報の入手方法

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

試用版のお申し込みをいただきましたら、IA-Connect ソフトウェアのセットアップのお手伝いと試用版ライセンスを提供するために、ご登録いただいたメール アドレスにご連絡いたします。 この試用版はすべての機能を備えており、試用期間中に、ご自身の環境で 8 つの IA-Connect コネクタすべてにおいて 650 のアクションのいずれかをテストできます。

コネクタの使用を開始する

IA-Connect の試用版を申し込むと、IA-Connect ソフトウェアおよびインストールとセットアップに関するドキュメントを含む ZIP ファイルをダウンロードできるようになります。 また、必要に応じてお客様にご連絡し、インストール プロセスのサポートやご案内をさせていただきます。

サポート

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

IA-Connect ライセンスを購入すると、Ultima の英国拠点の技術サービス センター (TSC) からの特注トレーニングまたはサポートと引き換えることができるサポート トークンが発行されます。

既知の問題と一般的なエラーに関する FAQ

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

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

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

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

件名 タイプ Description Required
API Key securestring この API の API キー True
IA-Connect オーケストレーターのアドレス string HTTP(S) コンポーネントなしで IA-Connect オーケストレーターのアドレスを指定してください True

調整制限

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

アクション

UIA DataGrid 要素のコンテンツを取得する

DataGrid 要素のコンテンツを返します。 これは、行、列、ヘッダー、セルを持つ要素 (テーブル) です。 このアクションは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。

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

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

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

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

UIA の要素が存在するか

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

UIA ウィンドウを最大化する

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

UIA ウィンドウを最小化する

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

UIA ウィンドウを通常に設定する

指定した UIA ハンドルでウィンドウを標準化します (最小化または最大化ではなく、通常のサイズのウィンドウに設定します)。

UIA デスクトップ要素が存在しなくなるまで待機する

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

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

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

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

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

UIA トランザクション タイムアウトを設定する

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

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

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

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

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

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

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

UIA 一覧の要素項目 (インデックス別) をクリックする

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

UIA 一覧の要素項目 (名前別) をクリックする

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

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

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

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

この操作は、要素 (通常はチェックボックスまたはラジオ ボックス) がオンになっているかどうかを示す true または false を返します。

UIA 要素が存在しなくなるまで待機する

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

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

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

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

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

UIA 要素にフォーカスする

要素にフォーカスして、キーボード フォーカスのアクティブな要素にします。アプリケーションによっては、要素ウィンドウが前面に表示される場合があります。

UIA 要素に改行を入力する

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

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

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

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

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

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

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

UIA 要素の値を取得する

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

UIA 要素の切り替え

要素 (通常はチェックボックスまたはラジオ ボックス) を切り替えます。 これにより、要素は現在の状態と反対の状態に変換されます (例: チェックマークの切り替えなど)。 特定の状態を設定する場合は、代わりに '要素をチェック' アクションを使用してください。

UIA 要素の周囲に長方形を描画する

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

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

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

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

指定された色の基準を満たす UIA 要素内のピクセル領域の詳細を返します。 スクリーンショットは要素の場所にある画面のコピーを取得するため、要素を最初に前面に表示する必要があります。

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

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

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

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

UIA 要素をチェックする

要素 (通常はチェックボックスやラジオボックス) の状態を、チェック済みまたはチェック解除のどちらかに設定します。

UIA 要素を展開する

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

UIA 要素を待機する

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

UIA 要素を折りたたむ

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

UIA 要素を押す

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

UIA 要素を数値に設定する

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

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

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

UIA 要素を選択する

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

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

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

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

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

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

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

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

指定した要素の親要素のハンドルを返します。 親要素は UIA 'ツリー' のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

Win32 ウィンドウを取得する

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

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

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

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

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

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

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

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

デスクトップのハンドルを返します。 これは廃止されたアクションです。デスクトップ要素を参照するにはハンドル '-2' を使用できるためと、デスクトップに相対して検索できる多くのアクション ('デスクトップ要素の待機' など) が存在するためです。

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

ウィンドウをフォアグラウンドに表示します。

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

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

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

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

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

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

プロセスに Win32 ウィンドウがある

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

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

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

マウスの中央ボタンで UIA 要素をクリックする (グローバル)

マウスを要素の中央に移動し、マウスの中央ボタンをクリックします。

マウスの右ボタンで UIA 要素をクリックする (グローバル)

マウスを要素の中央に移動し、マウスの右ボタンをクリックします。

マウスの左ボタンで UIA 要素をクリックする (グローバル)

マウスを要素の中央に移動し、マウスの左ボタンをクリックします。

マウスの左ボタンで UIA 要素をダブル クリックする (グローバル)

マウスを要素の中央に移動し、マウスの左ボタンをダブルクリックします。

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

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

最上位の Win32 ウィンドウが存在するか

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

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

UIA ツリー階層を検索して、検索条件に一致する最初の親要素を探します。 親要素は UIA "ツリー" のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

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

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

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

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

複数の UIA 要素をチェックする

複数の要素 (通常はチェックボックスやラジオ ボックス) の状態を、チェック済みまたはチェック解除のどちらかに設定します。

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

指定された親要素の子要素の値を列挙し、テーブル形式で返します。 これを使用すると、厳密にはテーブルではありませんが、テーブル構造にまとめて配置された要素からデータの行と列を返すことができます。 このアクションは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。

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

デスクトップ (ルート レベル) まで、指定された要素の親要素の階層ツリーを返します。 親要素は UIA "ツリー" のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

UIA DataGrid 要素のコンテンツを取得する

DataGrid 要素のコンテンツを返します。 これは、行、列、ヘッダー、セルを持つ要素 (テーブル) です。 このアクションは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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 要素名は、既定で '一番上の行' です。 ヘッダー行の名前が異なる場合は、その名前をここで指定します。

行の UIA 名を返す
ReturnRowUIAName boolean

この入力を設定すると、行の UIA 名が出力コレクションの列に格納されます。 列の名前は '行の UIA 名を格納する列の名前' 入力によって定義されます。

行の UIA 名を格納する列の名前
NameOfColumnToStoreRowUIAName string

入力 '行の UIA 名を返す' が true に設定されている場合、この入力は、行の UIA 名を保持する出力コレクション内の列の名前を指定します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

戻す最初の項目
FirstItemToReturn integer

1 から始まる、返される最初の項目 (行) の要素インデックス。

返される項目の最大数
MaxItemsToReturn integer

返す項目 (列) の最大数。すべての項目 (列) を返す場合は 0。

空の行の最初の N 行をスキャンする
ScanFirstNRowsForEmptyRows integer

一部の DataGrid には、UIA ツリー (通常は最上部) にいくつか空/null の行要素がありますが、これらの行要素は UI に表示されるテーブル内の何も表していないため、IA-Connect は自動的にスキップします。 この入力が 0 (デフォルト) に設定されている場合、「戻す最初の項目」がテーブル内のより深い行を取得するように設定されている場合でも、IA-Connect Agentは、常に最初の行以降の行要素をスキャンします。 これにより、行インデックス番号との整合性が保証されますが、最初の行から要求された行までのすべての行をスキャンする必要があるため、パフォーマンスに影響します。 テーブル内の空/null 行要素が最初の N (例: 10) 行内のみにあることが確実な場合は、これを N (例: 10) に設定すると、パフォーマンスが向上する可能性があります。 何をしているのかわからない場合は、0 以外の値を設定しないでください。

テーブルをスレッドとして読み取る
ReadTableAsThread boolean

false (デフォルト) に設定すると、IA-Connect Agent は即座にテーブルを読み取り、その内容を Director に返します。 大きなテーブルを読み取る場合、このアクションはタイムアウトになることがあります。true に設定すると、 IA-Connect Agent はテーブルを Agent スレッドとして読み取り、IA-Connect Director (またはオーケストレーター、PowerShell モジュール、Blue Prism) は、この Agent スレッドのステータスを監視し、完了するのを待つことができます。 これにより、大きなテーブルをタイムアウトせずに読み取ることができます。 IA-Connect Agent 9.3以前では、Agent スレッドとしてではなく、テーブルを即座に読み取ることのみできました。

スレッド ID の出力データを取得する
RetrieveOutputDataFromThreadId integer

以前にこのアクションを Agent スレッドとして実行し、「スレッドを待機する秒数」を 0 に設定した場合は、Agent スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションへの以前の呼び出しによって提供されます。 DataGrid を読み取る場合 (したがって、Agent スレッドとして実行された以前のクエリの結果を取得しない場合) は、0 (デフォルト) に設定します。

スレッドを待機する秒数
SecondsToWaitForThread integer

「テーブルをスレッドとして読み取る」が true に設定されている場合に、Agent スレッドが完了するまで待機する秒数。 テーブルを読み取る Agent スレッドがこの時間内に完了していない場合、例外が発生します。 待機をバイパスするには、0 に設定します。Agent は DataGrid の読み取りを続けますが、次のアクションでも使用できます。 その後、「Agent スレッドが正常に完了するまで待機する」アクションを使用して Agent スレッドが完了するのを待ってから、入力「スレッド ID の出力データを取得する」をAgent スレッド ID に設定してこの「UIA DataGrid 要素のコンテンツを取得する」アクションを再実行することで、後で結果 (DataGrid のコンテンツ) を取得できます。

DataGrid を N パーセントごとに垂直方向にスクロールする
ScrollDataGridVerticallyEveryNPercent integer

スクロールされている場所 (または近く) に DataGrid を定期的にスクロールすると、一部の大規模な DataGrid (例: 数千行) の読み取りパフォーマンスが向上することが観察されています。 0 (デフォルト) に設定すると、コンテンツの読み取り中に DataGrid はスクロールされません。 1 ~ 100 の値に設定すると、DataGrid はコンテンツの読み取り中に定期的に (総行数の N パーセントごとに) スクロールされます。 例: 20 に設定すると、DataGrid は 0、20、40、60、80 パーセントでスクロールされます。 または、「DataGrid を N 行ごとに垂直方向にスクロールする」を使用して、N パーセントごとではなく N 行ごとにスクロールします。

DataGrid を N 行ごとに垂直方向にスクロールする
ScrollDataGridVerticallyEveryNRows integer

スクロールされている場所 (または近く) に DataGrid を定期的にスクロールすると、一部の大規模な DataGrid (例: 数千行) の読み取りパフォーマンスが向上することが観察されています。 0 (デフォルト) に設定すると、コンテンツの読み取り中に DataGrid はスクロールされません。 1 以上の値に設定すると、DataGrid はコンテンツの読み取り中に N 行ごとにスクロールされます。 例: 5 に設定すると、DataGrid は 5 行ごとにスクロールされます。 または、「DataGrid を N パーセントごとに垂直方向にスクロールする」を使用して、N 行ごとではなく N パーセントごとにスクロールします。

DataGrid を垂直方向にスクロールする (要素ハンドル)
ScrollDataGridVerticallyElementHandle integer

コンテンツの読み取り中に DataGrid を垂直にスクロールする場合、この入力で IA-Connect の垂直スクロールバーの検索方法を定義します。 0 に設定すると、IA-Connect は、「スクロール」パターン (DataGrid がサポートしている場合) を使用するか、DataGrid 内に含まれる垂直スクロールバーを検索することによって、DataGrid を直接スクロールしようとします。 あるいは、垂直スクロールバー要素 (内部のボタンではなく、スクロールバー要素自体) の IA-Connect UIA ハンドルを 1 以上の値で指定できます。

スクロールする DataGrid の最小行数
MinimumDataGridRowsForScrolling integer

コンテンツの読み取り中に DataGrid を垂直にスクロールする場合、この入力で、IA-Connect がスクロールを実行する前にテーブル内で必要な最小行数を指定します。 0 に設定すると、IA-Connect は行数に関係なくスクロールします。 正の数に設定すると、IA-Connect は DataGrid にその数以上の行がある場合にのみスクロールを実行します。

スクロールできない場合は例外を発生する
RaiseExceptionIfCannotScroll boolean

コンテンツの読み取り中に DataGrid を垂直にスクロールする場合: スクロールの失敗を例外と見なす必要がある場合はこの入力を true に設定し、スクロールの失敗を無視する必要がある場合は false (デフォルト) に設定します。 スクロールの一般的な失敗には、スクロールバーの検索の失敗や、スクロールバーにスクロールに適した UIA パターン (「scroll」、「rangevalue」、「value」) がないなどがあります。

代替垂直スクロールバー名
AlternativeVerticalScrollbarName string

デフォルトでは、DataGrid の垂直スクロールバー「行」の UIA 要素名は「垂直スクロール バー」です。 垂直スクロールバーの名前が異なる場合は、その名前をここで指定します。 これは、IA-Connect コンテンツの読み取り中に DataGrid を定期的にスクロールする場合に使用されます。「DataGrid を垂直方向にスクロールする (要素ハンドル)」入力フィールドは 0 に設定します (IA-Connect で DataGrid を直接スクロールすることを指定します) が、DataGrid は「スクロール」パターンを実装していません。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
DataGrid コンテンツ JSON
DataGridContentsJSON string

JSON 形式の DataGrid 要素のコンテンツ。

テーブルが含む行数
NumberOfRowsInTable integer

テーブルが即座に読み取られた場合の出力テーブルの行数。

テーブルが含む列数
NumberOfColumnsInTable integer

テーブルが即座に読み取られた場合の出力テーブルの列数。

スレッド ID
ThreadId integer

このアクションが Agent スレッドとして実行されている場合、この出力には Agent スレッド ID が保持されます。これを使用して、アクションのプロセスを監視し、スレッドが完了したときに DataGrid のコンテンツを取得できます。

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

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 名は、既定で '一番上の行' です。 ヘッダー行の名前が異なる場合は、その名前をここで指定します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
列数
NumberOfColumns integer

DataGrid 内の列数。

表示する列数
NumberOfVisibleColumns integer

DataGrid 内で表示されている列の数。

行数
NumberOfRows integer

DataGrid 内の行数。

表示する行数
NumberOfVisibleRows integer

DataGrid 内で表示されている行の数。

最初に表示されている行
FirstVisibleRow integer

DataGrid 内で最初に表示されている行のインデックス。

最後に表示されている行
LastVisibleRow integer

DataGrid 内で最後に表示されている行のインデックス。

スクロールバーの数
NumberOfScrollbars integer

DataGrid が保持しているスクロールバーの数。

スクロールバー名
ScrollbarNames string

スクロールバーの名前のコンマ区切り一覧 (例: 水平、垂直)。

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

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

パラメーター

名前 キー 必須 説明
検索要素の名前
SearchElementName string

検索する UIA 要素名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のクラス名
SearchElementClassName string

検索する UIA 要素クラス名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素の自動化 ID
SearchElementAutomationId string

検索する UIA 要素の自動化 ID (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のローカライズしたコントロールの種類
SearchLocalizedControlType string

検索する UIA 要素のローカライズしたコントロール タイプ (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索プロセス ID
SearchProcessId integer

指定した場合 (1 以上の値) は、このプロセス ID (PID) のプロセスが所有する要素のみを検索で考慮します。 IA-Connect がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

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 の要素が存在するか

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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 がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみが検索されます。

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 ウィンドウを最大化する

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

パラメーター

名前 キー 必須 説明
ウィンドウ ハンドル
WindowHandle True integer

ウィンドウを最大化するための UIA ハンドル。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA ウィンドウを最小化する

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

パラメーター

名前 キー 必須 説明
ウィンドウ ハンドル
WindowHandle True integer

ウィンドウを最小化するための UIA ハンドル。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA ウィンドウを通常に設定する

指定した UIA ハンドルでウィンドウを標準化します (最小化または最大化ではなく、通常のサイズのウィンドウに設定します)。

パラメーター

名前 キー 必須 説明
ウィンドウ ハンドル
WindowHandle True integer

ウィンドウを標準化するための UIA ハンドル。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA デスクトップ要素が存在しなくなるまで待機する

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

パラメーター

名前 キー 必須 説明
検索要素の名前
SearchElementName string

検索する UIA 要素名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のクラス名
SearchElementClassName string

検索する UIA 要素クラス名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素の自動化 ID
SearchElementAutomationId string

検索する UIA 要素の自動化 ID (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のローカライズしたコントロールの種類
SearchLocalizedControlType string

検索する UIA 要素のローカライズしたコントロール タイプ (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索プロセス ID
SearchProcessId integer

指定した場合 (1 以上の値) は、このプロセス ID (PID) のプロセスが所有する要素のみを検索で考慮します。 IA-Connect がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

待機する秒数
SecondsToWait True integer

要素が存在しなくなるまで待機する最大秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

要素がまだ存在する場合に例外を発生する
RaiseExceptionIfElementStillExists boolean

待機期間後に UIA 要素がまだ存在する場合、IA-Connect で例外を発生させる必要がありますか?

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
待機前に要素が存在
ElementExistsBeforeWait boolean

待機前に要素が存在する場合は true、そうでない場合は false を返します。

待機後に要素が存在
ElementExistsAfterWait boolean

待機後に要素が存在する場合は true、そうでない場合は false を返します。

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

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

パラメーター

名前 キー 必須 説明
検索要素のローカライズしたコントロールの種類
SearchElementLocalizedControlType string

ローカライズされた要素のコントロールの種類によって結果をフィルター処理します。

検索プロセス ID
SearchProcessID integer

指定した場合は、このプロセス ID (PID) のプロセスが所有する要素のみを検索で考慮します。 IA-Connect がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白にします。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

戻す最初の項目
FirstItemToReturn integer

1 から始まる、返される最初の項目の要素インデックス。 逆順序で要素を返す場合 (UIA ツリーの一番下から) は、-1 から始まる負のインデックスを代わりに指定できます。

返される項目の最大数
MaxItemsToReturn integer

返す要素の最大数、またはすべての項目を返す場合は 0。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
見つかった要素の数
NumberOfElementsFound integer

検索条件に一致する、見つかったデスクトップ要素の数。

返される要素の数
NumberOfElementsReturned integer

返されたデスクトップ要素の数 (返す項目の最大数を指定する場合は、見つかった要素数よりも少なくなる場合があります)。

要素のプロパティ
ElementProperties array of object

検索条件に一致する、見つかったデスクトップ要素の要素プロパティ。

項目
ElementProperties object

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

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

パラメーター

名前 キー 必須 説明
検索要素の名前
SearchElementName string

検索する UIA 要素名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のクラス名
SearchElementClassName string

検索する UIA 要素クラス名 (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素の自動化 ID
SearchElementAutomationId string

検索する UIA 要素の自動化 ID (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索要素のローカライズしたコントロールの種類
SearchLocalizedControlType string

検索する UIA 要素のローカライズしたコントロール タイプ (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索プロセス ID
SearchProcessId integer

指定した場合 (1 以上の値) は、このプロセス ID (PID) のプロセスが所有する要素のみを検索で考慮します。 IA-Connect がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

待機する秒数
SecondsToWait True integer

要素の存在確認を待機する最大秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

要素が見つからない場合に例外を発生する
RaiseExceptionIfElementNotFound boolean

待機期間後に UIA 要素が存在しない場合、IA-Connect で例外を発生させる必要がありますか?

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 トランザクション タイムアウトを設定する

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

パラメーター

名前 キー 必須 説明
タイムアウト (秒)
TimeoutInSeconds True double

アプリケーションが要素に関する情報を返すまで UIA API が待機する最大期間。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

プロセスのメイン ウィンドウ (プロセス 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 プロセスのメイン ウィンドウを待機する

ハンドルを返す前に、プロセスのメイン ウィンドウ (名前によって指定) が存在するまで指定された期間待機する、シンプルで高速な 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 リスト要素項目を取得する

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
リスト項目の数
NumberOfListItems integer

リスト内の項目数。

リスト項目 JSON
ListItemsJSON string

リスト内の項目のプロパティ (JSON 形式)。

選択した項目の数
NumberOfSelectedItems integer

リスト内で選択されている項目の数。

最初に選択された項目のインデックス
IndexOfFirstSelectedItem integer

最初に選択された項目のリスト内のインデックス。

選択されている項目名
SelectedItemName string

選択されている項目の名前。

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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

最初の展開
ExpandFirst boolean

true に設定すると、リストの項目要素を検索する前に、IA-Connect がリストの展開を試みます。 この機能は、リストを展開するまでリスト項目要素を作成しない可能性がある、動的リストで便利です。

以降を折りたたむ
CollapseAfter boolean

true に設定すると、検索の実行後にリストを折りたたみます。

項目インデックス
ItemIndex integer

クリックする項目の一覧内のインデックス。

展開から折りたたみまでの秒数
SecondsBetweenExpandCollapse double

展開アクションと折りたたみアクションが true に設定されている場合にこれらのアクション間に待機する秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

最初の展開
ExpandFirst boolean

true に設定すると、リストの項目要素を検索する前に、IA-Connect がリストの展開を試みます。 この機能は、リストを展開するまでリスト項目要素を作成しない可能性がある、動的リストで便利です。

以降を折りたたむ
CollapseAfter boolean

true に設定すると、検索の実行後にリストを折りたたみます。

品目名
ItemName string

クリックする要素項目の名前。

展開から折りたたみまでの秒数
SecondsBetweenExpandCollapse double

展開アクションと折りたたみアクションが true に設定されている場合にこれらのアクション間に待機する秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

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

パラメーター

名前 キー 必須 説明
検索のクラス名
SearchClassName string

検索する最上位ウィンドウの要素クラス名 ('メモ帳' など)。

検索ウィンドウのタイトル
SearchWindowTitle string

検索する最上位ウィンドウのタイトル。

待機する秒数
SecondsToWait True integer

ウィンドウの存在確認を待機する最大秒数。

検索プロセス ID
SearchProcessId integer

ウィンドウを所有するプロセスのオプションのプロセス ID (たとえば、IA-Connect 環境/セッション アクションの「プロセスを実行する」の出力によって提供されます)。 プロセス ID で検索しない場合は 0 に設定します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

使用可能なウィンドウ プロパティに対して条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [タイトル]、例: '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数のウィンドウが一致する場合、並べ替えに使用するウィンドウのプロパティを指定することができます。 同時に、「照合インデックス」を使用して必要なウィンドウを選択することもできます。 例: 「列名で並べ替え」を [TopEdge]、「照合インデックス」を 1 に指定すると、一致するウィンドウのうち画面の一番上に表示されているものが返されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数のウィンドウが一致する場合、「照合インデックス」の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

ウィンドウが見つからない場合に例外を発生する
RaiseExceptionIfWindowNotFound boolean

待機期間後に検索 Win32 ウィンドウが存在しない場合、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 コントロールの種類。

要素が存在
ElementExists boolean

ウィンドウが存在する場合は true、存在しない場合は false を返します。

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

この操作は、要素 (通常はチェックボックスまたはラジオ ボックス) がオンになっているかどうかを示す 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
要素がチェックされている
ElementIsChecked boolean

要素がチェックされている場合は true、そうでない場合は false を返します。

UIA 要素が存在しなくなるまで待機する

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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 がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

待機する秒数
SecondsToWait True integer

要素が存在しなくなるまで待機する最大秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

要素がまだ存在する場合に例外を発生する
RaiseExceptionIfElementStillExists boolean

待機期間後に UIA 要素がまだ存在する場合、IA-Connect で例外を発生させる必要がありますか?

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
待機前に要素が存在
ElementExistsBeforeWait boolean

待機前に要素が存在する場合は true、そうでない場合は false を返します。

待機後に要素が存在
ElementExistsAfterWait boolean

待機後に要素が存在する場合は true、そうでない場合は false を返します。

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

要素 (通常はテキスト入力フィールド) にテキストを入力し、既存のテキストを置き換えるか、または特定の位置に新しい値を挿入する 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

既存の値を置き換える
ReplaceExistingValue boolean

要素に既存のテキストが存在する場合、これを置き換える必要がありますか?

挿入する位置
InsertPosition integer

テキストの挿入を開始する位置 (インデックス)。 既存のテキストがある場合、挿入位置を使用して、既存のテキスト内の特定の位置に挿入できます。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

パスワードを要素 (通常はパスワード入力フィールド) に入力して既存のテキストを置き換える 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

保存されたパスワードを含むパスワード
PasswordContainsStoredPassword boolean

パスワードに、IA-Connect に保存されているパスワード識別子 (形式: {IAConnectPassword:StoredPasswordIdentifier}) または IA-Connect オーケストレーター汎用資格情報 (形式: {OrchestratorCredential:FriendlyName}) が含まれる (または全体) 場合は、true に設定します。 この保存されたパスワードは、たとえば 'パスワードの生成' アクションによって生成された可能性があります。

ワークフロー
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA 要素に改行を入力する

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

既存の値を置き換える
ReplaceExistingValue boolean

要素に既存のテキストが存在する場合、これを置き換える必要がありますか?

挿入する位置
InsertPosition integer

テキストの挿入を開始する位置 (インデックス)。 既存のテキストがある場合、挿入位置を使用して、既存のテキスト内の特定の位置に挿入できます。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

水平スクロール率
HorizontalScrollPercentage double

要素を水平方向にスクロールする位置 (0 から 100まで、小数点をサポート)、または水平スクロール位置を変更しない場合は -1 です。

垂直スクロール率
VerticalScrollPercentage double

要素を垂直方向にスクロールする位置 (0 から 100まで、小数点をサポート)、または垂直スクロール位置を変更しない場合は -1 です。

スクロール パターンを試す
TryScrollPattern boolean

IA-Connect Agent で UIA スクロール パターンを使用してスクロール アクションを試行する場合は true に設定します。 選択した要素で UIA スクロール パターンが利用できない場合、IA-Connect Agent は他の選択したパターン (このアクションへの他の入力によって有効または無効) に戻ります。 IA-Connect Agent でスクロール パターンの使用を試行せず、すぐに他の選択されたパターンに戻るには、false に設定します。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲値、および値です。

範囲値パターンを試す
TryRangeValuePattern boolean

IA-Connect Agent で UIA 範囲値パターンを使用してスクロール アクションを試行する場合は true に設定します。 選択した要素で UIA 範囲値パターンが利用できない場合、IA-Connect Agent は他の選択したパターン (このアクションへの他の入力によって有効または無効) に戻ります。 IA-Connect Agent で範囲値パターンの使用を試行せず、すぐに他の選択されたパターンに戻るには、false に設定します。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲値、および値です。

値パターンを試す
TryValuePattern boolean

IA-Connect Agent で UIA 値パターンを使用してスクロール アクションを試行する場合は true に設定します。 選択した要素で UIA 値パターンが利用できない場合、IA-Connect Agent は他の選択したパターン (このアクションへの他の入力によって有効または無効) に戻ります。 IA-Connect Agent で値パターンの使用を試行せず、すぐに他の選択されたパターンに戻るには、false に設定します。 試行されるパターンの順序 (このアクションへの入力によって有効になっている場合) は、スクロール、範囲値、および値です。 警告: 編集要素で値パターンを使用すると、編集要素に値が入力されるだけになります。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
コマンド結果
UIASetElementScrollPercentageResult boolean

コマンドの結果 (成功または失敗) です。

Error message
ErrorMessage string

コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

要素のテキスト値。

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

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

要素の値を返す
ReturnElementValue boolean

true に設定すると、見つかった要素の値を返します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

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

要素に現在キーボード フォーカスがあるかどうかを返します。

要素はパスワード フィールド
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

入力 '要素の値を返す' が true に設定されており、要素に値のパターンがある場合、これはその値を保持します。

要素のテキスト値
ElementTextValue string

入力 '要素の値を返す' が true に設定されており、要素にテキスト値のパターンがある場合、これはそのテキスト値を保持します。

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

要素の値。

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA 要素の周囲に長方形を描画する

要素の周囲に長方形を描画して、見つかった要素が必要な要素であることを識別しやすくします。 長方形は 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

イメージの形式
ImageFormat string

スクリーンショットに使用する画像の形式。 これは、返されるデータの品質とサイズに影響する可能性があります。 サポートされている形式は PNG (既定)、JPG、BMP、GIF です

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Agent を非表示にする
HideAgent boolean

true に設定すると、Agent (表示されている場合) が自動的に非表示になり、スクリーンショットが隠されないようになります。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Base64 としての画面イメージ
ScreenBitmapBase64 string

Base64 でエンコードされた文字列としての画面イメージ。

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

指定された色の基準を満たす 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

検索色
SearchColour True string

0xAARRGGBB、#AARRGGBB、0xRRGGBB、または #RRGGBB の形式の検索色。各カラー チャネルは 16 進形式のバイトです (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 オフセット。 これにより、検索領域を拡大 (正の値の場合) または縮小 (負の値の場合) することができます。

Agent を非表示にする
HideAgent boolean

true に設定すると、Agent (表示されている場合) が自動的に非表示になり、分析対象の要素が隠されないようになります。

画面座標を物理座標として返す
ReturnPhysicalCoordinates boolean

画面座標を物理座標として返す場合は true に設定します。 画面座標を仮想座標として返す場合は false に設定します。 基本的な表示スケーリングが 100% の場合、物理座標と仮想座標は両方とも同じになります。 要素座標は常に仮想座標として返されます。

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 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

色一致境界ボックス画面の右ピクセル
ColourMatchBoundingBoxScreenRightPixelXCoord integer

指定された色に一致する右端のピクセルの画面ピクセル X 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

色一致境界ボックス画面の上ピクセル
ColourMatchBoundingBoxScreenTopPixelYCoord integer

指定された色に一致する上端のピクセルの画面ピクセル Y 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

色一致境界ボックス画面の下ピクセル
ColourMatchBoundingBoxScreenBottomPixelYCoord integer

指定された色に一致する下端のピクセルの画面ピクセル Y 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

色一致境界ボックス画面の中央 X ピクセル
ColourMatchBoundingBoxScreenCenterPixelXCoord integer

指定された色に一致するピクセルを含む境界ボックスの中心の画面ピクセル X 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

色一致境界ボックス画面の中央 Y ピクセル
ColourMatchBoundingBoxScreenCenterPixelYCoord integer

指定された色に一致するピクセルを含む境界ボックスの中心の画面ピクセル Y 座標。 これは、「物理座標を返す」の入力に応じて、物理座標または仮想座標のいずれかになります。

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

マウスを要素の中央に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

フォーカスする最初の要素
FocusElement boolean

IA-Connect はグローバル クリック前にフォーカスを要素に移動しますか?

要素のマウス左クリック (グローバル)
GlobalMouseClickOnElement boolean

テキストを入力する前に、要素に焦点を合わせる要素の座標でグローバル マウス クリックを実行する必要がありますか?

マウスのダブル クリックと delete キーで既存の値を置き換える
ReplaceExistingValueUsingDoubleClickDelete boolean

マウスのダブルクリックでハイライトして削除することにより、既存の値を置き換える必要がありますか?

CTRL-A と delete キーを使用して既存の値を置き換える
ReplaceExistingValueUsingCTRLADelete boolean

Ctrl-A を押してすべてをハイライトしてから削除することで、既存の値を置き換える必要がありますか? 要素の一部は Ctrl-A によるハイライトをサポートしていないので、その場合は代替オプション 'マウスのダブルクリックと delete キーで既存の値を置き換える' を試す必要があります。

入力テキスト
TextToInput string

キーボードを使用してグローバル入力するテキスト値。

キー イベントの送信を使用する
SendKeyEvents boolean

true に設定すると、キー イベント (シミュレートしたキー ストロークをオペレーティング システムに送信する低レベル API) の送信を使用します。 false に設定すると、代わりに送信キー (フォーカスした要素にキー ストロークを送信する高レベル API) を使用します。

間隔 (ミリ秒)
Interval integer

各キー押下間のミリ秒数。

記号を解釈しない
DontInterpretSymbols boolean

'入力するテキスト' 内の記号を特殊キー (例: Shift は +、Ctrl は ^ など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

マウスを要素の中央に移動し、フォーカスを合わせ、左クリックして、キーを押します。 通常、ネイティブ 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

フォーカスする最初の要素
FocusElement boolean

IA-Connect はグローバル クリック前にフォーカスを要素に移動しますか?

要素のマウス左クリック (グローバル)
GlobalMouseClickOnElement boolean

テキストを入力する前に、要素に焦点を合わせる要素の座標でグローバル マウス クリックを実行する必要がありますか?

マウスのダブル クリックと delete キーで既存の値を置き換える
ReplaceExistingValueUsingDoubleClickDelete boolean

マウスのダブルクリックでハイライトして削除することにより、既存の値を置き換える必要がありますか?

CTRL-A と delete キーを使用して既存の値を置き換える
ReplaceExistingValueUsingCTRLADelete boolean

Ctrl-A を押してすべてをハイライトしてから削除することで、既存の値を置き換える必要がありますか? 要素の一部は Ctrl-A によるハイライトをサポートしていないので、その場合は代替オプション 'マウスのダブルクリックと delete キーで既存の値を置き換える' を試す必要があります。

入力するパスワード
PasswordToInput True password

キーボードを使用してグローバル入力するパスワード値。

キー イベントの送信を使用する
SendKeyEvents boolean

true に設定すると、キー イベント (シミュレートしたキー ストロークをオペレーティング システムに送信する低レベル API) の送信を使用します。 false に設定すると、代わりに送信キー (フォーカスした要素にキー ストロークを送信する高レベル API) を使用します。

間隔 (ミリ秒)
Interval integer

各キー押下間のミリ秒数。

記号を解釈しない
DontInterpretSymbols boolean

'入力するパスワード' 内の記号を特殊キー (例: Shift は +、Ctrl は ^ など) として解釈しないようにしますか? 実際の記号を入力する場合は、これを true に設定する必要があります。

保存されたパスワードを含むパスワード
PasswordContainsStoredPassword boolean

パスワードに、IA-Connect に保存されているパスワード識別子 (形式: {IAConnectPassword:StoredPasswordIdentifier}) または IA-Connect オーケストレーター汎用資格情報 (形式: {OrchestratorCredential:FriendlyName}) が含まれる (または全体) 場合は、true に設定します。 この保存されたパスワードは、たとえば 'パスワードの生成' アクションによって生成された可能性があります。

ワークフロー
Workflow True string

次の式をここに追加します: workflow()

戻り値

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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素をチェック
CheckElement boolean

要素をチェックしますか (true)、またはチェック解除しますか (false)?

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

UIA 要素を待機する

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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 がプロセスを起動した場合は、IA-Connect 環境/セッション アクションが含む 'プロセスを実行する' アクションが PID を提供します。 PID が不明の場合は、このフィールドを空白 (または 0) にします。

UIA のサブツリーを検索する
SearchSubTree boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、見つかった要素に対するハンドルを返します。 このハンドルは以降のアクションで使用でき、'親' ハンドルとして機能します。

待機する秒数
SecondsToWait True integer

要素の存在確認を待機する最大秒数。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

子プロセスを含める
IncludeChildProcesses boolean

true に設定され、'検索プロセス ID' が指定されている場合、そのプロセス ID の子プロセスも検索に含まれます。 false に設定すると、'検索プロセス ID' に完全一致するプロセスのみを返します。

要素が見つからない場合に例外を発生する
RaiseExceptionIfElementNotFound boolean

待機期間後に UIA 要素が存在しない場合、IA-Connect で例外を発生させる必要がありますか?

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 要素を折りたたむ

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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 ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

ボタン イベントが完了するまで待機
Wait boolean

続行する前に、ボタン イベントが完了するまで自動化が待機するかどうか。 true に設定すると、ボタンがモーダル ダイアログを開いた場合にタイムアウトが発生する可能性があります。

Win32 クリック ボタン
Win32ClickButton boolean

Win32 クリック イベントを使用しますか? これは 'ファイア アンド フォーゲット' のクリック イベントで、クリック後に表示されるモーダル ダイアログの操作に使用すると便利な場合があります。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

新しい値
NewValue True integer

要素の設定先の数値。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

新しい値
NewValue True double

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

新しい値は割合である
NewValueIsPercentage boolean

新しい値は割合ですか?

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

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

パラメーター

名前 キー 必須 説明
要素のハンドル
ElementHandle True integer

ターゲット要素の UIA ハンドル。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
見つかった要素の数
NumberOfElementsFound integer

見つかった要素の数。

返される要素の数
NumberOfElementsReturned integer

返される要素の数。

UIA 要素のプロパティ JSON
UIAElementPropertiesJSON string

要素の UIA プロパティ (JSON 形式)。

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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

要素のラベルの値。

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

指定した要素の親要素のハンドルを返します。 親要素は UIA 'ツリー' のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

パラメーター

名前 キー 必須 説明
要素のハンドル
ElementHandle True integer

ターゲット要素の UIA ハンドル。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
親要素ハンドル
ParentElementHandle integer

親要素の UIA ハンドル。

Win32 ウィンドウを取得する

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

パラメーター

名前 キー 必須 説明
検索のクラス名
SearchClassName string

検索する最上位ウィンドウのオプションのクラス名 (「Chrome_WidgetWin_1」など)。

検索ウィンドウのタイトル
SearchWindowTitle string

検索する最上位ウィンドウのオプションのタイトル。

最上位ウィンドウのみを取得する
TopLevelWindowsOnly boolean

OS が最上位と見なす Win32 ウィンドウのみを取得するには、true に設定します。 すべての Win32 ウィンドウを取得するには、false に設定します。 Win32 のウィンドウの定義には、ウィンドウとして認識できない可能性のある項目が含まれており、多くのダイアログやメッセージ ボックスは、親ウィンドウの子であっても最上位としてマークされることに注意してください。

表示可能なウィンドウのみ取得する
VisibleWindowsOnly boolean

OS が表示可能と見なす Win32 ウィンドウのみを取得するには、true に設定します。 false に設定すると、表示可能な Win32 ウィンドウと表示不可能な Win32 ウィンドウの両方が取得されます。 画面外または透明なウィンドウが表示可能としてマークされている場合がありますが、表示されないことに注意してください。

タイトル バーのあるウィンドウのみ取得する
WindowsWithTitlebarOnly boolean

タイトル バーのある Win32 ウィンドウのみ取得するには、true に設定します。 タイトル バーの有無に関係なく Win32 ウィンドウを取得するには、false に設定します。 一部の透明なウィンドウにはタイトル バーがありますが、表示されないことに注意してください。

タイトルのあるウィンドウのみ取得する
WindowsWithTitleOnly boolean

タイトル (つまり、テキストを含むタイトル バー) を持つ Win32 ウィンドウのみを取得するには、true に設定します。 タイトルの有無に関係なく Win32 ウィンドウを取得するには、false に設定します。 タイトル バーはウィンドウの上部を横切る帯であり、タイトルはその中のテキストであることに注意してください。

透明なウィンドウを無視する
IgnoreTransparentWindows boolean

透過性のない Win32 ウィンドウのみを取得するには true に設定します。 透過性が設定されているかどうかに関係なく Win32 ウィンドウを取得するには、false に設定します。

検索プロセス ID
SearchProcessId integer

ウィンドウを所有するプロセスのオプションのプロセス ID (たとえば、IA-Connect 環境/セッション アクションの「プロセスを実行する」の出力によって提供されます)。 プロセス ID で検索しない場合は 0 に設定します。

検索フィルター
SearchFilter string

条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [タイトル]、例: '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数のウィンドウが一致する場合、並べ替えに使用するウィンドウのプロパティを指定することができます。 例: 「列名で並べ替え」が [TopEdge] の場合、ウィンドウのリストは上端から順に返されます。 このフィールドを空白のままにすると、ウィンドウは検出された順序で返されます。

照合インデックスは昇順です
MatchIndexAscending boolean

複数のウィンドウが検索に一致し、並べ替え列が指定されている場合、昇順に並べ替えるには true (デフォルト) に設定し、降順に並べ替えるには false に設定します。

UIA 要素ハンドルを返す
ReturnElementHandle boolean

true に設定すると、検索された各 Win32 ウィンドウへの UIA ハンドルが出力コレクション (「UIAHandle」列) に返されます。 このハンドルは以降のアクションで使用でき、IA-Connect UIA アクションの「親」ハンドルとして機能します。

戻す最初の項目
FirstItemToReturn integer

1 から始まる、返す最初のウィンドウ (行) のインデックス。

返される項目の最大数
MaxItemsToReturn integer

返すウィンドウの最大数、またはすべての項目を返す場合は 0。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
Win32 ウィンドウ JSON
Win32WindowsJSON string

検索条件に一致する Win32 ウィンドウのリスト (JSON 形式)。

Win32 ウィンドウの数
NumberOfWin32Windows integer

返される Win32 ウィンドウの数。

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

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

パラメーター

名前 キー 必須 説明
ワークフロー
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

指定された色の基準を満たす 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、"マッチ インデックス" の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

検索色
SearchColour True string

0xAARRGGBB、#AARRGGBB、0xRRGGBB、または #RRGGBB の形式の検索色。各カラー チャネルは 16 進形式のバイトです (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

ダブル クリックする場合の各クリック間の遅延 (ミリ秒)。

Agent を非表示にする
HideAgent boolean

true に設定すると、Agent (表示されている場合) が自動的に非表示になり、分析対象の要素が隠されないようになります。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
コマンド結果
UIAGlobalMouseClickElementSearchColourRegionResult boolean

コマンドの結果 (成功または失敗) です。

Error message
ErrorMessage string

コマンドが失敗した場合は、返されたエラー メッセージがここに表示されます。

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

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

パラメーター

名前 キー 必須 説明
入力要素
InputElementsJSON True string

テキストを入力する UIA 要素の配列 (JSON 形式)。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

デスクトップのハンドルを返します。 これは廃止されたアクションです。デスクトップ要素を参照するにはハンドル '-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 ウィンドウを設定する

ウィンドウをフォアグラウンドに表示します。

パラメーター

名前 キー 必須 説明
ウィンドウ ハンドル
WindowHandle True integer

フォアグラウンド ウィンドウとして設定する必要があるウィンドウの UIA ハンドル。

ウィンドウの切り替え
ToggleWindow boolean

ウィンドウにフォーカスを移動するかクリックしてウィンドウを切り替えますか? これにより、ウィンドウが確実にフォアグラウンドに表示されます。

切り替えはグローバルな左マウス クリック エージェントを使用する
ToggleUsesGlobalLeftMouseClickAgent boolean

ウィンドウを切り替える場合、グローバル マウス クリックを使用して IA-Connect Agent に最初にフォーカスするかどうかを指定できます。

切り替えの遅延 (秒)
ToggleDelay double

ウィンドウのトグルを選択する場合、トグル後に一時停止することを指定できます。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

現在フォーカスされている 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 ハンドルを取得する

現在フォーカスされている 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 によって指定) のハンドルを返す、シンプルで高速な 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 コントロールの種類。

プロセスに Win32 ウィンドウがある

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

パラメーター

名前 キー 必須 説明
検索プロセスの名前
SearchProcessName True string

検索するプロセスの名前 (メモ帳など)。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
プロセスにウィンドウがある
ProcessHasWindow boolean

表示されているウィンドウがプロセスに存在する場合は true、存在しない場合は false を返します。

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

プロセスのメイン ウィンドウ (名前によって指定) のハンドルを返す、シンプルで高速な 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 コントロールの種類。

マウスの中央ボタンで 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

オフセット X をクリック
ClickOffsetX integer

クリック アクションをオフセットする X ピクセル数。 このパラメーターは、正 (右) と負 (左) の両方のオフセット値をサポートしています。

オフセット Y をクリック
ClickOffsetY integer

クリック アクションをオフセットする Y ピクセル数。 このパラメーターは、正 (下) と負 (上) の両方のオフセット値をサポートしています。

相対オフセットの基準
OffsetRelativeTo string

オフセットする要素の相対位置 (センター/中央/中間、左、右、上、下、左上、右下、左下、右下)

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

マウスの右ボタンで 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

オフセット X をクリック
ClickOffsetX integer

クリック アクションをオフセットする X ピクセル数。 このパラメーターは、正 (右) と負 (左) の両方のオフセット値をサポートしています。

オフセット Y をクリック
ClickOffsetY integer

クリック アクションをオフセットする Y ピクセル数。 このパラメーターは、正 (下) と負 (上) の両方のオフセット値をサポートしています。

相対オフセットの基準
OffsetRelativeTo string

オフセットする要素の相対位置 (センター/中央/中間、左、右、上、下、左上、右下、左下、右下)

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

マウスの左ボタンで 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

オフセット X をクリック
ClickOffsetX integer

クリック アクションをオフセットする X ピクセル数。 このパラメーターは、正 (右) と負 (左) の両方のオフセット値をサポートしています。

オフセット Y をクリック
ClickOffsetY integer

クリック アクションをオフセットする Y ピクセル数。 このパラメーターは、正 (下) と負 (上) の両方のオフセット値をサポートしています。

相対オフセットの基準
OffsetRelativeTo string

オフセットする要素の相対位置 (センター/中央/中間、左、右、上、下、左上、右下、左下、右下)

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

マウスの左ボタンで 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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [TopEdge]、'照合インデックス' を 1 に指定すると、一致する要素のうち画面の一番上に表示されているものが選択されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数の要素が一致する場合、'マッチ インデックス' の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

オフセット X をクリック
ClickOffsetX integer

クリック アクションをオフセットする X ピクセル数。 このパラメーターは、正 (右) と負 (左) の両方のオフセット値をサポートしています。

オフセット Y をクリック
ClickOffsetY integer

クリック アクションをオフセットする Y ピクセル数。 このパラメーターは、正 (下) と負 (上) の両方のオフセット値をサポートしています。

相対オフセットの基準
OffsetRelativeTo string

オフセットする要素の相対位置 (センター/中央/中間、左、右、上、下、左上、右下、左下、右下)

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

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

パラメーター

名前 キー 必須 説明
検索のクラス名
SearchClassName string

検索する最上位ウィンドウの要素クラス名 ('メモ帳' など)。

検索ウィンドウのタイトル
SearchWindowTitle string

検索する最上位ウィンドウのタイトル。

検索プロセス ID
SearchProcessId integer

ウィンドウを所有するプロセスのオプションのプロセス ID (たとえば、IA-Connect 環境/セッション アクションの「プロセスを実行する」の出力によって提供されます)。 プロセス ID で検索しない場合は 0 に設定します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

使用可能なウィンドウ プロパティに対して条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [タイトル]、例: '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数のウィンドウが一致する場合、並べ替えに使用するウィンドウのプロパティを指定することができます。 同時に、「照合インデックス」を使用して必要なウィンドウを選択することもできます。 例: 「列名で並べ替え」を [TopEdge]、「照合インデックス」を 1 に指定すると、一致するウィンドウのうち画面の一番上に表示されているものが返されます。

照合インデックスは昇順です
MatchIndexAscending boolean

検索条件に複数のウィンドウが一致する場合、「照合インデックス」の照合を並べ替えたリストで上から順に行うのか (true)、下から順に行うのか (false) を指定します。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
ウィンドウ ハンドル
WindowHandle integer

ウィンドウの UIA ハンドル。 これは、このウィンドウ内でのさらなる UIA アクションへの入力として使用できます。

要素名
ElementName string

ウィンドウ要素の UIA 名。

要素のクラス名
ElementClassName string

ウィンドウ要素の UIA クラス名。

要素の自動化 ID
ElementAutomationId string

ウィンドウ要素の UIA 自動化 ID。

要素のローカライズされたコントロールの種類
ElementLocalizedControlType string

ウィンドウ要素のローカライズされた UIA コントロールの種類。

最上位の Win32 ウィンドウが存在するか

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

パラメーター

名前 キー 必須 説明
検索のクラス名
SearchClassName string

検索する最上位ウィンドウの要素クラス名 ('メモ帳' など)。

検索ウィンドウのタイトル
SearchWindowTitle string

検索する最上位ウィンドウのタイトル。

検索プロセス ID
SearchProcessId integer

ウィンドウを所有するプロセスのオプションのプロセス ID (たとえば、IA-Connect 環境/セッション アクションの「プロセスを実行する」の出力によって提供されます)。 プロセス ID で検索しない場合は 0 に設定します。

照合インデックス
MatchIndex integer

検索条件に複数の要素が一致する場合、どの要素を照合するか (1 から開始) を指定します。 同時に '列で並べ替え' を使用して、照合の並べ替え順を選択できます。

検索フィルター
SearchFilter string

使用可能なウィンドウ プロパティに対して条件演算子と任意の要素フィールドを使用して検索条件をさらに制限する、高度なオプション フィルター。 例 1: [幅] < 200。 例 2: [タイトル]、例: '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 その他の例については、ドキュメントを参照してください。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
ウィンドウが存在する
WindowExists boolean

ウィンドウが存在する場合は true、存在しない場合は false を返します。

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

UIA ツリー階層を検索して、検索条件に一致する最初の親要素を探します。 親要素は UIA "ツリー" のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

パラメーター

名前 キー 必須 説明
要素のハンドル
ElementHandle True integer

ターゲット要素の UIA ハンドル。

検索親要素のローカライズしたコントロール タイプ
SearchParentLocalizedControlType string

検索する親 UIA 要素のローカライズしたコントロール タイプ。 これは検査で検出できます。

検索親要素コントロール タイプ
SearchParentControlType integer

検索する親 UIA 要素のコントロール タイプ (ローカライズしていない整数)。 これは、異なる言語間でも同じ値です。

処理する親の最大件数
MaxParentsToProcess integer

処理する親要素の最大数。 既定では、50 に設定されています。

親要素が見つからない場合は例外を発生させる
RaiseExceptionIfParentElementNotFound boolean

検索 UIA 要素が見つからない場合、IA-Connect が例外を発生する必要がありますか?

ワークフロー
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 要素を取得する

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

パラメーター

名前 キー 必須 説明
X 座標
XCoord integer

UI 要素を検索する画面の X 座標値 (ピクセル単位)。

Y 座標
YCoord integer

UI 要素を検索する画面の Y 座標値 (ピクセル単位)。

要素が見つからない場合に例外を発生する
RaiseExceptionIfElementNotFound boolean

指定した場所に UIA 要素が配置されていない場合に、IA-Connect が例外を発生する必要がありますか?

ワークフロー
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 要素のプロパティを取得する

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

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
ParentWindowHandle True integer

検索の開始点として機能する親 UIA ウィンドウ ハンドル (1 以上の値)。 これは、検査で 'デスクトップ要素の待機' や '要素の待機' のようなアクションを使用して検出できます。

検索要素のローカライズしたコントロールの種類
SearchElementLocalizedControlType string

検索する UIA 要素のローカライズしたコントロール タイプ (親ウィンドウ ハンドルから開始) (オプション)。 これは検査で検出できます。

検索の下位要素
SearchDescendants boolean

true に設定すると、親ウィンドウ ハンドルの下の UIA ツリー全体が検索されます。 これはより入念ですが、さらに時間がかかります。 false に設定すると、UIA ツリーの親ウィンドウ ハンドルの下の要素が直接検索されます。

要素ハンドルを返す
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

検索条件に一致する、見つかった要素の要素プロパティ。

項目
ElementProperties object

複数の UIA 要素をチェックする

複数の要素 (通常はチェックボックスやラジオ ボックス) の状態を、チェック済みまたはチェック解除のどちらかに設定します。

パラメーター

名前 キー 必須 説明
入力要素
InputElementsJSON True string

チェックする UIA 要素の配列 (JSON 形式)。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

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

指定された親要素の子要素の値を列挙し、テーブル形式で返します。 これを使用すると、厳密にはテーブルではありませんが、テーブル構造にまとめて配置された要素からデータの行と列を返すことができます。 このアクションは、Agent スレッドとして実行されたこのアクションの以前の実行からの結果を取得するために使用することもできます。

パラメーター

名前 キー 必須 説明
親ウィンドウ ハンドル
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: [名前] like 'ドキュメント ' AND [ClassName] like 'ラベル'。 その他の例については、ドキュメントを参照してください。

列名で並べ替え
SortByColumn string

検索条件に複数の要素が一致する場合、並べ替えに使用する要素のプロパティを指定することができます。 同時に、'照合インデックス' を使用して必要な要素を選択することもできます。 例: '列名で並べ替え' を [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 は優先順位が 1 番目です。 2 は優先順位が 2 番目です。 3 は優先順位が 3 番目です。 0 は使用しないでください。

セル サブ要素テキストの値の優先度
CellSubElementTextValuePriority integer

セル サブ要素テキスト値を出力テーブルで値として使用するための優先順位。 1 は優先順位が 1 番目です。 2 は優先順位が 2 番目です。 3 は優先順位が 3 番目です。 0 は使用しないでください。

セル サブ要素名の値の優先度
CellSubElementNameValuePriority integer

セル サブ要素名 (ラベルで一般的) を出力テーブルで値として使用するための優先順位。 1 は優先順位が 1 番目です。 2 は優先順位が 2 番目です。 3 は優先順位が 3 番目です。 0 は使用しないでください。

セル サブ要素の最小の幅
MinimumCellSubElementWidth integer

テーブルが含むセル サブ要素の最小の幅 (ピクセル単位)。

セル サブ要素の最小の高さ
MinimumCellSubElementHeight integer

テーブルが含むセル サブ要素の最小の高さ (ピクセル単位)。

検索セル サブ要素境界ボックスの左
SearchCellSubElementBoundingBoxLeft integer

境界ボックス内に完全に含まれているセル サブ要素のみを含めます。 既定では、境界ボックスはかなり大きく、すべての要素が含まれています。

検索セル サブ要素境界ボックスの右
SearchCellSubElementBoundingBoxRight integer

境界ボックス内に完全に含まれているセル サブ要素のみを含めます。 既定では、境界ボックスはかなり大きく、すべての要素が含まれています。

検索セル サブ要素境界ボックスの上
SearchCellSubElementBoundingBoxTop integer

境界ボックス内に完全に含まれているセル サブ要素のみを含めます。 既定では、境界ボックスはかなり大きく、すべての要素が含まれています。

検索セル サブ要素境界ボックスの下
SearchCellSubElementBoundingBoxBottom integer

境界ボックス内に完全に含まれているセル サブ要素のみを含めます。 既定では、境界ボックスはかなり大きく、すべての要素が含まれています。

テーブルをスレッドとして読み取る
ReadTableAsThread boolean

false (デフォルト) に設定すると、IA-Connect Agent は即座にテーブルを読み取り、その内容を Director に返します。 大きなテーブルを読み取る場合、このアクションはタイムアウトになることがあります。true に設定すると、 IA-Connect Agent はテーブルを Agent スレッドとして読み取り、IA-Connect Director (またはオーケストレーター、PowerShell モジュール、Blue Prism) は、この Agent スレッドのステータスを監視し、完了するのを待つことができます。 これにより、大きなテーブルをタイムアウトせずに読み取ることができます。 IA-Connect Agent 9.3以前では、Agent スレッドとしてではなく、テーブルを即座に読み取ることのみできました。

スレッド ID の出力データを取得する
RetrieveOutputDataFromThreadId integer

以前にこのアクションを Agent スレッドとして実行し、「スレッドを待機する秒数」を 0 に設定した場合は、Agent スレッド ID を指定して結果を取得します。 このエージェント スレッド ID は、このアクションへの以前の呼び出しによって提供されます。 テーブルを読み取る場合 (したがって、Agent スレッドとして実行された以前のクエリの結果を取得しない場合) は、0 (デフォルト) に設定します。

スレッドを待機する秒数
SecondsToWaitForThread integer

「テーブルをスレッドとして読み取る」が true に設定されている場合に、Agent スレッドが完了するまで待機する秒数。 テーブルを読み取る Agent スレッドがこの時間内に完了していない場合、例外が発生します。 待機をバイパスするには、0 に設定します。Agent はテーブルの読み取りを続けますが、次のアクションでも使用できます。 その後、「Agent スレッドが正常に完了するまで待機する」アクションを使用して Agent スレッドが完了するのを待ってから、入力「スレッド ID の出力データを取得する」をAgent スレッド ID に設定してこの「複数の UIA 要素をテーブルとして取得する」アクションを再実行することで、後で結果 (テーブルのコンテンツ) を取得できます。

Workflow
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
見つかったセル サブ要素の数
NumberOfCellSubElementsFound integer

検索条件と一致する、見つかった (ヘッダーではない) セル サブ要素の数。

返されたセル サブ要素の数
NumberOfCellSubElementsReturned integer

返される (ヘッダーではない) セル サブ要素の数 (返す項目の最初の数または最大数を指定する場合、この値は検出される要素の数よりも小さくなる可能性があります)。

テーブルのコンテンツ JSON
TableContentsJSON string

複数の要素のコンテンツから JSON 形式で作成したテーブル。

テーブルが含む行数
NumberOfRowsInTable integer

出力テーブル内の行の数です。

テーブルが含む列数
NumberOfColumnsInTable integer

出力テーブル内の列の数です。

スレッド ID
ThreadId integer

このアクションが Agent スレッドとして実行されている場合、この出力には Agent スレッド ID が保持されます。これを使用して、アクションのプロセスを監視し、スレッドが完了したときにテーブルのコンテンツを取得できます。

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

デスクトップ (ルート レベル) まで、指定された要素の親要素の階層ツリーを返します。 親要素は UIA "ツリー" のすぐ上のレベルにある要素として定義され、ほとんど常に親要素になります。

パラメーター

名前 キー 必須 説明
要素のハンドル
ElementHandle True integer

ターゲット要素の UIA ハンドル。

処理する親の最大件数
MaxParentsToProcess integer

処理する親要素の最大数。 既定では、50 に設定されています。

ワークフロー
Workflow True string

次の式をここに追加します: workflow()

戻り値

名前 パス 説明
UIA 親要素
UIAParentElements array of object

配置されているすべての親要素 (およびそれらのプロパティ) のリスト。 返されるプロパティは、"複数の要素プロパティを取得する" アクションが返すプロパティと同じです。

項目
UIAParentElements object
返される親要素の数
NumberOfParentElementsReturned integer

検索から返される親要素の数。