UI オートメーション アクション

重要

不正アクセスを防ぐために、Power Automate では自動化するアプリケーションと同じかそれ以上の権限で実行する必要があります。 UI オートメーション アクション (デスクトップを使用するアクションを除く) を使用して、昇格した特権で実行されるアプリケーションと対話するには、管理者として Power Automate を実行します。 管理者として Power Automate を実行する詳細については、昇格した権利で Power Automate を実行を参照してください。

Power Automate は、ユーザーがウィンドウおよびデスクトップ アプリケーションと対話できるようにするためのさまざまな UI オートメーション アクションを提供します。 一部の UI オートメーション アクションでは、処理する要素を示すために、プロパティに UI 要素を設定する必要があります。

新しい UI 要素を追加する場合は、展開した UI オートメーション アクションまたはフロー デザイナーの UI 要素タブで UI 要素を追加する を選択します。

すべての UI 要素は、コンポーネントの階層構造を正確に示すセレクターで構成されています。 セレクターは、> 表記を使い、各要素がその左側の要素内に含まれていることを示します。

アプリケーション ウィンドウの UI 要素を作成すると、そのセレクターには常に :desktop という名前のルート要素があります。

アプリケーション ウィンドウ内のコンポーネントを特定する UI 要素を作成すると、2 つの UI 要素が自動的に作成されます。 親 UI 要素はアプリケーション ウィンドウを正確に示し、子はウィンドウ内の特定のコンポーネントの階層構造を示します。

UI 要素を追加するとセレクターが自動的に作成されますが、特定のシナリオでは手動でセレクターを作成する必要があります。 カスタム セレクターが必要な場合は、既存のセレクターを編集するか、または最初から作成できます。

より動的なフローを開発する場合は、等しい 演算子を他の演算子や正規表現で置き換えます。 さらに、セレクターの属性の値が前のアクションの結果に依存する場合は、ハード コーディングされた値ではなく変数を使用します。

UI オートメーションの多くのアクションには、アクションを実行するための 2 つのモード (物理モードとシミュレートモード) があります。 物理モードでは、ツールはマシンのマウスとキーボードを制御してアクションを物理的に実行します。 シミュレート モードでは、マウスやキーボードを制御したり、UI要素の画面を最前面に表示したりすることなく、アクションがプログラムによって実行されます。 シミュレートされたオプションはすべての UI 要素に適用できるわけではないことに注意することが重要です。 シミュレーションによってアクションを実行するには、一部のアクションで アクションをシミュレート パラメータを有効にするか、他のアクションのパラメータで 最前面に移動 を無効にします。

注意

UI オートメーション フローの開発とカスタム セレクターの作成の詳細については、デスクトップ フローを自動化する と カスタム セレクターを作成する を参照してください。

ウィンドウの詳細を取得する

ウィンドウのタイトルやソース テキストなどのプロパティを取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
ウィンドウ	いいえ	UI 要素		詳細を取得するウィンドウ
ウィンドウ プロパティ	N/A	ウィンドウ タイトルの取得、ウィンドウ テキストの取得、ウィンドウの場所とサイズの取得、プロセス名の取得	ウィンドウ タイトルを取得する	抽出するウィンドウのプロパティを選択
最前面へ移動する	N/A	ブール値	True	実行中にUI要素を含むウィンドウを最前面に表示するかどうかを指定します。 このオプションが無効になっている場合、アクションはバックグラウンドで実行されます。 すべての UI 要素がこのオプションを無効にすることと互換性があるわけではないことに注意してください。 さらに、アクションの実行にスクロールが必要な場合、このオプションを無効にするとすべての要素が抽出されない可能性があります。

生成される変数

引数	タイプ	Description
WindowProperty	一般の値	取得するウィンドウの情報

例外

例外	内容
ウィンドウのプロパティを取得できません	ウィンドウ プロパティを取得するときに問題が発生したことを示します

ウィンドウにある UI 要素の詳細を取得する

ウィンドウにある UI 要素の属性値を取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		詳細を取得する UI 要素
属性名	はい	テキスト値	独自のテキスト	値を取得する属性
最前面へ移動する	N/A	ブール値	True	実行中にUI要素を含むウィンドウを最前面に表示するかどうかを指定します。 このオプションが無効になっている場合、アクションはバックグラウンドで実行されます。 すべての UI 要素がこのオプションを無効にすることと互換性があるわけではないことに注意してください。 さらに、アクションの実行にスクロールが必要な場合、このオプションを無効にするとすべての要素が抽出されない可能性があります。

