UI Automation のアクティビティ

最終更新日時 2024年12月4日

文字を入力

UiPath.UIAutomationNext.Activities.NTypeInto

説明

テキストボックスなどの指定した UI 要素にテキストを入力します。

Tab や Enter などの特殊キーを UI 要素に送信することもできます。

固定キーもサポートされています。たとえば、Shift+End と入力してコントロールのテキストの一部のみを選択する場合は、特殊キーのリストから Shift と End を選択する必要があります。[k(Shift)][k(End)] というテキストが提示されます。その場合、Shift キーと End キーを順番に押す操作がエミュレートされます。正しいテキストは [d(Shift)][k(End)][u(Shift)] です。d はキーが押された状態、k はキーを押すこと、u はキーが解放された状態を表します。

機密情報を安全に入力するには、このアクティビティの前に [ユーザー名/パスワードを取得] アクティビティを追加して、当該アクティビティから、入力するテキストとして、後で使用するために保存するユーザー名とパスワードの値を選択します。

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

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

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

このアクティビティの使い方については、以下をご覧ください。

ログイン情報を安全に入力するための前提条件

このアクティビティを使用してユーザー名/パスワード情報を安全に入力する前に、以下の手順を実行する必要があります。

プロジェクトに [ユーザー名/パスワードを取得] アクティビティを追加します。
[ユーザー名/パスワードを取得] アクティビティで、Windows 資格情報マネージャーに以前に保存した資格情報を選択します。使用する資格情報がまだ Windows 資格情報マネージャーに保存されていない場合は、このアクティビティを使用して資格情報を追加できます。
資格情報を、プロジェクトで後で使用するために保存します。

プロジェクトの対応 OS

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

Windows - レガシ、Windows での設定

デザイナーパネル

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

ターゲットアプリケーションで要素にフォーカスが当たっている場合は、この手順は不要です。

ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 自動検証を追加 / 検証を削除 - アクティビティによって実行されるアクションの検証を追加または削除します。検証の実行は既定で有効化されています。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクトリポジトリに追加 - 現在の UI 要素をライブラリプロジェクトに追加し、オートメーションプロセス全体で要素を再利用することができます。
次を入力 - 入力するテキストです。テキストフィールドに送信する特殊キーをドロップダウンメニューを使用して選択することも、テキストビルダーから特殊キーを追加することもできます。テキストビルダー内のプラス メニューのオプションを使用して、後で使用するために保存しておく値を追加したり、プロジェクトノートブック、または親の [Excel ファイルを使用] アクティビティや [Outlook アカウントを使用] アクティビティからのデータを追加したりすることができます。テキスト、Excel または Outlook データ、特殊キーを、任意の組み合わせで使用できます。
入力前にフィールド内を削除 - フィールドの既存のコンテンツをテキストの入力前に削除するかどうかと、フィールド内を削除する方法を選択します。単一行のフィールドと複数行のフィールドの間で異なるキーストロークの組み合わせを送信して、フィールド内を削除します。指定したフィールドに応じて、適切なオプションを選択してください。以下のオプションを利用できます。
- なし - 既存のコンテンツを削除しません。
- 単一行 (End、Shift + Home、Del) - 1 行のテキストフィールドからコンテンツを削除します。これは既定のオプションです。
- 複数行 (Ctrl + A、Del) - 複数行のテキストフィールドからコンテンツを削除します。
このアクティビティを使用して、指定したテキストフィールドをクリアするには、このプロパティを設定して既存のコンテンツを削除し、[以下を入力] フィールドは空のままにして、[入力モード] プロパティを [ハードウェアイベント] に設定する必要があります。
入力前にクリック - 指定された UI 要素をテキストの入力前にクリックするかどうかと、実行するクリックの種類を選択します。オプションは [None] (クリックしない)、[Single] (シングルクリックを実行)、または [Double] (ダブルクリックを実行) です。

