> ## 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.

# Image field

> 文書から画像領域（署名、印影、顔写真）を抽出し、エクスポート時の画像の保存方法を設定します。

Image fieldを使用すると、文書の一部を画像として保存できます。たとえば、顔写真、署名、印影などです。

<div id="add-an-image-field">
  ## Image フィールドを追加する
</div>

ツールバーの **Add Image** をクリックします。データ フォームに新しい Image フィールドが表示されます。

<Warning>
  Image フィールドは学習できません。Image フィールドを含む各ドキュメントでは、[手動確認](/ja/vantage/documentation/runtime/manual-review/manual-review) で、または [カスタムアクティビティ](/ja/vantage/documentation/skill-designer/process/custom-activity) スクリプトを使用して、画像領域を設定する必要があります。
</Warning>

<Note>
  Image フィールドには複数の領域を設定できません。複数の画像を抽出するには、**Allow multiple items** を有効にして、インスタンスごとに 1 つの画像を追加します。
</Note>

<div id="general-properties">
  ## 一般プロパティ
</div>

| プロパティ        | 説明                                                                |
| :----------- | :---------------------------------------------------------------- |
| **field 名**  | Skill 内で一意である必要があります。使用できない文字: `. , / : * ? " < > \|`。最大長: 90 文字。 |
| **必須 field** | 有効にすると、抽出後に field が空の場合、ドキュメントはルール エラーとともに手動確認に送られます。             |
| **複数項目を許可**  | field が複数のインスタンスを持てるかどうかを示します (たとえば、契約書の各当事者の署名を個別の画像として抽出する場合) 。 |

<div id="access-extracted-images">
  ## 抽出された画像へのアクセス
</div>

データのエクスポート時に、Vantage は各画像をその領域座標に基づいて抽出し、JPG として保存します。抽出された画像には、他の抽出データと同じ方法でアクセスできます。

* **Vantage API** — 抽出された画像を他の field 値とあわせて取得できます。
* **Custom activity または Output アクティビティ のスクリプト** — [Field](/ja/vantage/documentation/skill-designer/process/custom-activity/field) オブジェクトでは、`Value` (ファイル名) と `Image` (バイナリコンテンツ) を利用できます。
* **Shared folder エクスポート (Output アクティビティ) ** — JSON エクスポートには、各画像 field の `value` キーに画像ファイル名が含まれます。画像ファイルは、JSON ファイル名と同じ名前のサブフォルダーに配置されます。

<div id="file-naming">
  ### ファイル名の付け方
</div>

エクスポート時、Vantage は各画像ファイルの名前を、field とその Skill 階層内での位置に基づいて決定します。

| field 構成                                           | ファイル名                                |
| :------------------------------------------------- | :----------------------------------- |
| 最上位レベルの field `Signature`                          | `Signature.jpg`                      |
| `Signature` の複数インスタンス                              | `Signature_1.jpg`, `Signature_2.jpg` |
| `Group1` > `Group2` 内で `Signature` としてネストされた field | `Group1_Group2_Signature.jpg`        |

<Note>
  生成されるファイル名が 256 文字 (区切り文字、インスタンス番号、`.jpg` 拡張子を含む) を超える場合、Vantage は `Field_{guid}.jpg` を使用します。ここで、`{guid}` は画像 field の GUID です。
</Note>

<div id="related-topics">
  ## 関連項目
</div>

* [カスタム アクティビティ](/ja/vantage/documentation/skill-designer/process/custom-activity/custom-activity)
* [Output アクティビティ](/ja/vantage/documentation/skill-designer/process/output-activity/output-activity)
* [Skill Designer でドキュメントにラベル付けする](/ja/vantage/documentation/skill-designer/document/labeling-documents)
* [フィールドを追加する](/ja/vantage/documentation/skill-designer/document/adding-fields/adding-fields)