生成される変数

引数	タイプ	Description
AttributeValue	Text 値	UI 要素のテキストの値

例外

例外	内容
UI 要素の属性を取得できません	UI 要素の属性の取得中に発生した問題を示します

ウィンドウ内の選択済みチェック ボックスを取得する

チェック ボックス グループ内のオンになったチェック ボックスの名前、または特定のチェック ボックスの状態を取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		チェック ボックスまたはチェック ボックス グループ
操作	N/A	グループ内の選択済みチェック ボックスの名前を取得する、チェック ボックスの状態を取得する	グループ内の選択済みチェック ボックスの名前を取得する	複数のオンになったチェック ボックスの状態を取得するか、1 つのチェック ボックスの状態のみ取得するかを指定
最前面へ移動する	N/A	ブール値	True	実行中に UI 要素を含むウィンドウを最前面に表示するかどうかを指定します。 このオプションが無効になっている場合、アクションはバックグラウンドで実行されます。 すべての UI 要素がこのオプションを無効にすることと互換性があるわけではないことに注意してください。 さらに、アクションの実行にスクロールが必要な場合、このオプションを無効にするとすべての要素が抽出されない可能性があります。

生成される変数

引数	タイプ	Description
IsChecked	ブール値	オンになったチェック ボックスの状態
SelectedCheckboxes	テキスト値のリスト	指定されたチェック ボックス グループ内のオンになったチェック ボックスの名前

例外

例外	内容
チェック ボックスの状態を取得できません	指定したチェック ボックスの状態の取得中に問題が発生したことを示します

ウィンドウ内の選択済みラジオ ボタンを取得する

ラジオ ボタン グループ内のオンになったラジオ ボタンの名前、または特定のラジオ ボタンの状態を取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		ラジオ ボタンまたはラジオ ボタン グループ
操作	N/A	グループにある選択済みラジオ ボタンの名前を取得する、ラジオ ボタンの状態を取得する	グループにある選択済みラジオボタンの名前を取得する	ラジオ ボタン グループで選択済みのラジオ ボタン名を取得するか、1 つのラジオ ボタンの状態のみを取得するかを指定する
最前面へ移動する	N/A	ブール値	True	実行中にUI要素を含むウィンドウを最前面に表示するかどうかを指定します。 このオプションが無効になっている場合、アクションはバックグラウンドで実行されます。 すべての UI 要素がこのオプションを無効にすることと互換性があるわけではないことに注意してください。 さらに、アクションの実行にスクロールが必要な場合、このオプションを無効にするとすべての要素が抽出されない可能性があります。

生成される変数

引数	タイプ	Description
IsSelected	ブール値	オンになったラジオ ボタンの状態
SelectedRadiobutton	テキスト値	指定したラジオ グループ内の選択したラジオ ボタン

例外

例外	内容
ラジオ ボタンの状態を取得できません	指定したラジオ ボタンの状態の取得中に問題が発生したことを示します

ウィンドウからデータを抽出する

単一の値、リスト、またはテーブルの形式で、ウィンドウの特定の部分からデータを抽出します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
ウィンドウ	いいえ	UI 要素		データ抽出元ウィンドウ
抽出したデータの保存場所	N/A	Excel スプレッドシート、変数	Excel スプレッドシート	抽出されたデータの保存場所を指定します
最前面へ移動する	N/A	ブール値	True	実行中にUI要素を含むウィンドウを最前面に表示するかどうかを指定します。 このオプションが無効になっている場合、アクションはバックグラウンドで実行されます。 すべての UI 要素がこのオプションを無効にすることと互換性があるわけではないことに注意してください。 さらに、アクションの実行にスクロールが必要な場合、このオプションを無効にするとすべての要素が抽出されない可能性があります。

生成される変数

引数	タイプ	Description
ExcelInstance	Excel インスタンス	抽出されたデータを含む Excel インスタンスです。 このインスタンスは、専用の Excel アクションを使ってスプレッドシートを操作する (または保存して閉じる) ために使用します。
DataFromWindow	一般の値	datatable の形式の抽出したデータ

例外

例外	内容
抽出に失敗しました	指定されたウィンドウからデータを抽出するときに問題が発生したことを示します

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

