UI Automation アクティビティ

最終更新日時 2026年1月14日

テキストの存在を確認

UiPath.Core.Activities.TextExists

指定した UI 要素の中でテキストが見つかったかどうかをチェックします。

注:

このアクティビティは、Chrome、Firefox、Edge など、操作の自動化に拡張機能を必要とするブラウザーで使用すると正しく機能しません。

プロパティ

入力

Text - 検索しようとする文字列です。

注:
文字列はすべて引用符で囲む必要があります。
Occurrence - Text フィールドの文字列が、指定した UI 要素の中で複数回出現する場合は、検索を必要とする出現回数をここに指定します。たとえば、文字列が 4 回出現し、1 回目に出現した文字列を検索する必要がある場合は、このフィールドに 1 を入力します。既定値は 1 です。

オプション

FormattedText - このチェックボックスをオンにした場合、スクレイピングしたテキストの画面レイアウトが保持されます。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
Target.Selector - アクティビティの実行時に特定の UI 要素の検索に使用する Text プロパティです。実際には、検索しようとする GUI 要素とそのいくつかの親要素の属性を指定する XML フラグメントです。
Target.TimeoutMS - SelectorNotFoundException エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。
Target.WaitForReady - アクションを実行する前に、ターゲットが準備完了になるまで待ちます。次のオプションを使用できます。
- NONE - ターゲット要素以外の要素の読み込みを待たずに、アクションを実行します。たとえば、UI 要素がすべて読み込まれるまで待つことなく、Web ページからテキストを取得したり、特定のボタンをクリックしたりする場合に、このオプションを使用できます。ボタンがまだ読み込まれていない要素 (スクリプトなど) に依存している場合、これは望ましくない結果を招く可能性があります。
- Interactive/Complete - 実際に操作を実行する前に、対象アプリのすべての UI 要素が存在するようになるまで待ちます。アプリケーションが対話または完了のどちらのステートにあるか調べるには、以下のタグを検証します。
- Desktop applications - <wnd> タグ、<ctrl> タグ、<java> タグ、または <uia> タグの存在を確認するために wm_null メッセージが送信されます。存在する場合、アクティビティが実行されます。
- Web アプリケーション：
1. Internet Explorer - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete に設定されているかどうかを確認するために使用されます。また、 Busy ステートでは、「False」に設定する必要があります。
2. Others - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete であるかどうかを確認するために使用されます。
- SAP applications - 最初に <wnd> タグを確認した後、SAP 固有の API を使用して、セッションがビジーかどうかを検出します。
Target.Element - 別のアクティビティから返される UiElement 変数を使用します。このプロパティを Selector プロパティと一緒に使用することはできません。このフィールドでは UiElement 変数のみサポートされています。
Target.ClippingRegion - UiElement を基準とするクリッピング四角形を定義します。