activities
latest
false
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。
UiPath logo, featuring letters U and I in white

UI Automation のアクティビティ

最終更新日時 2025年12月3日

JS スクリプトを挿入

UiPath.Core.Activities.NInjectJsScript

説明

UiElement に対応する Web ページのコンテキストで JavaScript コードを実行します。

このアクティビティは [アプリケーション/ブラウザーを使用] アクティビティに追加する必要があります。

このアクティビティを [アプリケーション/ブラウザーを使用] アクティビティの外で使用するには、入力要素を指定する必要があります。

このアクティビティはオブジェクト リポジトリに対応しています。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows、クロスプラットフォームでの設定

  • 画面上でターゲットを指定 - ターゲットとして使用する UI 要素を指定します。

    ターゲットを指定したら、プラス ボタンをクリックします。以下のオプションが表示されます。

    • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
    • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
  • スクリプト コード - 実行する JavaScript のコードです。文字列でコードを直接入力できるほか、実行するコードを収めた .js ファイルへのフル パスを追加することもできます。下記の例のように、単一の匿名関数を記述する必要があります。
    function (element, input) {
    return "result";
}function (element, input) {
    return "result";
}
    async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}
    ここで、element は呼び出し元の UI ノードに対応する HTML 要素を表し、input は、呼び出し元によって提供される入力文字列を表します。

プロパティ パネル

入力/出力

  • スクリプトの出力 - JavaScript コードから返される文字列の結果です。
  • 入力パラメーター - JavaScript コードに渡される入力データです。
  • 入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。
  • 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。
オプション
  • 実行環境 - スクリプトを実行する JavaScript 環境です。ドロップダウン メニューから、以下の 2 つのオプションのいずれかを選択します。
    • Isolated - スクリプトは HTML 要素にはアクセスできますが、ページ変数やページ コードにはアクセスできません。スクリプト実行がページと競合しないようにする場合は、このオプションを使用します。 これが既定の選択です。
    • Page - スクリプトは HTML 要素、ページ変数、ページ コードにアクセスできます。ページ変数 (例: jQuery $) へのアクセス、またはページ コードの操作 (例: window.alert) が必要な場合は、このオプションを使用します。MV3 拡張機能に固有の既知の問題を修正するには、このオプションを使用する必要があります。
    すべての [JS スクリプトを挿入] アクティビティの [実行環境] プロパティは、[プロジェクト設定] から変更できます。
  • エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

ターゲット

  • ターゲットのプロパティを展開 - ターゲットとアンカーのプロパティを表示します。これにより、他のアクティビティのプロパティは非表示になり、ターゲットに関連するプロパティのみが表示されます。
  • ターゲットのプロパティを折りたたみ - ターゲットとアンカーのプロパティを非表示にします。これにより、ターゲットに関連するプロパティが非表示になり、アクティビティのプロパティが表示されます。
  • ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
    • None
    • 厳密セレクター - ターゲット UI 要素に対して生成される厳密セレクターです。
    • あいまいセレクター - あいまいセレクターのパラメーターです。

    • Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。

      Computer Vision をターゲット メソッドとして使用するもう 1 つの方法は、[ローカル サーバーを使用] を [True] に設定することです。これは、UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。ローカル サーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカル サーバーはクロスプラットフォーム プロジェクトでは利用できません。

      • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
      • CV テキスト - Computer Vision で識別するテキストを指定します。
      • CV テキストの出現 - 複数の一致が見つかった場合に使用する特定の出現を指定します。
      • CV テキストの精度 - OCR のテキストの一致精度レベルを指定します。
    • セマンティック セレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
    • 画像 (Windows のみ)
      • 画像の精度 - 画像の一致精度レベルを指定します。
      • 画像の出現 - 複数の一致が見つかった場合に使用する特定の出現を指定します。
    • ネイティブ テキスト (Windows のみ)
      • ネイティブ テキスト - UI 要素を検出するために検索するテキストです。
      • ネイティブ テキストの出現 - 複数の一致が見つかった場合に使用する特定の出現を指定します。
  • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウのセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定している場合にのみ適用されます。
  • ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。以下のオプションを利用できます。
    • なし - ターゲットの準備ができるまで待機しません。
    • 対話型 - アプリの一部のみが読み込まれるまで待機します。
    • 完了 - アプリ全体が読み込まれるまで待機します。
  • 可視性を確認 - 有効化すると、アクティビティは UI 要素が表示されているかどうかも確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
    • なし - 可視性を確認しません。
    • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
    • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
  • レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。

タイミング

  • 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

  • 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

  • タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

