如何為流程圖整理 CSV 檔案結構

運作方式

1. 匯出一張乾淨的表格

   無論資料來自哪一套系統，只匯出那個格線，其他一概不要。報表標題、一個日期戳記、一行標誌、合併的標題、小計列與最底一行空行，全部都會變成檔案裡的一行，而每一行都會被讀成一個步驟。如果匯出功能有「原始資料」或者「不含格式」的選項，那就是要選的那個。

2. 令標題列成為第一行

   用文字編輯器而不是試算表打開這個檔案，看一看第一行。它必須是標題。開頭有兩三行中繼資料的匯出檔常見到值得把這件事放在第一個檢查，而刪掉那幾行就是全部的修法。

3. 把標題改成 QueryChart 的欄名

   把標題儲存格設為「形狀」、「方框文字」、「連線至」、「連線文字」、「橫向泳道」與「縱向泳道」。比對是按名稱做的，所以這些欄可以是任何次序，而你自己的欄——工單編號、系統、周期時間——可以原封留在檔案裡；它們會被帶過並忽略，而不是被拒絕。

4. 把那些列收攏成一個步驟一列

   一份匯出檔通常是一份日誌：一張工單、一條訂單、一宗個案一行。一張流程圖需要的是一個不重複的步驟一行，所以先做一次樞紐分析或去除重複，並把數量留待日後分析。一個四千行的檔案是一份資料集，不是一條流程，而匯入它會得到四千個方框。

5. 為步驟編號並填「連線至」

   「連線至」放的是目標行以 1 起計的位置，而且只數資料行，所以標題下面第一個步驟是 1。它不是工單編號、步驟代碼，也不是來源系統的任何東西。一個步驟通向兩處時，把兩個數字放進同一個欄位並以逗號分隔，再把那個欄位用引號包起。

6. 修好分隔符與編碼，然後把檔案拖進去

   以逗號分隔的 UTF-8 儲存，然後把 .csv 拖到一張新圖表的試算表區域。把第一次渲染當成對這個檔案的一次檢查：列數應該與你的步驟數相符，而每一個欄都應該落在你預期的位置。一個到埗時變成一個很闊的單欄的檔案，是分隔符的問題，不是匯入失敗。

常見問題

我的 CSV 裡欄的次序要緊嗎？

不要緊。比對是按標題名稱做的，所以「方框文字」可以是第四個欄，「形狀」可以是最後一個。要緊的是那些名稱正是編輯器所用的那幾個——「形狀」、「方框文字」、「連線至」、「連線文字」、「橫向泳道」、「縱向泳道」——並且它們坐在檔案的第一行。QueryChart 不認得的欄會被帶過並忽略，所以不需要事先把你的工單編號、系統或時間欄剔走。

這個檔案應該用哪個分隔符與編碼？

逗號與 UTF-8。分號是慣常的失敗原因：在一部地區清單分隔符為歐式的機器上，Excel 的「CSV」是分號分隔的，而這個檔案匯入之後就是單獨一個欄。編碼問題顯示出來的樣子是帶重音的字元變成亂碼——請另存為「CSV UTF-8」而不是普通 CSV。如果除了第一個欄以外全部都對應到了，就懷疑是一個位元組順序標記：它在編輯器裡隱形，卻附在第一個標題名稱上，於是那個名稱再也比對不上。

含有逗號的欄位該怎樣寫？

把整個欄位用雙引號包起，例如一個寫成 6,18 的「連線至」值。一個引號本身出現在被引號包起的欄位裡時，寫成兩個引號。被引號包起的欄位裡放換行也是合法的，不過一個方框標籤很少需要。連接那兩個欄幾乎一定需要引號，因為「6,18」與「已收到回覆,沒有回覆」按設計本來就含有那個分隔符——正是它把標籤與目的地配起對來。

我的匯出檔是一張工單一列，不是一個步驟一列。可以用嗎？

不能直接用。一份交易日誌描述的是發生了幾千次的事；一張流程圖描述的是本來應該發生一次的事。先把它收攏成不重複的步驟——通常按活動欄或狀態欄做一次樞紐分析就夠——並把數量另外保存，因為那是一次流程分析裡有趣的另一半。/yue/guides/csv轉流程地圖 在一份形狀完全相同的匯出檔上走了一次這個收攏過程。

到底哪些欄是必需的？

單有「方框文字」就匯入得到：你會得到一直行互不相連的方框。加上「連線至」，它就成為一張流程圖，因為那是承載關係的欄。「形狀」、「連線文字」與兩個泳道欄屬於精修——判斷畫成菱形、分支加上標籤、步驟歸入階段與負責人。如果你寧願由一個已經結構正確的檔案開始，/yue/templates/csv轉流程圖 就是一張可用圖表連同它背後的那些列。