ウィンドウ内の UI 要素のスクリーンショットを取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		スクリーンショットとして取得するウィンドウ内の UI 要素
保存モード	N/A	クリップボード、ファイル	クリップボード	画像をファイルに保存するか、クリップボードに保存するかを指定します
Image file path	いいえ	ファイル		保存するファイルのフル パスを設定する
File format	N/A	BMP、EMF、EXIF、GIF、JPG、PNG、TIFF、WMF	BMP	画像ファイルのファイル形式

生成された変数

引数	タイプ	説明設定
ImageFile	ファイル	生成されたスクリーンショットの画像ファイルのパス

例外

例外	内容
UI 要素を取得できません	UI 要素の取得中に発生した問題を示します
画像を保存できません	撮ったスクリーンショットを保存するときに問題が発生したことを示します
UI 要素のスクリーンショットを取得できません	UI 要素のスクリーンショットを取得中に問題が発生したことを示します

ウィンドウ内のテキスト フィールドをフォーカス

ウィンドウのテキスト ボックスにフォーカスを設定し、スクロールして表示します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
テキスト フィールド	いいえ	UI 要素		フォーカスするテキスト ボックス

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウ テキスト ボックスに入力フォーカスを設定できません	指定された Web ページのテキスト フィールドにフォーカスを設定するときに問題が発生したことを示します

ウィンドウ内のテキスト フィールドに入力する

ウィンドウ内のテキスト ボックスに指定されたテキストを入力します。

入力パラメーター

引数	オプション	受入	Default Value	Description
Text box	いいえ	UI 要素		入力するテキスト ボックス
入力するテキスト	いいえ	直接暗号化された入力またはテキスト値		テキスト フィールドに入力するテキスト
アクションをシミュレートする	N/A	ブール値	False	UI テキスト フィールド要素にテキストを入力するときに、プログラムでキーストロークをシミュレートします。 このオプションでは、UI 要素の画面をフォーカスする必要はなく、自動的にフォアグラウンドに表示されません。 このオプションは左クリック アクションにのみ適用でき、すべての UI 要素に適用できるわけではないことに注意してください。
フィールドが空白ではない場合	はい	テキストを置き換える、テキストをアペンドする	テキストを置換する	既存のコンテンツの置換、またはアペンドを指定します。
Click before populating	はい	左クリック、ダブルクリック、いいえ	左クリック	テキスト フィールドに入力する前に、マウスで左クリックするかどうかを指定します。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
テキスト ボックスに書き込めません	指定されたテキスト フィールドへの入力に問題があることを示します

ウィンドウ内のボタンを押す

ウィンドウ ボタンを押します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		押すボタン

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ボタンを押せません	指定されたボタンを押すときに問題が発生したことを示します

ウィンドウのラジオ ボタンをオンにする

ウィンドウのラジオ ボタンを選択します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Radio button	いいえ	UI 要素		選択するためのラジオ ボタン

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ラジオ ボタン UI 要素を選択できません	指定したラジオ ボタン UI 要素の選択中に発生した問題を示します

ウィンドウのチェック ボックスの状態を設定

ウィンドウ フォームのチェック ボックスをオンまたはオフにします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
チェック ボックス	いいえ	UI 要素		状態を設定するチェック ボックス
チェックボックスの状態を以下に設定する	N/A	オン、オフ	選択済みです	チェック ボックスを選択状態にするかどうかを指定します

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
チェック ボックスの状態を設定できません	指定したチェック ボックスの状態の設定中に問題が発生したことを示します

ウィンドウでドロップ ダウン リストの値を設定する

ウィンドウ フォームのドロップダウン リストで選択されているオプションを設定するかクリアします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
ドロップダウン リスト	いいえ	UI 要素		値を設定するドロップダウン リスト
オペレーション	N/A	選択したオプションをクリアし、名前でオプションを選択し、インデックスでオプションを選択する	選択したオプションをクリア	値を名前または順序位置 (1 2 3 ...) で選択するか、ドロップダウン リストの選択された値をクリアするかを指定します
オプション名	いいえ	テキスト値 の リスト		ドロップダウン リストに、選択するオプションまたはオプションのリストを入力します。 複数のオプションは、複数選択リストを操作する場合にのみ意味があります。 リストが単一選択の場合、指定されたリストの最初のオプションのみが使用されます。
正規表現を使用する	N/A	ブール値	False	オプション名の値を正規表現として解釈するかどうかを指定します
オプションのインデックス	いいえ	数値 の リスト		ドロップダウン リストに、選択するインデックスまたはインデックスのリストを入力します。 複数のオプションは、複数選択リストを操作する場合にのみ意味があります。 リストが単一選択の場合、指定されたリストの最初のオプションのみが使用されます。

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
ドロップダウン リストで指定されたオプションを選択できませんでした	ドロップダウン リストで指定されたオプションを選択する際に問題が発生したことを示します