Windows - レガシでの設定

  • [アプリ/ブラウザーで指定] を選択して、ターゲットとして使用する UI 要素を指定します。

    ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。

    • 画面上でターゲットを指定 - ターゲットをもう一度指定します。
    • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
    • 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
    • オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。
  • スクリプト コード - 実行する JavaScript のコードです。文字列でコードを直接入力できるほか、実行するコードを収めた .js ファイルへのフル パスを追加することもできます。下記の例のように、単一の匿名関数を記述する必要があります。 
    function (element, input) {
    return "result";
}function (element, input) {
    return "result";
}
    async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}
    ここで、element は呼び出し元の UI ノードに対応する HTML 要素を表し、input は、呼び出し元によって提供される入力文字列を表します。
  • InputParameter - JavaScript コードの入力データです (文字列または String 型変数)。
  • スクリプトの出力の保存先 - JavaScript コードの結果の保存場所です。
プロパティ パネル

共通

  • エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

  • 実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

  • 実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。

  • 表示名 - デザイナー パネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。

  • タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

  • 入力パラメーター - デザイナー パネルの [入力パラメーター] の説明をご覧ください。
  • スクリプト コード - デザイナー パネルの [スクリプト コード] の説明をご覧ください。
  • ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
    • CV コントロールの種類 - Computer Vision で識別するコントロールの種類を指定します。
    • CV テキスト - Computer Vision で識別するテキストを指定します。
    • あいまいセレクター - あいまいセレクターのパラメーターです。
    • ネイティブ テキスト - UI 要素の識別に使用されるテキストです。
    • レスポンシブ対応の Web サイト - レスポンシブ対応の Web サイトのレイアウトを有効化します。
    • 厳密セレクター - UI 要素に対して生成される厳密セレクターです。
    • ターゲット メソッド - 要素の識別に使用するセレクターの種類です。このプロパティには、ドロップダウン メニュー内の任意の組み合わせを設定できます。
      • None
      • 厳密セレクター
      • あいまいセレクター
      • 画像
      • ネイティブ テキスト
      • Computer Vision - ターゲット メソッドとして Computer Vision を使用するには、[プロジェクト設定] > [Computer Vision] に移動し、正しいサーバー エンドポイントを設定する必要があります。このフィールドはそのままにして、既定で入力されている「UiPath Cloud」を使用するか、他のパブリック エンドポイントを選択して別の値を入力できます。別の値を入力する場合、サーバー リージョンまたは独自のオンプレミス サーバー専用のエンドポイントを選択します。

        Computer Vision をターゲット メソッドとして使用するもう 1 つの方法は、[ローカル サーバーを使用] を [True] に設定することです。これは、UiPath.ComputerVision.LocalServer パッケージがプロジェクトにインストールされていることを意味します。ローカル サーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカル サーバーはクロスプラットフォーム プロジェクトでは利用できません。

      • セマンティック セレクター - 大規模言語モデル (LLM) を活用して、人間が書くような UI 要素の機能的な記述を生成します。これらの記述は信頼性が高いため、UI の変更に適応でき、従来のセレクターが失敗した場合のオートメーションの回復性が大幅に向上します。
    • 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
      • なし - 可視性を確認しません。
      • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
      • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
    • ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
      • なし - ターゲットの準備ができるまで待機しません。
      • 対話型 - アプリの一部のみが読み込まれるまで待機します。
      • 完了 - アプリ全体が読み込まれるまで待機します。
    • ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウに使用されるセレクターです。[ウィンドウ アタッチ モード] が [アプリケーション インスタンス] に設定されている場合にのみ適用されます。
  • 入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティ フィールドから取得できます。
  • 出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。
  • プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。
  • 実行環境 - スクリプトを実行する JavaScript 環境です。ドロップダウン メニューから、以下の 2 つのオプションのいずれかを選択します。
    • Isolated - スクリプトは HTML 要素にはアクセスできますが、ページ変数やページ コードにはアクセスできません。スクリプト実行がページと競合しないようにする場合は、このオプションを使用します。 これが既定の選択です。
    • Page - スクリプトは HTML 要素、ページ変数、ページ コードにアクセスできます。ページ変数 (例: jQuery $) へのアクセス、またはページ コードの操作 (例: window.alert) が必要な場合は、このオプションを使用します。MV3 拡張機能に固有の既知の問題を修正するには、このオプションを使用する必要があります。

    すべての [JS スクリプトを挿入] アクティビティの [実行環境] プロパティは、[プロジェクト設定] から変更できます。

  • スクリプトの出力 - JavaScript コードから返される文字列の結果です。

このページは役に立ちましたか?

サポートとサービス
サポートを受ける
UiPath アカデミー
RPA について学ぶ - オートメーション コース
UiPath フォーラム
UiPath コミュニティ フォーラム
Uipath Logo
信頼とセキュリティ
利用規約
プライバシー ポリシー
Cookie ポリシー
© 2005-2025 UiPath. All rights reserved.