Universal App Connector の使用

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む9読むのに数分

    • Universal App Connector (UAC) を使用して、Google ChromeおよびEdgeブラウザーベースのアプリケーションの自動化Windowsを作成します。単一の統合コネクタからアプリケーションを構成し、画面と要素、またはチェックボックスやボタンなどの画面コントロールをキャプチャします。こうした画面と要素のメソッドを使用して、自動化を構築します。

    始める前に

    開いているかアクティブな Windows、Java、 Google Chromeまたは Edge アプリケーションがあることを確認します。

    必要なロール：なし

    手順

    1. [ツールボックス] ペインで、[コネクタ] に移動し、[Universal App Connector] を [プロジェクトエクスプローラー (Project Explorer)] ペインの [グローバルオブジェクト (Global Objects)] にドラッグします。
      コネクタは、[グローバルオブジェクト (Global Objects)] の下に UniversalApplication オブジェクトとして追加されます。
    2. オプション: ユニバーサルアプリケーションの名前を変更するには、右クリックして [名前の変更] を選択します。
    3. Universal App Connector コネクタレベルでメソッドを使用するには、UniversalApplication オブジェクトをダブルクリックします。
      たとえば、Start メソッドは、アプリケーション画面または要素を操作する前にブラウザーまたはアプリケーションを起動する場合に使用されます。Start メソッドの使用方法の詳細については、「Use the Start method (Start メソッドの使用)」を参照してください。
      メソッドが [オブジェクトエクスプローラー (Object Explorer)] ペインに表示されます。
    4. UAC で画面と要素を構成するには、次の手順を実行します。
      1. [グローバル オブジェクト] で [ ユニバーサル アプリケーション ] を右クリックし、[ 構成] を選択します。
      2. [画面と要素の構成] ウィンドウで、[開いているウィンドウから選択] ドロップダウンを選択し ( 開いているウィンドウのドロップダウンから選択)、アプリケーション画面を選択します。
        アプリケーションを開きます。
        注:
        • サポートされているアプリケーションが開いていない場合は、「アプリウィンドウが見つかりません (App window not found)」というメッセージが表示されます。
        • 新しく開いたアプリケーション画面をリストに表示するには、[クリックしてウィンドウを更新]アイコン( クリックしてウィンドウを更新アイコン)を選択します。
      3. オプション: 開いているアプリケーションを種類でフィルター処理するには、[アプリケーションの種類をフィルター処理] アイコン ([アプリケーションの種類をフィルター処理] アイコン) を選択し、[すべて] または [ アプリケーションの種類] を選択します。
        たとえば、[Chrome] を選択した場合、[開いているウィンドウから選択] リストに Google Chrome ウェブページのみが表示されます。
      4. 選択したアプリケーション画面を追加するには、[ 画面の追加] を選択します。
        この手順を実行した後、画面要素をキャプチャしてアクションを実行できます。
        アプリケーション画面が [画面と要素 (Screens and elements)] ペインの下に表示されます。

        アプリケーション画面名は、[画面と要素] の下に表示されます。

      5. オプション: 画面の名前を変更するには、[画面と要素] ペインでアプリケーション画面の名前を選択します。
        選択したアプリケーション画面の情報が [プロパティ] ペインの下に表示されます。
      6. オプション: [ 名前 ] フィールドでアプリケーション画面の名前を更新し、 Enter キーを押します。
        アプリケーションの名前が [画面と要素 (Screens and elements)] ペインで更新されます。
      7. 画面から要素をキャプチャするには、[画面と要素] ペインで、追加した画面を右クリックし、[ 要素をキャプチャ] を選択します。
        [要素をキャプチャ] オプション。
        キャプチャしたアプリケーション画面にフォーカスが設定され、[要素をキャプチャ] ダイアログが表示されます。

        キャプチャされた画面にフォーカスがあり、キャプチャダイアログが表示されます。

      8. [要素をキャプチャ] ダイアログを使用して、必要な数の画面要素をキャプチャします。

        [要素をキャプチャ] ダイアログの使用方法については、「 [要素をキャプチャ] ダイアログの使用」を参照してください。

        キャプチャされた画面要素は、キャプチャされたアプリケーション画面の下に要素として表示されます。

        キャプチャされた画面コントロール。

    5. オプション: 画面一致ルールを使用して、指定された一致ルールの値を編集し、画面を一意に識別します。
      実行中、プラグインは画面上のアクションを自動化するためにターゲット画面を一意に識別する必要があります。属性の例としては、アプリケーション画面のタイトルや URL があります。属性は、[要素と画面の構成 (Configure elements and screen)] ウィンドウの [画面一致ルール (Screen match rules)] ペインの下に表示されます。UAC はこれらの属性を使用して、最初に画面を識別し、Click や Get Text などの要素に対してアクションを実行します。

      画面一致ルール。

      次の図は、[属性の一致] セクションで指定した同じ条件に一致する複数の要素の例を示しています。キャプチャされた要素をリフレッシュすると、複数のインスタンス (存在する場合) が表示され、括弧内に赤色で示されます。このような場合は、属性を微調整して、自動化する必要のある要素を正確に選択する必要があります。ユーザーは更新して、選択した条件が 1 つの要素と正確に一致するかどうかを確認できます。

      キャプチャされた要素の複数のインスタンス。

    6. オプション: 要素一致ルールを使用して、用意されている [ロケーター ] セクションと [属性の一致] セクションの値を編集し、要素を一意に識別します。
      実行中、プラグインは要素に対するアクションを自動化するためにターゲット要素を一意に識別する必要があります。属性は、[要素と画面の構成 (Configure elements and screens)] ウィンドウの [属性を照合 (Match Attributes)] ペインの下に表示されます。UAC はこれらの属性を使用して、最初に画面を識別し、Click や Get Text などの要素に対してアクションを実行します。

      この画像は、キャプチャされた要素の一致ルールを示しています。

      要素とその一致ルール。

    7. オプション: キャプチャされた要素のロケーターを使用して、アプリケーション画面上の要素を検索します。
      UAC には、複数のロケーターの種類が用意されています。たとえば、XPath ロケーターは要素に XPath を提供します。

      要素ロケーター。

      1. [画面と要素 (Screens and elements)] ペインで、画面の下の要素を選択します。
      2. [ロケーター] リストから、エレメント ロケーターの 1 つを選択します。
        表 : 1. 画面要素ロケーター
        ロケーター タイプ アプリケーションタイプ 説明
        ID Web、Java、および Windows ターゲットアプリケーションで定義されている場合の、要素の一意の識別子。
        名前 Web、Java、および Windows ターゲットアプリケーションで定義されている場合の要素の一意の名前。
        CssSelector Web キャプチャされた Web 要素を検索する CSS セレクター。たとえば、 div#navbarNav > ul > li > a のように指定します。Web アプリケーションがシャドウ DOM をサポートしている場合、CSS セレクターにはシャドウ DOM 要素を含むパスが表示されます。たとえば、html > body > shop-app > /ShadowDom/ > app-header[id="header"] > アプリツールバー> div:nth-of-type(3) > /ShadowDom/ > iron-icon[id="icon"] >紙のアイコンボタン>
        Tagname Web Web 要素の一意のタグ名。
        JavaScript Web ユーザーが要素を見つけるためのカスタム JavaScript コードを定義できるようにします。
        XPath Web XPath を使用して Web 要素を検索します。Web アプリケーションがシャドウ DOM をサポートしている場合、このロケーターはシャドウ DOM 要素を含む完全な XPath を表示します。たとえば、 html > body > shop-app > /ShadowDom/ > iron-pages > shop-home > /ShadowDom/ > div > h2 などです。
        Type (タイプ) Java と Windows タイプで画面要素を検索できます。たとえば、ボタンやテキスト ボックスなどです。

        型ロケーターを選択すると、UAC コネクタによって [値] フィールドに要素の種類が入力されます。
        パス Java と Windows 画面要素の階層内の位置を指定して、画面要素を見つけることができます。

        パスロケーターを選択すると、UAC コネクタによって [値] フィールドに要素のパスが入力されます。
        カスタムパス Windows 要素へのパスを微調整またはトリミングできます。
    8. オプション: キャプチャされた要素内の iframe へのパス (存在する場合) を表示するには、次の手順を実行します。
      1. [画面と要素 (Screens and elements)] ペインで、要素を選択します。
      2. [詳細] タブを選択します。
        iframe が表示されます。

        iFrame が表示されます。

      3. [ロケーター] リストからロケーターを選択して、iframe へのパスを検索します。
        iFrame ロケーター。
    9. オプション: アプリケーション画面または要素を右クリックして、追加の操作を実行します。
      アプリケーション画面および要素に対して実行できるさまざまな追加操作の詳細については、「Universal App Connector のアプリケーション画面と要素の追加オプション」を参照してください。
    10. アプリケーション画面または要素の構成が完了したら、[完了] を選択します。
      アプリケーション画面とその要素は、[ グローバルオブジェクト] の UAC オブジェクトの下に表示されます。
    11. 必要なアプリケーション画面または要素をダブルクリックすると、関連するメソッドを一覧表示する [オブジェクトエクスプローラー (Object Explorer)] ペインが表示されます。
      たとえば、Java アプリケーション画面または要素を選択すると、Java コネクタメソッドが [オブジェクトエクスプローラー (Object Explorer)] に表示されます。
      • Java コネクタメソッドの詳細については、「Java コネクタのメソッド」を参照してください。

      • Google Chrome および Microsoft Edge のコネクタメソッドの詳細については、「Chromium コネクタのメソッド」を参照してください。

      • Windows コネクタメソッドの詳細については、「Windows コネクタのメソッド」を参照してください。

      • Web アプリケーション画面をキャプチャし、その画面でカスタム JavaScript を実行する場合は、ExecuteJavascript メソッドを使用できます。

    12. [オブジェクトエクスプローラー (Object Explorer)] ペインから、必要なメソッドを [デザイン面 (design surface)] にドラッグします。

      メソッドは、[デザイン面 (design surface)] にアプリケーション画面または要素名とともに表示されます。

    次のタスク

    アプリケーション画面と要素に対してさまざまなメソッドを使用して自動化を設計し、自動化を保存します。