ブラウザー自動化アクション
ブラウザーの自動化アクションを使用すると、ユーザーは UI 要素を介して Web アプリケーションとコンポーネントと対話できます。 Web UI 要素は Web 要素とも呼ばれ、アクションが処理する Web コンポーネントを一意に記述します。
Web オートメーションを実行するには、まず新しいブラウザ インスタンスを作成する必要があります。 Microsoft Edge、Google Chrome、Mozilla Firefox、Internet Explorer をサポートするブラウザー起動アクションを使うことで実現できます、 ブラウザー起動アクションを使用すると、Web ページをローカル デスクトップで起動するか、仮想デスクトップ環境で起動するかを指定することもできます。
注意
仮想デスクトップでブラウザを起動するには、まずそのデスクトップ内の少なくとも 1 つの UI 要素をキャプチャします。 この要素は、フローの UI 要素リポジトリで使用可能である必要があります。
新しい UI 要素を追加するには、展開されたブラウザー自動化アクションから UI 要素の追加 を選択するか、またはフロー デザイナーの UI 要素タブを選択します。
web に関連するすべての UI 要素は、ページ上のコンポーネントの階層構造を特定する 1 つ以上の CSS セレクタ (web セレクタ) によって指定されます。 セレクターは、> 表記を使い、各要素がその左側の要素内に含まれていることを示します。
Web セレクタは UI 要素を追加するときに自動的に作成されますが、特定のシナリオでは手動でセレクタを作成する必要があります。 カスタムの web セレクタが必要な場合は、既存のセレクタを編集するか、ゼロからセレクタを作成します。
より動的な Web フローを開発するには、Equals to 演算子を他の演算子または正規表現に置換します。 さらに、web セレクタの属性の値が以前のアクションの結果に依存する場合は、ハードコードされた値の代わりに変数を使用してください。
Note
web エレメントの web フローの開発とカスタム web セレクタの作成に関する詳細は、web フローの自動化 と カスタム セレクタの作成 を参照してください。
Web ページからデータを抽出する
単一の値、リスト、行またはテーブルの形式で、Web ページの特定の部分からデータを抽出します。
このアクションの使用方法の詳細については、Web データの抽出を参照してください。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | Web ページ上でデータを抽出する UI 要素を選択します | |
抽出パラメーター | いいえ | Datatable | データを抽出するときに使用するパラメーターです。 抽出モードに応じて、このパラメーターは異なるデータを受け入れます。 | |
Max web pages to process | いいえ | 数値 | 処理する Web ページの最大数 | |
次のページの物理クリックを送信 | N/A | ブール値 | False | クリックする前にマウスのカーソルを物理的にページの上に移動するかを指定する。 エミュレートされたページへのクリックが、要素に対して意図的なアクションを実行しない場合は、物理クリックが必要です。 このオプションでは、ブラウザー ウィンドウをフォーカスする必要があるため、自動的に前面に表示されます。 |
ぺージ CSS セレクター | いいえ | Text 値 | ページ CSS セレクター | |
Extraction mode | N/A | 未定義、単一値、厳選された値、リスト、テーブル、HTML テーブル全体 | 単一の値 | Web ページから抽出する対象を指定します |
Use paging | N/A | ブール値 | 無効 | ページングを使用するかどうかを指定します |
Get all web pages | N/A | ブール値 | False | すべての Web ページを取得するかどうかを指定します |
抽出時にデータを処理する | N/A | ブール値 | False | 抽出されたデータを処理して、Web ページに表示されているとおりに表示するかどうかを指定します。 抽出されたデータの処理には、iframe にネストされた情報の表示と、非表示または表示の要素によるフィルター処理が含まれます。 大規模なデータセットの場合、このオプションを有効にすると抽出時間が長くなるため、お勧めしません。 |
タイムアウト | はい | 数値 | 60 | 抽出の完了を待機する時間 (秒) を設定します。この時間内に完了しなければ、アクションは失敗します |
データ保存モード | N/A | 変数、Excel スプレッドシート | 変数 | 抽出されたデータを、変数に保存するか、Excel スプレッドシートに保存するかを指定します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
ExcelInstance | Excel インスタンス | 抽出されたデータを含む Excel インスタンスです。 このインスタンスは、専用の Excel アクションを使ってスプレッドシートを操作する (または保存して閉じる) ために使用します。 |
DataFromWebPage | Datatable | 単一の値、リスト、データ行、またはデータ テーブルの形式で抽出されたデータです。 |
例外
例外 | 説明 |
---|---|
データを抽出できませんでした | データの抽出で問題が発生したことを示します |
Excel インスタンスを起動できませんでした | Excel インスタンスを起動するときに問題が発生したことを示します |
Excel に値を書き込めませんでした | Excel に値を書き込むときに問題が発生したことを示します |
Web ページ上の詳細を取得する
Web ページのタイトルやソース テキストなどのプロパティを取得します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
Get | N/A | Web ページの説明、Web ページのメタキーワード、Web ページのタイトル、Web ページのテキスト、Web ページのソース、Web ブラウザの現在の URL アドレス | Web ページの説明 | Web ページから取得する情報を選択します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
WebPageProperty | Text 値 | Web ページから取得された詳細 |
例外
例外 | 内容 |
---|---|
Web ページの詳細を取得できませんでした | 指定された Web ページの詳細の取得で問題が発生したことを示します |
Web ページ上の要素の詳細を取得する
Web ページ上の要素の属性値を取得します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | Web ページ上で詳細を取得する UI 要素を選択します | |
属性名 | いいえ | テキスト値 | 独自のテキスト | 値を取得する属性を入力または選択します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
AttributeValue | Text 値 | Web 要素の属性値 |
例外
例外 | 内容 |
---|---|
Web ページの UI 要素の属性を取得できませんでした | Web ページの要素の属性の取得で問題が発生したことを示します |
Web ページのスクリーンショットを取得します
現在ブラウザーに表示されている Web ページ (または Web ページの要素) のスクリーンショットを取得し、その画像をファイルまたはクリップボードに保存します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
Capture | N/A | Web ページ全体、特定の要素 | Web ページ全体 | Web ページ全体をキャプチャするか、Web ページの特定の要素のみをキャプチャするかを指定します |
UI 要素 | いいえ | UI 要素 | キャプチャする Web ページの UI 要素を選択します | |
保存モード | N/A | クリップボード、ファイル | クリップボード | 画像をファイルに保存するか、クリップボードに保存するかを指定します |
Image file | いいえ | ファイル | 画像のキャプチャを保存するファイルのフル パスを設定します | |
File format | N/A | BMP、EMF、EXIF、GIF、JPG、PNG、TIFF、WMF | BMP | 画像ファイルの形式を選択します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
ファイルを保存できませんでした | 指定されたファイルの保存で問題が発生したことを示します |
クリップボードに保存できませんでした | クリップボードへの保存で問題が発生したことを示します |
スクリーンショットを取得できませんでした。 | スクリーンショットの取得で問題が発生したことを示します |
Web ページ上のテキスト フィールドをフォーカス
Web ページの入力要素にフォーカスを設定し、スクロールして表示します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | フォーカスする Web ページ上の UI 要素を選択します | |
ページが読み込まれるまで待機 | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
Web ページのテキスト フィールドに入力フォーカスを設定できませんでした | 指定された Web ページのテキスト フィールドに入力フォーカスを設定するときに問題が発生したことを示します |
Web ページ内のテキスト フィールドに入力する
Web ページ内のテキスト フィールドに、指定されたテキストを入力します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | 入力するテキスト フィールドを選択します | |
テキスト | いいえ | 直接暗号化された入力またはテキスト値 | テキスト フィールドに入力するテキストを入力します | |
フィールドが空白ではない場合 | はい | テキストを置き換える、テキストをアペンドする | テキストを置換する | 既存のコンテンツの置換、またはアペンドを指定します。 |
物理的にキー入力を行ってテキストを入力する | N/A | ブール値 | False | UI テキスト フィールド要素にテキストを入力するときに、物理的なキー ストロークを使用してエミュレートします。 エミュレートされたテキスト入力が要素で意図的にアクションを実行しない場合は、物理的なキー ストロークが必要です。 このオプションでは、ブラウザー ウィンドウをフォーカスする必要があるため、自動的に前面に表示されます。 |
Emulate typing | N/A | ブール値 | True | テキスト フィールドへの入力を、テキスト ボックスの値を設定して一度に行うか、またはユーザーの入力をエミュレートして一文字ずつ送信するかを指定します。 後者の方法は処理が低速ですが、一部の複雑な Web ページでは必要になります。 |
Unfocus text box after filling it | N/A | ブール値 | 無効 | このアクションで指定したテキストでテキスト ボックスを塗りつぶした直後に、テキスト ボックスのフォーカスを外すかどうかを選択します。 自動補完リストをスクレイピングする場合は、このパラメータを False に設定します。 |
ページが読み込まれるまで待機 | N/A | ブール値 | True | テキスト フィールドに入力した後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | テキスト フィールドに入力した後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
テキスト フィールドに書き込めませんでした | 指定されたテキスト フィールドへの書き込みで問題が発生したことを示します |
Web ページのチェック ボックスの状態を設定する
Web フォームのチェック ボックスをオンまたはオフにします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | 状態を設定するチェック ボックスを選択します | |
チェック ボックスの状態 | N/A | オン、オフ | チェック済み | チェック ボックスの状態を選択します |
Wait for page to load | N/A | ブール値 | 有効 | チェック ボックスの状態を設定した後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | チェック ボックスの状態を設定した後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
チェック ボックスの状態を設定できませんでした | 指定されたチェック ボックスの状態の設定で問題が発生したことを示します |
Web ページのラジオ ボタンを選択する
Web ページのラジオ ボタンを選択します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | 選択するためのラジオ ボタン | |
ページが読み込まれるまで待機 | N/A | ブール値 | 有効 | ラジオ ボタンを選択した後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | ラジオ ボタンを選択した後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタン |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
ラジオ ボタンを選択できませんでした | 指定したラジオ ボタンの選択で問題が発生したことを示します |
Web ページでドロップ ダウン リストの値を設定する
Web フォームのドロップダウン リストで選択されているオプションを設定またはクリアします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | 値を設定するドロップダウン リストを選択する | |
操作 | N/A | すべてのオプションをクリアし、名前でオプションを選択し、インデックスでオプションを選択する | すべてのオプションをクリア | ドロップダウン リストで、値を選択するか、選択された値をクリアするかを選択します |
オプション名 | いいえ | テキスト値 の リスト | ドロップダウン リストに、選択するオプションまたはオプションのリストを入力します。 複数のオプションは、複数選択リストを操作する場合にのみ意味があります。 リストが単一選択の場合、指定されたリストの最初のオプションのみが使用されます。 | |
正規表現を使用する | N/A | ブール値 | False | オプション名の値を正規表現として解釈するかどうかを指定します |
オプション インデックス | いいえ | 数値 の リスト | ドロップダウン リストに、選択するインデックスまたはインデックスのリストを入力します。 複数のオプションは、複数選択リストを操作する場合にのみ意味があります。 リストが単一選択の場合、指定されたリストの最初のオプションのみが使用されます。 | |
ページが読み込まれるまで待機 | 該当なし | ブール値 | True | ドロップダウン リストの値を設定した後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページ読み込みのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | ドロップダウン リストの値を設定した後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
選択されたオプションを設定できませんでした | ドロップ ダウン リストで選択されたオプションを設定する際に問題が発生したことを示します |
Web ページのボタンを押す
Web ページのボタンを押します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | 押すボタンを選択します | |
ページが読み込まれるまで待機 | N/A | ブール値 | 有効 | ボタンを押した後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | ボタンを押した後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
Web ページのボタンをクリックできませんでした | 指定された Web ページのボタンのクリックで問題が発生したことを示します |
Web ページが次を含む場合
特定のテキストまたは要素が Web ページに存在するかどうかに応じて、条件付きアクション ブロックの開始位置をマークします
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
Check if web page | N/A | 要素を含む、要素を含まない、テキストを含む、テキストを含まない | 要素を含む | Web ページ内に特定のテキストまたは Web ページ要素が存在するかどうかを確認します |
UI 要素 | いいえ | UI 要素 | 確認する Web ページの UI 要素を選択します | |
テキスト | いいえ | Text 値 | Web ページ上で確認するテキストを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
ブラウザーとの通信が失敗しました | ブラウザーでエラーが発生したことを示します |
Web ページのコンテンツを待機する
特定のテキストまたは Web ページの要素が Web ページに表示されるまで (または非表示になるまで) フローを中断します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
Wait for web page to | N/A | 要素を含む、要素を含まない、テキストを含む、テキストを含まない | 次の要素を含む | web ページで特定のテキストや web ページ要素が表示されたり消えたりするのを待つかどうかを指定します |
UI 要素 | いいえ | UI 要素 | 確認する Web ページの UI 要素を選択します | |
テキスト | いいえ | Text 値 | Web ページ上で確認するテキストを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明 |
---|---|
Web ページのコンテンツの待機に失敗しました | 待機操作に失敗したことを示します |
新しい Internet Explorer を起動します
Web サイトと Web アプリケーションを自動化のため、新しいインスタンスを起動するか、Internet Explorer の実行中のインスタンスに接続します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Launch mode | N/A | 自動化ブラウザを起動し、新たな Internet Explorer を起動する、Internet Explorer の実行にアタッチする | オートメーション ブラウザーを起動します | オートメーション ブラウザーを起動するか、Internet Explorer の新しいインスタンスを起動するか、既存のインスタンスに接続するかを指定します |
Attach to Internet Explorer tab | N/A | タイトルごと、URL ごと、前景ウィンドウを使用する | タイトルを使用 | タイトルまたは URL を使用して Internet Explorer タブに接続するか、フォアグラウンド ウィンドウとして実行されている Internet Explorer のアクティブなタブに接続するかを指定します |
Initial URL | いいえ | テキスト値 | Web ブラウザーが起動されたときにアクセスする Web サイトの URL を入力します | |
Tab title | いいえ | テキスト値 | 接続先の Internet Explorer タブのタイトル (またはその一部) を入力します | |
Tab URL | いいえ | テキスト値 | 接続先の Internet Explorer タブの URL (またはその一部) を入力します | |
Window state | N/A | 通常、最大化、最小化 | 普通 | ブラウザー ウィンドウを、標準、最小化、最大化のどの状態で起動するかを指定します |
ターゲットのデスクトップ | N/A | ローカルコンピュータ、現在接続されているか、少なくとも 1 つの UI 要素がキャプチャされている仮想デスクトップ | ローカル コンピューター | ブラウザが起動するターゲット デスクトップの接続文字列の設定 |
Clear cache | N/A | ブール値 | False | Web ブラウザーの起動直後に、キャッシュ全体をクリアするかどうかを指定します |
Clear cookies | N/A | ブール値 | 無効 | Web ブラウザーの起動直後に、保存されたすべての Cookie をクリアするかどうかを指定します |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | 初期 Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
Custom user agent string | はい | テキスト値 | ランタイム web ヘルパーのカスタム ユーザー エージェントの文字列を指定します。 このフィールドが空のままの場合、ランタイム web ヘルパーは既定でコンピューターにインストールされている Internet Explorer のユーザーエー ジェント文字列を使用します。 |
Note
キャッシュをクリア と Cookie をクリア オプションは、インターネット オプション メニューで 保護モードでの実行 が無効になっている場合にのみ、意図したとおりに機能します。
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
InternetExplorer | Web browser instance | ブラウザーの自動化アクションで使用する Internet Explorer インスタンス |
例外
例外 | 説明 |
---|---|
Internet Explorer を起動できませんでした | Internet Explorer の起動で問題が発生したことを示します |
無効な URL | 指定された URL が無効であったことを示します |
新しい Firefox を起動する
Web サイトと Web アプリケーションを自動化のため、新しいインスタンスを起動するか、Firefox の実行中のインスタンスに接続します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Launch mode | N/A | 新しいインスタンスを起動する、実行中のインスタンスにアタッチする | 新しいインスタンスを起動する | Firefox の新しいインスタンスを起動するか、既存のインスタンスに接続するかを指定します |
Attach to Firefox tab | N/A | タイトルごと、URL ごと、前景ウィンドウを使用する | タイトルを使用 | タイトルまたは URL を使用して Firefox タブに接続するか、フォアグラウンド ウィンドウとして実行されている Firefox のアクティブなタブに接続するかを指定します |
Initial URL | いいえ | テキスト値 | Web ブラウザーが起動されたときにアクセスする Web サイトの URL を入力します | |
Tab title | いいえ | テキスト値 | 接続先の Firefox タブのタイトル (またはその一部) を入力します | |
Tab URL | いいえ | テキスト値 | 接続先の Firefox タブの URL (またはその一部) を入力します | |
Window state | N/A | 通常、最大化、最小化 | 普通 | ブラウザー ウィンドウを、標準、最小化、最大化のどの状態で起動するかを指定します |
ターゲットのデスクトップ | N/A | ローカルコンピュータ、現在接続されているか、少なくとも 1 つの UI 要素がキャプチャされている仮想デスクトップ | ローカル コンピューター | ブラウザが起動するターゲット デスクトップの接続文字列の設定 |
Clear cache | N/A | ブール値 | False | Web ブラウザーの起動直後に、キャッシュ全体をクリアするかどうかを指定します |
Clear cookies | N/A | ブール値 | 無効 | Web ブラウザーの起動直後に、保存されたすべての Cookie をクリアするかどうかを指定します |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | 初期 Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
Timeout | いいえ | 数値 | 60 | ブラウザーの起動を待機する時間 (秒) を設定します。この時間内に起動しなければ、アクションは失敗します |
ユーザー データ フォルダー | N/A | Picture-in-Picture のデフォルト、ブラウザー デフォルト、カスタム | Picture-in-Picture のデフォルト | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーを指定します。 ブラウザー デフォルトが選択されている場合、ブラウザーをデスクトップと Picture-in-Picture の両方で同時に開くことはできません。 詳細 |
ユーザー データ フォルダー パス | いいえ | フォルダー | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーのパスを指定します。 詳細 |
生成される変数
引数 | タイプ | 説明 |
---|---|---|
ブラウザー | Web browser instance | ブラウザーの自動化アクションで使用する Firefox インスタンス |
例外
例外 | 説明 |
---|---|
Firefox を起動できませんでした | Firefox の起動で問題が発生したことを示します |
無効な URL | 指定された URL が無効であったことを示します |
新しい Chrome を起動する
Web サイトと Web アプリケーションを自動化するため、新しいインスタンスを起動するか、Chrome の実行中のインスタンスに接続します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Launch mode | N/A | 新しいインスタンスを起動する、実行中のインスタンスにアタッチする | 新しいインスタンスを起動する | Chrome の新しいインスタンスを起動するか、既存のインスタンスに接続するかを指定します |
Attach to Chrome tab | N/A | タイトルごと、URL ごと、前景ウィンドウを使用する | タイトルを使用 | タイトルまたは URL を使用して Chrome タブに接続するか、フォアグラウンド ウィンドウとして実行されている Chrome のアクティブなタブに接続するかを指定します |
Initial URL | いいえ | テキスト値 | Web ブラウザーが起動されたときにアクセスする Web サイトの URL を入力します | |
Tab title | いいえ | テキスト値 | 接続先の Chrome タブのタイトル (またはその一部) を入力します | |
Tab URL | いいえ | テキスト値 | 接続先の Chrome タブの URL (またはその一部) を入力します | |
Window state | N/A | 通常、最大化、最小化 | 普通 | ブラウザー ウィンドウを、標準、最小化、最大化のどの状態で起動するかを指定します |
ターゲットのデスクトップ | N/A | ローカルコンピュータ、現在接続されているか、少なくとも 1 つの UI 要素がキャプチャされている仮想デスクトップ | ローカル コンピューター | ブラウザが起動するターゲット デスクトップの接続文字列の設定 |
Clear cache | N/A | ブール値 | False | Web ブラウザーの起動直後に、キャッシュ全体をクリアするかどうかを指定します |
Clear cookies | N/A | ブール値 | 無効 | Web ブラウザーの起動直後に、保存されたすべての Cookie をクリアするかどうかを指定します |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | 初期 Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
Timeout | いいえ | 数値 | 60 | アクションが失敗する前に、ブラウザーが開くのを待つ時間を秒単位で設定します |
ユーザー データ フォルダー | N/A | Picture-in-Picture のデフォルト、ブラウザー デフォルト、カスタム | Picture-in-Picture のデフォルト | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーを指定します。 ブラウザー デフォルトが選択されている場合、ブラウザーをデスクトップと Picture-in-Picture の両方で同時に開くことはできません。 詳細 |
ユーザー データ フォルダー パス | いいえ | フォルダー | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーのパスを指定します。 詳細 |
生成される変数
引数 | タイプ | 説明 |
---|---|---|
ブラウザー | Web browser instance | ブラウザーの自動化アクションで使用する Chrome インスタンス |
例外
例外 | 説明 |
---|---|
Chrome を起動できませんでした | Chrome の起動で問題が発生したことを示します |
無効な URL | 指定された URL が無効であったことを示します |
新しい Microsoft Edge を起動する
Web サイトと Web アプリケーションを自動化のため、新しいインスタンスを起動するか、Microsoft Edge の実行中のインスタンスに接続します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Launch mode | N/A | 新しいインスタンスを起動する、実行中のインスタンスにアタッチする | 新しいインスタンスを起動する | Microsoft Edge の新しいインスタンスを起動するか、既存のインスタンスに接続するかを指定します |
Attach to Microsoft Edge tab | N/A | タイトルごと、URL ごと、前景ウィンドウを使用する | タイトルを使用 | タイトルまたは URL を使用して Microsoft Edge タブに接続するか、フォアグラウンド ウィンドウとして実行されている Microsoft Edge のアクティブなタブに接続するかを指定します |
Initial URL | いいえ | テキスト値 | Web ブラウザーが起動されたときにアクセスする Web サイトの URL を入力します | |
Tab title | いいえ | テキスト値 | 接続先の Microsoft Edge タブのタイトル (またはその一部) を入力します | |
Tab URL | いいえ | テキスト値 | 接続先の Microsoft Edge タブの URL (またはその一部) を入力します | |
Window state | N/A | 通常、最大化、最小化 | 普通 | ブラウザー ウィンドウを、標準、最小化、最大化のどの状態で起動するかを指定します |
ターゲットのデスクトップ | N/A | ローカルコンピュータ、現在接続されているか、少なくとも 1 つの UI 要素がキャプチャされている仮想デスクトップ | ローカル コンピューター | ブラウザが起動するターゲット デスクトップの接続文字列の設定 |
Clear cache | N/A | ブール値 | False | Web ブラウザーの起動直後に、キャッシュ全体をクリアするかどうかを指定します |
Clear cookies | N/A | ブール値 | 無効 | Web ブラウザーの起動直後に、保存されたすべての Cookie をクリアするかどうかを指定します |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | 初期 Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
Timeout | いいえ | 数値 | 60 | ブラウザーの起動を待機する時間 (秒) を設定します。この時間内に起動しなければ、アクションは失敗します |
ユーザー データ フォルダー | N/A | Picture-in-Picture のデフォルト、ブラウザー デフォルト、カスタム | Picture-in-Picture のデフォルト | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーを指定します。 ブラウザー デフォルトが選択されている場合、ブラウザーをデスクトップと Picture-in-Picture の両方で同時に開くことはできません。 詳細 |
ユーザー データ フォルダー パス | いいえ | フォルダー | フローが Picture-in-Picture で実行されるときにブラウザーが使用するユーザー データ フォルダーのパスを指定します。 詳細 |
生成される変数
引数 | タイプ | 説明 |
---|---|---|
ブラウザー | Web browser instance | ブラウザーの自動化アクションで使用する Microsoft Edge インスタンス |
例外
例外 | 説明 |
---|---|
Microsoft Edge を起動できませんでした | Microsoft Edge の起動で問題が発生したことを示します |
無効な URL | 指定された URL が無効であったことを示します |
新しいタブを作成
新しいタブを作成し、指定された URL に移動します (Microsoft Edge、Chrome、Firefox に対応)。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
URL to navigate to | いいえ | テキスト値 | 移動先の URL、または URL を含む変数を入力します | |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
NewBrowser | Web browser instance | ブラウザーの自動化アクションで使用する新しい Web ブラウザー インスタンス |
例外
例外 | 説明 |
---|---|
無効な URL | 指定された URL が無効であったことを示します |
新しいタブを作成できませんでした | 新しいタブの作成で問題が発生したことを示します |
Web ページに移動します
Web ブラウザーで新しいページに移動します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
Navigate | N/A | URL、戻る、転送、Web ページの再読み込み | URL に移動 | 移動先を指定します |
URL | いいえ | テキスト値 | 移動先の URL を入力します | |
Wait for page to load | N/A | ブール値 | 有効 | 続行する前に、Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | Web ページの読み込み中に、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | テキスト値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
Web ページに移動できませんでした | 指定された Web ページへの移動で問題が発生したことを示します |
無効な URL | 指定された URL が無効であったことを示します |
Web ページのリンクをクリックする
Web ページのリンクまたはその他の要素をクリックします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | Web ページ上でクリックする UI 要素を選択します | |
クリックのタイプ | N/A | 左クリック、右クリック、ダブル クリック、左ボタン下、左ボタン上、右ボタン下、右ボタン上、ミドル クリック | 左クリック | 実行するクリックの種類 |
物理的クリックを送信 | N/A | ブール値 | False | クリックする前にマウスのカーソルを物理的に要素の上に移動するかを指定する。 エミュレートされたクリックが要素で意図したアクションを実行しない場合は、物理的なクリックが必要です。 このオプションでは、ブラウザー ウィンドウをフォーカスする必要があるため、自動的に前面に表示されます。 |
ページが読み込まれるまで待機 | N/A | ブール値 | True | リンクをクリックした後で、新しい Web ページが完全に読み込まれるまで待機するかどうかを指定します |
Web ページを読み込むためのタイムアウト | いいえ | 数値 | 60 | アクションがエラーをスローするまでのページの読み込み時間 (秒) を設定します |
If a pop-up dialog appears | N/A | 閉じる、ボタンを押す、何もしない | 何もしない | リンクをクリックした後で、ポップアップ ダイアログが表示された場合の動作を指定します |
Dialog button to press | はい | Text 値 | OK | ポップアップ ダイアログが表示された場合に押すダイアログ ボタンを入力します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
UI 要素をクリックできませんでした | 指定された要素のクリックで問題が発生したことを示します |
Web ページのダウンロード リンクをクリックする
Web ページ内のリンクを選択して、ファイルをダウンロードします。
重要
Web ページのダウンロード リンクをクリック アクションは Internet Explorer ライフサイクルの終わりに達したものでのみ動作します。 代わりに HTTP アクションを使用することをお勧めします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | Web ページ上でクリックする UI 要素を選択します | |
宛先フォルダー | いいえ | フォルダー | ダウンロードするファイルの保存先のフォルダーの完全なパスまたはフォルダーを含む変数を入力または選択します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
DownloadedFile | ファイル | ダウンロードが保存されているディスク上のファイルです。 この値は、上で指定されたダウンロード フォルダーと、Web サーバーによって指定されたファイル名で構成されたファイルパスです。 |
例外
例外 | 内容 |
---|---|
ファイルをダウンロードできませんでした | 指定されたファイルのダウンロードで問題が発生したことを示します |
指定された CSS セレクターを含む要素が見つかりません | 指定された CSS セレクターを持つ Web ページ要素が見つからないことを示します |
UI 要素をクリックできませんでした | 指定された要素のクリックで問題が発生したことを示します |
ファイルを保存できませんでした | 指定されたファイルの保存で問題が発生したことを示します |
Web ページで JavaScript 関数を実行する
Web ページ上で JavaScript 関数を実行し、返された結果を取得します。
Note
マニフェスト V3 ブラウザー拡張機能への移行は、このアクションに影響します。 マニフェスト V3 の詳細と、それが Web ページで JavaScript 関数を実行する アクションに与える影響については、マニフェスト V3 への移行 を参照してください。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
JavaScript function | はい | テキスト値 | function ExecuteScript() { /*your code here, return something (optionally); */ } | Web ページで実行する JavaScript 関数を入力します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
Result | Text 値 | 実行した JavaScript 関数の結果 |
例外
例外 | 説明設定 |
---|---|
JavaScript を実行できませんでした | JavaScript の実行で問題が発生したことを示します |
Web ページの要素の上にマウスを置く
Web ページの要素にマウスをホバーします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 操作する Web ブラウザー インスタンスを含む変数を入力または選択します | |
UI 要素 | いいえ | UI 要素 | Web ページ上でホバーする UI 要素を選択します | |
マウスを動かしてホバーする | いいえ | ブール値 | False | UI 要素をホバーするために、マウスカーソルを要素の上に物理的に移動させるかどうかを指定します。 物理的なホバーは、エミュレートされたホバーが要素に対して意図的なアクションを実行しない場合に必要です。 このオプションは、ブラウザ ウィンドウがフォーカスされている必要があるため、自動的に前面に表示されます。 |
生成される変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
要素をホバーできませんでした | 指定された要素をホバーするときに問題が発生したことを示します |
Web ブラウザーを閉じる
Web ブラウザー ウィンドウを閉じます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Web ブラウザー インスタンス | いいえ | Web ブラウザー インスタンス | 閉じる Web ブラウザー インスタンスを含む変数を入力または選択します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
Web ブラウザーを閉じることができませんでした | Web ブラウザーを閉じるときに問題が発生したことを示します |