Get window

デスクトップ アプリケーションを自動化するため、実行中のウィンドウを取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Get window	N/A	特定のウィンドウ、前景ウィンドウ	特定のウィンドウ	セレクターまたはフォアグラウンド ウィンドウのどちらを使って検索するかを指定
UI 要素	いいえ	UI 要素		取得するウィンドウのセレクター
ウィンドウを前面に表示する	N/A	ブール値	無効	取得したときにウィンドウを自動的にフォアグラウンドに表示するかどうかを指定
Fail if window isn't found	N/A	ブール値	有効	ウィンドウが表示されるまで無期限に待機するか、設定した時間内にウィンドウが表示されない場合は失敗するかを指定する
Timeout	いいえ	数値		タイムアウトまでの待機秒数

生成された変数

引数	タイプ	説明設定
WindowTitle	Text 値	フォアグラウンド ウィンドウのタイトル
AutomationWindow	ウィンドウ インスタンス	後で UI オートメーション アクションを実行するときに使う特定のウィンドウ インスタンス

例外

例外	内容
ウィンドウを取得できません	ウィンドウを取得するときに問題が発生したことを示します

ウィンドウにフォーカスする

特定のウィンドウをアクティブ化してフォアグラウンドに表示します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		フォーカスするウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウにフォーカスできません	指定されたウィンドウをフォーカスするときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウの状態の設定

特定のウィンドウを復元、最大化、または最小化します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		状態を設定するウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。
Window state	N/A	復元、最大化、最小化	復旧済み	ウィンドウを表示する状態を選択する

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウの状態を設定できません	指定されたウィンドウのウィンドウ状態を設定しているときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウの表示方法を設定する

非表示のウィンドウを表示するか、表示されているウィンドウを非表示にします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		表示方法を設定するウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。
Visibility	N/A	表示、非表示	非表示	ウィンドウの表示方法を設定する状態を選択

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウの表示方法を設定できません	指定されたウィンドウの表示方法を設定しているときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウの移動

特定のウィンドウの位置を設定します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		移動するウィンドウのインスタンスまたはハンドルです。
Window class	はい	テキスト値		同じタイトルを持つ 2 つのウィンドウがある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。
Position X	いいえ	数値		ウィンドウの X 位置
Position Y	いいえ	数値		ウィンドウの Y 位置

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウを移動できません	指定されたウィンドウを移動するときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウのサイズ変更

特定のウィンドウのサイズを設定します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		サイズ変更するウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します
Width	いいえ	数値		新しい幅 (ピクセル単位)
身長	いいえ	数値		新しい高さ (ピクセル単位)

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウをサイズ変更できません	指定されたウィンドウをサイズ変更するときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウを閉じる

特定のウィンドウを閉じます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window mode	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ タイトル	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
Window instance	いいえ	数値		閉じるウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウが見つかりません	指定したウィンドウが見つからなかったことを示します
ウィンドウを閉じることができません	指定されたウィンドウを閉じるときに問題が発生したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します

ウィンドウが次を含む場合

特定のテキストまたは UI 要素がウィンドウに存在するかどうかに応じて、条件付きアクション ブロックの開始位置をマークします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Check if window	N/A	UI 要素を含む、UI 要素を含まない、テキストを含む、テキストを含まない	UI 要素を含む	ウィンドウ内に特定のテキストまたは UI 要素が存在するかどうかを確認する
Check UI element state	N/A	ブール値	無効	特定の UI 要素が有効か無効かを確認する
テキスト	いいえ	テキスト値		確認するテキスト
UI 要素	いいえ	UI 要素		確認する UI 要素
ウィンドウ	いいえ	UI 要素		テキストが存在するかどうかを確認するウィンドウ
状態	N/A	有効、無効	有効化	確認する UI 要素の状態

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

ウィンドウ コンテンツを待機する

