上傳記錄

基準產品提供從檔案上傳資料的背景處理。批次控制外掛導向檔案上傳範本 (F1-PDUPL) 可以當作範本。此處理包含參數來設定要上傳之檔案的檔案路徑和檔案名稱，以及其他參數來控制如何處理遺漏檔案以及在處理之後如何重新命名檔案。如需詳細資訊，請參閱批次控制及其參數的描述。

此背景處理需要外掛點檔案上傳中插入的演算法。會為指定的檔案呼叫此外掛一次。批次處理會開啟該檔案，並將檔案讀取器元素傳遞到演算法。與批次控制相關聯的演算法則負責使用提供的 API 讀取檔案內容，並將資料儲存至適當的資料表 (例如，適當的暫存資料表中)。基準提供的處理支援上傳多個檔案，且可以透過多執行緒方式執行來處理多個檔案。每個檔案都是透過對「檔案上傳演算法」進行一次呼叫來處理，並對指定檔案中上傳的記錄支援單一確認。

備註：為實作此演算法類型所編寫的外掛指令檔必須使用 Groovy 指令檔引擎版本，因為無法使用 XPath 指令碼語言存取 API。如需詳細資訊，請參閱伺服器指令檔的其他編碼選項。

請注意，資料上傳的這個步驟只是典型上傳端對端處理的一部分。在產品中，此步驟有時稱為「處理 X」。此步驟的目標是將檔案中的記錄放入資料庫記錄，只需要進行最少的驗證和處理即可完成。資料應該儲存在接著由第二個步驟 (在產品中，通常稱為「上傳」步驟，例如「付款上傳」) 處理的記錄中。第二個步驟與此處所述的外掛導向批次處理無關，它負責驗證資料，應該可以由個別記錄進行執行緒處理，並具有適當的個別記錄錯誤處理。請注意，根據所上傳資料的類型，產品可能已提供外掛導向上傳處理可植入的適當資料表。這些可以是暫存資料表，例如付款上傳階段。或者，它們可能是具有業務物件的記錄，這些業務物件的生命週期是設計處理上傳的資料，例如業務標誌。在這種情況下，產品通常會提供立即可用的背景處理來驗證和進一步處理資料，以及完成上傳。如果要上傳的資料還沒有基準提供的暫存資料表，請務必與實作小組合作，以識別要用於外掛導向批次上傳的適當資料表。此外，也請確認第二個步驟的設計，第二個步驟負責資料的詳細驗證和完成。

產品會提供範例演算法，以說明如何呼叫提供的 API 來處理不同類型的來源資料：逗號分隔、固定位置和 XML。在所有情況下，上傳所支援的範例資料都會使用「度日」資訊來說明處理。系統會提供範例目標記錄 (根據「事實」維護物件)，以說明根據輸入資料儲存記錄的步驟。請注意，只提供範例外掛指令檔。未設定演算法、演算法類型或批次控制來使用範例外掛指令檔。若要檢視指令檔，請導覽至指令檔頁面，並搜尋指令檔類型外掛指令檔和演算法實體批次控制 - 檔案上傳，然後尋找「範例」指令檔。

請注意，產品所提供的範例外掛指令檔是提供來說明如何使用提供的 API。您不應該將它們視為如何實作實際使用案例之外掛指令檔的範本。下列是強調設計檔案上傳演算法時要考慮的幾點：

  • 錯誤處理/解決。範例外掛指令檔執行一些與資料相關的基本錯誤處理，以說明錯誤處理。不過，任何在此步驟中發現的錯誤都需要停止整個檔案的處理。因此，此外掛應該只報告無法修正的錯誤，但在此情況下應該拒絕整個檔案。如果資料中有可調整的錯誤，則建議不要在此步驟檢查這些錯誤。相反地，此外掛應該僅植入適當的暫存資料表，並讓下一個步驟檢查有效性。如上所述，下一個步驟應該包含標示個別錯誤記錄的功能，讓使用者修正資料並重試。

  • 目標資料表。範例外掛指令檔使用「事實」作為所產生插入陳述式的目標。如上所述，必須仔細考量儲存上傳資料之位置的決策。可能已有所指定使用案例特定的現有資料表。如果所上傳的資料沒有現有資料表可供使用，請複查產品以確認哪些現有資料表可能有用，例如「內送同步要求」或「服務任務」。請確定選擇的資料表支援錯誤處理，能立即可用，或是透過設計適當的業務物件，其具有支援錯誤狀態和解決錯誤功能的生命週期。另請注意，「範例純文字檔上傳」外掛說明標頭記錄/明細記錄案例。在此情況下，標頭記錄會透過 CLOB 元素連結至下階記錄。不建議使用此技術。在實際使用案例中，標頭記錄應該透過不同的資料庫資料欄連結至下階記錄，以允許搜尋。

設定新的處理

下列各點彙總實作新的檔案上傳背景處理所需的步驟：

  • 驗證上傳檔案中資料的詳細資料，並將資料對應至系統中一或多個適當資料表的欄位。

  • 設計讀取記錄詳細資料所需的邏輯，並識別可適當地建立插入陳述式來儲存資料的每筆記錄。產品所提供的範例外掛指令檔會說明如何使用各種可供使用的 API。建立外掛指令檔，其中演算法實體為批次控制 - 檔案上傳。為此外掛指令檔建立適當的演算法類型和演算法。

  • 透過複製基準範本建立批次控制。插入上面建立的演算法，並視需要設定參數。請注意，如有必要，您可以在批次控制上設定自訂特設參數。檔案上傳演算法可使用基準和自訂批次參數值。