如何把 CSV 匯入流程圖工具
如何在沒有精靈的情況下把一個 CSV 匯入流程圖工具：把檔案拖到試算表區域或把文字貼進去、按標題名稱比對，再檢查那四件說明列已經正確落地的事。
一個 CSV 有兩條路進去——把檔案拖到畫布下面的試算表區域，或者把 CSV 文字貼進去——而那些欄是按標題名稱而不是按位置比對的。
簡而言之
- 兩條路進去：把 .csv 拖到試算表區域，或者把 CSV 文字貼進去。
- 欄是按標題名稱而不是按位置比對的，所以匯出的次序無關緊要。
- 不獲認得的欄會被帶過並忽略——你匯出檔裡的編號與時間戳記留著就好。
- 第一行會被讀成標題，所以上面那個報表名稱必須先刪掉。
- 「連線至」放的是列號，所以那些列在檔案裡的次序也是資料的一部分。
由檔案到畫布之間發生了甚麼
沒有匯入精靈。一個 .csv 進入 QueryChart 只有兩種方式：把檔案拖到畫布下面的試算表區域，或者用文字編輯器打開它、選取那些文字，再貼進那張表。兩者走的是同一條路——第一行讀成標題，之後每一行變成一列——而圖就隨著那些列落地即時渲染。沒有任何東西要求你對應欄，因為標題名稱已經做了這件事。
比對是按標題名稱而不是按欄的位置做的：「形狀」、「方框文字」、「連線至」、「連線文字」、「連線樣式」、「橫向泳道」、「縱向泳道」、「備註」、「連結」。你的匯出檔可以按任何次序吐出它們。QueryChart 不認得的欄——工單編號、時間戳記、一個成本中心、兩年前有人為了一份報表加上去的那三個欄——會被帶過並忽略，所以匯入之前把檔案削減一輪，是你不必做的功夫。欄本身的設計在 /yue/guides/流程圖csv檔案結構 有交代。
CSV 與由試算表貼過來的分別，在於一個 CSV 是純文字檔，而文字檔帶著它自己那一套失敗方式。分隔符可能是分號而不是逗號，因為一個地區設定為歐洲的應用程式匯出來的正是這樣。編碼可能不是 UTF-8，那樣的話帶重音與非拉丁的標籤到埗時就是亂碼。一個含有逗號的欄位必須用引號包起，否則它會裂成兩個。而一份由報表工具匯出的檔案，通常在標題上方先來一個報表名稱與一個產生日期——檔案的第一行就是標題，所以那幾行必須刪掉。
下面的示例是一段 SaaS 由試用到續約的旅程：26 列、六個判斷、三個被剔除的結局，以及一條由第 7 日提醒回到設定的迴路。打開下面的試算表面板，看住每個階段填的是哪幾個欄，因為那正是一個匯入檔案的欄該按甚麼次序去要緊——而最後那兩個，正是大部分匯出檔已經以另一個名字帶著的。完成的圖表與產生它的那些列在 /yue/templates/csv客戶旅程地圖。
一份 26 列的匯出檔落入編輯器
這份客戶旅程 CSV 的四個階段：先到的是甚麼、連接那兩個欄加了甚麼、兩個泳道欄又加了甚麼。打開試算表面板讀它們。
那些列按檔案次序到埗
匯出檔的四行變成第 1 至 4 列：作為 Start 的「由推廣活動或搜尋到達網站」，然後「記錄來源、推廣活動與到達頁」、判斷「訪客是否開始試用？」，以及作為 End 的「在試用開始前離開」。落地的只有「方框文字」與「形狀」，所以有方框而沒有箭嘴。那些列號就是檔案次序——檔案的第 2 行是第 1 列，因為第 1 行是標題。
「連線至」填出箭嘴
試用那一段的列到齊，連接也一併跟著來。第 10 列「首個關鍵動作是否在 7 日內完成？」在同一個「連線至」儲存格裡放著三個數字——13、11 與 12——而第 11 列「寄出第 7 日的設定提醒並附上預約連結」指回 9，一條迴路就是這樣寫的。那些是檔案裡的位置，所以在這個欄填好之後才把匯出檔重新排序，正是一次匯入壞掉的原因。
「連線文字」為每個出口加上標籤
第 17 列「試用是否在到期前轉化？」把「連線至」的 20,18 與「連線文字」的 購買方案,到期未付款 配成一對，按位置對應，第一個配第一個。兩個欄都是住在單一欄位裡的逗號分隔清單，這正是一個 CSV 寫入器非把它們包起不可的原因。不加引號的話，那個標籤就是兩個欄位，而它右邊每一個值都會落錯一格。
兩個泳道欄
「橫向泳道」承載旅程階段——認知、試用、啟用、轉化、留存——而「縱向泳道」承載負責人：客戶、市場推廣、產品、銷售與客戶支援。大部分匯出檔本來就以別的名字帶著這兩樣：一個階段欄與一個負責人欄。所以這張圖的泳道版本，代價只是標題那一行改個名，而不是任何新資料。
運作方式
打開檔案，看一看第一行
用文字編輯器而不是 Excel 打開這個 .csv，因為 Excel 藏起來的正好就是會出事的那些東西。第一行必須是標題。把報表標題、產生日期那一行、標題上方任何空行，以及最底的合計列全部刪掉，然後儲存。
把標題改成編輯器的欄名
「形狀」、「方框文字」、「連線至」、「連線文字」、「連線樣式」、「橫向泳道」、「縱向泳道」、「備註」與「連結」。比對的是那些名稱，所以它們坐在甚麼次序無關緊要，而你沒有的欄乾脆缺席也可以。一個不屬於那些名稱的標題——「下一步」、「步驟類型」——會作為一個被忽略的多餘欄落地，而不是報錯，這正是為甚麼一條不見了的箭嘴幾乎一定是標題的問題。
檢查分隔符與編碼
一個由地區設定為歐洲的應用程式匯出的檔案通常是分號分隔的，而它到埗時整行都坐在一個欄裡。重新匯出並選逗號。順手另存為 UTF-8：由 Latin-1 或 UTF-16 過來，帶重音與非拉丁的標籤會變成亂碼，而重新匯出比把每一個標籤重打一次快。
把每一個含有逗號的欄位用引號包起
「連線至」與「連線文字」是住在單一欄位裡的逗號分隔清單，所以一個結構良好的檔案永遠會把它們包起——「20,18」與「購買方案,到期未付款」。任何以半形逗號寫成的「方框文字」也一樣。一個沒有引號保護的逗號會把那一列拆開，而它右邊的一切都落在錯的欄，卻沒有任何東西告訴你發生過這件事。
把檔案拖到試算表區域，或者把文字貼進去
開一張新圖表，然後把 .csv 拖到畫布下面的試算表區域，或者直接把 CSV 文字貼進去。不會出現精靈、欄位對應器或者欄位比對畫面；那些列會出現在表裡，而圖由它們渲染出來。如果你對這個檔案沒有把握，就先在一張草稿圖表上試一次。
列一落地就檢查四件事
一：列數等於檔案的行數減去標題。二：第 1 列是你的第一個步驟，不是你的標題文字。三：一個你本來就知道的「連線至」數字——那條往回指的最容易認出——落在你想要的那個步驟上。四：分支標籤坐在你預期的那些箭嘴上。由這一刻起，編輯那張表，不要再編輯那個檔案。
應避免的錯誤
標題列上方有一個報表名稱
CRM 與工單系統的匯出檔經常以報表名稱與一個產生日期開頭。檔案的第一行會被讀成標題，所以你真正的標題變成了第 1 列，而每一個「連線至」數字都差了一——一張渲染得出而且是錯的圖。匯入之前把那幾行刪掉。
分號分隔的匯出檔
一個地區設定以逗號作小數點的應用程式，會在欄位之間寫分號，於是每一行到埗時都是單獨一個值。請重新匯出並選逗號，而不是把分隔符搜尋取代掉，因為「連線至」與「連線文字」本身就含有逗號，一次全域取代會把它們毀掉。
「連線至」填好之後才把檔案排序
「連線至」指向的是列的位置，不是你來源系統的編號，所以事後按負責人或日期把匯出檔排序，會令那些連接下面每一個步驟重新編號。「連線至」最後才填，而如果那些列非動不可，就在編輯器裡動。/yue/guides/在csv裡定義連接 完整交代了這套定址方式。
以為一個對不上的欄會出聲
一個 QueryChart 不認得的欄會被帶過並忽略——沒有任何東西變紅，也沒有任何東西遺失。正是這一點令一份匯出檔可以原封進去，而這也正是為甚麼一個打錯了的標題會安安靜靜地失敗：資料在檔案裡、在那一列上，而且甚麼都沒有做。
把你的 CSV 匯入一張圖表
把這份旅程示例作為你自己的圖表打開，看看那些欄是怎樣填的，然後把你自己的 .csv 拖到試算表區域上。
相關指南
常見問題
有沒有匯入精靈或者欄位對應器？
沒有。有兩條路進去，而每一條都是一個動作：把 .csv 拖到畫布下面的試算表區域，或者把 CSV 文字貼進去。欄是按標題名稱比對的，所以沒有東西要設定，也沒有一個會做錯的欄位比對環節。當一個欄看上去甚麼都沒有做，原因是那個標題名稱，而不是你漏了甚麼設定。
QueryChart 用不到的欄要不要刪掉？
不用。不獲認得的欄會被帶過並忽略，所以一份帶著工單編號、時間戳記、一個成本中心與四個報表欄的匯出檔，可以原封不動地照著出來的樣子進去。留著它們不用付出任何代價，而且保住了回溯這些列來自哪裡的線索。唯一值得先做的欄位功夫，是把你確實想比對上的那幾個改名：「方框文字」、「連線至」、「連線文字」、「形狀」與兩個泳道欄。
我的檔案到埗時是單獨一個欄。發生了甚麼事？
分隔符不是逗號。由地區設定為歐洲的應用程式匯出的檔案通常是分號分隔的，而一個以 .csv 為副檔名儲存的定位字元分隔檔案表現一樣。請重新匯出並選逗號，而不是人手取代分隔符，因為「連線至」與「連線文字」放著的是逗號分隔清單，一次全域取代會把它們摧毀。順手另存為 UTF-8——一個錯的編碼顯示出來的樣子是標籤變成亂碼，永遠不會是一個錯誤。
那些列匯入了，卻沒有出現箭嘴。
「連線至」要麼是空的，要麼放著列號以外的東西。慣常的成因，是匯出檔的下一步欄承載的是來源系統自己的編號——STEP_014——而不是檔案裡的位置；或者是一個名稱沒有比對上的標題，那樣那個欄就作為一個被忽略的多餘欄落地。兩者都在那張表裡修：把列號打進「連線至」，箭嘴就隨著你打而出現。
之後可以再匯入這個檔案來更新圖表嗎？
沒有任何東西把圖表連回它所來自的那個檔案——沒有重新整理、沒有同步、也沒有連接器——所以再匯入一次是又一次貼上，而不是一次更新。把這件事當成一個只做一次的決定：匯入之後，圖表就是這條流程的定義，而那份匯出檔變成它當日樣貌的一個快照。如果來源資料真的每週都變，那它幾乎肯定是一份個案日誌而不是一份步驟定義，而只有步驟才屬於這張圖。