Universal App Connector の使用
Universal App Connector (UAC) を使用して、Windows、Java、Google Chrome、Edge ブラウザーベースのアプリケーションの自動化を作成します。単一の統合コネクタからアプリケーションを構成し、画面と要素、またはチェックボックスやボタンなどの画面コントロールをキャプチャします。こうした画面と要素のメソッドを使用して、自動化をビルドします。
始める前に
コネクタを使用する前に、プラグインマネージャーから Universal App Connector プラグインを追加します。SSH プラグインの追加の詳細については、「 でのプラグインの管理 RPA デスクトップデザインスタジオ」を参照してください。
開いているかアクティブな Windows、Java、 Google Chrome、または Edge アプリケーションがあることを確認します。
必要なロール:なし
手順
-
[ツールボックス] ペインで、[コネクタ] に移動し、[Universal App Connector] を [プロジェクトエクスプローラー (Project Explorer)] ペインの [グローバルオブジェクト (Global Objects)] にドラッグします。
コネクタは、[UniversalApplication] として、[グローバルオブジェクト (Global Objects)] に追加されます。
-
[Universal App Connector] のコネクタレベルでメソッドを使用するには、[UniversalApplication] オブジェクトをダブルクリックします。
メソッド名 参照 クリック Universal App Connector での Click メソッドの使用 GetValue Universal App Connector での GetValue メソッドの使用 SetValue Universal App Connector での SetValue メソッドの使用 開始 Universal App Connector の Start メソッドの使用 WaitForAnyScreen Universal App Connector での WaitForAnyScreen メソッドの使用 たとえば、アプリケーション画面または要素を操作する前にブラウザーまたはアプリケーションを起動する場合は、Start メソッドを使用します。メソッドが [オブジェクトエクスプローラー (Object Explorer)] ペインに表示されます。 -
UAC で画面と要素を構成するには、次の手順を実行します。
- [グローバルオブジェクト (Global Objects)] で [UniversalApplication] を右クリックし、[構成] を選択します。
-
[画面と要素の構成 (Configure screens and elements)] ウィンドウで、[ 開いているウィンドウから選択 (Choose from an open window )] ドロップダウン (
を選択し、アプリケーション画面を選択します。
注:- サポートされているアプリケーションが開いていない場合は、「
アプリウィンドウが見つかりません (App window not found)」というメッセージが表示されます。 - 新しく開いたアプリケーション画面をリストに表示するには、[クリックしてウィンドウを更新 (Click to refresh windows)] アイコン (
)を選択します。
- サポートされているアプリケーションが開いていない場合は、「
- オプション:
開いているアプリケーションをタイプでフィルタリングするには、[ すべての フィルターアプリケーションタイプ] アイコン (
を選択し、[すべて] またはアプリケーションタイプを選択します。
たとえば、[Chrome] を選択すると、Google Chrome Web ページのみが、[開いているウィンドウから選択 (Choose from an open window)] リストに表示されます。
たとえば、[Windowsアプリケーション] を選択すると、[開いているウィンドウから選択 (Choose from an open window)] リストに Windows つの画面のみが表示されます。
図 : 1. 開いているアプリケーションをフィルタリング -
選択したアプリケーション画面を追加するには、[画面の追加 (Add screen)] を選択します。
この手順を実行した後に、画面要素をキャプチャしてアクションを実行できます。アプリケーション画面が [画面と要素 (Screens and elements)] ペインに表示されます。
-
画面から要素をキャプチャするには、[画面と要素 (Screen and elements)] ペインで、追加した画面を右クリックし、[要素をキャプチャ (Capture Element)] を選択します。 キャプチャしたアプリケーション画面にフォーカスが設定され、[要素をキャプチャ (capture elements)] ダイアログが表示されます。たとえば、メモ帳などの Windows アプリケーションの要素をキャプチャする場合などです。UIA モード (UI オートメーション) を選択すると、メモ帳のスクロール バーもキャプチャされます。
図 : 2. Windows アプリケーションのキャプチャダイアログ - メモ帳 - UIA モード AA モード (Active Accessibility) を選択すると、メモ帳のスクロール バーはキャプチャされません。図 : 3. Windows アプリケーションのキャプチャダイアログ - メモ帳 - AA モード -
UI オートメーションとアクティブ アクセシビリティの 2 つのモードに対して Universal App Connector コネクタ レベルのメソッドを使用するには、 UniversalApplication オブジェクトをダブルクリックします。
UI オートメーション モードとアクティブ アクセシビリティ モードのメソッドの詳細については、「 UI オートメーション モードとアクティブ アクセシビリティ モードの方法」を参照してください。メソッドが [オブジェクトエクスプローラー (Object Explorer)] ペインに表示されます。
-
目的のアクションについて、次のいずれかのオプションを実行します。
オプション アクション UniversalApplication の名前を変更するには [プロジェクトエクスプローラー (Project Explorer)] ペインの [グローバルオブジェクト (Global Objects )] に移動し、 UniversalApplication を右クリックして [ 名前の変更] を選択します。 図 : 4. UniversalApplication の名前を変更 画面と要素の構成中に画面の名前を変更するには - [画面と要素 (Screens and elements)] ペインでアプリケーション画面の名前を選択します。
選択したアプリケーション画面の情報が [プロパティ] ペインの下に表示されます。
- [名前] フィールドでアプリケーション画面の名前を更新し、Enter キーを押します。
アプリケーションの名前が [画面と要素 (Screens and elements)] ペインで更新されます。
図 : 5. アプリケーション画面名の更新 画面を一意に識別するには 画面一致ルールを使用して、画面を識別して特定します。 実行中、プラグインは画面上のアクションを自動化するために、ターゲット画面を一意に識別する必要があります。属性の例としては、アプリケーション画面のタイトルや URL があります。属性は、[画面と要素の構成 (Configure screen and elements)] ウィンドウの [画面一致ルール (Screen match rules)] ペインに表示されます。UAC は、画面一致ルールを使用して最初に画面を識別し、要素一致ルールを使用して要素を識別してから、Click や Get Text などの要素に対してアクションを実行します。
次の図は、[属性の一致 (Match Attributes)] セクションで指定した同じ基準に一致する複数の要素の例を示しています。キャプチャされた要素を更新すると、複数のインスタンス (存在する場合) が表示され、括弧内に赤色で示されます。このような場合は、属性を微調整して、自動化する必要のある要素を正確に選択する必要があります。ユーザーは更新を行って、選択した条件が 1 つの要素と正確に一致するかどうかを確認できます。
要素を一意に識別するには 要素一致ルールを使用して、用意されている [ロケーター ] セクションと [ 一致属性 ] セクションの値を編集します。 実行中、プラグインは要素上のアクションを自動化するために、ターゲット画面を一意に識別する必要があります。属性は、[画面と要素の構成 (Configure screen and elements)] ウィンドウの [属性の一致 (Match Attributes)] ペインに表示されます。UAC は、画面一致ルールを使用して最初に画面を識別し、要素一致ルールを使用して要素を識別してから、Click や Get Text などの要素に対してアクションを実行します。
この画像は、キャプチャされた要素の一致ルールを示しています。
アプリケーション画面上の要素を検索するには キャプチャされた要素のロケーターを使用します。 詳細については、「アプリケーション画面で要素を検索する」を参照してください。
キャプチャされた要素内の iframe へのパス (存在する場合) を表示するには - [画面と要素 (Screens and elements)] ペインで、要素を選択します。
- [詳細] タブを選択します。
iframe が表示されます。
- [ロケーター] リストからロケーターを選択して、iframe へのパスを検索します。
- [画面と要素 (Screens and elements)] ペインでアプリケーション画面の名前を選択します。
- オプション:
アプリケーション画面または要素を右クリックして、[ リフレッシュ]、[ 画面と要素をリフレッシュ]、[ フォーカス]、[ カスタム要素を追加]、[ 要素を表示]、[ 削除] などの追加操作を実行します。
アプリケーション画面および要素に対して実行できるさまざまな追加操作の詳細については、「Universal App Connector のアプリケーション画面と要素の追加オプション」を参照してください。
-
アプリケーション画面または要素の構成が完了したら、[完了] を選択します。
アプリケーション画面とその要素は、[グローバルオブジェクト (Global Objects)] の UAC オブジェクト配下に表示されます。
-
必要なアプリケーション画面または要素をダブルクリックすると、関連するメソッドを一覧表示する [オブジェクトエクスプローラー (Object Explorer)] ペインが表示されます。
たとえば、Java アプリケーション画面または要素を選択すると、Java コネクタメソッドが [オブジェクトエクスプローラー (Object Explorer)] に表示されます。
- Java コネクタメソッドの詳細については、「Java コネクタのメソッド」を参照してください。
Google Chrome および Microsoft Edge のコネクタメソッドの詳細については、「Chromium コネクタのメソッド」を参照してください。
- Windows コネクタメソッドの詳細については、「Windows コネクタのメソッド」を参照してください。
キャプチャした Web アプリケーション画面でカスタム JavaScript を実行する場合は、ExecuteJavascript メソッドを使用できます。
-
[要素をキャプチャ (Capture elemen)] ダイアログを使用して、必要な数の画面要素をキャプチャします。
[要素をキャプチャ (Capture element)] ダイアログの使用方法については、「[要素をキャプチャ] ダイアログの使用」を参照してください。
キャプチャされた画面要素は、キャプチャされたアプリケーション画面の下に要素として表示されます。 -
必要なメソッドを、[オブジェクトエクスプローラー (Object Explorer)] ペインから [デザイン面 (Design surface)] にドラッグします。
メソッドは、[デザイン面 (Design surface)] にアプリケーション画面または要素名とともに表示されます。