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