特定のテキストまたは UI 要素がウィンドウに表示されたり消えたりするまで、オートメーションの実行を中断します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Wait until window	N/A	UI 要素を含む、UI 要素を含まない、テキストを含む、テキストを含まない	UI 要素を含む	特定のテキストまたは UI 要素がウィンドウに表示されるまで待機するかどうか
Check UI element state	N/A	ブール値	無効	特定の UI 要素が有効か無効かを確認する
テキスト	いいえ	テキスト値		確認するテキスト
UI 要素	いいえ	UI 要素		確認する UI 要素
ウィンドウ	いいえ	UI 要素		テキストが存在するかどうかを確認するウィンドウ
状態	N/A	有効、無効	有効化	確認する UI 要素の状態

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウ コンテンツの待機に失敗しました	待機操作に失敗したことを示します

イメージが次の場合

このアクションは選択した画像が画面上に存在するかどうかに応じて、条件付きアクション ブロックの開始位置を示します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
If image	N/A	存在する、存在しない	存在します	選択した画像の有無をチェックするかどうか
画像	いいえ	画像のリスト		アクションが存在するかどうかを確認する画像
画像の検索先	N/A	スクリーン全体、前景ウィンドウのみ	画面全体	指定されたイメージを最前面のウィンドウのみで探すか、表示されている画面全体で探すか。 どちらの選択肢を選んだ場合であっても、スクリーンにはっきりと表示されていない場合は、画像を見つけることはできません
Search mode	N/A	スクリーン全体、または前景ウィンドウの検索、スクリーンまたは前景ウィンドウの指定されたサブ領域の検索	画面全体またはフォアグラウンド ウィンドウを検索します	画面 (またはウィンドウ) 全体をスキャンして指定されたテキストを検索するか、またはそのサブ領域のみを検索するかを指定します
Find all images in the list	N/A	ブール値	無効	リスト上の画像がすべて存在するかどうかを確認する
X1	はい	数値		指定されたテキストをスキャンするサブ領域の開始 X 座標
X2	はい	数値		指定されたテキストをスキャンするサブ領域の終了 X 座標
Y1	はい	数値		指定されたテキストをスキャンするサブ領域の開始 Y 座標
Y2	はい	数値		指定されたテキストをスキャンするサブ領域の終了 Y 座標
Tolerance	はい	数値	10	最初に選択した画像に一致するまで、何回検索を繰り返すかを指定します
画像照合アルゴリズム	N/A	基本、上級	基本	画像を検索するときに使用する画像のアルゴリズムです

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
非インタラクティブ モードでは画像をチェックできません	非インタラクティブ モードでは画像を識別できないことを示します
無効なサブ領域座標	指定されたサブ領域の座標が無効であることを示します

デスクトップを使用する

デスクトップとタスク バー関連の操作を実行します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		クリックする対象の UI 要素
クリックのタイプ	N/A	左クリック、右クリック、ダブル クリック	左クリック	実行するクリックの種類
Launch new application when left-clicking on the taskbar	N/A	ブール値	有効	このパラメーターが 'True' に設定されている場合、'クイック起動' バー (Windows 7 以上のタスク バー) のアイコンを左クリックすると、アプリケーションの新しいウィンドウが必ず作成されます。 このオプションのチェックを外すと、実行中のアプリケーションのインスタンスがフォアグラウンドになります。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
タスク バー操作に失敗しました	タスク バーの操作に失敗したことを示します

ウィンドウでタブを選択する

タブのグループからタブを選択します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Tab キー	いいえ	UI 要素		選択するタブ

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
タブの選択に失敗しました	指定されたタブの選択中に問題が発生したことを示します

イメージを待機

