CSV甘特圖範本：檔案格式同排期
CSV甘特圖範本：14項任務嘅資料遷移計劃，附描述佢嘅CSV（Task、Group、Duration、Depends on）同自動計算嘅排期。
甚麼是CSV甘特圖範本：檔案格式同排期流程
CSV係計劃流通嘅格式。項目工具匯出，同事用電郵寄嚟，試算表儲存，而甘特圖工具就要讀入。流程圖要考慮點寫箭咀；甘特圖簡單啲，因為每項任務只需要四樣嘢：名稱、長度、組別同佢要等嘅任務。其他嘅，日期、橫條同完成日，全部由系統計算。
呢個範本係一個資料遷移項目，計劃嘅輸入本身就係CSV檔案：由舊系統匯出、清理、對應新欄位、試載入、核對，最後正式載入。下面嘅檔案就係以CSV寫成嘅計劃，欄位就係QueryChart甘特圖工作表貼上時讀取嘅欄位。標題名稱按名稱對應，次序隨便，最少要認得兩欄。最重要係Task（任務）欄；Duration（工期）係整數工作日，0代表里程碑；Group（組別）畫出階段帶；Depends on（前置任務）列出任務要等嘅任務。
三個細節決定CSV貼唔貼得乾淨。Depends on（前置任務）會放幾個以逗號分隔嘅任務編號，所以呢個欄位要用雙引號包住，而CSV寫入工具只有喺佢真係當佢係單一儲存格時先會幫你加。日期（如果你加Start或者End欄）要小心次序：yyyy-mm-dd喺邊種語言都讀得一樣，而好似3/4咁嘅日期會按語言嘅次序讀，可能係4月3日或者3月4日。另外Status欄會被當作進度，即係百分比或者Done呢個字；其他字眼唔認得。
甘特圖暫時未支援上載檔案。用任何文字編輯器或者試算表打開CSV，複製包括標題行嘅所有行，貼入工作表。下面嘅排期就係會出現嘅結果。
本流程圖涵蓋的內容
本範本包含
- 四個組別：提取（Extract）、轉換（Transform）、載入（Load）同核實（Verify），共14項任務同兩個里程碑：「收到CSV檔案」同「對應已簽核」，另外「核實通過」係最後載入前嘅關卡。
- 文字形式嘅檔案：圖表下面嗰段CSV，四個欄位，Depends on（前置任務）欄位如果有多於一項任務就加引號。
- 重疊進行嘅工作：「將來源欄位對應到目標欄位」喺「收到CSV檔案」開始後一個工作日開始，同「分析同清理資料」並行。
- 分兩條線嘅核實：「核對數量同總數」同「用戶檢查樣本記錄」都跟住「修正載入錯誤」，而「核實通過」要等兩者。
- 自動計算嘅排期：每個日期都由檔案入面嘅工期同依賴算出，唔係來自日期欄。
何時使用本範本
- 你有一份來自項目工具或者試算表嘅CSV計劃，想睇成甘特圖。
- 你用程式或者範本產生計劃，需要知道準確嘅欄位同引號寫法。
- 貼入甘特圖工作表時有部分被拒絕，想睇一份行得通嘅檔案。
- 你想要一個資料遷移、ETL或者匯入項目嘅起始計劃。
逐項任務嘅計劃
圖表入面每項任務，連同以工作日計嘅工期同佢哋等緊嘅前置任務。依賴用步驟編號表示；SS 係開始到開始，FF 係完成到完成，+n 係以工作日計嘅延遲。
| # | 任務 | 分組 | 工作日 | 依賴於 |
|---|---|---|---|---|
| 1 | 確定範圍同資料擁有人 | 提取 | 3 | |
| 2 | 將來源資料匯出成CSV | 提取 | 4 | 1 |
| 3 | 收到CSV檔案 | 提取 | 里程碑 | 2 |
| 4 | 分析同清理資料 | 轉換 | 8 | 3 |
| 5 | 將來源欄位對應到目標欄位 | 轉換 | 5 | 3SS+1 |
| 6 | 對應已簽核 | 轉換 | 里程碑 | 4, 5 |
| 7 | 喺測試系統試載入 | 載入 | 3 | 6 |
| 8 | 修正載入錯誤 | 載入 | 4 | 7 |
| 9 | 核對數量同總數 | 核實 | 3 | 8 |
| 10 | 用戶檢查樣本記錄 | 核實 | 4 | 8SS+2 |
| 11 | 核實通過 | 核實 | 里程碑 | 9, 10 |
| 12 | 正式載入 | 載入 | 2 | 11 |
| 13 | 封存來源檔案 | 核實 | 1 | 12 |
| 14 | 載入後檢討 | 核實 | 2 | 12 |
同一計劃嘅 CSV 檔案
連同標題行一齊複製到甘特圖表格：每一欄按欄名配對。包含多項任務嘅「前置任務」儲存格帶有逗號，所以加咗引號。計劃本身冇日期；對固定嘅任務，可以加「開始」欄並填上 ISO 日期（2026-04-03）。
Task,Group,Duration,Depends on
確定範圍同資料擁有人,提取,3,
將來源資料匯出成CSV,提取,4,1
收到CSV檔案,提取,0,2
分析同清理資料,轉換,8,3
將來源欄位對應到目標欄位,轉換,5,3SS+1
對應已簽核,轉換,0,"4, 5"
喺測試系統試載入,載入,3,6
修正載入錯誤,載入,4,7
核對數量同總數,核實,3,8
用戶檢查樣本記錄,核實,4,8SS+2
核實通過,核實,0,"9, 10"
正式載入,載入,2,11
封存來源檔案,核實,1,12
載入後檢討,核實,2,12運作方式
先寫標題行
Task、Group、Duration、Depends on（任務、組別、工期、前置任務）。只有固定日期嘅任務先加Start或End，有嘅話再加Progress、Owner或Notes。名稱按名稱對應，次序隨便，最少要認得兩欄。
每行一項任務
第一項任務係1號，Depends on（前置任務）就係指呢個編號。每項任務維持喺幾日至幾個星期。
每項任務都要有以整數工作日計嘅長度
里程碑用0。冇小時同半日，所以要進位，或者將好短嘅任務併入隔離嗰項。
Depends on寫成編號，而且加引號
列出佢要等嘅任務編號，例如4, 5。其他類型加SS、FF或SF，延遲用+n或-n，例如5SS+1。呢啲清單有逗號，所以欄位要用雙引號包住。
存成UTF-8並檢查文字
用文字編輯器打開檔案睇一次：逗號做分隔符，有逗號嘅欄位加引號，日期係yyyy-mm-dd。
複製、貼上，再睇邊啲被拒絕
複製所有行，貼入甘特圖工作表第一個Task（任務）儲存格，再睇有冇警告。讀唔到嘅日期、Depends on（前置任務）入面唔存在嘅任務或者依賴迴圈，會被報告並剔除，唔會估。
常見問題
用CSV整甘特圖需要邊啲欄位？
需要任務名稱，加上工期或者開始同完成日期。Group（組別）、Depends on（前置任務）、Progress（進度）同人員都係可選。標題行會命名各欄，欄位次序無所謂。
點解我嘅Depends on欄壞咗？
幾乎一定係因為有幾個任務編號嘅欄位，例如4, 5，冇加引號，所以逗號將佢分成兩欄。將呢個欄位用雙引號包住就得。
可以上載CSV檔案嗎？
甘特圖暫時未支援上載檔案，所以請由CSV複製各行（包括標題行），貼入圖表旁邊嘅工作表。
行嘅次序重要嗎？
喺一方面重要：任務編號就係佢嘅位置，而Depends on（前置任務）係指呢個編號。寫好依賴之後再改行次序，會令依賴指向其他任務，除非你用名稱指任務。
Status欄有咩用？
佢會被當作進度。百分比或者Done呢個字認得；其他字眼例如In progress唔認得，而該儲存格會被標示。
