アプリケーション画面で要素を検索する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:3分
  • RPA デスクトップデザインスタジオで Universal App Connector (UAC) を使用しているときに、キャプチャされた要素のロケーターを使用してアプリケーション画面上の要素を検索します。

    始める前に

    UAC の概念について理解しておいてください。詳細については、「Universal App Connector」を参照してください。

    UAC を構成します。詳細については、「Universal App Connector の使用」を参照してください。

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

    必要なロール:なし

    このタスクについて

    UAC には、複数のロケーターの種類が用意されています。たとえば、XPath ロケーターは要素に XPath を提供します。
    図 : 1. ロケータータイプ
    要素ロケーター。

    手順

    1. [ツールボックス] ペインで、[コネクタ] に移動し、[Universal App Connector] を [プロジェクトエクスプローラー (Project Explorer)] ペインの [グローバルオブジェクト (Global Objects)] にドラッグします。
      コネクタは、[UniversalApplication] として、[グローバルオブジェクト (Global Objects)] に追加されます。
    2. Universal App Connector を構成し、画面を追加します。
      詳細については、「Universal App Connector の使用」を参照してください。
    3. [画面と要素 (Screens and elements)] ペインで、画面配下の要素を選択します。
    4. [ロケーター] リストから、要素ロケーターの 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 要素へのパスを微調整またはトリミングできます。