Excel 匯入工具

基本邏輯

Excel 匯入工具是一款專為建築製圖工作流程設計的 Revit 外掛程式，能協助您從 Excel 試算表中選取任意儲存格範圍，將其忠實還原為 Revit 中的詳細線與文字註記。工具會讀取儲存格的邊框、文字內容、對齊方式、合併儲存格等資訊，按比例轉換為 Revit 製圖視圖中的 2D 元素。

使用這個工具，您可以：

• 一鍵啟動 Excel 並開啟目標檔案（.xls 或 .xlsx），自動監控儲存格選取範圍
• 將 Excel 儲存格的邊框線轉換為 Revit 詳細線（DetailCurve），忠實還原表格外觀
• 將儲存格文字轉換為 Revit 文字註記（TextNote），保留原始水平對齊方式
• 自動處理合併儲存格，正確計算尺寸與位置
• 自訂匯入比例、線條樣式、字型類型、定位點等參數
• 選擇寫入新製圖視圖或現有視圖（含詳圖、圖例、樓層平面）
• 支援附加模式，在不刪除既有元素的基礎上疊加匯入內容
• 透過 Revit 視圖中直接點擊挑選定位點，精確控制匯入位置

此工具特別適用於需要將 Excel 製表、規格表、標籤或圖例轉換為 Revit 製圖視圖內容的工作流程，可大幅減少手動重繪表格與輸入文字的時間。

操作步驟

1. 啟動工具與前置檢查

   在 Revit 中透過功能区按鈕或外掛選單啟動「Excel 匯入工具」。工具啟動時會自動執行以下前置檢查：

   • 確認目前開啟的是專案檔案（非族編輯器）。若在族編輯器中，工具將靜默退出。
   • 確認系統已安裝 Excel。若未安裝，將顯示錯誤訊息「未安裝 Excel 軟體」。
   • 單一執行個體檢查。若工具已在執行中，會自動將既有視窗置前，避免重複開啟。

   工具視窗開啟後，左下角的登入模組會自動向授權伺服器（license.wylin.com.tw）驗證授權狀態。若無快取憑證或驗證失敗，3 秒後會彈出登入對話框，需輸入授權碼完成認證。

   💡 授權系統

   本工具採用線上授權機制，包含 RSA 簽章驗證、硬體指紋綁定與會話管理。登入後，系統每 15 秒自動續期會話，每 3 分鐘檢查到期狀態。授權對話框中亦可查看目前活躍連線數並進行遠端登出操作。

2. 開啟 Excel 檔案

   點擊工具列上的「開啟」按鈕。系統會執行以下動作：

   • 啟動一個新的 Excel 執行個體，並設為可見
   • 彈出檔案開啟對話框，過濾條件為 *.xls 和 *.xlsx
   • 載入選取的檔案後，自動對所有工作表掛上「選取範圍變更」事件監聽器

   完成後，工具列上的匯入按鈕仍為停用狀態，等待您在 Excel 中選取儲存格範圍。

   💡 支援的檔案格式

   本工具支援 Excel 97-2003 格式（.xls）與 Excel 2007 以上格式（.xlsx）。開啟後，切換至任一工作表並選取儲存格範圍即可。

3. 選取儲存格範圍

   在開啟的 Excel 視窗中，以滑鼠拖曳選取要匯入的儲存格範圍。工具會即時偵測選取變化並自動更新以下資訊：

   • 工作表名稱：目前活躍的工作表名稱
   • 起始儲存格：選取範圍左上角（如 A1）
   • 結束儲存格：選取範圍右下角（如 D10）
   • 格數：總共選取的儲存格數量

   資訊更新完成後，「匯入」按鈕自動啟用。若 Excel 視窗失去焦點，工具會自動清除範圍資料並停用匯入按鈕，防止使用過期狀態。

   ⚠️ 儲存格數量限制

   當選取範圍超過 256 個儲存格時，「匯入」按鈕將保持停用狀態。請縮小選取範圍後再執行匯入。

