JavaScript 関数を呼び出すアクション
- 最終更新日2025/01/02
JavaScript 関数を呼び出すアクション
ブラウザ パッケージの [JavaScript 関数アクションを呼び出す]使用すると、Web ページ内または Web ページ内の iFrame に存在する JavaScript 関数を直接呼び出すことができます。 この アクション は、デスクトップ Chromium Embedded Framework (CEF) アプリケーションで JavaScript 関数を呼び出すこともできます。
設定を構成する
注:
- このアクションは、Google Chrome および Chromium ベースの Microsoft Edge ブラウザをサポートします。
- この アクション はCEFベースのデスクトップアプリケーションをサポートしています。
- アクティブなサポートされているブラウザ タブのリストからブラウザ タブを選択するか、ウィンドウ変数を挿入します。 CEFアプリケーションでJavaScript関数を呼び出すには、アプリケーションタブを使用してください。 アプリケーション タブのアプリケーションのリストから特定のCEFアプリケーションを選択します。 CEFアプリケーションは、デスクトップアプリケーションにChromiumを埋め込むことでウェブブラウザ機能を統合します。重要:
- CEFフレームワークを使用するデスクトップアプリケーションを自動化するには、昇格モードで自動化を開発および実行する必要があります。 「」を参照してください。
- CEFアプリケーションを自動化するには、ブラウザ パッケージ バージョン3.13.1以降を使用することを確認してください。
注:- 単一のCEFアプリケーションでクロスドメインiFrameを自動化することはサポートされていません。
- CEFアプリケーションはブラウザタブに表示されません。
正規表現 (regex) を使用して、ウィンドウ タイトルを識別できます。正規表現の条件として [文字列] または [パターン] を選択し、値を入力します。デフォルトでは、[ウィンドウ タイトル] フィールドで大文字と小文字が区別されます。
ブラウザのタイトルを識別する場合、[大文字と小文字が区別される] オプションを有効にすると、大文字と小文字を一致させることができます。このオプションを無効にすると、大文字と小文字が一致しないウィンドウ タイトルを識別できます。注: システムにインストールされている最小 Bot エージェント バージョンが、Automation 360 v.26 でリリースされたバージョンであることを確認してください。Automation 360 v.25 以前でリリースされた Bot エージェント バージョンを使用している場合、ウィンドウ タイトルはデフォルトで大文字小文字を区別して識別されます。たとえば、単語の後に「- Notepad
」が続くすべてのウィンドウ タイトル名に一致させるには、[文字列] 値として「* -Notepad」と入力するか、[パターン] 値として ((\w)\s)*document-Notepad を使用してこのパターンにマッチするウィンドウ タイトルのみに一致させます。注:- 任意のアクションでウィンドウ タイトルの入力値として「-title」を含む [文字列] 型の正規表現を使用する場合、Bot にランタイム エラーが発生する可能性があります。ランタイム エラーを防ぐために、「*-title」と文字列を追加入力したときに特定のタイトルのアプリケーションが開くことを確認します。アスタリスク (*) は単なる文字であり、ワイルド カード文字ではありません。
- 任意のアクションでウィンドウ タイトルの入力値として「-title」を含む [パターン] 型の正規表現を使用する場合、入力値「*-title」が正しくないため、Bot にランタイム エラーが発生する可能性があります。
有効な正規表現パターンを使用していることを確認してください。
-
任意: [オブジェクトをキャプチャ] オプションを使用して iFrame をキャプチャします。注: [オブジェクトをキャプチャ] 機能を使用して、iFrame 内で既存の JavaScript 関数を呼び出して実行することができます。
- [関数名] フィールドで、呼び出したい既存の JavaScript 関数の名前を指定します。
-
任意: [引数] セクションで、[引数を追加] をクリックして、JavaScript 関数を呼び出すために渡す必要のある引数を追加します。
- [引数の詳細] ダイアログ ボックスで、特定の引数に必要な [引数のタイプ] を選択します。
- [値] フィールドに、渡したい選択したタイプの対応する値または変数を入力します。注: 引数内の文字列値はすべて、文字の変換やエスケープを行わずに、そのまま渡されます。
-
任意: [次の時間経過したらタイムアウト] フィールドでは、Bot がブラウザ アクションの完了を待機する秒数を入力します。注: 9 秒以上のタイムアウト値を入力してください。
- [リターン タイプ] フィールドで、JavaScript 関数が返す値のタイプを選択します。注: 関数が何も返さない場合、[リターン タイプ] フィールドで、[なし] を選択します。
- [なし] を除く [リターンタイプ] に対して、[結果を変数に保存] フィールドで、JavaScript 関数の出力を保持する選択した [リターンタイプ] の変数を選択します。
変数を作成
選択した [リターンタイプ] の変数を作成するには、次の手順を実行します。
- [結果を変数に保存] フィールドの隣にある [変数を作成] 記号をクリックします。
[変数を作成] ダイアログが開き、選択した変数のタイプに応じたデフォルトの変数名が表示されます。
- 任意: [説明] フィールドで変数情報を指定します。
- 任意: [デフォルト値] フィールドに値を指定します。
- [作成して選択] をクリックして、新しく作成した変数を選択します。
引数タイプ フィールドとリターン タイプ フィールドでサポートされている JavaScript のタイプ
以下の JavaScript タイプがサポートされます。
- 文字列、数値、および Boolean の JavaScript のタイプ。これらは、Bot 変数の同じ変数タイプに対応します。
- JavaScript の配列型。これは、 変数の BotList 変数型に対応します。
- JavaScript のオブジェクト型。これは、 変数の BotDictionary 変数型に対応します。