做這個功能之前我一直覺得“Excel導(dǎo)入”在進銷存軟件里是最吃力不討好的需求之一。天天有人喊著要說手工錄單太慢太容易錯可真把導(dǎo)入功能做出來了又有一批人根本不用寧可繼續(xù)一行一行敲鍵盤。我后來想明白了這兩個聲音其實都沒錯問題不在“要不要導(dǎo)入”而在“模板設(shè)計得好不好用”跟供應(yīng)商平時給的Excel對不上跟業(yè)務(wù)現(xiàn)場的填寫習(xí)慣對不上那功能就是個擺設(shè)。這次給時空智友的“采購入庫單”增加導(dǎo)入Excel模板的方式也是先把這句話掰扯清楚才開始動手。一套采購入庫單牽涉的不只是庫存數(shù)字還連著應(yīng)付賬款、采購成本、批次保質(zhì)期、財務(wù)憑證一步錯后面全是窟窿。本文把從需求分析、字段映射、模板制作到導(dǎo)入鏈路、踩坑排查的完整過程捋一遍給正在折騰ERP/進銷存系統(tǒng)導(dǎo)入功能的同學(xué)一個可以直接套用的思路。1. 從一筆三十行的入庫單說起手工錄入的賬目與時間成本1.1 一張普通入庫單背后的手工鏈路時空智友里的“采購入庫單”業(yè)務(wù)上不只是“貨到了登個記”這么簡單。供應(yīng)商送貨過來倉庫清點完得錄入商品、數(shù)量、單價然后這張單子會一路牽動庫存臺賬、采購明細、應(yīng)付暫估、成本核算。如果采購單是分批到貨的還要關(guān)聯(lián)原采購訂單做分單入庫反寫訂單執(zhí)行數(shù)量。這些聯(lián)動關(guān)系決定了入庫單的每一行數(shù)據(jù)都必須是干凈的。手工錄入時一條完整的鏈路大致是這樣先打開入庫單界面選供應(yīng)商、選倉庫、填日期然后在表體一行行加商品。商品通?？烤幋a或者助記碼搜索找到以后填數(shù)量再回填采購價。三十行的單子運氣好熟手也要半小時以上遇到?jīng)]建檔的新商品還要先停下來去貨品檔案里補資料。連鎖門店或者商貿(mào)公司一天的采購單如果有個五六張大半天時間就沒了手累眼累還容易把相近編碼的商品選錯把含稅價當(dāng)成無稅價填進去。這個痛點其實不用多講真正做業(yè)務(wù)的人都懂。但我在設(shè)計時提醒自己花的功夫不能只省掉“打字”這一步如果導(dǎo)入還得讓人先費勁整理Excel那同樣是徒勞。所以整個項目的目標(biāo)拆成了三條——導(dǎo)得進模板容易填、對得上字段映射清晰、錯得明白導(dǎo)入失敗時能快速定位。1.2 為什么不能只把Excel當(dāng)成“加速錄入”的工具有個容易被忽略的點采購入庫單導(dǎo)入Excel本質(zhì)上不是在給錄入員找一個快捷方式而是在給“數(shù)據(jù)產(chǎn)生方式”換一個源頭。供應(yīng)商的送貨清單、采購部的訂購明細、倉庫的驗收記錄很多本來就在Excel里流轉(zhuǎn)。如果到了入庫這一步還要脫褲子放屁重新打一遍等于把已經(jīng)電子化的數(shù)據(jù)又人工轉(zhuǎn)錄一次。轉(zhuǎn)錄這件事一次是省事兩次就是風(fēng)險源。而且入庫單的時效性影響很大。手工錄入總有延遲貨到了、賬還沒入庫存查詢不準(zhǔn)采購催單也不知道哪些訂單已經(jīng)履約。Excel導(dǎo)入縮短的不僅是錄入工時更是從“貨到”到“賬到”的時間差。但反過來也要承認一個現(xiàn)實有些企業(yè)嘗試過導(dǎo)入后來放棄了原因是模板設(shè)計得太“軟件化”字段全是系統(tǒng)內(nèi)部概念比如“存貨編碼”“倉庫內(nèi)碼”“業(yè)務(wù)類型”填的人根本不知道每個格子該寫什么。真正能長期跑起來的模板一定是從“供應(yīng)商/采購員手里的Excel長什么樣”出發(fā)再往系統(tǒng)字段上靠。2. 供應(yīng)商的Excel長什么樣先理解對方再設(shè)計模板2.1 別嫌對方格式亂要先接受現(xiàn)實我在項目啟動前做了一件看起來不太起眼的事找了幾家供應(yīng)商和內(nèi)部采購員把他們手上實際在用的Excel送貨單、采購明細表收集了一批。結(jié)果可以用“慘不忍睹”來形容——有從財務(wù)系統(tǒng)里導(dǎo)出的明細賬格式有倉庫手工維護的臺賬格式還有從對賬單里復(fù)制出來的混合格式。列名也是五花八門同一家公司這次發(fā)貨單叫“數(shù)量”下次就叫“發(fā)貨數(shù)”再下次直接是個沒表頭的。這個收集動作極其重要。因為一旦想清楚“導(dǎo)入模板最終是給誰填的”就會發(fā)現(xiàn)模板設(shè)計的第一約束條件不是數(shù)據(jù)庫字段而是使用者的認知習(xí)慣。做進銷存系統(tǒng)設(shè)計的常見錯誤是站在開發(fā)者視角設(shè)計一個“最規(guī)范”的模板結(jié)果一線人員要對照著供應(yīng)商的Excel手工轉(zhuǎn)置把數(shù)據(jù)從一個格子搬到另一個格子這跟直接錄單沒有本質(zhì)區(qū)別甚至還多一道工序。2.2 模板字段怎么定能不放的都不放不能少的必須精這一版模板我最終確定了一套“少而精”的字段方案共十二列。這么說吧模板列越少使用門檻越低錯誤率越低。但少不意味著該省的全全省了有五個字段是底線缺了導(dǎo)入就沒法落庫。模板列是否必填作用說明供應(yīng)商名稱或編碼必填定位供應(yīng)商檔案兩個都填時優(yōu)先編碼倉庫存放地名稱或編碼必填入庫的倉庫/門店多倉庫場景必須先落庫入庫日期必填默認填當(dāng)天但補錄上月單據(jù)時必用商品編碼必填系統(tǒng)內(nèi)商品的唯一識別不支持名稱識別數(shù)量必填入庫數(shù)量正數(shù)不允許負數(shù)和零含稅單價選填不填則取供應(yīng)商該商品最近一次采購價稅率%選填默認0按賬務(wù)要求填批次號選填啟用批次管理的商品必填生產(chǎn)日期選填涉及保質(zhì)期管理時使用到期日期選填有效期管理時使用采購訂單號選填用于關(guān)聯(lián)請購/采購訂單推單入庫備注選填原單信息、到貨說明等這里有兩個容易起爭議的設(shè)計我說明原因。一是“商品編碼必填、不支持名稱識別”。剛開始很多人覺得填名稱更方便但倉庫實際發(fā)貨單上商品的叫法常常不統(tǒng)一“伊利純牛奶250ml”和“伊利純牛奶箱”可能是同一個東西名稱匹配極易出錯。編碼是系統(tǒng)內(nèi)唯一的匹配永遠精準(zhǔn)這是寧可讓人多查一次編碼也要堅持的原因。二是“含稅單價可選填、不填則取上次采購價”。實際做采購入庫時很多時候單子上的價格跟上次一模一樣與其讓人反復(fù)翻舊賬不如默認帶出歷史價只要填單人確認過就沒問題。這算是在“少填”和“數(shù)據(jù)完整”之間找的平衡點。2.3 固定表頭就是一個穩(wěn)定的“數(shù)據(jù)邊界”確定字段后我把這套模板做成了兩種交付物一版是“空白模板”只有表頭和數(shù)據(jù)行預(yù)留區(qū)用于日常錄入另一版是“帶示例數(shù)據(jù)模板”前三行預(yù)填了幾條不同狀態(tài)的商品數(shù)據(jù)比如正常商品、啟用批次管理的商品、超量入庫觸發(fā)校驗的商品用來演示填寫規(guī)則。表頭行我固定在第1行數(shù)據(jù)從第2行開始而不是把說明文字放在表頭上面占幾行。因為解析Excel時“跳過N行表頭”是最容易出錯的環(huán)節(jié)有的業(yè)務(wù)員會在模板里加一行“請按規(guī)則填寫”再開始真正的表頭程序一旦沒跳過就會把說明文字當(dāng)字段名。固定規(guī)則就是把這個出錯的窗口直接堵死。模板里第一行固定是字段名第二行開始是數(shù)據(jù)誰改誰負責(zé)。3. 字段映射的精髓Excel列到入庫單的每一處對應(yīng)關(guān)系3.1 主表字段先定“這張單是誰的、從哪進、放哪、什么時候”時空智友的采購入庫單分主表和表體。主表記錄單據(jù)本身的信息一般包括供應(yīng)商、倉庫、單據(jù)日期、業(yè)務(wù)類型、制單人、備注等。Excel導(dǎo)入時主表的每個字段來源必須逐一對齊因為同一批數(shù)據(jù)里如果有多個供應(yīng)商或多個入庫日期程序要么拆單要么直接拒絕。我們定下的規(guī)則比較簡單粗暴單次導(dǎo)入只支持同一供應(yīng)商、同一倉庫同一天入庫如果Excel里混著兩家供應(yīng)商就提示“第幾行供應(yīng)商不一致請拆分文件后再導(dǎo)入”。寧可讓用戶多拆幾次文件也不要讓程序在后臺“聰明地”自動拆單——自動拆單的邏輯一旦判斷失誤很容易把倉庫和供應(yīng)商張冠李戴出了問題極難追溯。主表字段的映射邏輯是供應(yīng)商編碼或名稱取整列的最大重合值如果某一行跟其他行不一致就標(biāo)紅報錯入庫日期默認取當(dāng)天但Excel里填寫了日期就按填寫的來倉庫同理。制單人不需要填導(dǎo)入時取當(dāng)前登錄操作員。業(yè)務(wù)類型的默認值按系統(tǒng)配置走一般采購入庫就是“普通采購”特殊業(yè)務(wù)如“采購?fù)素洝辈辉谶@條導(dǎo)入通道處理避免業(yè)務(wù)邏輯復(fù)雜化。3.2 表體字段商品、數(shù)量、單價、稅率和批次的對應(yīng)細節(jié)表體字段是錯誤的高發(fā)區(qū)尤其要注意四個細節(jié)。第一個是數(shù)量。很多系統(tǒng)在數(shù)據(jù)庫里存的是基本單位數(shù)量而Excel里填的可能是輔助單位。舉個例子商品主單位是“箱”輔助單位是“罐”一箱24罐Excel里填“2箱”如果系統(tǒng)直接按數(shù)值入庫數(shù)量就錯了。我們采用的方案是模板里只允許填“基本單位數(shù)量”不做單位自動換算。雖然增加了填寫人的換算負擔(dān)但換來了結(jié)果的確定性不會出現(xiàn)“你以為填的是箱系統(tǒng)當(dāng)成了罐”這種哈希式錯誤。第二個是含稅單價的處理。模板里的“含稅單價”是給業(yè)務(wù)看的但入庫單明細里往往還會拆分出“無稅單價”和“稅額”。很多財務(wù)對單價的口徑極其敏感采購談的是含稅價入賬卻需要無稅價。我們不做自動換算而是采用“填寫時二選一”的方式填了含稅單價系統(tǒng)根據(jù)稅率自動推算無稅單價和稅額如果單獨填了無稅單價系統(tǒng)反推含稅價。兩列都填了但算出來不一致直接報錯不做“以某列優(yōu)先”的默認值。這個“不算就被逼著搞明白”的設(shè)計讓財務(wù)和采購在錄入時就確認口徑而不是等月底對賬再扯皮。第三個是稅率。模板里默認填0但實際上很多采購業(yè)務(wù)有13%、9%、6%等不同稅率。如果系統(tǒng)本身不帶稅率字段忽略這個問題也無所謂但時空智友的入庫單涉及采購結(jié)算和憑證生成稅率錯了應(yīng)付暫估和進項稅就全歪了。所以導(dǎo)入邏輯里稅率列留白時按主數(shù)據(jù)里該供應(yīng)商的默認稅率走填寫了則按填寫的校驗合法性。第四個是批次和有效期。啟用批次管理或保質(zhì)期管理的商品Excel模板里必填批次號生產(chǎn)日期和到期日選填。批次號碰撞時會限制同一商品同一批次在同一倉庫不能重復(fù)入庫因為真正做醫(yī)藥、食品、化工業(yè)務(wù)的人都知道批號是追溯的關(guān)鍵線索同批號分多次到貨是可以的但同一行的入庫不能憑空多出來一個根本不存在的批次。3.3 重復(fù)行、合并單元格和空行的“預(yù)處理規(guī)則”Excel導(dǎo)入最翻車的地方其實不在字段本身而在文件格式的“臟數(shù)據(jù)”。這次整理了一套明確的預(yù)處理規(guī)則規(guī)則如下整行為空的行直接忽略但處于中間位置的空行如果引起行號錯亂后續(xù)報錯提示會誤導(dǎo)人所以導(dǎo)入前先將空行物理刪除再把結(jié)果反饋給用戶。合并單元格在解析時只有左上角單元格有值其余全為空這會導(dǎo)致數(shù)量列大量被判為空值。開發(fā)解析時先“取消合并”重新計算每個單元格的值再做校驗。重復(fù)行不自動去重。去重要靠用戶業(yè)務(wù)判斷同一種商品分兩車到貨也是合理的系統(tǒng)不能替用戶決定。首列出現(xiàn)類似“合計”“總計”等文字時直接按冗余行跳過但不影響其他行的合法性判斷。這些規(guī)則我會在后面的“導(dǎo)入鏈路”章節(jié)給出具體實現(xiàn)思路。4. 導(dǎo)入鏈路實現(xiàn)解析、校驗、落庫與失敗回滾4.1 技術(shù)選型別糾結(jié)“要不要用組件”核心是容錯和日志實現(xiàn)Excel導(dǎo)入網(wǎng)上能抄的方案一抓一大把無非是用第三方庫讀文件再把行數(shù)據(jù)轉(zhuǎn)成實體對象。真正的復(fù)雜度不在讀文件而在“從文件到可落庫的合法數(shù)據(jù)結(jié)構(gòu)”這一段的完整性處理。我用方案時堅持了三個原則第一同時兼容xls和xlsx格式因為很多供應(yīng)商的老電腦還在用極老的Office版本第二讀取階段嚴格區(qū)分“單元格類型”文本、數(shù)字、日期、公式值都要轉(zhuǎn)成統(tǒng)一格式再進校驗避免數(shù)字單元格被解析成科學(xué)計數(shù)法文本第三所有讀取過程不得因為單個單元格解析異常中斷整個文件而是要記錄錯誤行號后繼續(xù)掃完最后一次性反饋。另外一個容易被新手忽略的是文件上傳的存儲路徑。很多實現(xiàn)直接把文件放在臨時目錄程序跑完就刪。但我們的做法是保留每次導(dǎo)入的原始文件和解析日志按日期歸檔。萬一后續(xù)有人問“當(dāng)時導(dǎo)的這個數(shù)怎么來的”能直接找到源頭文件這一點在財務(wù)審計時特別管用。這里我補充一個關(guān)于“是否預(yù)覽”的設(shè)計決斷導(dǎo)入過程分兩段第一段是上傳并解析預(yù)覽第二段是確認導(dǎo)入。Excel先解析出表頭和前幾行數(shù)據(jù)反饋到界面上讓用戶確認“列對沒對上、數(shù)據(jù)是不是想導(dǎo)的一批”再點“開始導(dǎo)入”正式落庫。多一步確認能攔截掉因為列錯位引發(fā)的整單錯誤。這在給門店操作員培訓(xùn)時特別關(guān)鍵他們能看到“誒這一列怎么跑到備注里去了”比自己事后翻庫存差異靠譜太多。4.2 三類校驗的順序格式校驗、業(yè)務(wù)校驗、沖突校驗導(dǎo)入時的校驗順序同樣有講究。我把校驗分成三層按順序執(zhí)行任一環(huán)節(jié)出錯就停止往下走。這樣做的好處是避免同一行數(shù)據(jù)既報“格式錯誤”又報“業(yè)務(wù)錯誤”讓使用者無從下手。第一層是格式校驗主要檢查必填列是否為空、數(shù)量是否為數(shù)字、日期是否符合實際格式、批次號是否超過指定字符長度。這一層是機械性檢查速度快能在文件解析后秒級完成。第二層是業(yè)務(wù)校驗主要檢查編碼是否存在、供應(yīng)商檔案是否停用、倉庫是否對應(yīng)該操作員的權(quán)限范圍、商品是否啟用了批次管理但未填批次號、稅率是否在合法枚舉值內(nèi)。這一層要查數(shù)據(jù)庫但也是明確了才能進行。第三層是沖突校驗跟前兩層不同它檢查的是數(shù)據(jù)之間的關(guān)系。比如同一文件內(nèi)商品編碼重復(fù)且數(shù)量相同——這很可能是同一批貨被復(fù)制了兩行系統(tǒng)不會直接判錯而是提示“可能存在重復(fù)數(shù)據(jù)請確認”。再比如批號對應(yīng)的生產(chǎn)日期不能晚于到期日這個也是常識性檢查。我把這三層校驗的結(jié)果匯總到一張“導(dǎo)入校驗報告”里用“行號-列名-原因”的方式列出所有問題同時在界面上標(biāo)注最大錯誤行數(shù)超過50行時直接整個文件拒絕防止用戶在幾百行錯誤里迷失。4.3 落庫與回滾一張單據(jù)要么完全成功要么完全失敗數(shù)據(jù)校驗通過后就到了落庫階段。這一階段的實現(xiàn)重點只有一個事務(wù)邊界。整個導(dǎo)入過程外部表現(xiàn)是“一張入庫單”內(nèi)部可能拆成主表插入、表體明細批量插入、批次更新、庫存數(shù)量變化、訂單執(zhí)行記錄反寫等好幾個步驟。這些步驟必須在一個數(shù)據(jù)庫事務(wù)里完成任何一個失敗都整體回滾。我在實現(xiàn)中特意做了兩件事一是落庫前把“校驗通過的數(shù)據(jù)快照”保存下來萬一會話斷掉、服務(wù)器異?？梢曰诳煺栈謴?fù)重試二是批量的數(shù)量做了拆捆處理每次寫庫100行不用一條一條insert但拆捆后任一批次失敗同樣全量回滾不允許出現(xiàn)“前100行成功、后100行失敗”的臟數(shù)據(jù)狀態(tài)。導(dǎo)入結(jié)果分三類統(tǒng)計成功數(shù)、失敗數(shù)、警告數(shù)。警告不影響落庫但會提示用戶關(guān)注比如供應(yīng)商上次采購價缺失、商品已經(jīng)停用但仍進貨等。導(dǎo)入完成頁不只給“成功多少行”這個結(jié)論還要允許一鍵把失敗明細和原因?qū)С龀尚碌腅xcel方便業(yè)務(wù)員拿回去核對修改后再導(dǎo)。這比在頁面上看一堆紅字友好得多。這里還有一點要強調(diào)導(dǎo)入不等于審核。入庫單導(dǎo)入后處在“已保存”狀態(tài)不代表庫存已經(jīng)生效。是否需要審核后再入賬按企業(yè)流程走可以由系統(tǒng)參數(shù)控制。但我會在“已保存”狀態(tài)和“已審核”狀態(tài)之間留一個明確的提示不給操作員混淆空間。5. 導(dǎo)入失敗的高頻原因與修復(fù)辦法5.1 數(shù)字格式陷阱單價、數(shù)量和Excel單元格的“臟類型”導(dǎo)入功能上線后測試過程里暴露最多的問題集中在這幾個場景。第一類是數(shù)字居然能錯。Excel單元格看起來是“11.10”解析出來卻變成“11.1”數(shù)據(jù)庫里保存的也是“11.10”顯示出來實際一樣但財務(wù)人員追求賬面兩列合計完全相等一旦有單價11.10元數(shù)量100的貨手工合計是1110.00系統(tǒng)是1110.00她就沒話說但如果單價是11.09數(shù)量是100手工一加是1109.00系統(tǒng)算出1109.02她就要找你麻煩了。這個問題不大但根本原因在于Excel把“11.10”這種數(shù)值存成了浮點數(shù)小數(shù)位誤差在那一刻出現(xiàn)。解決方式是解析階段對金額、數(shù)量列統(tǒng)一做“乘以100轉(zhuǎn)整數(shù)”或者使用固定小數(shù)位數(shù)截斷而不是直接用浮點數(shù)相加。第二類是格式偽裝成字符串的數(shù)字。比如從某系統(tǒng)導(dǎo)出的Excel數(shù)量列單元格左上角有個綠色小三角是文本型數(shù)字。文本型數(shù)字在大多數(shù)組件里能自動轉(zhuǎn)數(shù)值但有時帶不可見字符比如換行、空格一轉(zhuǎn)換就報“不是數(shù)字類型”。處理這類問題的通用招數(shù)是在解析時先Trim掉所有非可見字符再做類型轉(zhuǎn)換界面上的校驗提示也會寫明“第5行數(shù)量列存在空格”。5.2 商品編碼里的字母大小寫與前后空格商品編碼匹配失敗是最容易讓用戶崩潰的錯誤。很多商品編碼帶有字母供應(yīng)商發(fā)來的Excel編碼大小寫不一致、編碼前后多了一個空格、某些字符看著一樣實際是全角半角不同這些都能讓一對一匹配直接撲空。我在排查這類問題時發(fā)現(xiàn)一個規(guī)律用戶拿到的Excel很少是自己輸入的大多是從別的系統(tǒng)復(fù)制出來的復(fù)制過程中編碼列經(jīng)常被帶上格式尾巴。處理策略是三管齊下讀取時先做Trim和全半角統(tǒng)一匹配時優(yōu)先精確匹配、失敗后嘗試忽略大小寫二次匹配仍然失敗再嘗試去空格模糊匹配。但這里有一個原則系統(tǒng)匹配邏輯可以寬容落庫的編碼必須是規(guī)范檔案中的原始編碼不能把帶空格、改大小寫的拼接字符串寫進數(shù)據(jù)庫。還有一種更氣人的情況商品編碼里藏了肉眼看不見的零寬字符。這類字符在處理時用正則方案過濾掉否則你的導(dǎo)入日志里永遠不會告訴你“為什么這兩個編碼看起來一模一樣卻匹配不上”。5.3 日期格式與合并單元格的典型鬧劇日期列也是重災(zāi)區(qū)。Excel里的日期有三種形態(tài)真的日期類型、字符串格式“2024-01-15”、文本格式“2024/01/15”。如果解析時強行統(tǒng)一格式很容易出現(xiàn)“1900年1月15日”這種因為單元格格式錯誤而生成的錯誤日期。我們的規(guī)則是“按模板說明優(yōu)先使用YYYY-MM-DD”但解析時兼容常見分隔符遇到日期類型單元格則直接轉(zhuǎn)成標(biāo)準(zhǔn)字符串。合并單元格的坑比日期還隱蔽。某次演示中用戶發(fā)來的模板有合并單元格表頭下方兩行商品合并了導(dǎo)入后所有商品只來了第一行第二行數(shù)據(jù)全部消失。后來查是合并單元格的值只在左上角程序讀第二行對應(yīng)列時為null校驗時被判“數(shù)量為空”直接丟棄。前面預(yù)處理規(guī)則里“先取消合并再取值”就是為這個場景準(zhǔn)備的。程序邏輯上徹底斷絕合并單元格進入數(shù)據(jù)區(qū)這不是建議是必須。5.4 導(dǎo)入重復(fù)的“冪等”處理幫用戶擋住自己挖的坑上線試用后出現(xiàn)頻率最高的一個操作是同一份Excel導(dǎo)了兩遍庫存憑空翻倍。這種事基本無解——導(dǎo)入本身是合法操作系統(tǒng)判斷不了用戶是“就想重復(fù)入庫”還是“手滑又點了一次”。我們做的是四重防線導(dǎo)入界面上在提交按鈕旁邊給出“本次導(dǎo)入的行數(shù)及單據(jù)號碼”的二次確認同時生成一次性導(dǎo)入批次號每次導(dǎo)入成功后把該批次號關(guān)聯(lián)的單據(jù)明細保留在導(dǎo)入歷史里下次上傳時系統(tǒng)會自動比對“供應(yīng)商商品編碼數(shù)量批次號”四條完全一致的數(shù)據(jù)并提示“該文件與某次歷史導(dǎo)入高度相似是否確認繼續(xù)”如果用戶是正常補錄、歷史原因?qū)е碌恼Ｖ貜?fù)到貨則可以強制繼續(xù)最后從系統(tǒng)層面看操作記錄里會保全這次導(dǎo)入的賬號、時間、文件指紋。防重復(fù)導(dǎo)入這件事做多少層都不過分。業(yè)務(wù)數(shù)據(jù)的重復(fù)比數(shù)據(jù)缺失更麻煩因為缺失還能補重復(fù)往往要手動沖銷而沖銷又是一張新單據(jù)來來回回的賬目痕跡抹不干凈。6. 上線前的驗證清單與導(dǎo)入性能的優(yōu)化觀察6.1 三條必跑通的驗收用例正常、部分失敗、全部失敗功能開發(fā)完別急著全量開放先按我的經(jīng)驗把這三條用例跑通。第一條是正常路徑用完全符合規(guī)范的Excel導(dǎo)入100行驗證主表和表體數(shù)據(jù)、庫存數(shù)量、訂單反寫都準(zhǔn)確無誤。第二條是部分失敗路徑構(gòu)造一版有5行錯誤、95行正確的文件驗證錯誤提示是否能準(zhǔn)確定位到行和列以及導(dǎo)入成功部分是否和預(yù)期一致。第三條是全部失敗路徑構(gòu)造一個從第一行就缺必填列的文件驗證程序是否會干凈利落地拒絕并給出明確指引而不是導(dǎo)出一半卡死。另外還要做一次“格式破壞實驗”把.xlsx文件另存成.xls刪掉模板里的隱藏行或者加一列備注看程序是否還能正確識別列位置。很多導(dǎo)入實現(xiàn)其實很脆弱一旦模板的列位置變了就全部錯位這版模板特意支持了“列名定位”而不是“列序號定位”——只要表頭名稱對得上列的順序打亂也能導(dǎo)。這個特性在一次供應(yīng)商交付中被驗證了價值對方把備注放到了第二列系統(tǒng)仍然識別正確。6.2 大數(shù)據(jù)量與并發(fā)幾萬行導(dǎo)入會不會拖垮業(yè)務(wù)庫導(dǎo)入性能問題也要提前想清楚。普通商貿(mào)公司一次采購入庫100行就很多了但有些批發(fā)商、電商倉單次導(dǎo)入能達到5000行以上。代碼實現(xiàn)上如果是一次性把所有數(shù)據(jù)加載到內(nèi)存再批量寫庫幾百行沒問題5000行也可能沒問題但到了幾萬行時內(nèi)存和數(shù)據(jù)庫連接池的壓力就上來了。我實測下來比較穩(wěn)的參數(shù)是這樣單次導(dǎo)入限制2萬行以內(nèi)解析階段用流式讀取不把整個工作簿一次性載入落庫階段每500行一個批次BatchInsert事務(wù)內(nèi)所有批次執(zhí)行完后統(tǒng)一Commit任一批次失敗全量Rollback。2萬行的入庫單從上傳到導(dǎo)入完成整體耗時控制在10秒以內(nèi)如果超過這個數(shù)多半是主數(shù)據(jù)校驗里編碼匹配拖后腿得先優(yōu)化查詢而不是改導(dǎo)入代碼。這么做順便也把并發(fā)的坑解決了不限制導(dǎo)入端并發(fā)的話兩個人在同一時間導(dǎo)同一供應(yīng)商同一天的入庫單就可能出現(xiàn)主數(shù)據(jù)查詢和庫存扣減的競態(tài)問題。我的做法是在事務(wù)開始時對該供應(yīng)商和倉庫的組合加分布式鎖或數(shù)據(jù)庫行鎖避免重復(fù)寫庫存。聽起來復(fù)雜但真正遇到過一次“兩個人同時導(dǎo)入同一批貨庫存翻倍”的事故你就明白為什么非做不可。6.3 模板版本的管理Excel也是要“迭代”的模板這個東西從誕生第一天起就在被使用者改。今天張三把表頭文字改成了“供應(yīng)商名稱必填”明天李四把“數(shù)量”列挪了位置后天王五在中間插入了一列“物流單號”每次改動都可能導(dǎo)致導(dǎo)入“莫名其妙”失敗。我們的對策是在模板里放一個版本標(biāo)記比如“模板版本V3”程序解析時先讀取這個版本號跟當(dāng)前支持的版本比對不一致時直接報“模板版本不匹配請重新下載最新模板”。這個設(shè)計初期覺得“是不是有點小題大做”上線后卻成了降低客服咨詢量最有效的功能。沒這個標(biāo)記之前幾乎每周都有人在群里喊“導(dǎo)入不了”一問全是模板被改了。模板文件的下載入口要跟系統(tǒng)版本掛鉤后臺發(fā)布新模板時導(dǎo)入界面會提示“有新版模板可用”。舊模板也不是立刻作廢會保留一個過渡期這個過渡期里舊模板仍然能導(dǎo)但會在校驗結(jié)果上方顯示“當(dāng)前使用的模板版本較低建議升級”等過了一個月再強制禁用舊版。這樣既照顧了不常導(dǎo)人的使用習(xí)慣也控制了模板演化帶來的導(dǎo)入錯誤率。6.4 上線后的真實感受誰在用誰不用為什么功能上線兩周后我抽看了導(dǎo)入日志。用得最勤的還真是之前手工錄單最慢的兩個倉庫一個月導(dǎo)了六十多單平均每單導(dǎo)入加確認不到一分鐘。但也有一些操作員基本不用點開導(dǎo)入一次發(fā)現(xiàn)要填模板就關(guān)掉了。后來聊了下不是功能難用是他們習(xí)慣了在錄入界面里邊搜邊填邊填邊看到貨單一個界面能完成所有事。Excel導(dǎo)入讓他們“看不到一張正在生成的單據(jù)”心理上不踏實。這個反饋讓我意識到導(dǎo)入功能不是用來“替代”手工錄入的而是給不同工作習(xí)慣的人多一條路。老員工可以繼續(xù)手工錄年輕人可以批量導(dǎo)最后形成的日報、庫存、應(yīng)付數(shù)據(jù)是完全一致的。這才是一個倉庫版塊真正落地的狀態(tài)功能多做一點不虧但別指望它讓所有人改變習(xí)慣。最后提醒一句工具做得再好也得有人在每次大版本更新后重新下載最新模板。模板版本這件事我一定會寫進SOP讓新人第一天就知道“先看模板版本再談導(dǎo)入”。