4. 設定匯入參數

   在工具視窗中調整以下參數以控制匯入結果：

   文字與線條設定

   欄位名稱	說明	預設值 / 建議
   字型	選擇文字註記的類型。下拉選單會自動從 Revit 專案中讀取所有可用的文字註記類型，依名稱排序	依專案規範選取
   線型	選擇詳細線的線條樣式。下拉選單會自動從 Revit 專案中讀取所有線條樣式，依名稱排序	依專案規範選取
   文字上偏移	設定文字在儲存格內的垂直偏移量。正值表示向上偏移，用於微調文字在儲存格中的垂直位置	1（步進 0.5）
   啟用縮排	勾選後，會將 Excel 儲存格的縮排層數轉換為空格字元填充。適用於 Revit 2017 以上版本	依需求勾選
   縮排轉換	設定每個縮排層數對應的空格數量。當「啟用縮排」未勾選時可調整此數值	1（範圍 1~10000）
   文字寬度係數	勾選後，Revit 文字註記的寬度將與 Excel 儲存格寬度成比例。寬度計算公式為：(儲存格寬度 / 411) × 寬度比	依需求勾選
   寬度比	文字寬度係數的倍率乘數。與上述公式搭配使用，用於微調文字寬度	1（範圍 0.5~1000，步進 0.5）

   尺寸與定位設定

   欄位名稱	說明	預設值 / 建議
   線長比例係數	所有線條長度與儲存格尺寸的倍率乘數。用於調整匯入元素的大小比例	1（範圍 0.5~1000，步進 0.5）
   初始定位點 X	設定匯入內容的 X 軸偏移量。配合「挑選點」使用可精確控制放置位置	0（範圍 ±99999）
   初始定位點 Y	設定匯入內容的 Y 軸偏移量。配合「挑選點」使用可精確控制放置位置	0（範圍 ±99999）
   挑選點	點擊後工具視窗最小化，進入 Revit 的物件挑選模式。在 Revit 視圖中點擊任意位置，該點的 X/Y 座標將自動填入定位點欄位	依需求使用

   💡 精確定位技巧

   建議先點擊「挑選點」在 Revit 視圖中選取基準位置，然後再透過 X/Y 偏移數值進行微調。此方式比直接輸入座標數值更加直觀準確。

5. 選擇目標視圖

   工具提供兩種寫入模式：

   模式一：寫入自訂製圖視圖（預設）

   勾選「僅寫入自訂視圖 → 啟用」後，設定以下參數：

   欄位名稱	說明	預設值 / 建議
   視圖名稱	輸入要建立的製圖視圖名稱。若同名視圖已存在，會覆用該視圖	「Excel 匯入」
   視圖比例	設定製圖視圖的出圖比例分母（如 300 代表 1:300）	300（範圍 1~10000，步進 50）
   附加模式	勾選後不會刪除目標視圖中既有的線條、文字註記與詳細元件。未勾選時會先清除既有內容再匯入	依需求勾選（預設未勾選）

   模式二：寫入現有視圖

   取消勾選「啟用」後，左側的視圖樹狀列表將可用。列表分為三個類別：

   • 詳圖：所有製圖視圖
   • 圖例：所有圖例視圖
   • 樓層平面圖：所有樓層平面視圖

   各類別下的視圖依名稱排序。可按住 Ctrl 鍵多選多個視圖，同一份 Excel 資料將同時匯入所有選取視圖。雙擊任一視圖名稱可在 Revit 中切換至該視圖。

   💡 附加模式的用途

   當製圖視圖中已有部分內容（如標題、邊框或其他標註），只需新增 Excel 資料時，勾選「附加模式」即可保留既有元素。取消勾選則會先清空視圖再匯入。

6. 執行匯入

   確認所有設定無誤後，點擊底部的「匯入」按鈕。系統會依序執行以下動作：

   • 根據目標視圖模式建立或選取製圖視圖，設定比例並（若非附加模式）清除既有內容
   • 逐個處理選取範圍內的儲存格：
     • 檢測合併儲存格：若為合併區域的非左上角儲存格則跳過；若是左上角則使用整個合併區域的尺寸
     • 計算位置：由 A1 起累加所有前面欄位的寬度與列高，加上 X/Y 偏移量得出絕對座標
     • 建立邊框線：檢查儲存格四邊（上、左、下、右）是否有邊框樣式。僅為有邊框的邊界建立詳細線（DetailCurve），並套用設定的線條樣式
     • 建立文字註記：讀取儲存格文字內容，判斷水平對齊方式（左、中、右或一般）。若為「一般」對齊，自動偵測數值型資料靠右、文字靠左。在儲存格垂直中央偏上位置建立 TextNote
     • 若啟用縮排，根據 Excel 的縮排轉換數值，在文字前方填充空格
     • 若啟用文字寬度係數，設定文字註記寬度為 (儲存格寬度 / 411) × 寬度比
   • 進度列即時顯示匯入進度百分比

   完成後，所有匯入元素會出現在目標視圖中。您可以切換到該視圖檢視結果。

   ⚠️ 匯入中斷

   匯入過程中若需中止，可點擊「取消」按鈕。系統會在處理完當前批次後停止並提交已完成的內容。

7. 檢視與後續處理

   匯入完成後，切換到目標視圖即可看到結果：

   • 儲存格的邊框已轉換為詳細線（DetailCurve），使用設定的線條樣式
   • 儲存格文字已轉換為文字註記（TextNote），保留原始對齊方式
   • 合併儲存格會正確顯示為大尺寸的單一區塊

   所有匯入元素都是標準的 Revit 圖元，您可以直接在 Revit 中進行以下操作：

   • 選取、移動、刪除個別線條或文字
   • 修改文字內容、字型大小或對齊方式
   • 變更線條樣式、顏色或線寬
   • 使用 Revit 內建的群組（Group）功能將相關元素分組管理
   • 列印、匯出 DWG/DXF 或發布為 PDF

實用小技巧

問題排除

搭配使用建議

常見問題（FAQ）