既定のオプションは [シングル]です。
テキストが空であることを確認 - [自動検証を追加] が選択されている場合、このオプションが表示されます。現在のアプリケーションまたは任意のアプリケーションで指定できます。

プロパティパネル

共通

エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
表示名 - デザイナーパネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。
タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。

入力

セキュリティで保護されたテキスト - 入力するセキュリティで保護されたテキストです。このフィールドは SecureString 型変数のみをサポートします。このフィールドを設定すると、[テキスト] フィールドはクリアされます。このフィールドの最大文字列長は 65536 文字です。
ターゲット - ターゲット要素です。ターゲット要素を設定する必要があります。画面で指定する前は、このフィールドは (null) に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。
- クリックのオフセット - [クリック] アクティビティのオフセットを詳細に設定できます。
  - アンカーポイント - [X のオフセット] プロパティと [Y のオフセット] プロパティで設定したオフセットが追加される、カーソルの開始位置を表します。指定できるオプションは、TopLeft、 TopRight、BottomLeft、BottomRight および Center です。既定では、Center が選択されています。
  - X のオフセット - カーソルの位置を、[アンカーポイント] プロパティで選択した位置から水平方向にずらす距離を指定します。このフィールドでは、Int32 型の変数のみがサポートされています。
  - Y のオフセット - カーソルの位置を、[アンカーポイント] プロパティで選択した位置から垂直方向にずらす距離を指定します。このフィールドでは、Int32 型の変数のみがサポートされています。
- 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 パッケージがプロジェクトにインストールされていることを意味します。ローカルサーバーが有効な場合、サーバーの値は上書きされます。ただし、ローカルサーバーはクロスプラットフォームプロジェクトでは利用できません。
- 可視性を確認 - UI 要素が表示されているかどうかを確認します。ドロップダウンメニューの次の 3 つのオプションのいずれかを選択できます。
  - なし - 可視性を確認しません。
  - 対話型 (あいまいセレクター用) - 既定のオプションです。要素が表示される可能性があるかどうかを確認します。確認時、ページをスクロールしないと表示されない、他のアプリで隠れている、アプリケーションが最小化されているという点は無視されます。この確認は、DOM に存在するものの表示されていない非表示の要素をターゲット要素として設定しないようにする場合に便利です。
  - 完全に表示されている - UI 要素が表示されるかどうかを確認します。
- ページの読み込みを待機 - アプリケーションが入力を受け入れる準備が完了するまで、アクションの実行を待機します。ドロップダウンメニューの次の 3 つのオプションのいずれかを選択できます。
  - なし - ターゲットの準備ができるまで待機しません。
  - 対話型 - アプリの一部のみが読み込まれるまで待機します。
  - 完了 - アプリ全体が読み込まれるまで待機します。
