跳轉到主要內容
影像欄位可讓你將文件的部分內容儲存為影像。例如,在處理證件照片、簽名或圖章時會很有用。 你可以按一下 新增影像 圖示來新增影像欄位。如有需要,請新增影像區域,但請注意,影像欄位無法訓練。對於每一份包含影像欄位的文件,你必須在手動審核期間或使用 Custom activity 腳本來找到該影像並設定其區域。 影像欄位不得包含多個區域。

Image 欄位的一般屬性

  • 欄位名稱。在特定技能中欄位的唯一名稱。欄位名稱不能包含特殊字元,例如句點、逗號、斜線、冒號、星號、問號、引號、小於號、大於號或豎線符號。欄位名稱允許的最大長度為 90 個字元。
  • 必要欄位。指定此欄位的值不可留空。啟用此屬性會在頁面上新增一個驗證規則。如果擷取後欄位為空,該文件將會以錯誤狀態送交手動審核。
  • 允許多個項目。指定此欄位可以有多個實例。例如,如果一份合約由多方簽署,您可能會希望將所有簽名都作為同一個 Image 欄位的實例進行擷取。

使用擷取的影像

在資料匯出期間,系統會依照影像的區域座標擷取影像,並以 JPG 格式儲存。您可以與其他擷取的資料以相同方式存取這些影像:
  • 透過 Vantage API。
  • 在 Custom activity 或 Output activity(外部系統)指令碼中。Field 物件具有用來儲存檔案名稱的 Value 屬性,以及具有影像二進位表示形式的 Image 屬性。
  • 在 Output activity 中使用您設定的 Shared Folder export。如果文件具有影像欄位,包含文件資料的 JSON 檔案會在對應影像欄位的 value 索引鍵中儲存每個影像的檔名。影像檔案會放置在與 JSON 檔案同名的子資料夾中。

檔案命名

影像檔案名稱遵循以下命名規則:
  • 從欄位擷取出的影像會繼承該欄位名稱作為檔案名稱。例如,如果影像欄位名稱為 Signature,產生的檔名為 Signature.jpg
  • 如果某個欄位有多個實例,每個實例的檔名會在檔名後加上下劃線分隔的實例編號作為後綴。例如,如果一個簽名欄位有兩個實例,檔名將會是 Signature_1.jpgSignature_2.jpg
  • 如果該欄位是某個群組或群組巢狀結構的一部分,檔名將包含該影像欄位的完整路徑,並以下劃線作為分隔符。例如,如果簽名欄位是欄位群組 Group2 的子項,而 Group2 本身又是欄位群組 Group1 的子項,則產生的檔名將會是 Group1_Group2_Signature.jpg
注意: 如果依照此命名規則產生的檔名長度超過 256 個字元(包含所有分隔符、後綴數字以及副檔名),將會改用另一種命名規則:Field_{Guid of image field}.jpg

另請參閱