從共用資料夾匯入文件

ABBYY Vantage 讓您能從託管於 Vantage 伺服器上的共用資料夾上傳文件。 對該資料夾的存取是透過 SFTP 通訊協定進行。已建立資料夾的存取詳細資訊（例如匯入與例外資料夾的連結，以及用於存取這些資料夾的登入帳號與密碼）會顯示在 Input Settings: Shared Folder 對話方塊中。

重要！ 要將檔案上傳到輸入共用資料夾，必須在 SFTP 用戶端中使用二進位傳輸模式。

一旦該 skill 已發佈，ABBYY Vantage 會開始每 20 秒檢查一次該資料夾中是否有新檔案。

提示： 匯入代理程式一次最多可以擷取 30 個檔案。如果將檔案上傳到 SFTP 資料夾成為效能瓶頸，請考慮建立兩個各自具有專屬 SFTP 資料夾的 skill。這樣即可讓兩個代理程式同時擷取檔案。

來源類型 (FolderImport) 和來源檔案名稱會儲存在文件註冊參數 SourceType 和 SourceFileName 中。若在 技能監控 的交易區段中新增相應欄位，即可存取這些參數的值。它們也會匯出到輸出 JSON 檔案中，此檔案包含完整的資料擷取結果，並可在 Output 活動的 Exported Data 區段中進行設定。

注意： 以下字元不允許出現在檔案名稱中，且在上傳時會被底線字元（_）取代：/ : ? # [ ] @ ! $ & ' ( ) * + , ; = \。原始檔案名稱會儲存在文件註冊參數中。您可以使用此指令碼來擷取它們。

如果檔案成功匯入，會為該檔案建立一個處理作業，隨後該檔案會從匯入資料夾中刪除。若檔案無法匯入且未為其建立任何處理作業，則會被移動至名為 <Input folder name>-exception 的例外資料夾。例外資料夾的位置在 Input Settings: Shared Folder 對話方塊中指定。例外資料夾中檔案的儲存期間由保留原則決定，預設為 2 週。 如果檔案已不在匯入資料夾中，但找不到任何處理結果，這可能是因為處理作業在發生錯誤的情況下已完成。關於處理作業錯誤的更多詳細資訊可以在技能監控中找到。欲了解更多資訊，請參閱技能監控的「交易」章節。 Vantage 可以從共用資料夾的根目錄匯入壓縮檔。目前支援以下檔案類型：

• 在 Windows 中建立的 ZIP 檔，
• 在 Linux 中使用 tar czvf 指令建立的 TAR GZ 檔。

重要！ 僅在選取 Single file 匯入方式時，才能匯入壓縮檔。

壓縮檔大小上限為 3 GB。壓縮檔中每個檔案的大小上限為 100 MB。 系統會為每個壓縮檔建立一個新的處理作業。壓縮檔中的所有檔案隨後都會成為此處理作業的文件。壓縮檔名稱會儲存到文件註冊參數 SourceArchiveName 中。 如果壓縮檔類型不受支援，或壓縮檔包含不受支援的檔案類型和/或壓縮檔，相應的處理作業將會失敗。 如果超出檔案大小限制，或壓縮檔包含子資料夾，該壓縮檔將會被移動到例外資料夾中，且不會建立任何處理作業。之後可以在錯誤記錄中檢視對應的錯誤。 預設情況下，Vantage 會對從共用資料夾匯入的每個檔案分別建立一筆交易。您可以將 Import method 設為 From subfolder 來變更此行為。在此模式下，Vantage 會在共用資料夾中尋找子資料夾，而不是直接尋找檔案。子資料夾的名稱必須符合指定的命名規則。當找到符合條件的子資料夾時，該子資料夾中的所有檔案（包括其巢狀子資料夾中的檔案）都會作為單一交易的文件加以匯入。子資料夾名稱會儲存到每個文件的 SourceFolderName 文件註冊 Parameter 中。

Note: 如果檔案是從子資料夾內的巢狀資料夾匯入的，則 SourceFolderName Parameter 中只會包含最上層子資料夾的名稱。

如果子資料夾無法匯入，它會被移至 Exceptions 資料夾。Vantage 不會為其建立交易，並且會產生一則錯誤，您可以在 Skill Monitor 服務的錯誤記錄（Error Log）中查看。 如果子資料夾中包含不受支援格式的檔案，對應的交易將會失敗。

Important! 不支援從子資料夾匯入壓縮檔。

名稱符合命名規則的空子資料夾會從共用資料夾中刪除，但 Vantage 不會為其建立交易，並且會產生一則警告，指出無法匯入任何資料。您可以在 Skill Monitor 服務的錯誤記錄（Error Log）中查看這則警告。 只有當子資料夾名稱符合子資料夾命名規則時，才會被匯入。預設值「*」會比對任何字串。您可以使用 * 符號作為遮罩，代表任意數量的字元來設定規則。「?」字元不支援作為單一字元的佔位符。遮罩比對不區分大小寫：例如「subfolder」與「SUBFOLDER」都會符合「subfolder」遮罩。遮罩長度上限為 64 個字元。 為了避免可能的檔案存取衝突，請先將檔案複製到子資料夾，之後再依照命名規則重新命名該子資料夾。

1. 在文件處理流程中，左鍵按一下 Input 活動區塊。若尚未在 Skill Designer 中新增該區塊，請使用 Activities 面板新增。
2. 在 Actions 面板中，勾選 Select additional source 選項，並選取 Shared folder。

3. 按一下 Settings。這會開啟一個對話方塊，用於設定共用資料夾的存取詳細資訊。

您也可以修改建議的匯入資料夾名稱。 資料夾名稱必須符合下列條件：

• 在該 skill 中必須是唯一的（不能與 Output 活動區塊中另一個共用資料夾的名稱相同）。
• 必須以數字或字母開頭。
• 不得包含特殊字元 : * ? " < > / | \ 或控制字元（例如換行與定位字元）。
• 結尾不得為點號。
• 不得為空白。
• 不得超過 64 個字元。

4. 如有需要，將 Import method 變更為 From subfolder，並依需求（如有）調整 Subfolder naming scheme。
5. 使用 SFTP 用戶端，利用 Input Settings: Shared Folder 對話方塊中提供的登入詳細資訊，設定將檔案匯入至該資料夾。按一下對應欄位中的複製 icon，即可將每個欄位的內容複製到剪貼簿。資料夾連結包含設定連線所需的所有資料。將該連結貼上至 SFTP 用戶端設定對話方塊中，即可自動填入其他參數。
6. 若需儲存變更，請按一下 Save 以關閉對話方塊；若不需儲存變更，請按一下 Cancel 關閉對話方塊。

重要！ 對設定所做的任何變更，僅會在您的 skill 發佈之後才會生效。

系統管理員可以使用技能監控來停用文件匯入。詳情請參閱 技能監控。停用文件匯入並不會影響透過 API 匯入至此 skill 的文件。 當刪除某個 skill 時，共用匯入資料夾也會從伺服器中刪除。