メインコンテンツへスキップ画像のfieldでは、ドキュメントの一部を画像として保存できます。たとえば、本人確認用の写真、署名、印影などを扱う際に有用です。
画像のfieldは、Add Image のiconをクリックして追加できます。必要に応じて画像領域を追加します。ただし、画像のfieldは学習できません。画像のfieldを含む各ドキュメントについては、手動確認中またはCustom activityのスクリプトを使用して、該当する画像を特定し、その領域を設定する必要があります。
画像のfieldに複数の領域を設定することはできません。
- Field name。特定の Skill 内における field の一意の名前。Field name には、ピリオド、カンマ、スラッシュ、コロン、アスタリスク、クエスチョンマーク、引用符、不等号記号、山かっこ、または縦棒といった特殊文字を含めることはできません。Field name の最大長は 90 文字です。
- Required field。field の値を空にできないことを指定します。このプロパティを有効にすると、ページに検証ルールが追加されます。抽出後に field が空の場合、Document はエラー付きで手動確認に送られます。
- Allow multiple items。field に複数のインスタンスを持てることを指定します。たとえば、契約が複数の当事者によって署名されている場合、同じ Image field のインスタンスとしてすべての署名を抽出できます。
データをエクスポートする際、画像は領域座標に基づいて抽出され、JPG 形式で保存されます。画像には、他の抽出データと同様の方法でアクセスできます。
- Vantage API 経由
- Custom activity または Output activity（外部システム）のスクリプト内。Field オブジェクトには、ファイル名を保持する Value プロパティと、画像のバイナリ表現を保持する Image プロパティがあります。
- Output activity で設定した Shared Folder エクスポートの利用。ドキュメントに画像の field がある場合、ドキュメントデータを含む JSON ファイルは、該当する画像の field の value キーに各画像のファイル名を保存します。画像ファイルは、JSON ファイルと同じ名前のサブフォルダーに配置されます。
画像ファイル名は次の命名方式に従います。
- field から抽出された画像は、その field 名をファイル名として引き継ぎます。たとえば、画像の field 名が Signature の場合、生成されるファイル名は Signature.jpg になります。
- field に複数のインスタンスがある場合、各ファイル名にはアンダースコアで区切ったインスタンス番号の接尾辞が付きます。たとえば、signature の field に 2 つのインスタンスがある場合、ファイル名は
Signature_1.jpg と Signature_2.jpg になります。
- field がグループ、またはグループの入れ子構造の一部である場合、ファイル名にはアンダースコアを区切り文字として用い、画像 field へのフルパス全体を含めます。たとえば、signature の field が fields の Group2 グループの子で、さらにそれが fields の Group1 グループの子である場合、生成されるファイル名は
Group1_Group2_Signature.jpg になります。
注: この命名方式で作成したファイル名が 256 文字を超える場合（区切り文字、接尾番号、拡張子をすべて含む）、次の代替方式を使用します: Field_{Guid of image field}.jpg。
