資料表格 Excel 匯入 / 匯出¶
TsERP 全系統的資料表格（畫面上以欄位排列的明細列表，底層為共用元件 TsRadGridView）都內建右鍵選單，提供兩個 Excel 相關功能。兩者按右鍵的位置不同：
- 匯出至 Excel：在表格的欄位標題列（最上方那一排欄位名稱）按滑鼠右鍵叫出。把目前表格的內容輸出成 Excel 檔。
- 從 Excel 匯入（本次新增）：在表格的任一資料列（表格中任一筆資料）按滑鼠右鍵叫出；若整張表沒有任何資料列，則在表格的空白資料區按右鍵也會出現。把 Excel 檔的資料填回表格。
本頁說明這兩個共用功能的操作方式與規則。各模組另有自帶的專屬匯入（例如總帳傳票），規則略有不同，會在該模組頁面另行說明。
適用範圍
本頁介紹的右鍵選單，適用於所有使用 TsRadGridView 的明細表格畫面，例如傳票輸入、各式單據的明細區等。少數特殊表格（樞紐／動態欄位）不在此列。
功能簡介¶
| 功能 | 用途 | 使用情境 |
|---|---|---|
| 匯出至 Excel | 將表格目前顯示的列匯出成 .xlsx |
需要把畫面資料拿到 Excel 另作分析、列印、寄送 |
| 從 Excel 匯入 | 將 Excel 內容批次填入表格 | 大量明細在 Excel 整理好後，一次匯入，省去逐列手key |
「從 Excel 匯入」依畫面不同有兩種行為：
- 畫面自帶匯入：部分畫面（如總帳傳票）有專屬匯入規則，右鍵的「從 Excel 匯入」等同畫面上原有的
Excel匯入按鈕，只是多一個操作入口。詳見各模組頁面。 - 通用表頭對應匯入：一般明細表格若沒有自帶匯入，右鍵「從 Excel 匯入」會以「Excel 表頭文字 ↔ 表格欄位標題」自動對應，逐列把值填進對應欄位。本頁以下說明的即為此通用行為。
前置需求¶
- 已具備登入 TsERP 的使用者帳號與該畫面的操作權限。
- 表格必須處於可編輯狀態（已按
新增或修改）。唯讀／瀏覽狀態下不會出現「從 Excel 匯入」。 - 準備好的 Excel 檔：第 1 列為欄名（表頭），第 2 列起為資料。
操作步驟¶
匯出至 Excel¶
- 在表格的欄位標題列按滑鼠右鍵。
- 選擇
匯出至 Excel。 - 指定存檔位置與檔名，按
儲存。 - 系統將表格目前的列輸出為 Excel 檔。
從 Excel 匯入（通用表頭對應）¶
- 先按
新增或修改，讓表格進入可編輯狀態。 -
準備 Excel 檔：
- 第 1 列填入欄名，且欄名文字需與表格的欄位標題完全一致（例如表格欄位顯示「品名」，Excel 第 1 列就要寫「品名」）。
- 第 2 列起為要匯入的資料，每一列對應表格的一行。
-
在表格的任一資料列按右鍵，選擇
從 Excel 匯入（若表格目前沒有任何資料列，則在表格的空白資料區按右鍵）。 - 選取 Excel 檔，按
開啟。 -
系統先做整批預檢：
- 若沒有任何欄名對得上表格欄位，會提示後中止，不匯入。
- 若某些格子的內容型別轉換不過（例如該欄是金額卻填了文字），會列出問題列後整批中止，不會匯入一半。
-
預檢通過後，系統將每一列的值填進對應欄位，匯入完成。
對應方式就是「欄名對欄名」
通用匯入不看 Excel 的欄位順序，而是用欄名比對。只要 Excel 第 1 列的欄名與表格欄位標題一致，順序不同也能正確對應；對不上的欄名會被忽略。
匯入規則說明¶
通用表頭對應匯入有以下重點規則，請務必了解：
| 規則 | 說明 |
|---|---|
| 僅可編輯狀態可用 | 只有在 新增 或 修改 狀態才會出現「從 Excel 匯入」。瀏覽／唯讀狀態看不到此選項。 |
| 在資料列右鍵叫出 | 「從 Excel 匯入」掛在資料列右鍵選單（非欄位標題列）。表格無任何資料列時，改在空白資料區右鍵叫出。 |
| 欄名需一致 | Excel 第 1 列欄名必須與表格欄位標題一致才會對應。完全沒有一欄對得上就不匯入並提示。 |
| 整批預檢、全有全無 | 匯入前先檢查所有資料格。只要任何一格型別轉不過（例如金額欄填了文字），就整批中止、不會匯入一半，並列出前 20 筆問題列（含 Excel 列號與欄名），方便回 Excel 修正。 |
| 空白不覆寫 | Excel 中空白的儲存格不會覆寫表格該欄的預設值，保留系統帶出的預設。 |
| 唯讀／連動欄不匯入 | 唯讀欄、以及由系統計算或連動帶出的欄位不會被匯入對應，避免覆寫掉自動算出的值。 |
| 文字型代碼保留原樣 | 以文字儲存的編號（例如有前導零的代碼 00123）會原樣保留，不會被當成數字而掉前導零。 |
整批中止不會留下半筆資料
通用匯入採「全有全無」：只要有任何一格驗證失敗，整批都不會進表格。請依提示的 Excel 列號與欄名修正後，重新匯入。
常見問題¶
右鍵選單裡找不到「從 Excel 匯入」？
請確認兩件事：一是表格需處於新增／修改可編輯狀態（瀏覽／唯讀狀態不會出現此選項，請先按 新增 或 修改）；二是要在資料列按右鍵，而不是欄位標題列——「從 Excel 匯入」掛在資料列右鍵選單（欄位標題列右鍵只有「匯出至 Excel」）。若表格目前沒有任何資料列，改在空白資料區按右鍵。少數特殊表格（樞紐／動態欄位）不支援此功能。
為什麼匯入沒反應，提示「沒有可對應的欄位」？
表示 Excel 第 1 列的欄名沒有一個對得上表格的欄位標題。請打開表格確認各欄的標題文字，並把 Excel 第 1 列改成完全一致的欄名（含全形／半形、空白都要一致）。
為什麼整批失敗？只是其中一兩格有問題而已。
通用匯入採整批預檢、全有全無：只要有一格型別轉不過（例如金額欄填了文字、日期欄填了非日期），整批都會中止，不會匯入一半。系統會列出前 20 筆問題列的 Excel 列號與欄名，請逐一修正後重新匯入。
Excel 裡有些欄位是空的，匯入後會把表格原本的值清掉嗎？
不會。空白儲存格不覆寫，表格該欄會保留系統帶出的預設值。若要清空某欄，請改用畫面操作而非匯入。
為什麼有些欄位匯入後沒變？
唯讀欄、以及計算／連動欄（值由其他欄位自動算出）不會被匯入對應，以免覆寫掉自動算出的結果。這些欄位即使 Excel 有填也會被忽略。
編號開頭的 0 不見了怎麼辦？
若該欄在系統是文字型代碼，匯入會保留原樣、不會掉前導零。若仍發現掉零，通常是 Excel 端把該格存成數字了；請在 Excel 把該欄格式設為「文字」，或在數字前加單引號 '00123，再重新匯入。
總帳傳票的匯入規則跟這頁不一樣？
是的。總帳傳票（傳票輸入）有自帶的專屬匯入規則（固定欄位位置、科目代號驗證），右鍵的「從 Excel 匯入」會走那套規則，而非本頁的通用表頭對應。詳見 傳票輸入。