- ウィンドウセレクター (アプリケーションインスタンス) - アプリケーションウィンドウに使用されるセレクターです。[ウィンドウアタッチモード] が [アプリケーションインスタンス] に設定されている場合にのみ適用されます。
テキスト - 入力するテキストです。アクティビティ本体のドロップダウンリストからテキストに特別なキーを追加できます。このフィールドを設定すると、[セキュリティで保護されたテキスト] フィールドはクリアされます。このフィールドの最大文字列長は 65536 文字です。
実行を検証 - 実行時に、アクティビティによって実行されたアクションが正しいかどうかを検証します。それには、[期待されるテキスト] プロパティで指定したテキストがアクティビティの実行後に指定した UI 要素内に存在するかどうかを確認するか、アクションの実行後も表示されている必要のある要素、または表示されている必要のない要素を指定して、それをアクティビティの実行後に監視および検証します。この機能は [プロジェクト設定] で有効化するか、アクティビティの本体でコンテキストメニューから [自動検証を追加] を選択して有効化します。
- 表示名 - 検証アクションの表示名です。このフィールドは、選択した検証アクションと要素に基づいて自動入力されます。実行の検証を設定すると、この表示名がアクティビティカード内に表示されます。
- 期待されるテキスト - 指定したテキストフィールドに入力されることが期待されるテキストです。このフィールドは任意です。このフィールドでは、文字列と String 型変数のみがサポートされています。
- リトライ - オンにすると、期待される結果が達成されない場合は、アクティビティのタイムアウトまでの期間、アクションがリトライされます。既定では、このチェックボックスはオンになっています。
- ターゲット - このターゲットを使用して、実行時に検証する要素を指定します。このプロパティの下で展開できるプロパティフィールドの詳細については、上の [ターゲット] プロパティをご覧ください。プロパティの機能は同じです。
- タイムアウト - 検証対象の要素が出現、消滅、または変化するまで待機する時間 (秒) です。[リトライ] チェックボックスをオンにすると、アクションが再度実行された後、アクティビティの [タイムアウト] プロパティで指定した時間の間、検証が行われます。既定値は 10 秒です。
- 要素の次の動作を検証 - 検証ターゲットのどのような変更を確認するかを定義します。利用可能なオプションは次のとおりです。
  - 出現 - 要素が出現するかどうかを確認します。
  - 消滅 - 要素が消滅するかどうかを確認します。
  - テキストの変化 - 要素のテキストに変化があるかどうかを確認します。
  - 表示の変化 - 要素の画像に変化があるかどうかを確認します。

入力/出力要素

入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティフィールドから取得できます。
出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。

その他

プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。

オプション

無効化された要素を変更 - オンにすると、指定した UI 要素が無効化されていても、アクションが実行されます。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。

このプロパティは、[入力モード] プロパティが [ハードウェアイベント] に設定されている場合は適用されません。
入力モード - ロボットが対象のアプリケーションと対話するメソッドを、以下より選択します。
- アプリ/ブラウザーと同一 - [アプリケーション/ブラウザーを使用] アクティビティと同じ入力モードを使用します。
  
  これが既定の選択です。
- ハードウェアイベント - ハードウェアドライバーを使用してアクションを実行します。動作が極めて遅く、バックグラウンドでは動作しませんが、すべてのデスクトップアプリに対して使用できます。
- シミュレート - アクセシビリティ API を使用してシミュレートします。ブラウザー、Java ベースのアプリケーション、および SAP を使用する場合に推奨されます。通常はハードウェアイベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。
  
  [プロパティ] パネルで、[入力モード] プロパティフィールドの横にあるボタンによって、実行しているアクションに適した入力モードが自動的にテストされて選択されます。この機能を使用すると、利用可能なすべての入力メソッドでターゲットフィールドにテキストが入力され、最も適切な入力メソッドが自動的に選択されます。
  
  [アクティブ化]、[入力前にクリック]、[キー入力間の待機時間]、および [フィールド内を削除] の各プロパティは、入力モードが [シミュレート] の場合は使用できません。
- Chromium API - デバッガー API を使用してアクションを実行します。これは、Chromium の要素に対してのみ動作します。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。詳しくは、こちらのページをご覧ください。
- ウィンドウメッセージ - Win32 メッセージを使用してシミュレートします。デスクトップアプリに適しています。通常はハードウェアイベントよりも信頼性が高くなります。すべてのテキストを 1 回の操作で送信します。対象のアプリにフォーカスしていなくても動作します。対象のアプリケーションの UI 要素がこの方法をサポートしているかどうかをテストしてください。

オプション - ハードウェアイベント / Chromium API

アクティブ化 - クリックする前に UI 要素をフォアグラウンドに移動し、アクティブ化します。オンにしない場合、現在アクティブなウィンドウに入力されます。このフィールドでは、Boolean 値 (True、 False) のみがサポートされています。既定値は True です。
入力前にクリック - デザイナーパネルの [入力前にクリック] の説明をご覧ください。
キー入力間の待機時間 - 2 つの連続するキーストローク間の待機時間 (秒単位) です。既定値は 0.02 秒です。最大値は 1 秒です。
フィールド内を削除 - デザイナーパネルの [入力前にフィールド内を削除] の説明をご覧ください。

