アクティビティ
最新
API 目次
ロゴ
UI Automation のアクティビティ
最終更新日 2023年11月28日

API

API を使用すると、[パッケージを管理] メニューで提供されているサービスにアクセスして操作することができます。これらの API は、コード化されたオートメーションを設計する際に使用できます。コード化されたオートメーションと、API を使用してそれらのオートメーションを設計する方法について詳しくは、こちらをご覧ください。
メモ: [ 定義に移動] (F12) を使用すると、特定のサービスの UiPath API の定義にアクセスできます。 コード化されたオートメーションを実装する場合は、直接公開されている API のみを使用することをお勧めします。 サービスで直接公開されていないその他の API は、事前の通知なしに変更される場合があります。

オーバー ロード

API には多くの場合、過剰な負荷があります。つまり、パラメーター オプションが異なる同じメソッドの複数のバージョンを提供します。 オーバー ロードすると、特定の要件に基づいて API の動作をカスタマイズできます。 たとえば、UI Automation API には、UI 要素が表示されるまでの最大時間を指定するタイムアウト パラメーターを受け入れるオーバー ロードが設定されている場合があります。

API をそれぞれのオーバー ロードで使用することで、目的のオートメーションのロジックと動作を簡単に実現できます。

UI Automation API

このセクションには、UiPath.UIAutomationNext.API.Contracts サービスの API が含まれています。
API 説明
添付 UI 操作の自動化で使用するために、既に開いているデスクトップ アプリケーションまたは Web ブラウザー ページにフォーカスします。
チェック チェック ボックスまたはラジオ ボタンのオンオフを切り替えます。
クリック ボタンやリンクなど、指定した UI 要素をクリックします。 ユース ケースに応じて、クリック アクションをさらに設定できます。
ドラッグ アンド ドロップ ソース UI 要素からターゲット UI 要素へのドラッグ アンド ドロップ操作を実行します。
データを抽出 データをデータ テーブルとして抽出します。
属性を取得 指定した UI 要素が持つ特定の属性の値を取得します。
Getchildren 指定したターゲットの子を取得します。
GetRuntimeTarget 指定したターゲットのランタイム ターゲットを取得します。
GetText UI 要素からテキストを抽出してコピーします。
URL を取得 現在の Web ページから URL を取得します。
GoToUrl 指定した Web ブラウザーで、指定した URL に移動します。
強調表示 選択した UI 要素を強調表示します。
ホバー 現在の Web ページから URL を取得します。
有効 UI 要素が有効化されているかどうかを確認します。
キーボード ショートカット UI 要素に 1 つ以上のキーボード ショートカットを送信します。
マウス スクロール アプリケーション内でマウス スクロール イベントを送信し、指定した UI 要素までのスクロールを可能にします。
開く UI 操作の自動化で使用するデスクトップ アプリケーションまたは Web ブラウザーを開きます。
項目を選択 ドロップダウン コンボ ボックスまたはリスト ボックスから項目を選択します。
スクリーンショットを作成 指定した UI 要素またはアプリケーションのスクリーンショットを作成して、ファイルに保存します。
文字を入力 テキスト ボックスなどの指定した UI 要素にテキストを入力します。Tab や Enter などの特殊キーを UI 要素に送信することもできます。
WaitState 要素がユーザー インターフェイスで表示されているか、それとも消滅しているかを検証して、アプリケーションまたは Web ブラウザーのステートを確認します。

UI Automation API を使用する

UI Automation API を UI 要素と組み合わせて使用できます。 UI アプリケーションを自動化するプロセスには、目的のアプリケーションを開くか、アプリケーションに焦点を合わせてから、その UI 要素を自動化することが含まれます。 UI Automation API を使用してアプリケーションを自動化するには、次の手順を実行します。

  1. Attach および Open API を使用するときは、UI Automation サービスを呼び出します。これらの API は、アプリケーションや Web ブラウザーを開いたりフォーカスしたりするために、単独で使用されます。
    1. オブジェクト リポジトリで記述子としてキャプチャされた UI 要素を操作する場合は、 IScreenDescriptor オーバー ロードで Open または Attach API を使用します。

      uiAutomation.Open(ObjectRepository.Decriptors.<ApplicationName>.<ScreenName>)

    2. ネイティブ セレクターの場合は、UI Explorer を使用してアプリケーションの <app/> タグをコピーし、 TargetAppModel オーバーロードで OpenAPI を利用します。

      var applicationScreen = uiAutomation.Open(Target.FromSelector("<html app = 'chrome.exe'/>"))

  2. UI 要素上で直接 UI Automation API を呼び出します。
    1. オブジェクト リポジトリで記述子としてキャプチャされた UI 要素を操作する場合は、 IElementDescriptor オーバー ロードされた残りの API を使用します。
      var applicationScreen = uiAutomation.Open(ObjectRepository.Decriptors.<ApplicationName>.<ScreenName>)
      applicationScreen.TypeInto(ObjectRepository.Descriptors.<ApplicationName>.<ScreenName>.<ElementName>, "Hello")var applicationScreen = uiAutomation.Open(ObjectRepository.Decriptors.<ApplicationName>.<ScreenName>)
      applicationScreen.TypeInto(ObjectRepository.Descriptors.<ApplicationName>.<ScreenName>.<ElementName>, "Hello")
    2. ネイティブ セレクターの場合は、UI Explorer を使用して要素の <webctrl/> タグをコピーし、 TargetAnchorableModel オーバーロードを持つ残りの API を使用します。
      var applicationScreen = uiAutomation.Open(Target.FromSelector("<html app = 'chrome.exe'/>"));
      applicationScreen.TypeInto(Target.FromSelector("<webctrl id='generalClick' tag='BUTTON'/>"), "Hello")var applicationScreen = uiAutomation.Open(Target.FromSelector("<html app = 'chrome.exe'/>"));
      applicationScreen.TypeInto(Target.FromSelector("<webctrl id='generalClick' tag='BUTTON'/>"), "Hello")
ロゴ
サポートを受ける
ロゴ
RPA について学ぶ - オートメーション コース
ロゴ
UiPath コミュニティ フォーラム
UiPath ロゴ (白)
信頼とセキュリティ
© 2005-2023 UiPath. All rights reserved.