Kofax RPA へようこそ > リファレンス > Design Studio > その他のトピック > タグ ファインダー、範囲ファインダー、JSON ファインダー > タグ ファインダー

タグ ファインダー

タグ ファインダーは HTML/XML ページ上のタグを検索するために使用されます。タグ ファインダーはステップで使用され、ステップが適用されるタグを検索する方法を定義します。現在のステップのタグ ファインダーのリストはステップ ビューの [ファインダー] タブにあります。スプレッドシートのコンテンツを操作の対象とするステップは、タグ ファインダーではなく、範囲ファインダーを使用します。

タグ パスを理解する

タグ ファインダーを理解するうえでタグ パスの概念は重要です。タグ パスは、タグのページ内での位置についての短いテキスト表現です。以下のタグ バスについて考えます。

このタグ パスは、<html> タグ内の <body> タグ内にある <div> タグ内の <a> タグを表します。

html.body.div.a

タグ パスは、同じページにある複数のタグと照合することができます。たとえば、上記のタグ パスは、このページ上の 3 番目のタグを除くすべての <a> タグと一致します。

<html>
  <body>
    <div>
      <a href="url...">Link 1</a>
      <a href="url...">Link 2</a>
    </div>
    <p>
      <a href="url...">Link 3</a>
    </p>
    <div>
      <a href="url...">Link 4</a>
      <a href="url...">Link 5</a>
      <a href="url...">Link 6</a>
    </div>
  </body>
</html>

インデックスを使って、そのレベルの同じタイプのタグの中から特定のタグを参照することができます。以下のタグ バスについて考えます。

html.body.div[1].a[0]

このタグ パスは、<html> タグ内の <body> タグにある 2 番目の <div> タグ内の 1 番目の <a> タグを表します。したがって、上記のページでは、このタグ パスは "Link 4" の <a> タグとのみ照合されます。インデックスが 0 から始まる点に注意してください。タグ パス上のタグにインデックスが指定されていない場合、上記の最初のタグのパスで見たように、パスはそのレベルの該当するタイプのあらゆるタグと照合されます。インデックスが負の場合、照合されるタグは、インデックス -1 に相当する最後の一致タグから逆方向にカウントされます。以下のタグ バスについて考えます。

html.body.div[-1].a[-2]

このタグ パスは、<html> タグ内の <body> タグにある最後の <div> タグ内の最後から 2 番目の <a> タグを表します。したがって、上記のページでは、このタグ パスは "Link 5" の <a> タグとのみ照合されます。

アスタリスク ('*') を使って、任意のタイプの、任意の順番のタグを表すことができます。たとえば、次のタグ パスがあったとします。

html.*.p|div|td.a

このタグ パスは、<html> タグ内の任意の場所に配置された <p>、<div>、または <td> タグ内の <a> タグを表します。

タグ パスでは、ページ上のテキストはキーワードの "text" を使用して、他のタグと同様に表されます。技術的には、テキストはタグではありませんが、タグ パスでは同様に処理されて表示されます。例として、以下の HTML を考えます。

<html>
  <body>
    <a href="url...">Link 1</a>
    <a href="url...">Link 2</a>
  </body>
</html>

タグ パス "html.body.a[1].text" は、テキスト "Link 2" を表します。

タグ ファインダーのプロパティ

以下のプロパティを使用して [タグ ファインダー] を設定できます。

検索範囲

このプロパティでは、名前付きタグとの関連でタグを検索する場所を指定することができます。デフォルト値は「ページ内の任意の場所」であり、名前付きタグはタグの検索に使われません。

タグ パス

このプロパティでは、前のセクションで説明したタグ パスを指定できます。タグパスは、値セレクターを使用して複数の方法で指定できます。

属性名

このプロパティでは、たとえば "align" などの特定の属性を持つタグを指定できます。

属性値

このプロパティでは、特定の値を持つ属性を持つタグを指定できます。[属性名] プロパティが設定されている場合、属性値はその属性名に関連付けられます。

  • 「テキストと等しい」は、属性値が指定したテキストと完全に一致することを指定します。テキストは属性値の全体と一致する必要があることに注意してください。
  • 「テキストを含む」は、属性値に指定されたテキストが含まれることを指定します。
  • 「パターン」は、属性値がパターンと一致することを指定します。パターンは属性値全体と一致する必要があることに注意してください。
タグ パターン

このプロパティでは、(タグ内部のすべてのタグを含む) タグが一致しなければならない「.*.*Stock Quotes.*.*」などの パターン を指定できます。このプロパティはロボットのパフォーマンスに多大な影響を及ぼす可能性があるため、このプロパティを使用するときは注意する必要があります。タグ パターンは、1 つの一致するタグを検索するためにページ全体に何度も適用されることがあるためです。これを回避するには、照合対象プロパティに「テキストのみ」を選択する方法があります。

照合対象

このプロパティでは、「タグ パターン」がテキストまたはタグの HTML 全体と照合することを指定できます。デフォルトでは、パフォーマンスの高速化のため、テキストのみと照合します。

タグ深度

このプロパティは、一致するタグどうしが互いの内部に含まれている場合に、どちらのタグを使用するかを決定します。デフォルト値はすべての一致するタグを受け入れる「範囲内の深度」です。「最も外側のタグ」を選択した場合は、最も外側のタグのみが受け入れられ、同様に、「最も内側のタグ」を選択した場合は、最も内側のタグのみが受け入れられます。

タグ番号

このプロパティは、複数のタグがタグ パスおよび他の条件と一致した場合に、どのタグを使用するかを決定します。使用するタグの数を、一致する最初のタグから順方向、または一致する最後のタグから逆方向のいずれかで数えて指定します。

例

例えば、タグ パスを "table" に、属性名プロパティを "align"、タグ属性プロパティを "align" に、 属性値プロパティをテキストを "center" にした「固定テキスト」、タグ パターン プロパティを ".*Business News.*" に設定すると、タグ ファインダーは、<table> タグで、中央揃えされ、"Business News" というテキストが含まれる最初のものを見つけます。