Universal App Connector の使用

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：9分

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

    始める前に

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

    必要なロール：なし

    手順

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

        アプリケーション画面名が [画面と要素 (Screens and elements)] ペインに表示されます。

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

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

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

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

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

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

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

      画面一致ルール。

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

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

    6. オプション: 要素一致ルールを使用して、用意されている [ロケーター] セクションと [属性の一致 (Match Attributes)] セクションの値を編集し、要素を一意に識別します。
      実行中、プラグインは要素上のアクションを自動化するために、ターゲット画面を一意に識別する必要があります。属性は、[要素と画面の構成 (Configure elements and screen)] ウィンドウの [属性の一致 (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 アプリケーションが Shadow DOM をサポートしている場合、CSS セレクターにはシャドウ DOM 要素を含むパスが表示されます。たとえば、html > body > shop-app > /ShadowDom/ > app-header[id="header"] > app-toolbar > div:nth-of-type(3) > a > paper-icon-button > /ShadowDom/ > iron-icon[id="icon"] などです。
        Tagname Web Web 要素の一意のタグ名。
        JavaScript Web ユーザーが要素の位置を特定するためのカスタム JavaScript コードを定義できるようにします。
        XPath Web XPath を使用して Web 要素の位置を特定します。Web アプリケーションが Shadow DOM をサポートしている場合、このロケーターには Shadow DOM 要素を含む XPath がフルで表示されます。たとえば、html > body > shop-app > /ShadowDom/ > iron-pages > shop-home > /ShadowDom/ > div > h2 などです。
        タイプ Java と Windows タイプ別に画面要素の位置を特定できます。たとえば、ボタンやテキストボックスなどです。

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

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

        iframe が表示されます。

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

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

    次のタスク

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