オプション - シミュレート

終了時に選択解除 - このチェックボックスは、[入力モード] プロパティが [シミュレート] に設定され、既定で選択されている場合にのみ使用できます。一部のターゲットアプリケーションでは、アクションとともに COMPLETE イベントが送信されない限り、アクションの種類は登録されません。このチェックボックスをオンにすると、アクションを正しく登録するために、テキストの入力後に COMPLETE イベントが追加されます。このチェックボックスがオフの場合、COMPLETE イベントはターゲットアプリケーションに送信されません。既定では、このチェックボックスはオンになっています。

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

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

ターゲットを指定したら、プラスボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
次を入力 - 入力するテキストです。テキストビルダーから特殊キーを追加できます。

その他のオプション

タイミング

実行前の待機時間 - 前のアクティビティが完了してから、現在のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.2 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
実行後の待機時間 - 現在のアクティビティが完了してから、次のアクティビティが何らかの操作を開始するまでの遅延時間を秒単位で指定します。既定値は 0.3 秒です。アクティビティとアクティビティの間に遅延を追加すると、次のアクティビティを開始する前に、現在のアクティビティを確実に終了できる時間を確保できます。
タイムアウト - エラーを発生させる前にアクティビティの実行を待機する時間を秒単位で指定します。既定値は 30 秒です。
エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは、Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

オプション

フィールド内を削除 - フィールドの既存のコンテンツをテキストの入力前に削除するかどうかと、フィールド内を削除する方法を選択します。単一行のフィールドと複数行のフィールドの間で異なるキーストロークの組み合わせを送信して、フィールド内を削除します。指定したフィールドに応じて、適切なオプションを選択してください。以下のオプションを利用できます。
- なし - 既存のコンテンツを削除しません。
- 単一行 (End、Shift + Home、Del) - 1 行のテキストフィールドからコンテンツを削除します。これは既定のオプションです。
- 複数行 (Ctrl + A、Del) - 複数行のテキストフィールドからコンテンツを削除します。
入力前にクリック - 指定した UI 要素をテキストの入力前にクリックするかどうかと、実行するクリックの種類を選択します。オプションは [なし] (クリックしない)、[シングル] (シングルクリックを実行)、または [ダブル] (ダブルクリックを実行) です。既定のオプションは [シングル] です。
アクティブ化 - オンにすると、テキストを入力する前に、指定した UI 要素が前面に表示されアクティブ化されます。オンにしない場合、現在アクティブなウィンドウに入力されます。このフィールドでは、Boolean 値 (True、 False) のみがサポートされています。既定値は True です。
終了時に選択解除 - Web ブラウザーでの特定の UI 応答をトリガーするために、テキストの入力後に完了イベントを追加します。
入力モード - ロボットが対象のアプリケーションと対話するメソッドを、以下より選択します。
- ブラウザーと同一 - 親の [ブラウザーを使用] アクティビティの [入力モード] の設定を使用します。これは既定のオプションです。
- Chromium API - デバッガー API を使用してアクションを実行します。Chrome および Edge の要素にのみ使用できます。すべてのテキストを一度に送信します。対象のアプリにフォーカスしていなくても動作します。
- シミュレート - アクセシビリティ API を使用してクリックをシミュレートします。ブラウザーに使用できます。すべてのテキストを一度に送信します。この入力メソッドは、バックグラウンドで (対象のアプリにフォーカスしていなくても) 動作します。

入力/出力

入力要素 - アクティビティの実行対象となる UI 要素で、UIElement オブジェクトに保存されます。このフィールドでは UIElement オブジェクトのみがサポートされています。このオブジェクトは、他の UI Automation アクティビティの [出力要素] プロパティフィールドから取得できます。
出力要素 - ターゲット UI 要素を出力して、UIElement オブジェクトに保存し、他のアクティビティで同じ要素をターゲットとして使用できるようにします。