UI 要素を更新 (以前の名称は [値を設定])

UiPath.Semantic.Activities.NSetValue

説明

AI を使用して、入力ボックス、ドロップダウン、チェック ボックス、ラジオ ボタン、日付の選択などの任意の入力フィールドにシームレスに値を設定します。

Chrome、Edge、Firefox、Safari でのみ使用できます。

[フォームに入力] と同じ機能を使用しますが、要素レベルで使用します。

特定の入力フィールドごとに別のアクティビティ (例: 入力ボックスには [文字を入力]、チェック ボックスには [チェック/チェック解除] など) を使用するのではなく、1 つの汎用の [UI 要素を更新] アクティビティを使用できます。また、日付の選択やラジオ ボタンのグループも処理できます。

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

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

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• 画面上で指定 - ターゲットとして使用する UI 要素を指定します。
  ターゲットを指定したら、プラス ボタンをクリックします。以下のオプションが表示されます。
  • ターゲットを指定 - ターゲットをもう一度指定します。
  • ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
• 値 - フィールドに設定される値です。このフィールドは String 型の変数のみを受け入れます。
  指定したターゲットがチェックボックスの場合、次の値が受け入れられます。
  • True: "true"、 "yes"、 "checked"、 "x"
  • False: "false"、"no"、"unchecked"
• 検証を有効化 - トグル ボタンが [オン] に設定されている場合、実行時の値の実行検証を有効化します。実行後に内部検証メカニズムで無効な値が検出されると、例外がスローされます。既定のオプションは [オフ] です。

プロパティ パネル

ターゲット

• ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウ (アプリケーション/ブラウザー) のセレクターです。
• セマンティック セレクター - ターゲットのセマンティックな説明です。
• セマンティック セレクター モデル - セマンティック処理に使用される、基になる LLM モデルを示します。[ プロジェクト設定 ] > UI Automation > [セマンティック セレクター] からのみ変更できます。
  使用可能なモデル: Gemini 2.5 Flash、Path Mini (「セマンティック セレクターのプロジェクト設定」を参照)。
• ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が整うまで待機してから操作を実行します。以下のオプションを利用できます。
  • なし - ターゲットの準備ができるまで待機しません。
  • 対話型 - アプリの一部のみが読み込まれるまで待機します。
  • 完了 - アプリ全体が読み込まれるまで待機します。
• 可視性を確認 - 有効化すると、アクティビティは UI 要素が表示されているかどうかも確認します。ドロップダウン メニューの次の 3 つのオプションのいずれかを選択できます。
  • なし - 可視性を確認しません。
  • 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  • 完全に表示されている - UI 要素が表示されるかどうかを確認します。
• レスポンシブ Web サイト - レスポンシブ Web サイトのレイアウトを可能にします。

オプション

• モデル - ターゲット UI 要素を理解し、設定する値の生成に使用する LLM モデルです。[ プロジェクト設定 ] > [UI Automation > セマンティック アクティビティ ] > [UI 要素を更新] - [モデル] からのみ変更できます。
  利用可能なモデル ( 「セマンティック アクティビティのプロジェクト設定」を参照):
  • GPT-4.1
  • GPT-4.1 mini
  • GPT-5 mini
  • Gemini 2.5 Flash
  • Gemini 3.0 Flash Preview
  • Path Mini
• Healing Agent モード - プロセス レベルまたはジョブ レベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
  • アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。
  • ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセス レベルまたはジョブ レベルで適用します。
  • 無効化 - このアクティビティの Healing Agent をオフにします。
  • 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

タイミング

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