> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 検索要素

> NLP 検索要素（人、組織、住所、日付、金額、dictionary、regex、text、group）を使用して、非構造化テキストから抽出する対象を定義します。

**検索要素**を使用すると、抽出したいオブジェクトの種類やプロパティに関する条件を設定できます。NLP アクティビティは非構造化テキストを扱うため、検索条件はオブジェクト同士の幾何学的な関係ではなく、他のテキストに対する位置関係を指定します。補助的な検索要素を使って検索対象を絞り込み、対象オブジェクトがそれらの補助要素の内側、前、または後にあることを指定することもできます。

<div id="creating-a-search-element">
  ## 検索要素の作成
</div>

* 画像上でハイライト表示されているオブジェクトのいずれかをクリックすると、検索要素を素早く作成できます。新しい検索要素は、クリックしたオブジェクトと同じ種類になります。ツールバーの **Show Image Objects** ボタンで、ハイライト表示するオブジェクトを選択します。

<div id="highlight-objects">
  ### オブジェクトのハイライト
</div>

次の種類のオブジェクトをハイライト表示できます:

* **人**
* **組織**
* **住所**
* **位置**
* **日付**
* **期間**
* **金額**
* **認識済みの単語**

<Info>
  認識済みの単語を除き、これらのオブジェクトはすべて既定でハイライト表示されます。
</Info>

メニューから新しい検索要素を作成することもできます:

<Steps>
  <Step title="検索要素タブを開く">
    ドキュメントウィンドウ右側の **検索要素** タブに移動します。
  </Step>

  <Step title="要素タイプのリストを開く">
    **Create Element** をクリックします。
  </Step>

  <Step title="要素タイプを選択する">
    開いたリストで要素タイプを選択します。
  </Step>
</Steps>

要素を作成したら、**Properties** ペインでそのプロパティを設定します (詳細は「要素のプロパティ」を参照) 。

<Tip>
  これらのプロパティはコード形式でも表示および編集できます (詳細は「NLP の Extraction Rules アクティビティのコード構文」を参照) 。
</Tip>

<div id="search-element-types">
  ## 検索要素のタイプ
</div>

検索要素を作成する際は、検索対象となるオブジェクトに応じてタイプを指定する必要があります。利用可能な検索要素のタイプについて、以下に概要を示します。

<div id="person">
  ### 人
</div>

人物名の例: John Doe、Jane Smith。

<div id="organization">
  ### 組織
</div>

組織名。例：ABBYY、Acme Corp.

<div id="address">
  ### 住所
</div>

住所の例: 123 Main Str., Anytown AB 45678。

<div id="location">
  ### 位置
</div>

所在地名。例：Anytown、Corporate Place。

<div id="date">
  ### 日付
</div>

さまざまな形式の日付。例：2009年11月14日、11/14/2009。

<div id="duration">
  ### 期間
</div>

期間の例: 12（十二）か月、4日。

<div id="money">
  ### 金額
</div>

金額の例: \$2670.00、199 dollars 99 cents。

<Info>
  **人**、**組織**、**住所**、**位置**、**日付**、**期間**、および **金額** の各要素は、Named Entities (NER) アクティビティで設定可能な固有表現に対応しており、同一の技術で抽出されます。
</Info>

<div id="value-from-dictionary">
  ### 辞書からの値
</div>

辞書に含まれる単語または語句。辞書は、検索用のテキストのバリアントを1行に1つずつ列挙したプレーンなTXTファイルである必要があります。

<div id="value-from-regular-expression">
  ### 正規表現による値
</div>

指定した正規表現に一致する値。

<div id="text">
  ### Text
</div>

すべての語形を対象に検索したり、一定の認識エラーを許容したりできるオプションを備えたキーワードまたはフレーズ。

<div id="group">
  ### グループ
</div>

入れ子の検索要素の集合です。グループを構成する要素には、単純要素とグループ要素の両方を含めることができます。グループ要素自体には固有のプロパティはありません。データは、入れ子にされた検索要素の設定に基づいて抽出されます。

グループ要素は、要素の論理的な階層を構築して、デバッグやナビゲーションを容易にするために使用できます。

例えば、個人の氏名、住所、生年月日をひとまとめにグループ化すると、各人物に関するデータを一貫した方法で抽出できます。

<div id="repeating-group">
  ### 繰り返しグループ
</div>

この要素は、要素の繰り返しグループを検出するために設計されています。繰り返しグループは、あるエンティティに複数のインスタンスが存在し得るものの、その数が不明なケースを想定しています。各インスタンスのプロパティは、繰り返しグループの入れ子要素で指定します。

たとえば、履歴書を処理する場合は、「Education」という繰り返しグループを作成し、次の入れ子要素を含めます: "School\_name"、"Degree"、"Start\_date"、"Graduation\_date"。

一方、探しているデータが、異なる役割を持つ別個のエンティティに関係する場合は、繰り返しグループは適切ではありません。たとえば、契約当事者が買い手と売り手の2者のみであれば、1つの繰り返しの"Party"グループではなく、「Party1\_Buyer」グループと「Party2\_Seller」グループを作成します。

<div id="input-field">
  ### 入力 field
</div>

この要素を使用すると、別のアクティビティで抽出された field を、ルールの構成要素として利用できます。たとえば、Extraction Rules アクティビティの前に Segmentation アクティビティがある場合、検索範囲を絞り込むために一部のセグメントを活用できます。

<div id="change-an-elements-type-name-and-position-in-the-list">
  ## 要素の種類、名前、リスト内での位置を変更する
</div>

要素の種類を変更するには:

* 要素を右クリックし、ショートカットメニューで**要素を変換**を選択します。
* リスト内の要素を選択し、画像上のハイライト表示されたオブジェクトをクリックします。これにより、選択した検索要素をハイライト表示されたオブジェクトの種類に変換できます。ハイライト表示された認識済みの単語をクリックすると、検索要素を**Text**に変換すると同時に、その単語をこの検索要素のキーワード一覧に追加できます。
* 固有表現に対応する検索要素については、**Entities**プロパティを使用して固有表現の種類を変更します。

<Note>
  要素の種類を変更しても、非グループ要素をグループ要素へ、またはその逆に変換することはできません。
</Note>

要素の名前を変更するには:

* 要素を右クリックし、ショートカットメニューで**名前の変更**を選択して、新しい名前を入力します。
* 要素を選択し、その名前をクリック (または F2 を押す) して、新しい名前を入力します。

要素名には英字、数字、アンダースコアを使用できます。ただし、要素名を数字で始めることはできません。スペース、特殊記号 (.,:- \ /)、および予約語は使用できません。

リスト内の要素を移動するには:

* 要素をドラッグして上下に移動し、リスト内での位置を変更します。
* 要素をグループ要素にドラッグして、そのグループ内に配置します。

<Note>
  要素は上から下へ検索されます。つまり、ある要素の検索条件で使用される要素は、リスト内でその要素より前に配置する必要があります。
</Note>