このアクションは、特定の画像が画面またはフォアグラウンド ウィンドウに表示されるまで待機します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Wait for image to	N/A	表示、非表示	表示される	画像が表示されるか消えるまで待機するかどうかを確認する
待機する対象の画像	いいえ	画像のリスト		アクションが存在するかどうかを確認する画像
画像の検索先	N/A	スクリーン全体、前景ウィンドウのみ	画面全体	指定されたイメージを最前面のウィンドウのみで探すか、表示されている画面全体で探すか。 どちらの選択肢を選んだ場合であっても、スクリーンにはっきりと表示されていない場合は、画像を見つけることはできません
Search mode	N/A	スクリーン全体、または前景ウィンドウの検索、スクリーンまたは前景ウィンドウの指定されたサブ領域の検索	画面全体またはフォアグラウンド ウィンドウを検索します	画面 (またはウィンドウ) 全体をスキャンして指定されたテキストを検索するか、またはそのサブ領域のみを検索するかを指定します
Wait for all images	N/A	ブール値	無効	リスト上のすべての画像 (またはいずれかの画像) が表示される (消える) まで待機するかどうかを指定する
X1	はい	数値		指定されたテキストをスキャンするサブ領域の開始 X 座標
X2	はい	数値		指定されたテキストをスキャンするサブ領域の終了 X 座標
Y1	はい	数値		指定されたテキストをスキャンするサブ領域の開始 Y 座標
Y2	はい	数値		指定されたテキストをスキャンするサブ領域の終了 Y 座標
Tolerance	はい	数値	10	最初に選択した画像に一致するまで、何回検索を繰り返すかを指定します
画像照合アルゴリズム	N/A	基本、上級	基本	画像を検索するときに使用する画像のアルゴリズムです
タイムアウト エラーで失敗しました	N/A	ブール値	False	アクションを無期限に待機するか、設定した期間後にエラーにするかを指定します

生成された変数

引数	タイプ	説明設定
X	数値	画面上でテキストが見つかったポイントの X 座標。 テキストがフォアグラウンド ウィンドウで検索された場合、この値はウィンドウの左上隅からの相対位置です。
年	数値	画面上でテキストが見つかったポイントの Y 座標。 テキストがフォアグラウンド ウィンドウで検索された場合、この値はウィンドウの左上隅からの相対位置です。

例外

例外	内容
画像の待機に失敗しました	待機操作に失敗したことを示します
非インタラクティブ モードでは画像をチェックできません	非インタラクティブ モードでは画像を識別できないことを示します
無効なサブ領域座標	指定されたサブ領域の座標が無効であることを示します

ウィンドウの UI 要素の上にマウス ポインターを移動する

ウィンドウで任意の UI 要素の上にマウス ポインターを移動します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		ウィンドウ内でホバーする UI 要素を選択する

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
要素をホバーできませんでした	要素へのポイントが失敗したことを示します

ウィンドウの UI 要素をクリックする

ウィンドウの任意の UI 要素をクリックします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		クリックする UI 要素
クリックのタイプ	N/A	左クリック、右クリック、ダブル クリック、中クリック、左ボタンを押す、左ボタンを離す、右ボタンを押す、右ボタンを離す	左クリック	実行するクリックの種類
アクションをシミュレートする	N/A	ブール値	False	クリックする前に要素上でマウスのカーソルの移動をシミュレートするかどうかを指定します。 このオプションでは、UI 要素の画面をフォーカスする必要はなく、自動的にフォアグラウンドに表示されません。 このオプションは左クリック アクションにのみ適用でき、すべての UI 要素に適用できるわけではないことに注意してください。
Mouse position relative to UI element	N/A	左上隅、中央上部、右上隅、左中央、中央、右中央、左下隅、中央下、右下隅	中段中央	クリックする前にマウスの移動先の UI 要素のセクションを指定する
Offset X	はい	テキスト値	0	マウスの位置を右にオフセットするピクセル数
Offset Y	はい	テキスト値	0	マウスの位置を下にオフセットするピクセル数

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
クリックに失敗しました	クリックに失敗したことを示します

ウィンドウ内のメニュー オプションを選択する

ウィンドウのメニューのオプションを選択します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		選択するメニュー オプション

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
オプションを選択できませんでした	指定されたメニュー オプションの選択中に問題が発生したことを示します

UI 要素をウィンドウ内にドラッグ アンド ドロップ

