如何把 CSV 匯入流程圖工具

運作方式

1. 打開檔案，看一看第一行

   用文字編輯器而不是 Excel 打開這個 .csv，因為 Excel 藏起來的正好就是會出事的那些東西。第一行必須是標題。把報表標題、產生日期那一行、標題上方任何空行，以及最底的合計列全部刪掉，然後儲存。

2. 把標題改成編輯器的欄名

   「形狀」、「方框文字」、「連線至」、「連線文字」、「連線樣式」、「橫向泳道」、「縱向泳道」、「平行於」、「備註」與「連結」。比對的是那些名稱，所以它們坐在甚麼次序無關緊要，而你沒有的欄乾脆缺席也可以。一個不屬於那些名稱的標題——「下一步」、「步驟類型」——會作為一個被忽略的多餘欄落地，而不是報錯，這正是為甚麼一條不見了的箭嘴幾乎一定是標題的問題。

3. 檢查分隔符與編碼

   一個由地區設定為歐洲的應用程式匯出的檔案通常是分號分隔的，而它到埗時整行都坐在一個欄裡。重新匯出並選逗號。順手另存為 UTF-8：由 Latin-1 或 UTF-16 過來，帶重音與非拉丁的標籤會變成亂碼，而重新匯出比把每一個標籤重打一次快。

4. 把每一個含有逗號的欄位用引號包起

   「連線至」與「連線文字」是住在單一欄位裡的逗號分隔清單，所以一個結構良好的檔案永遠會把它們包起——「20,18」與「購買方案,到期未付款」。任何以半形逗號寫成的「方框文字」也一樣。一個沒有引號保護的逗號會把那一列拆開，而它右邊的一切都落在錯的欄，卻沒有任何東西告訴你發生過這件事。

5. 把檔案拖到試算表區域，或者把文字貼進去

   開一張新圖表，然後把 .csv 拖到畫布下面的試算表區域，或者直接把 CSV 文字貼進去。不會出現精靈、欄位對應器或者欄位比對畫面；那些列會出現在表裡，而圖由它們渲染出來。如果你對這個檔案沒有把握，就先在一張草稿圖表上試一次。

6. 列一落地就檢查四件事

   一：列數等於檔案的行數減去標題。二：第 1 列是你的第一個步驟，不是你的標題文字。三：一個你本來就知道的「連線至」數字——那條往回指的最容易認出——落在你想要的那個步驟上。四：分支標籤坐在你預期的那些箭嘴上。由這一刻起，編輯那張表，不要再編輯那個檔案。

常見問題

有沒有匯入精靈或者欄位對應器？

沒有。有兩條路進去，而每一條都是一個動作：把 .csv 拖到畫布下面的試算表區域，或者把 CSV 文字貼進去。欄是按標題名稱比對的，所以沒有東西要設定，也沒有一個會做錯的欄位比對環節。當一個欄看上去甚麼都沒有做，原因是那個標題名稱，而不是你漏了甚麼設定。

QueryChart 用不到的欄要不要刪掉？

不用。不獲認得的欄會被帶過並忽略，所以一份帶著工單編號、時間戳記、一個成本中心與四個報表欄的匯出檔，可以原封不動地照著出來的樣子進去。留著它們不用付出任何代價，而且保住了回溯這些列來自哪裡的線索。唯一值得先做的欄位功夫，是把你確實想比對上的那幾個改名：「方框文字」、「連線至」、「連線文字」、「形狀」與兩個泳道欄。

我的檔案到埗時是單獨一個欄。發生了甚麼事？

分隔符不是逗號。由地區設定為歐洲的應用程式匯出的檔案通常是分號分隔的，而一個以 .csv 為副檔名儲存的定位字元分隔檔案表現一樣。請重新匯出並選逗號，而不是人手取代分隔符，因為「連線至」與「連線文字」放著的是逗號分隔清單，一次全域取代會把它們摧毀。順手另存為 UTF-8——一個錯的編碼顯示出來的樣子是標籤變成亂碼，永遠不會是一個錯誤。

那些列匯入了，卻沒有出現箭嘴。

「連線至」要麼是空的，要麼放著列號以外的東西。慣常的成因，是匯出檔的下一步欄承載的是來源系統自己的編號——STEP_014——而不是檔案裡的位置；或者是一個名稱沒有比對上的標題，那樣那個欄就作為一個被忽略的多餘欄落地。兩者都在那張表裡修：把列號打進「連線至」，箭嘴就隨著你打而出現。

之後可以再匯入這個檔案來更新圖表嗎？

沒有任何東西把圖表連回它所來自的那個檔案——沒有重新整理、沒有同步、也沒有連接器——所以再匯入一次是又一次貼上，而不是一次更新。把這件事當成一個只做一次的決定：匯入之後，圖表就是這條流程的定義，而那份匯出檔變成它當日樣貌的一個快照。如果來源資料真的每週都變，那它幾乎肯定是一份個案日誌而不是一份步驟定義，而只有步驟才屬於這張圖。