ウィンドウの UI 要素をドラッグ アンド ドロップします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
ドラッグする UI 要素	いいえ	UI 要素		ドラッグする UI 要素
ドロップ先の UI 要素	いいえ	UI 要素		ドロップ先の UI 要素
クリックのタイプ	N/A	左クリック、右クリック	左クリック	UI 要素を目的の場所までドラックする際に、クリックして押したままにするマウス ボタンを指定する
Mouse down offset X	はい	テキスト値	0	ドラッグする UI 要素の指定に使用するマウス ダウン クリックを、このピクセル数右にオフセットする
Mouse down offset Y	はい	テキスト値	0	ドラッグする UI 要素の指定に使用するマウス ダウン クリックを、このピクセル数下にオフセットする
Mouse down position relative to drag-target UI element	N/A	左上隅、中央上部、右上隅、左中央、中央、右中央、左下隅、中央下、右下隅	中段中央	クリックする前にマウスでドロップする、UI 要素のセクションを指定します
Mouse up offset X	はい	テキスト値	0	ドラッグする UI 要素の指定に使用するマウス アップ クリックを、このピクセル数右にオフセットする
Mouse up offset Y	はい	テキスト値	0	ドラッグする UI 要素の指定に使用するマウス アップ クリックを、このピクセル数下にオフセットする
Mouse up position relative to drop-target UI element	N/A	左上隅、中央上部、右上隅、左中央、中央、右中央、左下隅、中央下、右下隅	中段中央	クリックした後にマウスでドラッグする、UI 要素のセクションを指定します

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ドラッグする UI 要素が見つかりません	ドラッグする UI 要素が見つからなかったことを示します
ドロップ ターゲット UI 要素が見つかりません	ドロップ ターゲット UI 要素が見つからなかったことを示します
ドラッグ アンド ドロップに失敗しました	指定した UI 要素のドラッグ アンド ドロップ中に発生した問題を示します

ウィンドウ内のツリー ノードを展開/折りたたむ

ウィンドウ内にあるツリー ビューのノードを展開するか折りたたみます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
UI 要素	いいえ	UI 要素		展開/折りたたむツリー ノード
フォルダー パス	はい	テキスト値		展開するか折りたたむツリー ノードに導く、フォルダー名で構成されるスラッシュ区切りのパス
Use regular expressions	N/A	ブール値	無効	パス内の各フォルダー名を正規表現として解釈するかどうかを指定する
Operation	N/A	展開/折りたたむ	Expand	ツリー ノードを展開するか折りたたむかを指定します

Note

Power Automate の正規表現エンジンは .NET です。 正規表現に関する詳細については、正規表現言語 - クイック リファレンス を参照してください。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ツリー ノードを指定された状態に設定できません	ツリー ノードを指定された状態に設定しているときに問題が発生したことを示します

ウィンドウが次の場合

このアクションは、ウィンドウが開いているかどうか、またはフォーカスのある (フォアグラウンド) ウィンドウであるかどうかに応じて、条件付きアクション ブロックの開始位置を示します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Get window	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
Window title	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ インスタンス	いいえ	数値		確認するウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します。
Check if window	N/A	オープンしている、オープンしていない、フォーカスされている、フォーカスされていない	開いている	確認するウィンドウの状態

生成された変数

このアクションは変数を生成しません。

例外

このアクションには例外は含まれません。

ウィンドウを待機する

特定のウィンドウが開くか、閉じるか、フォーカスを取得または失うまで、実行またはプロセスを中断します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Find window	N/A	ウィンドウの UI 要素ごと、ウィンドウ インスタンス/ハンドルごと、タイトル/クラスごと	ウィンドウの UI 要素ごと	ウィンドウの検索に UI 要素を使用するか、ウィンドウのタイトル/クラスの組み合わせを使用するかを指定する
Window title	はい	テキスト値		ウィンドウ タイトル。 '?' や '*' のワイルドカードを使用できます。
ウィンドウ	いいえ	UI 要素		ウィンドウ UI 要素
ウィンドウ インスタンス	いいえ	数値		確認するウィンドウのインスタンスまたはハンドル
Window class	はい	テキスト値		同じタイトルのウィンドウが 2 つある場合、ウィンドウ クラスがその区別に役立つことがあります。 この場合、使用するウィンドウのクラスを入力します
Wait for window to	N/A	開く、閉じる、フォーカスする、フォーカスを失う	未完了	特定のウィンドウが開く、閉じる、フォーカスされる (つまり、フォアグラウンド ウィンドウになる)、またはフォーカスを失う (フォアグラウンド ウィンドウでなくなる) まで待機するかどうか。
Focus window after it opens	N/A	ブール値	無効	ウィンドウが開いたらそのウィンドウを前面に表示し、以降のアクションでこのウィンドウを操作する

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ウィンドウにフォーカスできません	指定されたウィンドウをフォーカスするときに問題が発生したことを示します
ウィンドウを待機できませんでした	待機操作に失敗したことを示します
非インタラクティブ モードでウィンドウ関連のアクションを実行できません	非インタラクティブ モードでウィンドウに関連するアクションを実行しているときに問題が発生したことを示します